如何将json转成map集合

如何将JSON转成Map集合：从基础到实践的全面指南

在Java开发中,JSON（JavaScript Object Notation）作为一种轻量级的数据交换格式，广泛应用于前后端数据交互、配置文件存储等场景，而Map集合（如HashMap、LinkedHashMap）则是Java中用于存储键值对的核心数据结构，常用于动态数据处理、缓存等场景，将JSON转换为Map集合，是处理动态数据、灵活操作键值对的重要技能，本文将从基础概念出发，结合具体代码示例，详细讲解如何将JSON转换为Map集合，涵盖原生Java、第三方库（如Gson、Jackson）等不同实现方式，并总结最佳实践。

JSON与Map集合的基础关联

在开始转换之前,我们需要明确JSON与Map集合的底层对应关系：

JSON对象：由键值对组成，键是字符串类型，值可以是字符串、数字、布尔值、数组、嵌套JSON对象等。

{
  "name": "张三",
  "age": 25,
  "isStudent": false,
  "courses": ["数学", "英语"],
  "address": {
    "city": "北京",
    "district": "海淀区"
  }
}

Map集合：核心是键（Key）-值（Value）对，键必须是唯一且不可变（如String），值可以是任意Java对象（包括List、Map等嵌套结构）。

两者的天然对应关系为：JSON的键 → Map的Key，JSON的值 → Map的Value，上述JSON对象可转换为Map<String, Object>，

"name" → "张三"（String）
"age" → 25（Integer）
"isStudent" → false（Boolean）
"courses" → ["数学", "英语"]（List
"address" → {"city": "北京", "district": "海淀区"}（Map<String, String>）

使用原生Java实现JSON转Map（不推荐，但需了解）

如果项目中不引入第三方库,可以通过Java内置的javax.json（Java EE）或org.json（第三方但轻量）库实现转换，这里以org.json（需手动添加依赖）为例，说明原生实现方式：

添加依赖（Maven）

<dependency>
    <groupId>org.json</groupId>
    <artifactId>json</artifactId>
    <version>20231013</version>
</dependency>

代码示例

import org.json.JSONObject;
import java.util.HashMap;
import java.util.Map;
public class JsonToMapNative {
    public static void main(String[] args) {
        String jsonStr = "{\"name\":\"张三\",\"age\":25,\"isStudent\":false,\"courses\":[\"数学\",\"英语\"],\"address\":{\"city\":\"北京\",\"district\":\"海淀区\"}}";
        // 1. 将JSON字符串转为JSONObject
        JSONObject jsonObject = new JSONObject(jsonStr);
        // 2. 初始化Map集合
        Map<String, Object> resultMap = new HashMap<>();
        // 3. 遍历JSONObject的键，将键值对存入Map
        for (String key : jsonObject.keySet()) {
            Object value = jsonObject.get(key);
            // 处理嵌套JSON对象（递归转换为Map）
            if (value instanceof JSONObject) {
                value = convertJsonToMap((JSONObject) value);
            }
            // 处理JSON数组（此处简单转为List，实际可根据需求处理）
            else if (value instanceof org.json.JSONArray) {
                // JSONArray转List示例（略，需额外处理）
            }
            resultMap.put(key, value);
        }
        // 4. 输出结果
        System.out.println("转换后的Map: " + resultMap);
    }
    // 递归处理嵌套JSON对象
    private static Map<String, Object> convertJsonToMap(JSONObject jsonObject) {
        Map<String, Object> map = new HashMap<>();
        for (String key : jsonObject.keySet()) {
            Object value = jsonObject.get(key);
            if (value instanceof JSONObject) {
                value = convertJsonToMap((JSONObject) value);
            }
            map.put(key, value);
        }
        return map;
    }
}

优缺点分析

优点：无需额外依赖（若使用org.json，依赖极小）。
缺点：
- 代码冗余,需手动处理嵌套对象、数组等复杂结构；
- org.json不是JDK内置，仍需引入第三方库；
- 类型转换麻烦（如需区分Integer、String等需额外判断）。

