stringjoiner是java 8引入的专用于结构化字符串拼接的工具类,支持分隔符、前缀、后缀、空值定制、合并及长度统计,底层基于stringbuilder实现,轻量高效且线程不安全。

Java 8 引入的 StringJoiner 是专为结构化字符串拼接设计的工具类,它让带分隔符、前缀、后缀的拼接变得直观且不易出错,比手动用 StringBuilder 管理边界逻辑更可靠。
基础用法:三步完成规范拼接
只需三步:创建对象 → 添加元素 → 调用 toString():
- 仅需分隔符:
new StringJoiner(",")→ 输出如"a,b,c" - 带前后缀:
new StringJoiner(",", "[", "]")→ 输出如"[a,b,c]" - 链式添加:
sj.add("a").add("b").add("c"),无需判断是否是首个或末尾元素
空值处理:避免返回空字符串
未添加任何元素时,默认返回前缀+后缀(如 "[]")。若需自定义,调用 setEmptyValue():
-
new StringJoiner("|").setEmptyValue("N/A")→toString()返回"N/A" - 该设置必须在首次
add()前完成,否则无效
进阶能力:合并与长度统计
StringJoiner 支持跨上下文组合和精确长度计算:
-
merge()可将另一个非空StringJoiner的内容追加到当前对象(分隔符自动衔接) -
length()返回完整结果长度,包含前缀、所有元素、分隔符及后缀,比如"[a,b]"长度为 5 - 注意:
merge()不改变原对象的前缀/后缀,只合并中间内容
底层机制:轻量封装,性能友好
它内部基于 StringBuilder 实现,无额外装箱或拷贝开销:
- 首次
add()时才初始化StringBuilder,并自动前置前缀 - 后续每次
add()自动插入分隔符,后缀留待toString()时统一追加 - 线程不安全,适合单线程或局部构造场景;高并发拼接建议每个线程独立实例
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











