Fastjson

Fastjson 是一个阿里巴巴公司开源的 Java 语言编写的高性能功能完善的 JSON 库。它采用一种“假定有序快速匹配”的算法，把 JSON Parse 的性能提升到极致，是目前 Java 语言中最快的 JSON 库，并且它不依赖于其它任何库。

01. 基本用法

fastjson 提供了 JSON.parseObject() 和 JSON.toJSONString 两个直接用于解析和生成的方法。前者实现了反序列化，后者实现了序列化。

public class User {
    public String name;
    public int age;
    public String emailAddress;

    // 省略 getter/setter
}

生成 JSON 格式字符串：<small>（Object to JSON-String）</small>

User user = new User("怪盗kidou",24);

String jsonStr = JSON.toJSONString(user);

解析 JSON 格式字符串：<small>（JSON-String to Object）</small>

注意，需要 User 类有无参的构造方法。

String jsonString = "{\"name\":\"怪盗kidou\",\"age\":24}";

User user = JSON.parseObject(jsonString, User.class);

02. JSONObject

在 Java 中，一个 Map<String, Object> 对象可以等价描述一个 JavaBean。Map 中的每个键值对，对应 JavaBean 中的一个属性。键为属性名，值为属性值。

JSONObject 就是 fastjson 专门提供的一个用于这样的使用场景的 Map：

public class JSONObject extends ... implements Map<String, Object>, ... {
  ...
}

fastJson 提供了 JSON.parseObject() 将 JSON 格式字符串转换成一个JSONObject 对象（本质上，就是转换成一个Map）。

String jsonString = "{\"name\":\"怪盗kidou\",\"age\":24}";

JSONObject map = JSON.parseObject(jsonString);

String val1 = map.getString("name");
int val2 = map.getIntValue("age");

对于不同类型的各种属性，JSONObject 提供了不同的 getXXX() 方法与之对应。

03. @JSONField 注解：name 属性

默认/一般情况下，JSON 字段中的名字和类的属性名是一致的。但是也有不一致的情况，因为本身驼峰命名法（如 Java）和下划线命名法（如 C）本身就是两大命名规则“流派”。

对类的属性使用 @JSONField 注解（及其 name 属性），可以重新指定与该属性对应的 JSON 字符串中的名字。

@JSONField(name="email_address")
public String emailAddress

你甚至可以重新命名为另一个看起来毫不相关的名字：

@JSONField(name="xxx")
public String emailAddress;

String jsonString = "{\"name\":\"怪盗kidou\",\"age\":24, \"email_address\":\"123456@qq.com\"}";
User user = JSON.parseObject(jsonString, User.class);

04. 数组、集合的序列化和反序列化

数组的序列化很简单，与普通对象类似;

User[] arr = new User[3];
arr[0] = new User("tom", 20, "123@qq.com");
arr[1] = new User("jerry", 19, "456@qq.com");
arr[2] = new User("ben", 21, null);

String jsonStr = JSON.toJSONString(arr);

数组的反序列化，有几种方案，其中一种方案与普通对象的反序列化类似，，唯一需要注意的就是填写正确的数组类型：

User[] arr = JSON.parseObject(jsonStr, User[].class);

for (User user : arr)
            System.out.println(user);

鉴于 List 与 数组 有极大地相似性，另一种反序列化数组形式的JSON 字符串的方案是，将其反序列化为对象的链表：

List<User> list = JSON.parseArray(jsonStr, User.class);

for (User user : list)
    System.out.println(user);

05. JSONArray

反序列化数组形式的 JSON 格式字符串的第三种方案是利用 fastJson 提供的 JSONArray 。

public class JSONArray extends ... implements List<Object>, ... {
  ...
}

从其定义看，JSONArray 本质上也就是一个 List，所以这种方案本质上和之前的第二种方案没太大区别。

只不过它不需要在最开始提供所要转换的类型，而是通过各种 getXXX() 方法在获取值数据时进行转换。

JSONArray arr2 = JSON.parseArray(jsonStr);

for (int i = 0; i < arr2.size(); i++) {
    System.out.println(arr2.getObject(i, User.class));
}

06. 泛型 和 RESETfull API

泛型的引入可以减少无关的代码，这在 resetful api 返回数据时反映得更为清楚，通常 resetful api 接口返回的 JSON 数据为：

