1. 引言：JSON数据整合的挑战
在现代应用开发中，处理和整合来自不同源的JSON数据是一项常见任务。例如，您可能有两个或多个JSONArray，它们包含相关联但分散的信息，并且这些信息通过一个共同的标识符（如“id”）连接。您的目标是将这些分散的数据聚合起来，形成一个包含所有相关属性的单一JSONArray。
考虑以下场景： 您有一个用户基本信息列表：
[{"name": "John", "id": "1"}, {"name": "Adam", "id": "2"}]以及一个用户详细属性列表：
[{"color": "red", "id": "1", "country": "Poland"}, {"color": "green", "id": "2", "country": "Germany"}, {"color": "red", "id": "3", "country": "England"}]您的期望是根据共同的“id”字段，将它们合并成如下结构：
[{"color": "red", "name": "John", "country": "Poland"}, {"color": "green", "name": "Adam", "country": "Germany"}]注意，最终结果中排除了“id”字段，并且只包含了在两个原始数组中都有匹配id的对象。
立即学习“Java免费学习笔记（深入）”；
2. 核心思路与数据结构选择
为了实现上述合并逻辑，我们需要一种机制来：
- 快速查找： 根据“id”高效地定位已合并的对象。
- 聚合数据： 将来自不同JSONObject的键值对合并到同一个对象中。
- 去重与过滤： 确保每个id只对应一个合并后的对象，并过滤掉不匹配或不需要的字段。
HashMap
3. 实现步骤与代码示例
本教程将使用org.json库来处理JSON对象和数组。
3.1 准备输入数据
首先，定义我们的两个原始JSONArray：
import org.json.JSONArray;
import org.json.JSONObject;
import java.util.HashMap;
import java.util.Map;
import java.util.ArrayList;
import java.util.List;
public class JsonArrayMerger {
public static void main(String[] args) {
// 第一个JSONArray：用户基本信息
String jsonString1 = "[{\"name\": \"John\", \"id\": \"1\"}, {\"name\": \"Adam\", \"id\": \"2\"}]";
JSONArray jsonArray1 = new JSONArray(jsonString1);
// 第二个JSONArray：用户详细属性
String jsonString2 = "[{\"color\": \"red\", \"id\": \"1\", \"country\": \"Poland\"}, {\"color\": \"green\", \"id\": \"2\", \"country\": \"Germany\"}, {\"color\": \"red\", \"id\": \"3\", \"country\": \"England\"}]";
JSONArray jsonArray2 = new JSONArray(jsonString2);
// 将所有待合并的JSONArray放入一个列表中
List arraysToMerge = new ArrayList<>();
arraysToMerge.add(jsonArray1);
arraysToMerge.add(jsonArray2);
// 调用合并方法
JSONArray mergedResult = mergeJsonArraysById(arraysToMerge, "id");
System.out.println("合并后的JSONArray:\n" + mergedResult.toString(2));
}
/**
* 根据共享ID合并多个JSONArray中的JSONObject。
*
* @param arraysToMerge 包含待合并JSONArray的列表。
* @param idKey 用于匹配和作为HashMap键的ID字段名称。
* @return 合并后的JSONArray，其中每个JSONObject都包含了所有匹配ID的键值对，且不包含ID字段。
*/
public static JSONArray mergeJsonArraysById(List arraysToMerge, String idKey) {
// 使用HashMap存储已合并的对象，键为ID，值为合并后的JSONObject
Map mergedObjectsMap = new HashMap<>();
// 遍历所有待合并的JSONArray
for (JSONArray currentArray : arraysToMerge) {
// 遍历当前JSONArray中的每一个JSONObject
for (int i = 0; i < currentArray.length(); i++) {
JSONObject currentObj = currentArray.optJSONObject(i); // 使用optJSONObject避免空指针异常
if (currentObj != null) {
String id = currentObj.optString(idKey); // 获取ID字段的值
// 只有当ID存在且非空时才进行处理
if (id != null && !id.isEmpty()) {
// 使用computeIfAbsent方法：
// 如果map中不存在该ID对应的JSONObject，则创建一个新的JSONObject作为基础对象。
// 注意：在创建新对象时，我们将从currentObj中移除ID字段，
// 因为最终结果中我们不希望包含ID。
JSONObject existingObj = mergedObjectsMap.computeIfAbsent(id, k -> {
// 创建一个新的JSONObject作为该ID的合并基础，并复制当前对象（不包含ID）
JSONObject baseObj = new JSONObject();
for (String key : currentObj.keySet()) {
if (!key.equals(idKey)) {
baseObj.put(key, currentObj.get(key));
}
}
return baseObj;
});
// 将当前JSONObject中的所有键值对（除了ID字段）添加到existingObj中
// 如果存在同名键，新值将覆盖旧值。
for (String key : currentObj.keySet()) {
if (!key.equals(idKey)) { // 排除ID字段
existingObj.put(key, currentObj.get(key));
}
}
}
}
}
}
// 将HashMap中的所有合并后的JSONObject值收集到一个新的JSONArray中
return new JSONArray(mergedObjectsMap.values());
}
} 3.2 代码解析
-
Map
mergedObjectsMap = new HashMap(); - 这是核心的数据结构，用于存储中间结果。键是字符串类型的id，值是JSONObject，代表了该id下所有合并后的属性。
-
for (JSONArray currentArray : arraysToMerge)
- 外层循环遍历所有传入的JSONArray列表。
-
for (int i = 0; i
- 内层循环遍历当前JSONArray中的每一个JSONObject。
-
JSONObject currentObj = currentArray.optJSONObject(i);
- 安全地获取JSONObject，optJSONObject在索引无效时返回null，避免JSONException。
-
String id = currentObj.optString(idKey);
- 获取当前JSONObject的id值。optString在键不存在时返回空字符串，确保健壮性。
-
mergedObjectsMap.computeIfAbsent(id, k -> { ... });
- 这是Java 8+ HashMap的一个强大方法。
- 如果mergedObjectsMap中已经存在以id为键的JSONObject，则直接返回该JSONObject。
- 如果不存在，则会执行k -> { ... }中的Lambda表达式来创建一个新的JSONObject，并将其与id关联后存入map，然后返回这个新创建的JSONObject。
- 关键点： 在Lambda表达式内部，我们创建了一个新的JSONObject (baseObj)，并复制了currentObj中除了idKey之外的所有键值对到baseObj中。这样做的目的是确保当一个id首次被处理时，它的初始合并对象不包含id字段。
- 这是Java 8+ HashMap的一个强大方法。
-
for (String key : currentObj.keySet()) { if (!key.equals(idKey)) { existingObj.put(key, currentObj.get(key)); } }
- 这部分逻辑负责将currentObj中的所有键值对（除了idKey）添加到existingObj（即map中对应id的合并对象）中。
- 如果existingObj中已经存在同名的键，put操作会直接覆盖旧值。
-
return new JSONArray(mergedObjectsMap.values());
- 最后，将HashMap中所有合并后的JSONObject（即map.values()）收集起来，构造一个新的JSONArray并返回。
4. 注意事项与扩展
-
键值覆盖策略： 当前实现中，如果多个JSONObject（即使来自不同的原始JSONArray）包含相同的键（除了id），那么后处理的JSONObject中的值会覆盖先处理的值。例如，如果jsonArray1中有{"id": "1", "value": "A"}，jsonArray2中有{"id": "1", "value": "B"}，最终合并结果将是{"value": "B"}。
- 扩展： 如果您需要更复杂的合并策略（例如，将所有同名键的值收集到一个数组中，或者基于特定规则选择值），您需要在existingObj.put(key, currentObj.get(key))这一步添加额外的逻辑。
ID字段的排除： 示例代码明确地将id字段从最终的合并JSONObject中移除。这是通过在computeIfAbsent的Lambda表达式中构建baseObj时排除idKey，以及在后续的键值对复制循环中也排除idKey来实现的。如果希望保留id字段，只需移除相关的if (!key.equals(idKey))条件即可。
性能考量： 对于大规模的JSONArray合并，HashMap的查找效率（平均O(1)）使其成为一个高效的选择。总时间复杂度大致为O(N*M)，其中N是JSONArray的数量，M是每个JSONArray中JSONObject的数量。
空值和缺失字段： optJSONObject和optString方法提供了对缺失字段的健壮处理，它们会在字段不存在时返回null或空字符串，而不是抛出异常。
其他JSON库： 虽然本教程使用了org.json库，但类似的逻辑也可以应用于其他流行的JSON处理库，如Jackson或Gson。这些库通常提供更丰富的功能和更强的类型安全性。
5. 总结
通过利用HashMap作为中间存储和聚合工具，我们能够高效且灵活地合并多个JSONArray中的JSONObject，实现基于共享标识符的数据整合。这种模式在处理来自不同数据源的关联信息时非常有用，能够帮助您构建结构清晰、易于消费的JSON数据。理解其核心逻辑和注意事项，将使您在处理复杂JSON数据整合任务时更加得心应手。