使用Gson库实现JSON转Map（推荐）

Gson是Google开发的JSON处理库,以其简洁的API和强大的类型支持著称，是Java中处理JSON的首选工具之一。

添加依赖（Maven）

<dependency>
    <groupId>com.google.code.gson</groupId>
    <artifactId>gson</artifactId>
    <version>2.10.1</version>
</dependency>

核心API

Gson提供了JsonParser和Gson类，

JsonParser.parseString(jsonStr)：将JSON字符串解析为JsonElement；
JsonElement.getAsJsonObject()：将JsonElement转为JsonObject（对应JSON对象）；
Gson.fromJson(jsonStr, new TypeToken<Map<String, Object>>(){}.getType())：直接通过泛型类型将JSON转为Map（推荐方式）。

代码示例

通过`TypeToken`直接转换（推荐）

import com.google.gson.Gson;
import com.google.gson.reflect.TypeToken;
import java.util.Map;
public class JsonToMapGson {
    public static void main(String[] args) {
        String jsonStr = "{\"name\":\"张三\",\"age\":25,\"isStudent\":false,\"courses\":[\"数学\",\"英语\"],\"address\":{\"city\":\"北京\",\"district\":\"海淀区\"}}";
        // 1. 创建Gson实例
        Gson gson = new Gson();
        // 2. 使用TypeToken指定Map类型，避免类型擦除
        Map<String, Object> resultMap = gson.fromJson(jsonStr, new TypeToken<Map<String, Object>>(){}.getType());
        // 3. 输出结果
        System.out.println("转换后的Map: " + resultMap);
        // 输出嵌套Map：address={city=北京, district=海淀区}
    }
}

通过`JsonParser`逐层解析（适合复杂嵌套）

import com.google.gson.JsonElement;
import com.google.gson.JsonObject;
import com.google.gson.JsonParser;
import java.util.HashMap;
import java.util.Map;
public class JsonToMapGsonParser {
    public static void main(String[] args) {
        String jsonStr = "{\"name\":\"张三\",\"age\":25,\"address\":{\"city\":\"北京\"}}";
        // 1. 解析JSON字符串为JsonElement
        JsonElement jsonElement = JsonParser.parseString(jsonStr);
        // 2. 转为JsonObject
        JsonObject jsonObject = jsonElement.getAsJsonObject();
        // 3. 初始化Map并遍历
        Map<String, Object> resultMap = new HashMap<>();
        for (String key : jsonObject.keySet()) {
            JsonElement valueElement = jsonObject.get(key);
            if (valueElement.isJsonObject()) {
                // 递归处理嵌套对象
                resultMap.put(key, convertJsonObjectToMap(valueElement.getAsJsonObject()));
            } else {
                // 直接获取值（自动转换为对应Java类型）
                resultMap.put(key, valueElement.getAsString());
            }
        }
        System.out.println("转换后的Map: " + resultMap);
    }
    private static Map<String, Object> convertJsonObjectToMap(JsonObject jsonObject) {
        Map<String, Object> map = new HashMap<>();
        for (String key : jsonObject.keySet()) {
            JsonElement value = jsonObject.get(key);
            if (value.isJsonObject()) {
                map.put(key, convertJsonObjectToMap(value.getAsJsonObject()));
            } else {
                map.put(key, value.getAsString());
            }
        }
        return map;
    }
}

优缺点分析

优点：
- API简洁,一行代码即可完成转换（方式一）；
- 自动处理类型转换（如JSON数字自动转为Integer/Long，布尔值转为Boolean）；
- 支持复杂嵌套结构（通过TypeToken或递归处理）。
缺点：
需引入Gson依赖（但项目通常已集成）。

使用Jackson库实现JSON转Map（推荐）

Jackson是另一个广泛使用的JSON处理库,以其高性能和丰富的功能闻名，是Spring Boot等框架的默认JSON工具。

添加依赖（Maven）

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.15.2</version>
</dependency>
``

正文

如何将json转成map集合