语言

JsonWriter 类

定义

将 JSON(RFC 4627)编码的值写入流,一次一个令牌。

[Android.Runtime.Register("android/util/JsonWriter", DoNotGenerateAcw=true)]
public sealed class JsonWriter : Java.Lang.Object, IDisposable, Java.IO.ICloseable
[<Android.Runtime.Register("android/util/JsonWriter", DoNotGenerateAcw=true)>]
type JsonWriter = class
    inherit Object
    interface ICloseable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
继承
JsonWriter
特性
实现

注解

将 JSON(RFC 4627)编码的值写入流,一次一个令牌。 该流包括文本值(字符串、数字、布尔值和 null),以及对象和数组的开始和结束分隔符。

<h3>编码 JSON</h3> 若要将数据编码为 JSON,请创建新的 JsonWriter。 每个 JSON 文档必须包含一个顶级数组或对象。 在演练结构的内容、嵌套数组和对象时,对编写器调用方法: <ul><li>若要编写 <强>数组</强>,首先调用 #beginArray()。 使用适当的 #value 方法或通过嵌套其他数组和对象来编写每个数组的元素。 最后,使用 #endArray(). 关闭数组。 <li>要编写 <强>对象</强>,第一次调用 #beginObject()。 通过将调用 #name 与属性的值交替写入每个对象的属性。 使用适当的 #value 方法或嵌套其他对象或数组来编写属性值。 最后使用 #endObject(). 关闭对象。 </ul>

<h3>示例</h3> 假设我们要对消息流进行编码,如下所示:

{@code
            [
              {
                "id": 912345678901,
                "text": "How do I write JSON on Android?",
                "geo": null,
                "user": {
                  "name": "android_newb",
                  "followers_count": 41
                 }
              },
              {
                "id": 912345678902,
                "text": "@android_newb just use android.util.JsonWriter!",
                "geo": [50.454722, -104.606667],
                "user": {
                  "name": "jesse",
                  "followers_count": 2
                }
              }
            ]}

此代码对上述结构进行编码:

{@code
              public void writeJsonStream(OutputStream out, List<Message> messages) throws IOException {
                JsonWriter writer = new JsonWriter(new OutputStreamWriter(out, "UTF-8"));
                writer.setIndent("  ");
                writeMessagesArray(writer, messages);
                writer.close();
              }

              public void writeMessagesArray(JsonWriter writer, List<Message> messages) throws IOException {
                writer.beginArray();
                for (Message message : messages) {
                  writeMessage(writer, message);
                }
                writer.endArray();
              }

              public void writeMessage(JsonWriter writer, Message message) throws IOException {
                writer.beginObject();
                writer.name("id").value(message.getId());
                writer.name("text").value(message.getText());
                if (message.getGeo() != null) {
                  writer.name("geo");
                  writeDoublesArray(writer, message.getGeo());
                } else {
                  writer.name("geo").nullValue();
                }
                writer.name("user");
                writeUser(writer, message.getUser());
                writer.endObject();
              }

              public void writeUser(JsonWriter writer, User user) throws IOException {
                writer.beginObject();
                writer.name("name").value(user.getName());
                writer.name("followers_count").value(user.getFollowersCount());
                writer.endObject();
              }

              public void writeDoublesArray(JsonWriter writer, List<Double> doubles) throws IOException {
                writer.beginArray();
                for (Double value : doubles) {
                  writer.value(value);
                }
                writer.endArray();
              }}

每个 JsonWriter 流都可用于编写单个 JSON 流。 此类的实例不是线程安全的。 导致格式不正确的 JSON 字符串的调用将失败并出现 IllegalStateException。

Java文档android.util.JsonWriter。

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

构造函数

名称 说明
JsonWriter(Writer)

创建将 JSON 编码的流写入到 out的新实例。

属性

名称 说明
Class

返回此 Object的运行时类。

(继承自 Object)
Handle

基础 Android 实例的句柄。

(继承自 Object)
JniIdentityHashCode

获取互操作运行时分配给此Java对等的标识哈希代码。

(继承自 Object)
JniManagedPeerState

获取运行时上次分配的状态标志。

(继承自 JavaObject)
JniPeerMembers

获取用于访问此Java绑定成员的 JNI 元数据。

Lenient

如果此编写器具有宽松的语法规则,则返回 true。 - 或 - 将此编写器配置为放宽其语法规则。

PeerReference

获取此Java对等方的 JNI 对象引用。

(继承自 Object)
ThresholdClass

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

(继承自 Object)
ThresholdType

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

