如何在Java中生成混合元素类型的JSON数组（数组.混合.生成.元素.类型...）

wufei123 发布于 2025-09-17 阅读（10）

如何在Java中生成混合元素类型的JSON数组

本教程旨在解决在Java中构建包含混合类型元素（如字符串和JSON对象）的JSON数组的问题。通过利用JSON处理库（如Gson或Jackson）提供的灵活API，开发者可以精确地构造出符合复杂需求的JSON结构，实现字符串和自定义对象在同一数组中的混合序列化。

在java应用程序开发中，我们经常需要处理json数据。虽然将普通java对象（pojo）序列化为json对象或将list<pojo>序列化为json对象数组是常见操作，但有时会遇到更复杂的json结构需求，例如在同一个json数组中混合存储原始字符串和json对象。本文将详细介绍如何使用主流的java json处理库（google gson和jackson databind）来构建这种混合类型的json数组。

理解JSON混合类型数组的需求

假设我们期望生成以下JSON结构：

[
    "Test1",
    {
        "name": "testName",
        "phone": "123456"
    }
]

这个数组包含一个简单的字符串"Test1"和一个包含name和phone字段的JSON对象。直接使用ArrayList<Object>并将其交给标准对象映射器进行序列化，往往无法直接得到这种精确的混合结构，尤其是在添加纯字符串时。为了实现这种精细的控制，我们需要利用JSON库提供的“树模型”（Tree Model）或构建器API。

首先，我们定义一个简单的Java类TestClass来表示JSON中的对象部分：

public class TestClass {
    private String name;
    private String phone;

    // 默认构造函数，对于JSON库进行反序列化时很有用
    public TestClass() {
    }

    public TestClass(String name, String phone) {
        this.name = name;
        this.phone = phone;
    }

    // Getter 方法
    public String getName() {
        return name;
    }

    public String getPhone() {
        return phone;
    }

    // Setter 方法 (可选，但通常推荐提供)
    public void setName(String name) {
        this.name = name;
    }

    public void setPhone(String phone) {
        this.phone = phone;
    }
}
方法一：使用Google Gson库构建混合类型JSON数组

Gson是Google提供的一个强大的Java JSON库，它提供了简洁的API来处理JSON数据。我们可以使用其JsonArray、JsonPrimitive和JsonObject来手动构建复杂的JSON结构。

1. 添加Gson依赖

在您的pom.xml（Maven）或build.gradle（Gradle）中添加Gson依赖：

Maven:

<dependency>
    <groupId>com.google.code.gson</groupId>
    <artifactId>gson</artifactId>
    <version>2.10.1</version> <!-- 请使用最新稳定版本 -->
</dependency>

Gradle:

implementation 'com.google.code.gson:gson:2.10.1' // 请使用最新稳定版本

2. 实现代码

以下代码演示了如何使用Gson构建所需的混合类型JSON数组：

import com.google.gson.Gson;
import com.google.gson.JsonArray;
import com.google.gson.JsonObject;
import com.google.gson.JsonPrimitive;

public class GsonMixedArrayExample {
    public static void main(String[] args) {
        // 1. 实例化需要序列化的Java对象
        TestClass testObject = new TestClass("testName", "123456");

        // 2. 创建一个Gson实例
        Gson gson = new Gson();

        // 3. 使用Gson的JsonTree模型构建JsonArray
        JsonArray jsonArray = new JsonArray();

        // 4. 添加字符串元素
        // 可以直接添加字符串，Gson会自动将其包装为JsonPrimitive
        jsonArray.add("Test1"); 
        // 或者显式地创建JsonPrimitive
        // jsonArray.add(new JsonPrimitive("Test1"));

        // 5. 将TestClass对象转换为JsonObject并添加
        // toJsonTree方法可以将Java对象转换为JsonElement（这里是JsonObject）
        JsonObject testJsonObject = gson.toJsonTree(testObject).getAsJsonObject();
        jsonArray.add(testJsonObject);

        // 6. 将构建好的JsonArray序列化为JSON字符串
        String jsonOutput = gson.toJson(jsonArray);
        System.out.println(jsonOutput);
    }
}

输出示例：

["Test1",{"name":"testName","phone":"123456"}]

（Gson默认输出为紧凑格式，可以通过GsonBuilder配置美化输出。）

Post AI Post AI

博客文章AI生成器

Post AI50 查看详情 Post AI 方法二：使用Jackson Databind库构建混合类型JSON数组