{"status":0,"msg":'...',"data":{...}},
{"status":0,"msg":'...',"data":[...]},

status 表示响应状态码，msg 表示状态码配套的信息，而 data 才是最核心的部分：响应的数据。一般而言，它要么表示返回一个对象，要么表示返回一个对象的集合<small>（数组或 List）</small>。

在这里会把这个结果对象定义成泛型类：

public class Result<T> {
    public int code;
    public String message;
    public T data;
}

否则，data 的类型无穷无尽，你就需要为每一种情况定义一种 Result 类。

那么对于 data 字段，当 T 是 User 时则可以写为 Result<User>，当是个列表的时候为 Result<List<User>>，其它类型同理（Result<XXX> 和 Result<List<XXX>>）。

对此，Json 字符串转对象时，代码自然就类似如下：

JSONArray list = JSON.parseArray(jsonStr);

for (int i = 0; i < list.size(); i++) {
    Result<User> result = list.getObject(i, Result.class);
    System.out.println(result);
}

07. @JSONField 注解：serialzeFeatures 属性

在将一个对象转换成 JSON 格式字符串时，fastJson 会自动忽略掉其中值为 null 的属性，及不包含在 JSON 格式为字符串中。

User user = new User();
user.setName("tom");
System.out.println(JSON.toJSONString(user));  // {"name":"tom"}

有时你需要以更完善的形式来表达出这个对象中的所有属性，即便其值为 null 。

为此，fastJson 通过 @JSONField 注解的 serialzeFeatures 属性值进行设置：

@JSONField(serialzeFeatures={SerializerFeature.WriteNullNumberAsZero})
private Integer age;

@JSONField(serialzeFeatures={SerializerFeature.WriteMapNullValue})
private String emailAddress;

@JSONField(serialzeFeatures={SerializerFeature.WriteNullStringAsEmpty})
private List<String> list;

User user = new User();
user.setName("tom");
System.out.println(JSON.toJSONString(user));
// {"age":0,"emailAddress":null,"list":null,"name":"tom"}

08. @JSONField 注解：format 属性

当所需要序列化和反序列化的对象的属性有 Date 类型时，这里就涉及到 Date 类型的字符串形式的格式问题，为此 @JSONField 注解提供了 format 属性用以自定义其字符串格式：

@JSONField(format="yyyy-MM-dd")
private Date birthDate;

09. 循环引用

fastJson 自动识别循环混用的问题，并将其替换成 $ref 形式。而是不是 StackOverflowError 异常。

$ref：.. 上一级

$ref：@ 当前对象，也就是自引用

$ref：$ 根对象

$ref：$.children.0 基于路径的引用，相当于 root.getChildren().get(0)

如果百分百肯定所要序列化的对象不存在循环引用问题，可以在序列化时关闭该检测功能（默认是开启的）。

JSON.toJSONString(object, SerializerFeature.DisableCircularReferenceDetect);

10. @JSONField 注解：serialize 属性

标注了 @JSONField(serialize=false) 的属性在序列化成JSON格式字符串的过程中，会被 fastJSON 忽略。无论其是否有值。

11. 后记：Fastjson 快的代价

知乎上有一篇对 fastJson 的论题，各方相关、不相关人士<small>（包括 fastJson 开发作者）</small>都积极参与讨论，其中高票回答中写道：

fastjson 之所以没在国际上流行起来，最主要的原因应该是开发者的思路全放到“快”上去了，而偏离了“标准”及功能性，质量也不够好，有点“舍本逐末”的味道。... fastjson 就是一个代码质量较差的国产类库，用很多投机取巧的的做法去实现所谓的“快”，而失去了原本应该兼容的 java 特性，对 json 标准遵循也不严格，自然很难在国际上流行。

另外，有人指出，在 JDK 8 以前，JDK 对字符串相关的各种类的方法的底层实现没有进行充分的优化。一般的 JSON 库都是直接使用 JDK 中的字符串相关类和方法，而 fastJSON 则是通过各种【黑科技】绕过这些【慢】的方法采用自己的办法，从而提升速度。而 JDK 8 的版本中官方开始逐步优化这些字符串底层方法，从而导致在 JDK 8 的环境中，fastJSON 快的不那么【明显】。

简而言之，是否看重 fastJSON 的这种【快】，因人而异。

另外，最近 fastJSON 爆出安全漏洞问题，1.2.67 以下版本有安全隐患。