JsonWriter

public final class JsonWriter
extends Object implements Closeable

将JSON（ RFC 4627 ）编码值写入一个流，一次一个令牌。 该流包含字面值（字符串，数字，布尔值和空值）以及对象和数组的开始和结束分隔符。

Encoding JSON

• To write arrays, first call beginArray(). Write each of the array's elements with the appropriate value(boolean) methods or by nesting other arrays and objects. Finally close the array using endArray().
• To write objects, first call beginObject(). Write each of the object's properties by alternating calls to name(String) with the property's value. Write property values with the appropriate value(boolean) method or by nesting other objects or arrays. Finally close the object using endObject().

Example

 [
   {
     "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
     }
   }
 ]

   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 。

Summary

Inherited methods
From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程为该对象调用 notify()方法或 notifyAll()方法，或者某个其他线程中断当前线程，或者经过了一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法或经过了指定的时间量。 final void wait() 使当前线程等待，直到另一个线程调用此对象的方法 notify()或方法 notifyAll() 。
From interface java.io.Closeable abstract void close() 关闭此流并释放与其关联的所有系统资源。
From interface java.lang.AutoCloseable abstract void close() 关闭此资源，放弃任何底层资源。

Public constructors

JsonWriter (Writer out)

Public methods

JsonWriter beginArray ()

JsonWriter beginObject ()

void close ()

JsonWriter endArray ()

JsonWriter endObject ()

void flush ()

boolean isLenient ()

JsonWriter name (String name)

JsonWriter nullValue ()

void setIndent (String indent)

void setLenient (boolean lenient)

JsonWriter value (double value)

JsonWriter value (Number value)

JsonWriter value (boolean value)

JsonWriter value (long value)

JsonWriter value (String value)