当前位置：首页 > news >正文

StringJoiner更优雅创建含分隔符的字符序列

news 2025/8/18 12:31:50

文章目录

- 1 why
- 2 what
- 3 how
- 4 练习手段

1 why

StringBuilder拼接包含分隔符的字符序列时，分隔符需要一个一个添加，或者需要手动删除末尾冗余的分隔符，代码不美观，不好看。

比如，单个字符串依次拼接时：

StringBuilder sb = new StringBuilder();
sb.append("apple");
sb.append(",");
sb.append("orange");
sb.append(",");
sb.append("milk");
String str = sb.toString();

以及字符串集合循环拼接时：

StringBuilder sb = new StringBuilder();
for (String s:foodList) {sb.append(s);sb.append(",");
}
sb.deleteCharAt(sb.length()-1);
String str = sb.toString();

StringJoiner很好的解决了这个问题。

2 what

StringJoiner：用于构造由分隔符分隔的字符序列，并且可选前缀、后缀。内部实际是基于StringBuilder实现。

由于本文只使用StringJoiner替换StringBuilder，生成带分隔符的字符序列，所以与之无关的功能不介绍，详情可以参见jdk1.8官网手册。

StringJoiner功能
如图，需要用到的有StringJoiner本身提供的StringJoiner构造方法、add方法、toString方法，以及String类中通过StringJoiner实现的join方法。

（1）StringJoiner构造方法

public StringJoiner(CharSequence delimiter) {this(delimiter, "", "");
}

创建对象时，可以指定分隔符。

（2）add方法

public StringJoiner add(CharSequence newElement) {prepareBuilder().append(newElement);return this;
}

外层使用的prepareBuilder()方法，及StringBuilder的append方法，继续查看prepareBuilder方法：

private StringBuilder prepareBuilder() {if (value != null) {value.append(delimiter);} else {value = new StringBuilder().append(prefix);}return value;
}

也是用的StringBuilder的append方法，区别是增加了prefix（前缀，用于在输出的字符序列最前面添加用户自定义的字符，比如[）。

（3）toString方法

@Override
public String toString() {if (value == null) {return emptyValue;} else {if (suffix.equals("")) {return value.toString();} else {int initialLength = value.length();String result = value.append(suffix).toString();// reset value to pre-append initialLengthvalue.setLength(initialLength);return result;}}
}

（4）String类的join方法

public static String join(CharSequence delimiter, CharSequence... elements) {Objects.requireNonNull(delimiter);Objects.requireNonNull(elements);// Number of elements not likely worth Arrays.stream overhead.StringJoiner joiner = new StringJoiner(delimiter);for (CharSequence cs: elements) {joiner.add(cs);}return joiner.toString();
}

可以看到实际是调用StringJoiner实现的。

此处，实现了suffix（分隔符）的填充操作。

至此介绍完毕相关功能，后面进行尝试。

3 how

（1）单个字符串依次拼接时：

简单字符，可直接使用String类的join方法。

String result = String.join(",", "aaa", "bbb" ,"ccc");

第一个入参是分隔符，后面依次添加要追加的字符串。

字符串内容复杂时，使用StringJoiner。

StringJoiner sj = new StringJoiner(",");
sj.add("apple");
sj.add("orange");
sj.add("milk");
String str = sj.toString();

（2）字符串集合循环拼接时：

List<String> foodList = new ArrayList<String>();
foodList.add("apple");
foodList.add("orange");
foodList.add("milk");StringJoiner sj = new StringJoiner(",");
for (String s:foodList) {sj.add(s);
}
String str = sj.toString();