快捷導(dǎo)航

Java解析JSON的六種方案

更新時間：2025年01月02日 11:09:14 作者：蘇三說技術(shù)

這篇文章介紹了 6 種 JSON 解析方案,包括 Jackson、Gson、FastJSON、JsonPath、、手動解析,分別闡述了它們的功能特點(diǎn)、代碼示例、高級功能、優(yōu)缺點(diǎn)及適用場景,感興趣的小伙伴跟著小編一起來看看吧

前言

在 Java 開發(fā)中，解析 JSON 是一個非常常見的需求。

不管是和前端交互、調(diào)用第三方接口，還是處理配置文件，幾乎都繞不開 JSON。

這篇文章總結(jié)了6種主流的 JSON 解析方法，希望對你會有所幫助。

1. 使用 Jackson：業(yè)界標(biāo)配

功能特點(diǎn)

強(qiáng)大的序列化和反序列化：支持將 JSON 字符串轉(zhuǎn)為 Java 對象，也支持將 Java 對象轉(zhuǎn)換為 JSON。
支持復(fù)雜結(jié)構(gòu)：處理嵌套對象、數(shù)組、泛型等場景非常輕松。
支持注解：如 @JsonIgnore、@JsonProperty 等，能精細(xì)控制序列化與反序列化的行為。
性能高：Jackson 的性能非常出色，是很多企業(yè)級項目的首選。

代碼示例

1. JSON 轉(zhuǎn)對象（反序列化）

import com.fasterxml.jackson.databind.ObjectMapper;

public class JacksonExample {
    public static void main(String[] args) throws Exception {
        String json = "{"id":1,"name":"張三"}";

        ObjectMapper objectMapper = new ObjectMapper();
        User user = objectMapper.readValue(json, User.class);
        System.out.println(user.getName()); // 輸出：張三
    }
}

class User {
    private int id;
    private String name;

    // Getters 和 Setters 省略
}

2. 對象轉(zhuǎn) JSON（序列化）

User user = new User();
user.setId(1);
user.setName("李四");

ObjectMapper objectMapper = new ObjectMapper();
String json = objectMapper.writeValueAsString(user);
System.out.println(json); // 輸出：{"id":1,"name":"李四"}

高級功能

日期格式化：@JsonFormat(pattern = "yyyy-MM-dd")
忽略字段：@JsonIgnore
重命名字段：@JsonProperty("custom_name")

優(yōu)缺點(diǎn)

優(yōu)點(diǎn)	缺點(diǎn)
功能全面，支持復(fù)雜場景	配置較多，學(xué)習(xí)成本稍高
性能高，社區(qū)活躍，企業(yè)級項目首選	過于強(qiáng)大，部分功能用不上
豐富的注解支持，便于控制序列化行為	庫體積較大，對于小型項目略顯笨重

2. 使用 Gson：輕量好用

功能特點(diǎn)

輕量級：Gson 的設(shè)計非常簡潔，代碼量少，適合中小型項目。
支持泛型：可以輕松解析帶泛型的 JSON。
注解控制：支持通過注解控制序列化行為，如 @Expose。
易擴(kuò)展：通過自定義序列化器和反序列化器，可以處理復(fù)雜的場景。

代碼示例

1. JSON 轉(zhuǎn)對象

import com.google.gson.Gson;

public class GsonExample {
    public static void main(String[] args) {
        String json = "{"id":1,"name":"王五"}";

        Gson gson = new Gson();
        User user = gson.fromJson(json, User.class);
        System.out.println(user.getName()); // 輸出：王五
    }
}

2. 對象轉(zhuǎn) JSON

User user = new User();
user.setId(2);
user.setName("趙六");

Gson gson = new Gson();
String json = gson.toJson(user);
System.out.println(json); // 輸出：{"id":2,"name":"趙六"}

高級功能

忽略字段：@Expose

@Expose
private String name;

自定義序列化器/反序列化器：

Gson gson = new GsonBuilder()
        .registerTypeAdapter(CustomClass.class, new CustomSerializer())
        .create();

優(yōu)缺點(diǎn)

優(yōu)點(diǎn)	缺點(diǎn)
輕量級，簡單易用，適合中小型項目	性能稍遜于 Jackson
學(xué)習(xí)曲線平滑，新手容易上手	功能不如 Jackson 豐富
提供良好的擴(kuò)展能力	復(fù)雜對象處理起來較為麻煩

3. 使用 FastJSON：高性能

功能特點(diǎn)

性能優(yōu)異：FastJSON 的解析速度非?？?，適合大數(shù)據(jù)量場景。
支持動態(tài)字段：可以輕松處理動態(tài) JSON 數(shù)據(jù)。
強(qiáng)大的類型支持：支持嵌套對象、泛型、數(shù)組等復(fù)雜結(jié)構(gòu)。
注解控制：類似 Jackson 和 Gson，支持注解控制字段的序列化和反序列化。

代碼示例

1. JSON 轉(zhuǎn)對象

import com.alibaba.fastjson.JSON;

public class FastJsonExample {
    public static void main(String[] args) {
        String json = "{"id":1,"name":"小明"}";

        User user = JSON.parseObject(json, User.class);
        System.out.println(user.getName()); // 輸出：小明
    }
}

2. 對象轉(zhuǎn) JSON

User user = new User();
user.setId(3);
user.setName("小紅");

String json = JSON.toJSONString(user);
System.out.println(json); // 輸出：{"id":3,"name":"小紅"}

