Java 遞迴解析任意層級 JSON 字串通用工具類

前言

處理動態 JSON 結構是後端開發常見需求：第三方 API 回傳欄位不固定、配置檔結構多變、或需將 JSON 統一轉為 Map/List 供通用邏輯處理。傳統做法需針對每種結構寫死對應的 POJO，維護成本高。本文介紹一套基於 org.json 與正則表達式的遞迴解析器，能自動處理任意層級的 JSONObject 與 JSONArray，輸出巢狀的 Map<String, Object>、List<Object> 或基本型別。

核心設計思路

策略模式擴充解析類型

定義 RegexPolicy 列舉，預留擴充點（如 HTML 圖片擷取、Email 提取）：

public enum RegexPolicy {
    Json("Json"),
    Image("ImageFromHtml");

    private final String value;
    RegexPolicy(String value) { this.value = value; }
    @Override public String toString() { return value; }
}

遞迴下降解析演算法

regexJson() 為核心遞迴函式，流程如下：

1. 型別判斷：嘗試建構 JSONObject 或 JSONArray，失敗則視為純量值直接回傳。
2. 物件解析：使用正則 "([^\" ]+?):" 擷取所有鍵名，配合 JSONObject.opt() 取值，對值遞迴呼叫 regexJson()。
3. 陣列解析：逐項遍歷 JSONArray，每個元素遞迴解析後加入 List<Object>。
4. 正則游標修正：遇到巢狀陣列時，根據字串長度調整 Matcher.region() 避免重複匹配。

關鍵程式碼解析

進入點：統一解析介面

public static Object regex(final RegexPolicy policy, final String data) {
    switch (policy) {
        case Json: return regexJson(data);
        case Image: break; // 預留擴充
        default: break;
    }
    return null;
}

遞迴核心：regexJson()

private static Object regexJson(final String jsonStr) {
    if (jsonStr == null) throw new NullPointerException("JsonString shouldn't be null");
    try {
        if (isJsonObject(jsonStr)) {
            // 解析 JSONObject -> Map
            final Pattern pattern = Pattern.compile(REGULAR_JSON_ITEM_NAME);
            final Matcher matcher = pattern.matcher(jsonStr);
            final Map map = new HashMap<>();
            final JSONObject jsonObject = new JSONObject(jsonStr);

            for (; matcher.find(); ) {
                String key = matcher.group(1);
                Object value = jsonObject.opt(key);
                // 跳過巢狀陣列字串長度，避免正則重複匹配內部鍵名
                if (value != null && isJsonArray(value.toString())) {
                    matcher.region(matcher.end() + value.toString().replace("\\", "").length(), matcher.regionEnd());
                }
                if (value != null && !map.containsKey(key)) {
                    map.put(key, regexJson(value.toString()));
                }
            }
            return map;
        } else if (isJsonArray(jsonStr)) {
            // 解析 JSONArray -> List