Gson Json 序列号 最常用的功能 MD

时间:2024-07-31 08:35:02
Markdown版本笔记 我的GitHub首页 我的博客 我的微信 我的邮箱
MyAndroidBlogs baiqiantao baiqiantao bqt20094 baiqiantao@sina.com

Gson Json 序列号 最常用的功能 MD


目录

通过 fromJson 反序列化为对象

普通对象

Person person = gson.fromJson(jsonString, Person.class);
Person person = gson.fromJson(jsonString, new TypeToken<Person>() {}.getType());

数组

String[] array = gson.fromJson(jsonString, String[].class);
String[] array = gson.fromJson(jsonString, new TypeToken<String[]>() {}.getType());
int[][] array = gson.fromJson(jsonString, int[][].class);

集合

List<Person> list = gson.fromJson(jsonString, new TypeToken<List<Person>>() {}.getType());//支持带泛型
Map<String, Integer> map = gson.fromJson(jsonString2, new TypeToken<Map<String, Integer>>() {}.getType());

问题:为何要用 TypeToken 去包装要解析的类型?为何不直接用 List<Person>.class

解疑:因为编译之后,List 和 List 这写类型的字节码文件只一个,那就是 List.class,这是Java泛型使用时要注意的问题:泛型擦除

更优雅的打印一个对象

class Fu {
protected String key = "fu";
}
class A extends Fu {
private static String NAME = "A";
private boolean isBest = true;
private int age = 28;
}
System.out.println(new Gson().toJson(new A())); //{"isBest":true,"age":28,"key":"fu"}

parse 对特殊字符串的解析

关于解析后的数据类型:

System.out.println(new JsonParser().parse("").getClass().getSimpleName());//【JsonNull】,注意不是字符串
" " -> 【JsonNull】,注意不是字符串
"null" -> 【JsonNull】,注意不是字符串 "\"\"" -> 【JsonPrimitive】,是空字符串【】
"\"null\"" -> 【JsonPrimitive】,是字符串【null】
"\"[null]\"" -> 【JsonPrimitive】,是字符串【[null]】 .parse("[]").getAsJsonArray().size();//【0】,长度为0的数组。此数组并不为null,所以解析后不必判空
.parse("[0]").getAsJsonArray().get(0).getClass().getSimpleName();//【JsonPrimitive】,有一个元素的数组
"[null]" -> 【JsonNull】,有一个元素的数组
"[{}]" -> 【JsonObject】,有一个元素的数组

注意,所有的引号、大括号、中括号都必须完整(这是一个合法的json字符串的基本要求),不然都会出现解析异常:

new JsonParser().parse("{");//End of input at line 1 column 2 path $.
new JsonParser().parse("{");//End of input at line 1 column 2 path $[0]
new JsonParser().parse("\"");//Unterminated string at line 1 column 2 path $ new JsonParser().parse("{key}");//Expected ':' at line 1 column 6 path $.key
new JsonParser().parse("1,2");//Use JsonReader.setLenient(true) to accept malformed JSON at line 1 column 3 path $

下面这些是可以的:

new JsonParser().parse("{key:value}");//这样是可以的【{"key":"value"}】,所有的引号都可以去掉
new JsonParser().parse("{key:\"value\"}"));//这样也是可以的【{"key":"value"}】
new JsonParser().parse("[0,null,\"\",{}]");

fromJson 对特殊字符串的处理

通过 Gson.fromJson 方法将一个json字符串解析为对象 AA 时,要求解析结果必须是一个JsonObject,且要求必须保证解析后的每个字段的类型和 AA 中定义的一致:

new Gson().fromJson("[]", AA.class);//Expected BEGIN_OBJECT but was BEGIN_ARRAY at line 1 column 2 path $
System.out.println(new Gson().fromJson("1", AA.class));//Expected BEGIN_OBJECT but was NUMBER at line 1 column 2 path $

但是,其可以将解析后为 JsonNull 的结果转换为 null 而不报异常:

String jString = null;
System.out.println(new Gson().fromJson(jString, AA.class));//null,注意是一个空对象,所以不能对此结果做任何操作,包括getClass
System.out.println(new Gson().fromJson(" ", AA.class));//和上述结果一样为 null

所以,解析时为了防止解析异常,在不确定数据结构的情况下,可以做一些安全性判断:

if (!TextUtils.isEmpty(response) && response.trim().startsWith("{")) {
//为了防止服务器返回数据格式错误导致解析异常
}

为某个字段提供多个属性名

或者说将 json 字符串中的某一字段的值赋给要转化的对象中的某一指定字段。比如,服务器可能通过不同的字段返回给我们错误信息,有的用tips、有的用msg、有的用errorinfo……现在,我们不管服务器用哪种方式返回给我们错误信息,我们都用 message 字段去接收。

