在Java开发中,拼接JSON字符串是一项常见任务，尤其在处理API交互、数据序列化等场景时，由于JSON格式要求严格，手动拼接时需注意语法正确性和数据安全性，以下是几种常用的JSON字符串拼接方法，涵盖从基础到进阶的实现方式，并分析其适用场景与注意事项。
手动字符串拼接
手动拼接是最直接的方式,通过字符串连接操作符（如+）或StringBuilder逐个拼接JSON字段，这种方法简单直观，适用于结构固定、字段较少的JSON对象。
String name = "Alice";
int age = 25;
String json = "{\"name\":\"" + name + "\",\"age\":" + age + "}";
优点：无需额外依赖，代码直观易懂。
缺点：当JSON结构复杂或包含特殊字符（如双引号、换行符）时，容易出现语法错误；且频繁拼接字符串会影响性能，建议使用StringBuilder优化：
StringBuilder sb = new StringBuilder();
sb.append("{").append("\"name\":\"").append(name).append("\",")
.append("\"age\":").append(age).append("}");
String json = sb.toString();
使用JSON库
为避免手动拼接的繁琐和错误,推荐使用成熟的JSON库，如Gson、Jackson或org.json，这些库提供了API自动处理转义字符、数据类型转换等问题，提升开发效率和代码健壮性。
使用Gson
Gson是Google开源的JSON处理库,通过JsonObject和JsonArray类构建JSON：
import com.google.gson.JsonObject;
JsonObject json = new JsonObject();
json.addProperty("name", "Alice");
json.addProperty("age", 25);
String jsonString = json.toString();
使用Jackson
Jackson是高性能的JSON库,其ObjectMapper类支持灵活的JSON操作：
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.node.ObjectNode;
ObjectMapper mapper = new ObjectMapper();
ObjectNode json = mapper.createObjectNode();
json.put("name", "Alice");
json.put("age", 25);
String jsonString = mapper.writeValueAsString(json);
使用org.json
org.json是轻量级库，适合简单场景：
import org.json.JSONObject;
JSONObject json = new JSONObject();
json.put("name", "Alice");
json.put("age", 25);
String jsonString = json.toString();
优点：自动处理转义字符、数据类型验证；支持嵌套JSON和数组；代码更简洁易维护。
缺点：需引入第三方依赖，但Maven/Gradle管理依赖后影响可忽略。
动态拼接JSON数组
当需要拼接JSON数组时,可通过库的API动态添加元素，例如使用Gson构建数组：
import com.google.gson.JsonArray;
import com.google.gson.JsonObject;
JsonArray array = new JsonArray();
for (int i = 0; i < 3; i++) {
JsonObject item = new JsonObject();
item.addProperty("id", i);
item.addProperty("value", "Item" + i);
array.add(item);
}
String jsonArrayString = array.toString();
注意事项
- 特殊字符处理：库会自动处理双引号、反斜线等特殊字符，避免JSON语法错误。
- 数据类型匹配：确保Java数据类型与JSON类型对应（如Java的Date需格式化为字符串）。
- 性能考虑：对于高频操作，Jackson等库的性能优势明显；低频简单场景可手动拼接。
- 异常处理：使用库时需捕获可能的异常（如JsonSyntaxException）。
Java拼接JSON字符串的方法需根据场景选择：简单结构可手动拼接，复杂场景推荐使用Gson、Jackson等库，手动拼接需注意语法和性能，而库能显著提升开发效率和代码质量，无论哪种方式，都应确保最终JSON格式符合规范，避免因转义或类型问题导致解析失败，通过合理选择工具和方法，可以高效、安全地完成JSON字符串的拼接任务。
