Java中高效解析JSON数组中的嵌套对象数据-java教程-PHP中文网

Java中高效解析JSON数组中的嵌套对象数据

DDD

发布： 2025-11-04 14:00:18

原创

744人浏览过

Java中高效解析JSON数组中的嵌套对象数据

本教程详细介绍了如何在java中解析包含嵌套json对象的json数组，以提取如'id'和'result'等特定字段。文章将演示两种主要方法：传统的循环迭代结合pojo/record，以及利用java stream api进行更简洁的函数式处理，旨在帮助开发者高效、健壮地处理复杂的json响应。

在现代应用开发中，与服务器进行数据交互是常态，而JSON作为一种轻量级的数据交换格式被广泛使用。我们经常会遇到服务器返回的JSON响应中包含嵌套的数组和对象结构，例如：

{"result":[{"result":"success","id":"345"}]}

登录后复制

在这种结构中，我们的目标是从"result"键对应的JSON数组中，提取每个子对象中的"result"和"id"值。直接获取整个JSONArray后，需要进一步处理才能访问到内部的键值对。本教程将介绍两种在Java中实现这一目标的高效方法。

方法一：使用POJO/Record结合循环迭代解析

当JSON结构相对固定时，定义一个对应的Java对象（Plain Old Java Object, POJO）或Java 16+的Record可以极大地提高代码的可读性和类型安全性。我们将JSON中的每个内部对象映射到一个Java Record。

首先，定义一个Record来表示JSON数组中的每个元素：

立即学习“Java免费学习笔记（深入）”；

public record Result(String result, int id) {}

登录后复制

这个Result Record包含了result（字符串类型）和id（整型）两个字段，与JSON子对象中的键值对相对应。

接下来，我们将使用org.json库来解析JSON字符串，并通过循环迭代的方式提取数据：

import org.json.JSONArray;
import org.json.JSONObject;

import java.util.ArrayList;
import java.util.List;

public class JsonParsingExample {

    public record Result(String result, int id) {} // 嵌套Record定义或单独文件

    public static void main(String[] args) {
        String response = """
            {"result":[{"result":"success","id":"345"}]}
        """;

        try {
            // 1. 将整个响应字符串解析为JSONObject
            JSONObject jsonResponse = new JSONObject(response);

            // 2. 获取键为"result"的JSONArray
            JSONArray jsonArray = jsonResponse.getJSONArray("result");

            // 3. 创建一个List来存储解析后的Result对象
            List<Result> results = new ArrayList<>();

            // 4. 遍历JSONArray，解析每个JSONObject
            for (int i = 0; i < jsonArray.length(); i++) {
                // 获取当前索引处的JSONObject
                JSONObject resObject = jsonArray.getJSONObject(i);

                // 从JSONObject中提取"result"和"id"值，并创建Result对象
                // 注意：id在JSON中是字符串"345"，但我们希望解析为int，getJSONArray会自动尝试转换
                results.add(new Result(resObject.getString("result"), resObject.getInt("id")));
            }

            // 打印解析结果
            results.forEach(System.out::println);

        } catch (org.json.JSONException e) {
            System.err.println("JSON解析错误: " + e.getMessage());
        }
    }
}

登录后复制

输出：

即构数智人

即构数智人是由即构科技推出的AI虚拟数字人视频创作平台，支持数字人形象定制、短视频创作、数字人直播等。

查看详情

Result[result=success, id=345]

登录后复制

注意事项：

org.json库提供了getString()和getInt()等方法来安全地获取指定类型的键值。如果键不存在或类型不匹配，这些方法会抛出JSONException。
为了增强健壮性，可以使用optString(key, defaultValue)或optInt(key, defaultValue)等opt系列方法，它们在键不存在时返回默认值，而不是抛出异常。

确保你的项目中已添加org.json库的依赖，例如在Maven中：

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

登录后复制

方法二：使用Java Stream API解析

Java 8引入的Stream API提供了一种更函数式、更简洁的方式来处理集合数据。对于处理JSONArray，我们可以将其转换为一个流，然后利用流操作进行转换。

import org.json.JSONArray;
import org.json.JSONObject;

import java.util.List;
import java.util.stream.StreamSupport; // 注意导入此包

public class JsonStreamParsingExample {

    public record Result(String result, int id) {} // 嵌套Record定义或单独文件

    public static void main(String[] args) {
        String response = """
            {"result":[{"result":"success","id":"345"}]}
        """;

        try {
            JSONObject jsonResponse = new JSONObject(response);
            JSONArray jsonArray = jsonResponse.getJSONArray("result");

            // 使用Stream API解析JSONArray
            List<Result> results = StreamSupport.stream(jsonArray.spliterator(), false) // 1. 将JSONArray转换为Stream<Object>
                .map(JSONObject.class::cast) // 2. 将Stream<Object>转换为Stream<JSONObject>
                .map(jsonObject ->           // 3. 将Stream<JSONObject>映射为Stream<Result>
                    new Result(jsonObject.getString("result"), jsonObject.getInt("id"))
                )
                .toList(); // 4. 将Stream收集为List (Java 16+语法)

            // 对于Java 8-15，可以使用 .collect(Collectors.toList());
            // import java.util.stream.Collectors;
            // List<Result> results = ... .collect(Collectors.toList());

            results.forEach(System.out::println);

        } catch (org.json.JSONException e) {
            System.err.println("JSON解析错误: " + e.getMessage());
        }
    }
}

登录后复制

解析步骤详解：

StreamSupport.stream(jsonArray.spliterator(), false)：JSONArray本身不是Iterable，但它提供了一个spliterator()方法。StreamSupport.stream()工具类可以利用这个Spliterator创建一个Stream<Object>。false表示非并行流。
.map(JSONObject.class::cast)：由于JSONArray中的元素是JSONObject，我们使用map操作将Stream<Object>中的每个元素强制转换为JSONObject，得到Stream<JSONObject>。
.map(jsonObject -> new Result(jsonObject.getString("result"), jsonObject.getInt("id")))：这是核心转换步骤。对于流中的每个JSONObject，我们提取其"result"和"id"字段，并用它们构造一个新的Result对象。
.toList()：这是一个Java 16+的语法糖，用于将流中的所有元素收集到一个新的List中。如果使用旧版本的Java，应使用collect(Collectors.toList())。

优势：