java嵌套json怎么解析

Java中嵌套JSON的解析方法与实战技巧

在Java开发中，处理JSON数据已成为一项基本技能，尤其是面对复杂的嵌套JSON结构时，如何高效、准确地解析数据成为许多开发者面临的挑战，本文将详细介绍Java中解析嵌套JSON的多种方法，从传统的库使用到现代的函数式编程方案,帮助开发者不同场景下的最佳实践。

常见的JSON解析库

Java生态中有多种JSON处理库,其中最常用的包括：

Jackson：高性能的JSON处理器，广泛应用于Spring框架
Gson：Google开发的JSON库，简单易用
org.json：轻量级JSON处理库
Fastjson：阿里巴巴开源的高性能JSON库

使用Jackson解析嵌套JSON

Jackson是处理复杂嵌套JSON的首选工具,其强大的数据绑定能力可以轻松应对多层嵌套结构。

基本解析流程

首先添加Jackson依赖：

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

解析简单嵌套JSON

import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
public class JacksonNestedJsonExample {
    public static void main(String[] args) throws Exception {
        String json = "{\"name\":\"张三\",\"age\":30,\"address\":{\"city\":\"北京\",\"district\":\"海淀区\"}}";
        ObjectMapper mapper = new ObjectMapper();
        JsonNode rootNode = mapper.readTree(json);
        // 获取基本字段
        String name = rootNode.get("name").asText();
        int age = rootNode.get("age").asInt();
        // 获取嵌套对象
        JsonNode addressNode = rootNode.get("address");
        String city = addressNode.get("city").asText();
        String district = addressNode.get("district").asText();
        System.out.println("姓名: " + name);
        System.out.println("年龄: " + age);
        System.out.println("地址: " + city + district);
    }
}

使用POJO映射复杂嵌套结构

对于更复杂的嵌套JSON,可以创建对应的Java类进行映射：

// 地址类
public class Address {
    private String city;
    private String district;
    // getters和setters
}
// 用户类
public class User {
    private String name;
    private int age;
    private Address address;
    // getters和setters
}
// 使用示例
public class JacksonPojoExample {
    public static void main(String[] args) throws Exception {
        String json = "{\"name\":\"张三\",\"age\":30,\"address\":{\"city\":\"北京\",\"district\":\"海淀区\"}}";
        ObjectMapper mapper = new ObjectMapper();
        User user = mapper.readValue(json, User.class);
        System.out.println(user.getName());
        System.out.println(user.getAddress().getCity());
    }
}

处理数组嵌套

JSON中经常包含数组嵌套,Jackson可以轻松处理：

String json = "{\"users\":[{\"name\":\"张三\",\"age\":30},{\"name\":\"李四\",\"age\":25}]}";
ObjectMapper mapper = new ObjectMapper();
JsonNode rootNode = mapper.readTree(json);
JsonNode usersNode = rootNode.get("users");
for (JsonNode userNode : usersNode) {
    String name = userNode.get("name").asText();
    int age = userNode.get("age").asInt();
    System.out.println(name + ": " + age);
}

使用Gson解析嵌套JSON

Gson是另一个流行的JSON处理库,其API设计简洁直观。

添加依赖

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

基本解析示例

import com.google.gson.Gson;
import com.google.gson.JsonObject;
import com.google.gson.JsonParser;
public class GsonNestedJsonExample {
    public static void main(String[] args) {
        String json = "{\"name\":\"张三\",\"age\":30,\"address\":{\"city\":\"北京\",\"district\":\"海淀区\"}}";
        JsonParser parser = new JsonParser();
        JsonObject jsonObject = parser.parse(json).getAsJsonObject();
        String name = jsonObject.get("name").getAsString();
        int age = jsonObject.get("age").getAsInt();
        JsonObject addressObj = jsonObject.getAsJsonObject("address");
        String city = addressObj.get("city").getAsString();
        String district = addressObj.get("district").getAsString();
        System.out.println("姓名: " + name);
        System.out.println("年龄: " + age);
        System.out.println("地址: " + city + district);
    }
}

使用POJO映射

Gson gson = new Gson();
User user = gson.fromJson(json, User.class);

处理复杂嵌套场景的技巧

动态解析未知结构

当JSON结构不确定时,可以使用JsonNode或JsonObject动态访问：

// Jackson示例
JsonNode node = mapper.readTree(json);
if (node.has("optionalField")) {
    String value = node.get("optionalField").asText();
    // 处理字段
}
// Gson示例
JsonObject jsonObject = parser.parse(json).getAsJsonObject();
if (jsonObject.has("optionalField")) {
    String value = jsonObject.get("optionalField").getAsString();
    // 处理字段
}

处理多层嵌套数组

String complexJson = "{\"data\":[{\"items\":[{\"id\":1,\"name\":\"项目1\"},{\"id\":2,\"name\":\"项目2\"}]}]}";
ObjectMapper mapper = new ObjectMapper();
JsonNode rootNode = mapper.readTree(complexJson);
JsonNode dataNode = rootNode.get("data");
JsonNode itemsNode = dataNode.get(0).get("items");
for (JsonNode itemNode : itemsNode) {
    int id = itemNode.get("id").asInt();
    String name = itemNode.get("name").asText();
    System.out.println("ID: " + id + ", 名称: " + name);
}

使用TypeReference处理泛型集合

String jsonArray = "[{\"name\":\"张三\"},{\"name\":\"李四\"}]";
ObjectMapper mapper = new ObjectMapper();
List<User> users = mapper.readValue(jsonArray, 
    new TypeReference<List<User>>() {});
// 或者使用Gson
Type listType = new TypeToken<List<User>>() {}.getType();
List<User> users = gson.fromJson(jsonArray, listType);

性能优化与最佳实践

重用ObjectMapper/Gson实例：这些类是线程安全的，可以重用
选择合适的数据结构：对于简单嵌套，使用JsonNode更灵活；对于固定结构，POJO更类型安全
异常处理：添加适当的异常处理，防止JSON解析错误导致程序崩溃
日志记录：记录解析过程中的关键信息，便于调试

try {
    User user = mapper.readValue(json, User.class);
    // 处理数据
} catch (JsonProcessingException e) {
    System.err.println("JSON解析错误: " + e.getMessage());
    // 处理异常
}

Java中解析嵌套JSON有多种方法选择，Jackson和Gson是最常用的两个库,选择哪种方法取决于具体需求：