Fastjson的常用API

清疚 2023-10-04 20:22 45阅读 0赞

### 1.FastJson 概述 ###

`Fastjson` 是阿里巴巴提供的一个Java语言编写的高性能功能完善的 `JSON` 库，是目前Java语言中最快的 `JSON` 库，可以实现 `Java` 对象和 `JSON` 字符串的相互转

`Fastjson 源码地址`：https://github.com/alibaba/fastjson

### 2.maven依赖 ###

<dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>fastjson</artifactId>
        <version>2.0.1</version>
    </dependency>

### 3.Fastjson API ###

`JSON`这个类是fastjson API的入口，主要的功能都通过这个类提供，常用的序列化操作都可以在JSON类上的静态方法直接完成。

*  **Fastjson 常用API**

public static final Object parse(String text); // 把JSON文本parse为JSONObject或者JSONArray 
    public static final JSONObject parseObject(String text)； // 把JSON文本parse成JSONObject    
    public static final <T> T parseObject(String text, Class<T> clazz); // 把JSON文本parse为JavaBean 
    public static final JSONArray parseArray(String text); // 把JSON文本parse成JSONArray 
    public static final <T> List<T> parseArray(String text, Class<T> clazz); //把JSON文本parse成JavaBean集合 
    public static final String toJSONString(Object object); // 将JavaBean序列化为JSON文本 
    public static final String toJSONString(Object object, boolean prettyFormat); // 将JavaBean序列化为带格式的JSON文本 
    public static final Object toJSON(Object javaObject); 将JavaBean转换为JSONObject或者JSONArray。

*  **序列化API**

package com.alibaba.fastjson;
    
    public abstract class JSON {
        
        // 将Java对象序列化为JSON字符串，支持各种各种Java基本类型和JavaBean
        public static String toJSONString(Object object, SerializerFeature... features);
    
        // 将Java对象序列化为JSON字符串，返回JSON字符串的utf-8 bytes
        public static byte[] toJSONBytes(Object object, SerializerFeature... features);
    
        // 将Java对象序列化为JSON字符串，写入到Writer中
        public static void writeJSONString(Writer writer, 
                                           Object object, 
                                           SerializerFeature... features);
    
        // 将Java对象序列化为JSON字符串，按UTF-8编码写入到OutputStream中
        public static final int writeJSONString(OutputStream os,
                                                Object object,
                                                SerializerFeature... features);
    }

*  **JSON字符串反序列化API**

package com.alibaba.fastjson;
    
    public abstract class JSON {
        
        // 将JSON字符串反序列化为JavaBean
        public static <T> T parseObject(String jsonStr, 
                                        Class<T> clazz, 
                                        Feature... features);
    
        // 将JSON字符串反序列化为JavaBean
        public static <T> T parseObject(byte[] jsonBytes,  // UTF-8格式的JSON字符串
                                        Class<T> clazz, 
                                        Feature... features);
    
        // 将JSON字符串反序列化为泛型类型的JavaBean
        public static <T> T parseObject(String text, 
                                        TypeReference<T> type, 
                                        Feature... features);
    
        // 将JSON字符串反序列为JSONObject
        public static JSONObject parseObject(String text);
    }

### 4.使用示例 ###

*  **Java对象转JSON**

String jsonStr = JSON.toJSONString(obj);

将 Java 对象转换为 JSON 串，只需要使用 `Fastjson` 提供的 `JSON` 类中的 `toJSONString()` 静态方法即可。

*  **JSON字符串转Java对象**

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

将 json 转换为 Java 对象，只需要使用 `Fastjson` 提供的 `JSON` 类中的 `parseObject()` 静态方法即可。

*  **JSON字符串转JSONObject**

JSONObject jsonObj = JSON.parseObject(jsonStr);

*  **Java对象数组转JSON字符串**

// 构建用户对象数组  
            User[] users = new User[2];  
            users[0] = guestUser;  
            users[1] = rootUser;  
            String jsonString2 = JSON.toJSONString(users);   // 用户对象数组转JSON串

*  **JSON字符串转Java对象列表**

List<User> users2 = JSON.parseArray(jsonString2, User.class);

*  **解析POJO泛型**

Type type = new TypeReference<List<Model>>() {
        }.getType(); 
    List<Model> list = JSON.parseObject(jsonStr, type);

*  **将POJO转换为json字节**

Model model = ...; 
    byte[] jsonBytes = JSON.toJSONBytes(model);

*  **将POJO作为json字符串写入OutputStream**

Model model = ...; 
    OutputStream os;
    JSON.writeJSONString(os, model);

*  **将POJO作为json字符串写入Writer**

Model model = ...; 
    Writer writer = ...;
    JSON.writeJSONString(writer, model);