FastJson常用的API整理

工作的时候一直用到fastjson做JavaBean和Json的转化，最近工作的时候对fastjson的API的理解有点混乱，所以做了整理。

一、对象类型梳理

首先要明确在转换中涉及到的五个类型的对象，分别是：JavaObject、JavaObjectList、JsonString、JsonObject、JsonArray。

二、接口类型的梳理

接口分为序列化接口和非序列化接口，序列化是将Object转为String的过程，反之为反序列化

2.1 序列化接口：

• JSON.toJSONString() // 将java对象、java集合、Json对象转为jsonString
• JSON.toJSON() // 将java对象、java集合转为json对象

从转换结果的类型来看，序列化接口有两种，toJSONString() 是直接转成JSONString，toJSON() 是转Object，这个接口的返回类型是Object，但是实际是JSONObejct或者JSONArray两种

2.2 反序列化接口：

• JSON.parse() // 将jsonString解析为jsonObject或者jsonArray
• JSON.parseObject() // 将jsonString解析为javaObject或者jsonObject
• JSON.parseArray() // 将jsonString解析为javaObjectList或者jsonArray

从解析的结果来看，.parseObject() 能够将jsonString解析为javaObject或者jsonObject，.parseArray() 将jsonString解析为javaObjectList或者jsonArray。其实就是解析为单个对象还是对象列表的区别。那么 .parse() 就是自适应的将jsonString解析为jsonObject或者jsonArray。但是需要注意的是，如果要解析为javaObject或者javaObjectList，.parse() 接口是做不到的

2.3 各类型对象转换关系图

三、 代码示例

首相我们先定义一个用于示例的Person类，这里省略了get()、set()方法和toString()方法

public class PersonDO {
    /**
     * 姓名
     */
    private String name;

    /**
     * 年龄
     */
    private String age;

    /**
     * 职业
     */
    private String job;

    /**
     * 国籍
     */
    private String country;

    /**
     * 身高
     */
    private BigDecimal height;

    /**
     * 体重
     */
    private BigDecimal weight;
}

然后我们来看一下转化的代码

public class Main {
    public static void main(String[] args) {
        // 创建person对象
        PersonDO personDO = PersonDO.builder()
                .name("xiaoMing")
                .age("18")
                .job("student")
                .country("china")
                .weight(new BigDecimal("66.6"))
                .height(new BigDecimal("179.9"))
                .build();
        // 创建personList
        List<PersonDO> personDOList = new ArrayList<>();
        personDOList.add(personDO);
        
        /**
         * 一、序列化接口
         */
        // 1.1 JSON.toJSONString()
        // javaObject || javaObjectList -> JSONString
        String personStr = JSON.toJSONString(personDO);
        String personListStr = JSON.toJSONString(personDOList);

		// 1.2 JSON.toJSON()
        // javaObject -> JSONObject || javaObjectList -> JSONArray
        JSONObject personJsonObj = (JSONObject) JSON.toJSON(personDO);
        JSONArray personJsonArr = (JSONArray) JSON.toJSON(personDOList);
        
        /**
         * 二、 反序列化接口
         */
        // 2.1 JSON.parse()
        // JSONString -> JSONObject || JSONArray
        JSONObject personParseJsonObj = (JSONObject) JSON.parse(personStr);
        JSONArray personParseJsonArr = (JSONArray) JSON.parse(personListStr);
        
        // 2.2 JSON.parseObject()
        // JSONString -> JSONObject || javaObject
        personParseJsonObj = JSON.parseObject(personStr);
        PersonDO parsedPerson = JSON.parseObject(personStr, PersonDO.class);
        
        // 2.3 JSON.parseArray()
        // JSONString -> JSONArray || javaObjectList
        personParseJsonArr = JSON.parseArray(personListStr);
        List<PersonDO> parsedPersonList = JSON.parseArray(personListStr, PersonDO.class);
    }
}