高級功能

自動駝峰轉(zhuǎn)下劃線：

JSON.DEFFAULT_DATE_FORMAT = "yyyy-MM-dd HH:mm:ss";

動態(tài)字段解析：

Map<String, Object> map = JSON.parseObject(json, Map.class);

優(yōu)缺點(diǎn)

優(yōu)點(diǎn)	缺點(diǎn)
性能極高，解析速度快	曾有歷史安全漏洞的爭議
支持復(fù)雜的動態(tài)字段解析	社區(qū)活躍度稍遜于 Jackson 和 Gson
功能全面，適合大規(guī)模數(shù)據(jù)處理場景	配置選項和 API 比較多，稍顯復(fù)雜

4. 使用 JsonPath：快速提取嵌套字段

功能特點(diǎn)

高效字段提取：通過路徑表達(dá)式（類似 XPath）快速提取嵌套字段。
靈活性強(qiáng)：支持動態(tài)字段和條件過濾。
輕量級：專注于字段提取，功能簡單明確。

代碼示例

import com.jayway.jsonpath.JsonPath;

public class JsonPathExample {
    public static void main(String[] args) {
        String json = """
            {
                "store": {
                    "book": [
                        {"title": "書1", "price": 10},
                        {"title": "書2", "price": 20}
                    ]
                }
            }
        """;

        // 提取第一個書籍的標(biāo)題
        String title = JsonPath.read(json, "$.store.book[0].title");
        System.out.println(title); // 輸出：書1

        // 提取所有書籍價格
        List<Integer> prices = JsonPath.read(json, "$.store.book[*].price");
        System.out.println(prices); // 輸出：[10, 20]
    }
}

優(yōu)缺點(diǎn)

優(yōu)點(diǎn)	缺點(diǎn)
字段提取簡潔高效	不支持序列化和反序列化
動態(tài)字段處理能力強(qiáng)	依賴 JsonPath 語法
適合快速提取嵌套字段	不適合全量 JSON 轉(zhuǎn)換

5. 使用 org.json：輕量工具類

功能特點(diǎn)

輕量級：核心是一個工具類，適合簡單場景。
構(gòu)造和解析簡單：適合快速創(chuàng)建 JSON 或提取字段。
靈活性一般：不支持復(fù)雜對象映射。

代碼示例

import org.json.JSONObject;

public class OrgJsonExample {
    public static void main(String[] args) {
        String json = "{"id":1,"name":"張三"}";

        // 提取字段
        JSONObject jsonObject = new JSONObject(json);
        System.out.println(jsonObject.getString("name")); // 輸出：張三

        // 構(gòu)造 JSON
        JSONObject newJson = new JSONObject();
        newJson.put("id", 2);
        newJson.put("name", "李四");
        System.out.println(newJson.toString()); // 輸出：{"id":2,"name":"李四"}
    }
}

優(yōu)缺點(diǎn)

優(yōu)點(diǎn)	缺點(diǎn)
輕量級，適合簡單場景	不支持復(fù)雜嵌套對象
使用簡單，學(xué)習(xí)成本低	功能簡單，擴(kuò)展性差

6. 手動解析 JSON：靈活度最高

功能特點(diǎn)

完全自由：不依賴第三方庫，自己解析 JSON。
動態(tài)處理：適合不規(guī)則字段結(jié)構(gòu)的 JSON。
代碼復(fù)雜度高：適合特殊場景。

代碼示例

import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;

import java.util.Map;

public class ManualParsing {
    public static void main(String[] args) throws Exception {
        String json = "{"id":1,"name":"動態(tài)字段"}";

        ObjectMapper objectMapper = new ObjectMapper();
        Map<String, Object> map = objectMapper.readValue(json, new TypeReference<Map<String, Object>>() {});
        System.out.println(map.get("name")); // 輸出：動態(tài)字段
    }
}

優(yōu)缺點(diǎn)

優(yōu)點(diǎn)	缺點(diǎn)
靈活性高，適合動態(tài)字段	代碼復(fù)雜度高，不易維護(hù)
不依賴第三方庫	性能和效率低于專業(yè) JSON 庫

總結(jié)

最后給大家對比一下文章中提到的6種方法各自的優(yōu)缺點(diǎn)：

方法	適用場景	優(yōu)點(diǎn)	缺點(diǎn)
Jackson	企業(yè)級項目，復(fù)雜序列化和反序列化場景	功能強(qiáng)大，性能優(yōu)異，支持復(fù)雜結(jié)構(gòu)	配置復(fù)雜，學(xué)習(xí)曲線高
Gson	中小型項目，簡單的 JSON 轉(zhuǎn)換場景	輕量級，簡單易用	功能有限，性能略遜
FastJSON	高性能需求，大數(shù)據(jù)量的動態(tài)解析	性能極高，功能豐富	曾有安全漏洞爭議，社區(qū)支持稍遜 Jackson
JsonPath	嵌套結(jié)構(gòu)復(fù)雜、動態(tài)字段提取場景	字段提取語法簡單，靈活性強(qiáng)	不支持序列化和反序列化
org.json	快速解析或構(gòu)造 JSON 場景	輕量級，適合簡單場景	功能單一，擴(kuò)展性差
手動解析	動態(tài) JSON 或字段不固定的場景	自由度高，靈活性強(qiáng)	代碼復(fù)雜，效率低于專業(yè)工具