手机json怎么合并

手机JSON数据合并全攻略：从基础到进阶

在移动开发中,JSON（JavaScript Object Notation）作为轻量级的数据交换格式，几乎无处不在——无论是从服务器获取的接口数据、本地缓存的用户信息，还是多个模块间的数据传递，都离不开JSON的身影，实际开发中常常需要将多个JSON对象或数组合并为一个，比如合并用户基本信息与扩展信息、拼接分页数据，或将不同接口的响应数据整合，本文将结合手机开发场景（Android/iOS），从基础到进阶，详细讲解JSON合并的方法、注意事项及最佳实践。

为什么需要合并JSON数据？手机开发中的常见场景

在手机端开发中,JSON合并的需求主要源于以下几点：

1. 数据整合需求
   用户信息可能分散在多个接口：基本信息（姓名、头像）来自/user/profile，扩展信息（年龄、爱好）来自user/extend，订单列表来自/user/orders，为了在用户详情页统一展示，需要将这些JSON数据合并为一个完整的对象。

2. 本地缓存优化
   为了减少网络请求，手机端常将数据缓存到本地（如Android的SharedPreferences、iOS的UserDefaults或SQLite数据库），当多次缓存的数据需要合并时（如增量更新用户动态），就需要操作JSON对象的合并。

3. 跨模块数据交互
   在大型App中，不同模块（如订单模块、支付模块）可能独立管理JSON数据，当需要联动展示时（如订单详情页合并订单信息与支付状态），就需要将模块间的JSON数据进行合并。

4. 分页数据拼接
   列表数据（如商品列表、消息列表）通常通过分页接口获取，每次返回一页数据，为了展示完整列表，需要将多页的JSON数组逐页合并。

JSON合并的核心概念：对象与数组的区别

JSON数据本质上有两种结构：对象（Object）和数组（Array），合并逻辑也因此不同：

• 对象合并：指将多个JSON对象的键值对合并到一个新对象中，若存在相同键，后合并的会覆盖先前的（“后进先出”原则）。
  示例：合并{"a": 1, "b": 2}和{"b": 3, "c": 4}，结果为{"a": 1, "b": 3, "c": 4}。

• 数组合并：指将多个JSON数组合并为一个新数组，元素按顺序拼接。
  示例：合并[1, 2]和[3, 4]，结果为[1, 2, 3, 4]。

手机开发中,需先明确要合并的是对象还是数组，再选择对应方法。

手机端JSON合并的常用方法（附代码示例）

无论是Android（Java/Kotlin）还是iOS（Swift/OC），都有成熟的JSON处理库，支持高效的合并操作，下面分别介绍两种平台的实现方式。

（一）Android端：使用Gson与JSONObject

Android中最常用的JSON库是Google官方的Gson和轻量级的org.json，两者均支持JSON合并。

使用org.json库（原生API）

org.json提供了JSONObject和JSONArray类，可直接操作JSON对象和数组。

合并JSON对象：
通过put()方法逐个添加键值值，若键已存在则覆盖。

import org.json.JSONObject;
public class JsonMergeUtils {
    public static JSONObject mergeJsonObjects(JSONObject json1, JSONObject json2) throws Exception {
        JSONObject mergedJson = new JSONObject(json1.toString()); // 避免修改原对象
        for (String key : json2.keySet()) {
            mergedJson.put(key, json2.get(key));
        }
        return mergedJson;
    }
    public static void main(String[] args) throws Exception {
        JSONObject json1 = new JSONObject();
        json1.put("name", "张三");
        json1.put("age", 25);
        JSONObject json2 = new JSONObject();
        json2.put("age", 26); // 覆盖json1的age
        json2.put("hobby", "篮球");
        JSONObject merged = mergeJsonObjects(json1, json2);
        System.out.println(merged.toString());
        // 输出：{"name":"张三","age":26,"hobby":"篮球"}
    }
}

合并JSON数组：
通过put()方法将数组的元素逐个添加到新数组。

