一、常用json解析库比较及选择
1.简介
fastjson和gson是目前比较常用的json解析库，并且现在我们项目代码中，也在使用这两个解析库。
fastjson 是由阿里开发的，号称是处理json效率最高的框架。而gson 是由google开发的，是功能比较全面的json解析工具。
2.比较
下面根据体积、性能、调用方式、文档完备程度等几个方面，来比较一下这两个库。
2.1 包体积
都使用当前最新版本的jar包，fastjson-1.1.56.android.jar 为209.7kb，gson-2.8.0.jar 为232kb。
两者体积相差不大，都很小。
2.2 性能
因为fastjson号称是效率最高的框架，这部分网上有很多人讨论，看了一些关于性能比较的帖子
自己也写了简单的程序，使用最新版本的两个库测试。
测试方法为定义一个简单的类 Example，并生成List<Example> 实例，分别使用两个类库执行 object => string 和 string => object 操作 10 次，计算消耗时间(毫秒)。
| 100 | 641 | 551 | 1.16 |
| 200 | 1191 | 970 | 1.23 |
| 300 | 1786 | 1445 | 1.235 |
| 400 | 2393 | 1911 | 1.25 |
| 500 | 3038 | 2550 | 1.19 |
| 1000 | 6054 | 5062 | 1.195 |
| 2000 | 12647 | 11044 | 1.145 |
| 3000 | 22488 | 17923 | 1.25 |
| 4000 | 30385 | 24178 | 1.26 |
考虑到移动端的实际使用场景，没有继续再测试更大数据量的耗时，上述时间也与设备性能和数据结构的复杂性有关。根据上述数据来看，确实fastjson比gson快了20%左右。
2.3 调用方式
只比较最简单的由object=>string 和 string=>object 的操作，两者都非常简便
2.4 文档完备程度
相对来说，fastjson的文档很少，从github上，能找到一篇 简单的示例代码 和一篇 常见问题解答 。没有比较全面的使用指南。
而gson的文档就丰富的多了，包括 api , 使用指南 , 以及第三方写的使用指南的链接 Gson Tutorial ， Gson Tutorial Series 等。
2.5 流行程度
gson远比fastjson流行，使用的人群更多。无论是在google上搜索fastjson/gson关键词，还是在*上搜索两者相关的提问，两者都存在数量级上的差距。
3.结论
通过两者比较，虽然在性能上fastjson比gson更优，但在我们具体的业务场景下，一般只会涉及到小数据量的解析操作，gson并不会比fastjson额外耗费太多的解析时间。
另外，从文档完备程度和解析库的流行程度来说，gson文档相对更完善，对开发人员比较友好。另外更广泛的使用人群，也方便开发人员更容易解决或规避使用中会出现的问题。
再有，个人感觉fastjson的一些特性相对gson来说，并不是太好，比如 对所有的getter方法对应的属性，都做处理 , 忽略大小写 。 以及在编写demo时感觉，fastjson相对gson来说，对代码有更多要求，相对来说感觉gson更傻瓜一些。
二、相关文档及使用方式
当前使用gson的最新版源码，版本为2.8.0，根据 CHANGELOG 中描述，在2.5版本时，将最小支持JDK版本升为 1.6。
代码路径：http://athena.devops.letv.com/#/admin/projects/ui/apps/LeGson
jar包：LeGson-v1.0.0.jar
gson github：https://github.com/google/gson
增加了 LeGson 类，对 gson 做了简单的封装
- 使用单例的方式保存了一个 gson 对象，省去了调用方创建 gson 对象的操作。
- catch 住调用 gson 时可能产生的json解析异常，以 warn log 的形式打印出来， TAG 为 LeGson，并返回 null
目前 LeGson 封装了下面方法，后续如果有需要会继续添加。
toJson
封装 gson 方法
public String toJson(Object src)
|
调用示例
String str = LeGson.toJson(user); |
fromJson
封装 gson 方法
public <T> T fromJson(String json, Type typeOfT)
|
调用示例
String jsonArray = "[\"test1\",\"test2\",\"test3\"]";
List<String> stringList = LeGson.fromJson(jsonArray, new TypeToken<List<String>>() {}.getType());
|
封装 gson 方法
public <T> T fromJson(String json, Class<T> classOfT)
|
调用示例
User user = LeGson.fromJson(str, User.class);
|
我们会将编好的gson jar包放在项目 /vendor/letv/frameworks/base/3rd_jars 目录下，可通过如下方式引用
在Android.mk文件中添加
LOCAL_JAVA_LIBRARIES := gsonjar |
在AndroidManifest.xml文件中添加
AndroidManifest.xml
<application android:name="xxx"
android:icon="@drawable/ic_app"
android:label="@string/app_name"
android:theme="@style/Feedback.Theme.Holo.Letv">
<uses-library android:name="gsonjar"/>
<activity android:name=".Activity"
android:theme="@style/Feedback.Theme.Holo.Letv" />
|
三、调用示例
1. 基本用法
gson提供了 fromJson() 和 toJson() 两个直接用于解析和生成的方法，前者实现反序列化，后者实现了序列化。
基本数据类型
Gson gson = new Gson();
String jsonNumber = gson.toJson(100); // 100
String jsonBoolean = gson.toJson(false); // false
String jsonString = gson.toJson("String"); // "String"
|
POJO类的生成与解析
public class User {
public int id;
public String name;
} |
生成Json：
Gson gson = new Gson();
User user = new User(123, "test-name");
String jsonStr = gson.toJson(user); |
解析Json：
Gson gson = new Gson();
String str = "{\"name\":\"test_name\", \"id\":234}";
User user = gson.fromJson(str, User.class);
|
2.属性重命名 @SerializedName 注解的使用
当期望的json格式为
{"name":"test_name", "id":234}
|
而实际的格式为
{"user_name":"test_name", "user_id":234}
|
可对 User 类中相关属性添加@serializedName注解
public class User {
@SerializedName("user_id")
public int id;
@SerializedName("user_name")
public String name;
} |
这样的话，可以在保留前后端命名习惯的前提下完成数据解析。
如果要兼容多种不同的命名方式，比如:
{"user_name":"test_name", "user_id":234}
{"custom_name":"test_name", "custom_id":234}
{"student_name":"test_name", "student_id":234}
|
可使用@SerializedName注解的 alternate 属性，传入数组参数
@SerializedName(value = "user_id", alternate = {"student_id", "custom_id"})
public int id;
|
当指定的三个属性中任意一个出现时，都可以得到正确的结果。
当多种情况同时出现时，保留最后一个出现的值
String str = "{\"student_name\":\"test_name\", \"custom_id\":234, \"user_name\":\"user-name\"}";
User tmp = gson.fromJson(str, User.class); // name = "user-name"
|
3.解析成数组或列表
String str = "[\"test-1\",\"test-2\",\"test-3\",\"test-4\",\"test-5\"]";
String[] strs = gson.fromJson(str, String[].class);
List<String> strList = gson.fromJson(str, new TypeToken<List<String>>() {}.getType());
|
或使用上面定义的User类型为例：
List<User> userList = gson.fromJson(jsonstr, new TypeToken<List<User>>() {}.getType());
|
4. 更多详细功能介绍
上面只是列出了gson比较基本的功能，其实gson对于json的解析处理是非常的灵活的，大家可查看更多gson的使用方式，来适应实际工作中的各种解析场景。
下面列出一些介绍的文章：