在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结构。
立即学习“Java免费学习笔记（深入）”；
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配置美化输出。）
方法二：使用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() 默认会美化输出。）
关键考虑与最佳实践
-
树模型与数据绑定：
- 数据绑定 (Data Binding): 适用于简单的POJO到JSON的映射，代码简洁，但对于混合类型或非结构化的JSON，灵活性不足。
- 树模型 (Tree Model): 提供了更细粒度的控制，允许开发者手动构建JSON结构，非常适合处理复杂、动态或混合类型的JSON数据。本教程中使用的JsonArray/ArrayNode就是树模型的体现。
- 选择合适的库： Gson和Jackson都是优秀的JSON库。Jackson在企业级应用和Spring Boot项目中更为常见，功能更全面。Gson则以其简洁的API和良好的性能受到青睐。根据项目现有依赖和团队偏好选择即可。
- 可读性与维护性： 尽管树模型提供了极大的灵活性，但过度使用手动构建JSON可能会降低代码的可读性和维护性。在可能的情况下，优先使用数据绑定。只有当数据绑定无法满足需求时，才转向树模型。
- 错误处理： 在实际应用中，JSON序列化/反序列化操作应妥善处理可能抛出的异常（如JsonProcessingException），确保程序的健壮性。
总结
在Java中生成包含混合类型元素（如字符串和JSON对象）的JSON数组，需要借助JSON处理库（如Gson或Jackson）提供的树模型API。通过JsonArray/ArrayNode等构建器，我们可以精确地控制JSON数组中每个元素的类型和内容，无论是原始数据类型还是复杂的Java对象。掌握这些技巧，将使您能够更灵活地处理各种复杂的JSON数据构建需求。
