stringjoiner 从 jdk 8 起可用,专门用于在拼接字符串时自动处理前缀、后缀和分隔符。它比 stringbuilder 更简洁,能直接生成如 [a,b,c] 格式的字符串。以下三个示例分别替换 main.java 的内容,执行 javac main.java 和 java main。示例在 jdk 17 环境中使用 stringjoiner 完成带括号的列表拼接,并处理空值与合并场景。

初始化 StringJoiner 设置分隔符与括号
创建 StringJoiner 实例需要传入三个参数:分隔符(delimiter)、前缀(prefix)和后缀(suffix)。这三个参数决定了最终 toString() 输出的格式。例如,若希望结果为 [item1,item2],则分隔符为逗号,前缀为左方括号,后缀为右方括号。
import java.util.StringJoiner;
public class Main {
public static void main(String[] args) {
// 定义分隔符为逗号,前缀为[,后缀为]
StringJoiner sj = new StringJoiner(",", "[", "]");
// 添加元素
sj.add("apple");
sj.add("banana");
// 输出结果
System.out.println(sj.toString());
}
}运行上述代码,控制台将输出 [apple,banana]。注意,如果未调用 add 方法,直接调用 toString(),默认会返回前缀加后缀组成的空状态文本,即 []。这是 StringJoiner 的默认行为,不同于某些其他集合工具类可能返回空字符串或 null。

立即学习“Java免费学习笔记(深入)”;
处理空值与自定义空状态显示
当向 StringJoiner 添加 null 值时,add 方法会将其视为普通字符串 "null" 进行存储,而不是跳过或报错。如果需要过滤 null 值,应在添加前自行判断。此外,可以使用 setEmptyValue 方法自定义当没有任何元素被添加时的输出内容,替代默认的 prefix + suffix。
import java.util.StringJoiner;
public class Main {
public static void main(String[] args) {
StringJoiner sj = new StringJoiner(",", "[", "]");
// 添加正常值和 null
sj.add("valid");
sj.add(null);
System.out.println("With null: " + sj.toString());
// 重置并测试空值处理
StringJoiner emptySj = new StringJoiner(",", "[", "]");
emptySj.setEmptyValue("(empty)");
System.out.println("Empty state: " + emptySj.toString());
}
}预期输出第一行为 With null: [valid,null],第二行为 Empty state: (empty)。这表明 add(null) 会将 null 转换为字符串 "null" 存入。而 setEmptyValue 仅在 StringJoiner 内部计数为 0 时生效,一旦添加了任何元素(包括 null),setEmptyValue 的设置将被忽略,输出仍遵循 prefix+content+suffix 的规则。
合并两个 StringJoiner 实例
merge 方法允许将一个 StringJoiner 的内容追加到另一个中。合并时,源 StringJoiner 的前缀和后缀会被丢弃,仅保留其内部已添加的元素序列,源的内部内容作为一个整体加入目标,源的内部各项仍保留原分隔符,只有与目标已有内容之间使用目标分隔符。这适用于将多个分组数据合并为一个完整列表的场景。
import java.util.StringJoiner;
public class Main {
public static void main(String[] args) {
StringJoiner target = new StringJoiner(",", "[", "]");
target.add("group1_item1");
StringJoiner source = new StringJoiner(",", "[", "]");
source.add("group2_item1");
source.add("group2_item2");
// 合并 source 到 target
target.merge(source);
System.out.println(target.toString());
}
}运行结果应为 [group1_item1,group2_item1,group2_item2]。可以看到,source 中的 [ 和 ] 并未出现在最终结果中,只有其内部的元素被提取出来,并以 target 的分隔符 , 连接。如果 source 为空(未添加任何元素),merge 操作不会改变 target 的状态,也不会抛出异常。


















