深入了解Java中的StringJoiner类-编程知识

在Java编程中，字符串的拼接是一个常见的操作。Java提供了多种方法来实现字符串拼接，其中之一就是StringJoiner类。本文将详细介绍StringJoiner的用法和功能。

StringJoiner简介

StringJoiner是Java 8引入的一个用于拼接字符串的工具类。它允许我们以指定的分隔符将一组字符串连接成一个单独的字符串。我们可以在其源码中看到一个熟悉的身影StringBuilder,它是基于StringBuilder实现字符串操作的，所以它的性能和StringBuilder是差不多的，它也是非线程安全的。
以下是关于StringJoiner 构造方法和属性的源码：

package java.util;public final class StringJoiner {private final String prefix;private final String delimiter;private final String suffix;private StringBuilder value;private String emptyValue;public StringJoiner(CharSequence delimiter) {this(delimiter, "", "");}public StringJoiner(CharSequence delimiter,CharSequence prefix,CharSequence suffix) {Objects.requireNonNull(prefix, "The prefix must not be null");Objects.requireNonNull(delimiter, "The delimiter must not be null");Objects.requireNonNull(suffix, "The suffix must not be null");// make defensive copies of argumentsthis.prefix = prefix.toString();this.delimiter = delimiter.toString();this.suffix = suffix.toString();this.emptyValue = this.prefix + this.suffix;}
}

字段说明：

prefix：这是一个私有字段，表示拼接后的字符串的前缀部分。在构造函数中通过传递参数指定，如果未提供则默认为空字符串。
delimiter：这是一个私有字段，表示拼接字符串时使用的分隔符。同样，它在构造函数中通过参数传递，如果未提供则默认为空字符串。
suffix：这是一个私有字段，表示拼接后的字符串的后缀部分。同样，它在构造函数中通过参数传递，如果未提供则默认为空字符串。
value：这是一个私有字段，它是一个StringBuilder对象，用于存储实际的拼接结果。
emptyValue：这是一个私有字段，用于存储拼接结果为空时的默认值，即前缀和后缀的组合。这个值在构造函数中初始化。

构造函数详解：

StringJoiner(CharSequence delimiter)

这个构造函数接受一个CharSequence类型的参数delimiter，它表示拼接字符串时要使用的分隔符。前缀和后缀默认为空字符串。

StringJoiner(CharSequence delimiter, CharSequence prefix, CharSequence suffix)

这个构造函数接受三个CharSequence类型的参数，分别是分隔符delimiter、前缀prefix和后缀suffix。这个构造函数允许您自定义拼接结果的格式。在构造函数内部，会检查这些参数是否为null，并将它们转换为字符串形式保存在相应的字段中。同时，也会初始化emptyValue字段为前缀和后缀的组合。

`add()`方法

add()方法是StringJoiner类最重要的方法之一。add()方法用于将元素添加到StringJoiner对象中。这个方法用于将一个新元素（newElement）添加到StringJoiner对象中，并返回StringJoiner对象本身（支持链式调用）。源码如下：


public StringJoiner add(CharSequence newElement) {prepareBuilder().append(newElement);return this;
}private StringBuilder prepareBuilder() {if (value != null) {value.append(delimiter);} else {value = new StringBuilder().append(prefix);}return value;
}

示例代码：

public static void main(String[] args) {StringJoiner stringJoiner = new StringJoiner(",","[","]");stringJoiner.add("x") .add("j");StringJoiner stringJoiner1 = new StringJoiner(",","(",")");stringJoiner1.add("x1").add("j1");System.out.println(stringJoiner.toString());System.out.println(stringJoiner1.toString());System.out.println(stringJoiner1.merge(stringJoiner).toString());System.out.println(stringJoiner1.toString());System.out.println(stringJoiner.merge(stringJoiner1).toString());
}

输出结果：

[x,j]
(x1,j1)
(x1,j1,x,j)
(x1,j1,x,j)
[x,j,x1,j1,x,j]

stream中的应用

有些家人们可能会说，如果我需要把集合 List list 中的字符串使用,拼接的话可以直接借助stream实现

list.stream().collect(Collectors.joining(","));

我们可以看下Collectors.joining(",") 的源码就可以发现，他就是借助StringJoiner实现的，源码如下：

public static Collector<CharSequence, ?, String> joining(CharSequence delimiter) {return joining(delimiter, "", "");
}public static Collector<CharSequence, ?, String> joining(CharSequence delimiter,CharSequence prefix,CharSequence suffix) {return new CollectorImpl<>(() -> new StringJoiner(delimiter, prefix, suffix),StringJoiner::add, StringJoiner::merge,StringJoiner::toString, CH_NOID);
}