JsonWriter

版本：Android 4.0 r1

结构

继承关系

public final classJSonWriterextendsObjectimplementsCloseable

java.lang.Object

android.util.JsonWriter

类概述

输出JSON（RFC4627）的流编码值，每次一个token。这个流值包括文字内容（字符串，数字布尔值，nulls）以及对象和数组的开始和结束符。

JSON编码

将数据编码为JSON格式，创建一个JsonWriter对象。每个JSON文件必须包含一个顶层的数组或者对象。嵌套数组和对象必须如下调用方法来组织内容：

l写数组，首先要调用beginArray()。用适当的value()方法或嵌套其他数组和对象为每个元素赋值。最后关闭数组调用endArray()。

l写对象，首先调用beginObject()。通过交替调用name(String)方法循环写入对象属性值。用适当的value()方法或嵌套其他数组和对象写入熟悉值。最后关闭对象调用endObject()。

例子

编写流信息如下：

如下表示以上信息结构：

publicvoidwriteJsonStream(OutputStreamout,Listmessages)throwsIOException{
JsonWriterwriter=newJsonWriter(newOutputStreamWriter(out,"UTF-8"));
writer.setIndent(" ");
writeMessagesArray(writer,messages);
writer.close();


publicvoidwriteMessagesArray(JsonWriterwriter,Listmessages)throwsIOException{
writer.beginArray();
for(Messagemessage:messages){
writeMessage(writer,message);
}
writer.endArray();
}

publicvoidwriteMessage(JsonWriterwriter,Messagemessage)throwsIOException{
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();
}

publicvoidwriteUser(JsonWriterwriter,Useruser)throwsIOException{
writer.beginObject();
writer.name("name").value(user.getName());
writer.name("followers_count").value(user.getFollowersCount());
writer.endObject();
}

publicvoidwriteDoublesArray(JsonWriterwriter,Listdoubles)throwsIOException{
writer.beginArray();
for(Doublevalue:doubles){
writer.value(value);
}
writer.endArray();
}}

JsonWriter可用于来写一个JSON流。这个类的实例不是线程安全的。调用JsonWriter产生一个不规则JSON字符串会抛出异常IllegalStateException。

构造方法

publicJsonWriter(Writer out)

创建一个新的JSON编码流的实例。为了获得最佳性能，需要确保Write缓冲，必要时强制转换为BufferedWriter。

公共方法

publicJsonWriterbeginArray()

开始一个新的数组编码。每次调用这个方法必须调用一个endArray()进行配对。

返回值

JsonWriter对象。

异常

IOException

public JsonWriterbeginObject()

开始一个新的对象编码。每次调用这个方法必须调用一个endObject()进行配对。

返回值

JsonWriter对象。

异常

IOException

public voidclose()

刷新和关闭实例对象和底层Writer。

异常

IOException如果JSON文件不完整抛出此异常。

public JsonWriterendArray()

结束当前编码数组

返回值

JsonWriter对象。

异常

IOException

public JsonWriterendObject()

结束当前编码对象

返回值

JsonWriter对象。

异常

IOException

public voidflush()

确保所有缓存数据写入底层Writer并刷新(flush)这个实例对象。

public booleanisLenient()

如果writer对象是不严格的语法规则返回true。

public JsonWritername(String name)

编码属性名

参数

name将被赋值对象的名字，不允许使用空值。

返回值

JsonWriter对象。

异常

IOException

public JsonWriternullValue()

编码空值。

返回值

对象本身。

异常

IOException

public voidsetIndent(String indent)

为编码文档每一级设置缩进字符串。如果indent.isEmpty()返回true编码文档将被压缩，否则编码文档将更加易读。

参数

indent一个仅包含空格的字符串。

public voidsetLenient(boolean lenient)

配置writer对象使其使用不严格的语法规则。默认情况下，此writer对象只能发送符合RFC 4627语法规则的JSON。设置允许writer不严格规则如下：

l最顶层的值可以是任何类型。严格来说，最顶层的值必须是一个对象或者数组。

l数字可以是非数值类型或无限大。

public JsonWritervalue(double value)

编码属性值

参数

Value一个限定的值。不能是非数值或无限大的数(NaNs)，除非writer对象是不严格的。

返回值

Writer对象

异常

IOException

public JsonWritervalue(long value)

编码属性值

返回值

Writer对象

异常

IOException

public JsonWritervalue(Number value)

编码属性值

参数

Value一个限定的值。不能是非数值或无限大的数(NaNs)，除非writer对象是不严格的。

返回值

Writer对象

异常

IOException

public JsonWritervalue(boolean value)

编码属性值

返回值

Writer对象

异常

IOException

public JsonWritervalue(String value)

编码属性值

参数

Value一个字符串值，或者空值来编码空字符

返回值

Writer对象

异常

IOException

补充

文章精选

Android JSON写入类- JsonWriter

JDOM创建XML例子