@SerializedName(value = "message", alternate = {"tips", "msg","errorinfo","error"})
public String message;

当上面的几个属性中出现任意一个时均可以得到正确的结果,如果多种属性同时出,那么是以最后一个出现的值为准

用 JsonElement 去定义未知类型的字段

可以用Gson框架中的基类 【JsonElement】去定义json数据中不确定具体类型的某些字段。

如下面的 data ,对于不同的网络请求,其内容是完全不一样的,可能是一个JsonObject,也可能是一个JsonArray,也可能是一个String,那么就可以用一个 JsonElement 类型的字段去接收,Gson解析时不会解析具体内容,而是把此字段中的值【原封不动】的返回给你

PS:JsonElement 是 Gson 框架中所有元素的父类,其子类包括 JsonObject、JsonArray、JsonPrimitive、JsonNull。Json字符串中的所有 value 都可以被解析为 JsonElement 的子类。

public class Test {
public static void main(String[] args) {
String content1 = "{\"code\":\"100\",\"data\":{\"errorinfo\":\"成功\"}}";
String content2 = "{\"code\":\"100\",\"data\":\"成功\"}";
String content3 = "{\"code\":\"100\",\"data\":[\"成功\"]}"; System.out.println(new Gson().fromJson(content1, Response.class).data);
System.out.println(new Gson().fromJson(content2, Response.class).data);
System.out.println(new Gson().fromJson(content3, Response.class).data);
} static class Response {
public String code;
public JsonElement data;//用一个JsonElement去接收不想解析的内容
}
}

打印内容为:

{"errorinfo":"成功"}
"成功"
["成功"]
  • 拓展1,如果用 Object 去定义 data,则打印内容为:
{errorinfo=成功}
成功
[成功]

可以看到,两者被解析后的内容是不一样的,用 JsonElement 定义时得到的内容是带有双引号的完整的原始结果,而用 Object 去定义时得到的内容是被Gson框架处理后的结果

  • 拓展2,如果用一个泛型 去定义 data,比如:
static class Response<T> {
public String code;
public T data;
}

测试结果和使用 Object 时完全一致。

  • 拓展3,如果用 一个普通对象 AA 去定义 data,对于 content1,打印内容为:AA@5910e440。对于 content2、content3,直接异常!

解析 Json 字符串中的内容

注意,一定要保证 get 和 getAs* 方法获取的 key 存在且格式兼容,否则会直接崩掉!

String jsonString = "{'flag':true,'data':{'name':'张三','age':18,'address':'广州'}}";
JsonObject root = new JsonParser().parse(jsonString).getAsJsonObject(); boolean flag = root.getAsJsonPrimitive("flag").getAsBoolean();
String name = root.getAsJsonObject("data").get("name").getAsString();
System.out.println(flag + " " + name);//true 张三

格式化 Json 字符串

return new GsonBuilder()
.setPrettyPrinting()
.create()
.toJson(new JsonParser().parse(content));

将序列化后的内容写到 控制台、文件、SB中

gson.toJson(user, System.out); //直接写到控制台。System.out 继承自 PrintStream 实现了Appendable接口

FileWriter fileWriter=new FileWriter("d://a.txt");//将toJson后的字符串拼接到文件中
gson.toJson(person, fileWriter);//FileWriter 继承自 OutputStreamWriter 继承自 Writer 实现了Appendable接口
fileWriter.close(); StringBuilder builder=new StringBuilder();//将toJson后的字符串拼接到StringBuilder中
gson.toJson(person, builder);//StrngBuilder、StringBuffer都是Appendable接口的实现类
System.out.println(builder.toString());

使用 JsonWriter 编写 Json 串

JsonWriter writer = new JsonWriter(new OutputStreamWriter(System.out));//可以先写到文件中,再从文件中读取
writer.beginObject()
.name("name").value("包青天")
.name("sport").beginArray().value("篮球").value("排球").endArray()//数据
.name("info").beginObject().name("age").value(28).endObject()//对象
.endObject();
writer.close(); //{"name":"包青天","sport":["篮球","排球"],"info":{"age":28}}

写到指定位置:

StringWriter stringWriter = new StringWriter();
JsonWriter writer = new JsonWriter(stringWriter);//可以先写到文件中,再从文件中读取
writer.setIndent(" ");//设置缩进格式,一般使用2-4个空格,或使用制表符\t
//...上面的内容
System.out.println(stringWriter.getBuffer().toString());

结果

{
"name": "包青天",
"sport": [
"篮球",
"排球"
],
"info": {
"age": 28
}
}

2018-5-27