Jackson是Java生态系统中最流行和功能最丰富的JSON处理库之一，尤其在Spring框架中被广泛使用。它也提供了强大的树模型API来构建复杂的JSON结构。

1. 添加Jackson依赖

在您的pom.xml（Maven）或build.gradle（Gradle）中添加Jackson Databind依赖：

Maven:

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.15.2</version> <!-- 请使用最新稳定版本 -->
</dependency>

Gradle:

implementation 'com.fasterxml.jackson.core:jackson-databind:2.15.2' // 请使用最新稳定版本

2. 实现代码

以下代码演示了如何使用Jackson构建所需的混合类型JSON数组：

import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.node.ArrayNode;
import com.fasterxml.jackson.databind.node.ObjectNode;

public class JacksonMixedArrayExample {
    public static void main(String[] args) throws Exception {
        // 1. 实例化需要序列化的Java对象
        TestClass testObject = new TestClass("testName", "123456");

        // 2. 创建一个ObjectMapper实例
        ObjectMapper mapper = new ObjectMapper();

        // 3. 使用Jackson的Tree模型构建ArrayNode
        ArrayNode arrayNode = mapper.createArrayNode();

        // 4. 添加字符串元素
        // 可以直接添加字符串，Jackson会自动将其包装为TextNode
        arrayNode.add("Test1"); 
        // 或者显式地创建TextNode
        // arrayNode.add(mapper.getNodeFactory().textNode("Test1"));

        // 5. 将TestClass对象转换为ObjectNode并添加
        // valueToTree方法可以将Java对象转换为JsonNode（这里是ObjectNode）
        JsonNode objectNode = mapper.valueToTree(testObject);
        arrayNode.add(objectNode);

        // 6. 将构建好的ArrayNode序列化为JSON字符串
        // writerWithDefaultPrettyPrinter() 用于美化输出，使其更易读
        String jsonOutput = mapper.writerWithDefaultPrettyPrinter().writeValueAsString(arrayNode);
        System.out.println(jsonOutput);
    }
}

输出示例：

[
  "Test1",
  {
    "name": "testName",
    "phone": "123456"
  }
]

（Jackson writerWithDefaultPrettyPrinter() 默认会美化输出。）

关键考虑与最佳实践
  1. 树模型与数据绑定：
    • 数据绑定 (Data Binding): 适用于简单的POJO到JSON的映射，代码简洁，但对于混合类型或非结构化的JSON，灵活性不足。
    • 树模型 (Tree Model): 提供了更细粒度的控制，允许开发者手动构建JSON结构，非常适合处理复杂、动态或混合类型的JSON数据。本教程中使用的JsonArray/ArrayNode就是树模型的体现。
  2. 选择合适的库： Gson和Jackson都是优秀的JSON库。Jackson在企业级应用和Spring Boot项目中更为常见，功能更全面。Gson则以其简洁的API和良好的性能受到青睐。根据项目现有依赖和团队偏好选择即可。
  3. 可读性与维护性： 尽管树模型提供了极大的灵活性，但过度使用手动构建JSON可能会降低代码的可读性和维护性。在可能的情况下，优先使用数据绑定。只有当数据绑定无法满足需求时，才转向树模型。
  4. 错误处理： 在实际应用中，JSON序列化/反序列化操作应妥善处理可能抛出的异常（如JsonProcessingException），确保程序的健壮性。
总结

在Java中生成包含混合类型元素（如字符串和JSON对象）的JSON数组，需要借助JSON处理库（如Gson或Jackson）提供的树模型API。通过JsonArray/ArrayNode等构建器，我们可以精确地控制JSON数组中每个元素的类型和内容，无论是原始数据类型还是复杂的Java对象。掌握这些技巧，将使您能够更灵活地处理各种复杂的JSON数据构建需求。

以上就是如何在Java中生成混合元素类型的JSON数组的详细内容，更多请关注知识资源分享宝库其它相关文章！

相关标签： java js json node go app ai json处理 java应用程序 json数组 spring框架 Java spring spring boot json maven 数据类型 Object xml 字符串 对象 gradle 低代码 大家都在看： Java中Collections.sort方法的原理 Java中对象克隆的核心概念和使用方法 如何在Java中实现对象的封装 Java基本运算符使用技巧和注意事项 Java中访问控制符的本质和作用

标签:  数组 混合 生成 

相关阅读

发表评论:

◎欢迎参与讨论，请在这里发表您的看法、交流您的观点。

最近发表

标签列表