Java 中怎么使用 StringBuilder 拼接 XML 或 JSON 报文数据

胖枫姑娘_3642

胖枫姑娘_3642

2026-08-13

308人浏览

原创

Java中不推荐用StringBuilder拼装复杂JSON或XML,因其不校验格式、不转义特殊字符、不处理嵌套结构;仅适用于结构固定、字段极少、性能敏感的简单场景,如心跳包或清洗后的日志组装。

java 中怎么使用 stringbuilder 拼接 xml 或 json 报文数据

Java 中用 StringBuilder 拼接 XML 或 JSON 报文,核心是“避免字符串重复创建”,但必须注意:它不校验格式、不转义特殊字符、不处理嵌套结构——适合简单、可控、性能敏感的场景(比如日志组装、内部协议生成),不适合替代 Jackson/Gson 或 DOM/JAXB。

拼接 XML 要手动处理转义和结构

XML 对 、<code>>、&、"、' 有严格转义要求,StringBuilder 不自动处理,必须自己做:

  • 用 StringEscapeUtils.escapeXml11()(Apache Commons Text)或手写简单转义逻辑
  • 标签必须严格配对,缩进靠人工控制(或用换行+制表符模拟)
  • 属性值要用双引号包裹,且内容需转义

示例(简化版用户信息 XML):

StringBuilder xml = new StringBuilder();
xml.append("<user id='"").append(escapeXml(userId)).append(""'>
");
xml.append("  <name>").append(escapeXml(name)).append("</name>
");
xml.append("  <email>").append(escapeXml(email)).append("</email>
");
xml.append("</user>");

其中 escapeXml() 需自行实现或引入工具类,否则含 & 的邮箱(如 a&b@x.com)会导致 XML 解析失败。

拼接 JSON 更容易出错,慎用

JSON 要求双引号键名、字符串值必须用双引号、禁止尾逗号、数字不能加引号——StringBuilder 完全不检查这些:

  • 键和字符串值都必须用 " 包裹,且内部双引号要转义为 "
  • 布尔值写 true/false,不要加引号;null 直接写,不写 "null"
  • 数组用 [...],对象用 {...},括号必须成对

错误示例(看似正常,实则非法):

sc-java-to-ts-interface
sc-java-to-ts-interface

将后端 Java 接口文档转换为前端 TypeScript 类型定义(interface / type)。输入:飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出:包含请求参数与响应结果的 .md 文件,含完整 JSDoc 注释。触发关键词:Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。

下载
// ❌ 错误:name 值没转义引号,age 加了引号变成字符串
sb.append("{"name":"Zhang "San", "age":"25"}");
// ✅ 正确:转义内部引号,数字不加引号
sb.append("{"name":"Zhang \"San\"", "age":25}");

什么时候可以用?明确适用边界

适合以下情况:

  • 报文结构固定、字段极少(如心跳包:{"type":"heartbeat","ts":1712345678})
  • 高频低延迟场景(如每秒万级日志埋点,且字段已清洗过)
  • 嵌入式或受限环境(无法引入第三方 JSON/XML 库)

不适合:

  • 字段来自用户输入或外部 API(风险高,易注入或格式崩坏)
  • 嵌套对象或动态数组(手写逻辑极易漏括号、逗号)
  • 需要校验、格式化、缩进输出的调试场景

比 StringBuilder 更稳的轻量替代方案

如果只是想避开大库但又要安全,可考虑:

  • JSON:用 Gson 的 JsonWriter(流式写入,内存友好)
  • XML:用 StAX 的 XMLStreamWriter(边写边校验,支持命名空间)
  • 极简需求:封装一个带自动转义的小工具类,只暴露 addTag()、addProp() 等方法,屏蔽底层拼接

不复杂但容易忽略:拼接后建议用正则或简单校验(如统计 { 和 } 数量是否相等)快速拦截明显错误。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

java js json

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

11357

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

8462

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

7292

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1224

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

988

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1456

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2989

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20251

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1315

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习