import org.json.JSONArray;
public class JsonArrayMerge {
    public static JSONArray mergeJsonArrays(JSONArray array1, JSONArray array2) throws Exception {
        JSONArray mergedArray = new JSONArray(array1.toString());
        for (int i = 0; i < array2.length(); i++) {
            mergedArray.put(array2.get(i));
        }
        return mergedArray;
    }
    public static void main(String[] args) throws Exception {
        JSONArray array1 = new JSONArray();
        array1.put("苹果");
        array1.put("香蕉");
        JSONArray array2 = new JSONArray();
        array2.put("橙子");
        array2.put("葡萄");
        JSONArray merged = mergeJsonArrays(array1, array2);
        System.out.println(merged.toString());
        // 输出：["苹果","香蕉","橙子","葡萄"]
    }
}

使用Gson库（更灵活，支持对象映射）

如果JSON数据已映射为Java对象（如User类），Gson可以直接合并对象，再转回JSON。

import com.google.gson.Gson;
import com.google.gson.JsonObject;
public class GsonMergeExample {
    public static String mergeWithGson(String json1Str, String json2Str) {
        Gson gson = new Gson();
        JsonObject json1 = gson.fromJson(json1Str, JsonObject.class);
        JsonObject json2 = gson.fromJson(json2Str, JsonObject.class);
        // 合并json2到json1
        for (String key : json2.keySet()) {
            json1.add(key, json2.get(key));
        }
        return gson.toJson(json1);
    }
    public static void main(String[] args) {
        String json1Str = "{\"name\":\"张三\",\"age\":25}";
        String json2Str = "{\"age\":26,\"hobby\":\"篮球\"}";
        String merged = mergeWithGson(json1Str, json2Str);
        System.out.println(merged);
        // 输出：{"name":"张三","age":26,"hobby":"篮球"}
    }
}

（二）iOS端：使用SwiftJSON与原生JSONSerialization

iOS中常用的JSON处理库是SwiftyJSON（第三方，更易用）和系统自带的JSONSerialization（原生API）。

使用SwiftyJSON（推荐）

通过CocoaPods或Swift Package Manager引入SwiftyJSON后，合并操作非常简洁。

合并JSON对象（Dictionary）：
SwiftyJSON的JSON类型可以直接通过或字典合并操作符实现合并。

import SwiftyJSON
func mergeJsonObjects(json1: JSON, json2: JSON) -> JSON {
    var merged = json1
    for (key, subJson) in json2 {
        merged[key].object = subJson.object // 直接覆盖或添加
    }
    return merged
}
// 示例
let json1: JSON = ["name": "张三", "age": 25]
let json2: JSON = ["age": 26, "hobby": "篮球"]
let merged = mergeJsonObjects(json1: json1, json2: json2)
print(merged)
// 输出：{
//   "age" : 26,
//   "hobby" : "篮球",
//   "name" : "张三"
// }

合并JSON数组（Array）：
通过运算符直接拼接数组。

import SwiftyJSON
func mergeJsonArrays(array1: JSON, array2: JSON) -> JSON {
    let mergedArray = array1.arrayValue + array2.arrayValue
    return JSON(mergedArray)
}
// 示例
let array1: JSON = ["苹果", "香蕉"]
let array2: JSON = ["橙子", "葡萄"]
let mergedArray = mergeJsonArrays(array1: array1, array2: array2)
print(mergedArray)
// 输出：[
//   "苹果",
//   "香蕉",
//   "橙子",
//   "葡萄"
// ]

使用原生JSONSerialization（系统自带）

如果不引入第三方库,可以用系统自带的JSONSerialization，但代码稍显繁琐。

合并JSON对象：
先将JSON字符串转为字典，合并字典后再转回JSON。

import Foundation
func mergeWithJSONSerialization(json1Data: Data, json2Data: Data) -> Data? {
    guard let json1 = try? JSONSerialization.jsonObject(with: json1Data, options: []) as? [String: Any],
          let json2 = try? JSONSerialization.jsonObject(with: json2Data, options: []) as? [String: Any] else