JsonReader

public final class JsonReader
extends Object implements Closeable

将JSON（ RFC 4627 ）编码值读取为令牌流。 该流包括文字值（字符串，数字，布尔值和空值）以及对象和数组的开始和结束分隔符。 这些令牌按深度优先顺序遍历，与它们在JSON文档中出现的顺序相同。 在JSON对象中，名称/值对由单个标记表示。

Parsing JSON

接下来，为您的JSON文本中的每个结构创建处理程序方法。 您需要为每种对象类型和每种数组类型提供一种方法。

• Within array handling methods, first call beginArray() to consume the array's opening bracket. Then create a while loop that accumulates values, terminating when hasNext() is false. Finally, read the array's closing bracket by calling endArray().
• Within object handling methods, first call beginObject() to consume the object's opening brace. Then create a while loop that assigns values to local variables based on their name. This loop should terminate when hasNext() is false. Finally, read the object's closing brace by calling endObject().

当遇到嵌套的对象或数组时，委托给相应的处理程序方法。

遇到未知名称时，严格的解析器应该会失败并产生异常。 宽松的解析器应该调用skipValue()以递归方式跳过该值的嵌套标记，否则这些标记可能会发生冲突。

如果值可能为空，则应首先使用peek()检查。 可以使用nextNull()或skipValue()来消费空文字。

Example

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

   public List<Message> readJsonStream(InputStream in) throws IOException {
     JsonReader reader = new JsonReader(new InputStreamReader(in, "UTF-8"));
     try {
       return readMessagesArray(reader);
     } finally {
       reader.close();
     }
   }

   public List<Message> readMessagesArray(JsonReader reader) throws IOException {
     List<Message> messages = new ArrayList<Message>();

     reader.beginArray();
     while (reader.hasNext()) {
       messages.add(readMessage(reader));
     }
     reader.endArray();
     return messages;
   }

   public Message readMessage(JsonReader reader) throws IOException {
     long id = -1;
     String text = null;
     User user = null;
     List<Double> geo = null;

     reader.beginObject();
     while (reader.hasNext()) {
       String name = reader.nextName();
       if (name.equals("id")) {
         id = reader.nextLong();
       } else if (name.equals("text")) {
         text = reader.nextString();
       } else if (name.equals("geo") && reader.peek() != JsonToken.NULL) {
         geo = readDoublesArray(reader);
       } else if (name.equals("user")) {
         user = readUser(reader);
       } else {
         reader.skipValue();
       }
     }
     reader.endObject();
     return new Message(id, text, user, geo);
   }

   public List<Double> readDoublesArray(JsonReader reader) throws IOException {
     List<Double> doubles = new ArrayList<Double>();

     reader.beginArray();
     while (reader.hasNext()) {
       doubles.add(reader.nextDouble());
     }
     reader.endArray();
     return doubles;
   }

   public User readUser(JsonReader reader) throws IOException {
     String username = null;
     int followersCount = -1;

     reader.beginObject();
     while (reader.hasNext()) {
       String name = reader.nextName();
       if (name.equals("name")) {
         username = reader.nextString();
       } else if (name.equals("followers_count")) {
         followersCount = reader.nextInt();
       } else {
         reader.skipValue();
       }
     }
     reader.endObject();
     return new User(username, followersCount);
   }

Number Handling

每个JsonReader可用于读取单个JSON流。 这个类的实例不是线程安全的。

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

JsonReader (Reader in)

Public methods

void beginArray ()

void beginObject ()

void close ()

void endArray ()

void endObject ()

boolean hasNext ()

boolean isLenient ()

boolean nextBoolean ()

double nextDouble ()

int nextInt ()

long nextLong ()

String nextName ()

void nextNull ()

String nextString ()

JsonToken peek ()

void setLenient (boolean lenient)

void skipValue ()

String toString ()