(继承自 Object)

方法

名称 说明
BeginArray()

开始对新数组进行编码。

BeginArrayAsync()

异步运行 BeginArray() 。

BeginObject()

开始对新对象进行编码。

BeginObjectAsync()

异步运行 BeginObject() 。

Clone()

创建并返回此对象的副本。

(继承自 Object)
Close()

刷新并关闭此编写器和基础 Writer。

Construct(JniObjectReference, JniObjectReferenceOptions)

将此对等方的构造委托给运行时的值管理器。

(继承自 JavaObject)
Dispose()

释放此Java对等方持有的资源。

(继承自 Object)
Dispose(Boolean)

释放此Java对等方持有的资源。

(继承自 Object)
DisposeUnlessReferenced()

要求值管理器释放此对等方,除非其映射保留此相同的托管实例。

(继承自 JavaObject)
EndArray()

结束对当前数组的编码。

EndArrayAsync()

异步运行 EndArray() 。

EndObject()

结束对当前对象的编码。

EndObjectAsync()

异步运行 EndObject() 。

Equals(Object)

测试另一个托管对等方是否引用同一Java对象。

(继承自 JavaObject)
Equals(Object)

指示其他对象是否“等于”此对象。

(继承自 Object)
Flush()

确保所有缓冲数据都写入基础 Writer 并刷新该写入器。

FlushAsync()

异步运行 Flush() 。

GetHashCode()

返回对象的哈希代码值。

(继承自 Object)
JavaFinalize()
已过时.

当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。

(继承自 Object)
Name(String)

对属性名称进行编码。

NameAsync(String)

异步运行 Name(String) 。

Notify()

唤醒正在等待此对象的监视器的单个线程。

(继承自 Object)
NotifyAll()

唤醒正在等待此对象的监视器的所有线程。

(继承自 Object)
NullValue()

编码 null。

NullValueAsync()

异步运行 NullValue() 。

SetHandle(IntPtr, JniHandleOwnership)

设置 Handle 属性。

(继承自 Object)
SetIndent(String)

为编码文档中的每一级缩进设置要重复的缩进字符串。

SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

在不创建 JNI 引用副本的情况下,将引用值存储在控制块中。

(继承自 JavaObject)
ToArray<T>()

从此Java数组包装器创建托管数组。

(继承自 Object)
ToString()

返回对象的字符串表示形式。

(继承自 Object)
UnregisterFromRuntime()

从互操作运行时取消注册此Java对等。

(继承自 Object)
Value(Boolean)

编码 value。

Value(Double)

编码 value。

Value(Int64)

编码 value。

Value(Number)

编码 value。

Value(String)

编码 value。

ValueAsync(Boolean)

异步运行 Value(Boolean) 。

ValueAsync(Double)

异步运行 Value(Double) 。

ValueAsync(Int64)

异步运行 Value(Int64) 。

ValueAsync(Number)

异步运行 Value(Number) 。

ValueAsync(String)

异步运行 Value(String) 。

Wait()

导致当前线程等待,直到它被唤醒,通常是通过 通知 或 中断。

(继承自 Object)
Wait(Int64, Int32)

使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。

(继承自 Object)
Wait(Int64)

使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。

(继承自 Object)

显式接口实现

名称 说明
IJavaPeerable.Disposed()

将此对等方标记为已释放,并将disposing调用Dispose设置为 true.

(继承自 JavaObject)
IJavaPeerable.Finalized()

将此对等方标记为已释放,并将disposing调用Dispose设置为 false.

(继承自 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

获取此对等方使用的本机控制块指针。

(继承自 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

存储运行时提供的标识哈希代码。

(继承自 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

替换存储的托管对等状态标志。

(继承自 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

更新对等引用,并在引用无效时释放已释放的对等方控制块。

(继承自 JavaObject)
IJavaPeerable.UnregisterFromRuntime()

从运行时的Java对象查找中删除此实例。

扩展方法

名称 说明
GetJniTypeName(IJavaPeerable)

获取实例 self类型的 JNI 名称。

JavaAs<TResult>(IJavaPeerable)

尝试强制self键入TResult,检查强制是否在Java端有效。

JavaCast<TResult>(IJavaObject)

执行 Android 运行时检查的类型转换。

JavaCast<TResult>(IJavaObject)

重复使用兼容的托管对等,或获取请求类型的包装器。

TryJavaCast<TResult>(IJavaPeerable, TResult)

尝试强制self键入TResult,检查强制是否在Java端有效。

适用于