在现代Web开发与后端服务构建中,java 字符串转json字符串已成为一项基础且高频的操作需求。JSON(JavaScript Object Notation)作为一种轻量级数据交换格式,因其结构清晰、易于解析、跨语言兼容等优势,广泛应用于RESTful API、配置文件、数据缓存等场景。而Java作为企业级应用开发的主流语言,其对JSON的支持生态日趋成熟。
本文将系统性地梳理java 字符串转json字符串的核心技术路径,涵盖从基础概念到高阶技巧的全链条知识体系,结合真实项目案例,深入解析Gson、Jackson、Fastjson三大主流库的实现机制、性能差异与适用边界,帮助开发者规避常见陷阱,提升开发效率与系统健壮性。
尤其值得强调的是,字符串转JSON并非简单的“字符串拼接”或“replace操作”——若处理不当,极易引发注入攻击、格式错误、编码异常等问题。例如,未对特殊字符(如引号、换行符、反斜杠)进行转义,会导致生成的JSON非法;若直接拼接用户输入内容,还可能造成安全漏洞。因此,正确、规范地实现java 字符串转json字符串,是保障系统安全与稳定的关键一环。
本文内容严格遵循Java 8及以上版本规范,覆盖JDK标准库与主流三方库,并针对多线程环境、大文本处理、性能优化等实际问题提供解决方案。全文超过3000字,内容详实、示例丰富、逻辑清晰,适合Java初级至高级开发者系统性学习。
在Java中,将字符串转换为JSON字符串(即JSON序列化)通常有三种路径:手动构建、使用标准库(如org.json)、依赖成熟三方库。每种方式均有其适用场景,需结合项目需求权衡选择。
对极简单的JSON结构(如单层键值对),开发者可能尝试手动拼接字符串实现java 字符串转json字符串:
String name = "张三";
int age = 28;
String json = "{"name":" + "\"" + name + "\"" + ",\"age\":" + age + "}";
⚠️ 此方式存在严重缺陷:
因此,**不推荐在任何生产环境中使用手动拼接方式实现java 字符串转json字符串**。
org.json是Java早期广泛使用的JSON处理库,API简洁,适合中小型项目。其核心类包括:
JSONObject:表示JSON对象JSONArray:表示JSON数组JSONStringer:用于流式构建JSON字符串示例:将字符串转为JSON对象并序列化
import org.json.JSONObject;
String name = "李四";
int age = 30;
JSONObject obj = new JSONObject();
obj.put("name", name);
obj.put("age", age);
String jsonString = obj.toString(); // 输出:{"name":"李四","age":30}
✅ 优点:无需依赖复杂配置,API直观;支持自动转义特殊字符。
⚠️ 注意:org.json对null值的处理为直接忽略(非`"value":null`),且不支持泛型反序列化,灵活性有限。
主流三方库通过注解、反射、字节码增强等技术,提供高度可配置的序列化能力,是企业级项目的首选。
以下对比Gson、Jackson、Fastjson在java 字符串转json字符串场景下的核心特性:
轻量、易用,API设计简洁。支持复杂对象、泛型、匿名类序列化。
示例:对象转JSON字符串
Gson gson = new Gson();
User user = new User("王五", 25);
String json = gson.toJson(user);
支持自定义序列化器与反序列化器,适合需要精细控制输出格式的场景。
功能最强大、性能优异,Spring Boot默认集成。支持树模型(JsonNode)、数据绑定、流式API三种模式。
数据绑定示例:
ObjectMapper mapper = new ObjectMapper();
User user = new User("赵六", 22);
String json = mapper.writeValueAsString(user);
支持注解(如`@JsonProperty`、`@JsonInclude`)灵活控制序列化行为。
高性能(尤其在JDK 8下),支持大量特性如循环引用处理、TypeReference泛型解析。
示例:字符串转JSON对象再转回字符串
String input = "{\"name\":\"孙七\",\"age\":24}";
JSONObject obj = JSON.parseObject(input);
String output = obj.toJSONString();
⚠️ 注意:曾曝出多个高危漏洞(如远程代码执行),需严格使用>=1.2.80版本。
在java 字符串转json字符串过程中,用户输入常含特殊字符(如换行、制表符、Unicode控制字符),Gson可通过`GsonBuilder`配置转义规则:
Gson gson = new GsonBuilder()
.disableHtmlEscaping() // 默认会转义HTML字符如& < >
.serializeNulls() // 序列化null值字段
.setPrettyPrinting() // 美化输出(用于调试)
.create();
当`serializeNulls()`启用时,`{"name":"测试", "desc":null}`将保留null字段,而非省略。
Jackson通过`ObjectMapper`提供精细控制:
writeValuesAsString():直接输出字符串(避免中间文件)configure(JsonGenerator.Feature.ESCAPE_NON_ASCII, true):转义非ASCII字符(如中文)registerModule(new JavaTimeModule()):支持LocalDateTime等新时间API示例:处理时间字段
ObjectMapper mapper = new ObjectMapper();
mapper.registerModule(new JavaTimeModule());
mapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);
User user = new User();
user.setCreatedAt(LocalDateTime.now());
String json = mapper.writeValueAsString(user);
输出:`{"createdAt":"2024-07-15T14:30:22"}`而非时间戳。
Fastjson在java 字符串转json字符串时存在以下常见问题:
安全建议:禁用`autoType`支持,避免反序列化攻击:
JSON.parseObject(jsonStr, Object.class, Feature.AutoTypeSupport, false);
当用户输入含双引号(如`"name": "张三"李四"`)时,直接拼接会破坏结构:
// 错误示例
String userInput = "张三\"李四";
String json = "{\"name\":\"" + userInput + "\"}";
// 结果:{"name":"张三"李四"} → 非法JSON!
正确做法:使用库自动转义:
Gson gson = new Gson();
Map data = new HashMap<>();
data.put("name", userInput);
String json = gson.toJson(data); // 自动转义为 {"name":"张三\"李四"}
当对象字段为null时,若未配置序列化策略:
// Gson默认忽略null字段
Gson gson = new Gson();
User user = new User(null, 20);
String json = gson.toJson(user); // 输出:{"age":20} → name字段丢失
解决方案:启用`serializeNulls()`,或使用`@JsonInclude(Include.NON_NULL)`注解。
在HTTP响应中直接输出JSON字符串,若未指定UTF-8编码,浏览器可能显示乱码:
// 错误:响应头未指定charset
response.getWriter().write(jsonString);
正确方式:
response.setContentType("application/json;charset=UTF-8");
response.setCharacterEncoding("UTF-8");
response.getWriter().write(jsonString);
Jackson默认将`Date`序列化为时间戳,与前端期望的`"2024-07-15"`不符:
// 问题:{"date":1721032222000}
ObjectMapper mapper = new ObjectMapper();
String json = mapper.writeValueAsString(user);
修复方案:
示例:高效批量序列化
Gson gson = new Gson(); // 全局单例
List users = ...;
String json = gson.toJson(users); // 一次性转换,非循环调用
安全反序列化示例
// Fastjson:指定目标类型
User user = JSON.parseObject(jsonStr, User.class);
// Jackson:使用TypeReference限定
TypeReference typeRef = new TypeReference(){};
User user = mapper.readValue(jsonStr, typeRef);
美化输出示例
// Gson
Gson prettyGson = new GsonBuilder().setPrettyPrinting().create();
String prettyJson = prettyGson.toJson(data);
// Jackson
ObjectMapper mapper = new ObjectMapper();
String prettyJson = mapper.writerWithDefaultPrettyPrinter().writeValueAsString(data);
| 特性 | Gson | Jackson | Fastjson |
|---|---|---|---|
| 学习曲线 | 低,API直观 | 中,功能丰富但配置复杂 | 低,但需注意安全细节 |
| 性能(序列化) | 中等 | 高(尤其JDK 8+) | 极高(官方基准测试最快) |
| 循环引用支持 | 需手动禁用 | 自动处理 | 默认处理,可配置 |
| 泛型支持 | 优秀(TypeToken) | 优秀(TypeReference) | 优秀(TypeReference) |
| 安全漏洞历史 | 极少 | 极少 | 较多(需严格版本控制) |
| 默认null处理 | 忽略 | 忽略 | 忽略 |
| Spring Boot集成 | 需手动配置 | 默认集成 | 需排除默认库 |
A:标准JSON要求键名与字符串值必须用双引号。Gson/Jackson无法直接解析单引号JSON,需先转换为标准格式:
String invalidJson = "{'a':1,'b':2}";
String validJson = invalidJson.replace("'", "\"");
Gson gson = new Gson();
JsonObject obj = gson.fromJson(validJson, JsonObject.class);
java 字符串转json字符串时保留字段顺序?A:使用`LinkedHashMap`而非`HashMap`存储数据,或启用Fastjson的`SortField`特性:
// Fastjson
JSON.toJSONString(map, SerializerFeature.SortField);
A:这是双重转义问题。当字符串本身含`\"`(如用户输入),再经JSON库转义时会叠加反斜杠。解决方案:
A:使用泛型类型引用:
// Gson
Type listType = new TypeToken>(){}.getType();
List users = gson.fromJson(jsonArrayStr, listType);
// Jackson
List users = mapper.readValue(jsonArrayStr,
mapper.getTypeFactory().constructCollectionType(List.class, User.class));