优雅拼接字符串:StringJoiner 的完整指南

在Java开发中，字符串拼接是高频操作。无论是日志格式化、构建CSV数据，还是生成动态SQL，开发者常需处理分隔符、前缀和后缀的组合。传统的StringBuilder虽然灵活，但代码冗余且易出错。Java 8推出的StringJoiner类，以简洁的链式调用和自动处理边界的能力，成为字符串拼接的优雅解决方案。本文将通过丰富的代码示例，详解StringJoiner的核心功能。

一、StringJoiner 的构造方法

StringJoiner提供了两种构造方法，适应不同场景的字符串拼接需求。

1. 仅指定分隔符

适用于无需前后缀的简单拼接。

// 语法：StringJoiner(CharSequence delimiter)
StringJoiner joiner = new StringJoiner(", ");
joiner.add("苹果").add("香蕉").add("橙子");
System.out.println(joiner.toString()); // 输出：苹果, 香蕉, 橙子

2. 指定分隔符 + 前缀 + 后缀

适合需要包裹内容的场景，如JSON数组、带括号的列表等。

// 语法：StringJoiner(CharSequence delimiter, CharSequence prefix, CharSequence suffix)
StringJoiner joiner = new StringJoiner(" | ", "[ ", " ]");
joiner.add("Java").add("Python").add("C++");
System.out.println(joiner.toString()); // 输出：[ Java | Python | C++ ]

二、StringJoiner 的关键方法

通过链式调用，StringJoiner提供高效且直观的操作方式。

1. `add(CharSequence element)`

添加元素，自动处理分隔符的插入位置。

StringJoiner joiner = new StringJoiner("-");
joiner.add("2023").add("08").add("20");
System.out.println(joiner.toString()); // 输出：2023-08-20

2. `merge(StringJoiner other)`

合并两个StringJoiner对象，保留当前对象的分隔符和前后缀。

StringJoiner joiner1 = new StringJoiner(",", "[", "]");
joiner1.add("A").add("B"); StringJoiner joiner2 = new StringJoiner("+", "<", ">");
joiner2.add("1").add("2");joiner1.merge(joiner2); 
System.out.println(joiner1.toString()); // 输出：[A,B,1+2]

3. `setEmptyValue(CharSequence emptyValue)`

设置当无元素时的默认返回值，避免空输出。

StringJoiner joiner = new StringJoiner("/");
joiner.setEmptyValue("暂无数据");
System.out.println(joiner.toString()); // 输出：暂无数据

4. `toString()`

生成最终字符串，自动添加前后缀并移除末尾多余的分隔符。

StringJoiner joiner = new StringJoiner(", ", "{ ", " }");
joiner.add("Name").add("Age").add("City");
System.out.println(joiner.toString()); // 输出：{ Name, Age, City }

三、实战场景与进阶技巧

1. 与Stream API结合

将集合快速转换为格式化字符串。

List<String> list = Arrays.asList("北京", "上海", "广州");
String result = list.stream().collect(Collectors.joining(", ", "Cities: [", "]"));
System.out.println(result); // 输出：Cities: [北京, 上海, 广州]

2. 处理空值或过滤元素

灵活跳过无效数据。

List<String> data = Arrays.asList("Java", "", "Python", null);
StringJoiner joiner = new StringJoiner("; ");
data.stream().filter(str -> str != null && !str.isEmpty()).forEach(joiner::add);
System.out.println(joiner.toString()); // 输出：Java; Python