fastjson 常用 API 整理：JSON 解析、序列化與代碼示例

fastjson 常用 API 整理

fastjson 是阿里巴巴開源的高性能 JSON 庫，廣泛應用於 Java 項目中。本文系統梳理其核心 API，幫助開發者快速掌握 JSON 字符串與 Java 對象的雙向轉換。

一、JSON 字符串解析為對象

1. 解析為 JSONObject / JSONArray（無實體類場景）

• Object parse(String text)：通用解析入口，自動判斷返回 JSONObject 或 JSONArray。
• JSONObject parseObject(String text)：直接解析為 JSONObject。
• JSONArray parseArray(String text)：直接解析為 JSONArray。

優勢：當項目中缺乏對應的 Model 類時，可直接通過鍵名獲取數據，靈活便捷。

2. 解析為 Java Bean / List<Bean>（有實體類場景）

• T parseObject(String text, Class<T> clazz)：單個 Bean 對象解析。
• List<T> parseArray(String text, Class<T> clazz)：多個 Bean 對象解析生成列表。

優勢：擁有 Model 類時，直接映射為強類型對象，便於後續業務邏輯操作。

二、Java 對象序列化為 JSON

1. Bean 對象轉 JSON 字符串

• String toJSONString(Object object)：標準輸出。
• String toJSONString(Object object, boolean prettyFormat)：prettyFormat=true 時輸出格式化（帶縮進）的 JSON，適合調試。

2. Java 對象轉 JSONObject / JSONArray

• Object toJSON(Object javaObject)：萬能轉換，單個 Bean、List、Map 均可處理。轉換後調用 toString() 即得 JSON 字符串。

三、代碼示例

完整示例代碼可下載附件參考，涵蓋上述所有 API 的典型調用姿勢。