目录
前言
这篇文章主要介绍了Java实用工具之StringJoiner详解,文中有非常详细的代码示例,对正在学习java的小伙伴们有很好地帮助,需要的朋友可以参考下；
在平时的业务开发中，我们可能会遇到字符串列表根据分隔符进行拼接的需求。比如：
输入：
数组：[“a”,“b”,“c”]分隔符：","输出：
“a,b,c”
通常我们可以使用StringBuilder根据下标位置决定是否需要添加分隔符以达到目的，比如：
public static void main(String[] args) {
StringBuilder sb = new StringBuilder();
String[] strings = new String[]{"a", "b", "c"};
String delimiter = ",";
for (int i = 0; i < strings.length; i++) {
if (i != 0) {
sb.append(delimiter);
}
sb.append(strings[i]);
}
System.out.println(sb.toString());
}或者
public static void main(String[] args) {
StringBuilder sb = new StringBuilder();
String[] strings = new String[]{"a", "b", "c"};
String delimiter = ",";
int tmp = strings.length - 1;
for (int i = 0; i < strings.length; i++) {
sb.append(strings[i]);
if (i != tmp) {
sb.append(delimiter);
}
}
System.out.println(sb.toString());
}但是每次遇到这种情况都去这样拼接很麻烦，而且如果使用迭代器，没有下标就不能使用这种方法。那么就每次append分隔符，最后再截断：
public static void main(String[] args) {
StringBuilder sb = new StringBuilder();
String[] strings = new String[]{"a", "b", "c"};
String delimiter = ",";
for (String str:strings) {
sb.append(str).append(delimiter);
}
System.out.println(sb.substring(0,sb.length()-1));
}
所以通常情况下，我们都会去扩展一个StringBuilder以提供分隔符组装的功能：
public class MyStringBuilder {
private StringBuilder stringBuilder;
private String delimiter;
public MyStringBuilder(String delimiter) {
this.delimiter = delimiter;
}
public MyStringBuilder append(String item) {
getStringBuilder().append(item);
return this;
}
/**
* 模拟的就是这个逻辑：
* if(index != 0){
* append(delimiter);
* }
* append(str);
*
* @return
*/
private StringBuilder getStringBuilder() {
if (stringBuilder == null) {
//相当于index==0，
stringBuilder = new StringBuilder();
} else {
stringBuilder.append(delimiter);
}
return stringBuilder;
}
@Override
public String toString() {
return stringBuilder == null ? "" : stringBuilder.toString();
}
}
在初始化的时候指定分隔符，然后每次直接append就行了，由内部决定在何时添加分隔符。
在JDK1.8之后，提供了一个StringJoiner类，提供了类似的功能，可以在初始化的时候指定分隔符和前缀后缀：
StringJoiner sj = new StringJoiner(",","(",")");
sj.add("a").add("b").add("c");
System.out.println(sj.toString());
//输出：(a,b,c)大致看了一下StringJoiner的实现逻辑，很简单，和咱们扩展StringBuilder基本是一样的逻辑，另外加入了前缀后缀，然后多了一个merge的功能：
public StringJoiner merge(StringJoiner other) {
Objects.requireNonNull(other);
if (other.value != null) {
final int length = other.value.length();
// lock the length so that we can seize the data to be appended
// before initiate copying to avoid interference, especially when
// merge 'this'
StringBuilder builder = prepareBuilder();
builder.append(other.value, other.prefix.length(), length);
}
return this;
}
StringJoiner这个工具到底是个什么呢？我们又该如何去使用？
直接上代码！！！！！
一、为什么会新增这样一个string辅助类？
原有的stringbuilder太死板，不支持分割，如果想让最终的字符串以逗号隔开，需要这样写
StringBuilder sb = new StringBuilder();
IntStream.range(1,10).forEach(i->{
sb.append(i+"");
if( i < 10){
sb.append(",")
}
});
是不是太死板了，不好用，StringJoiner怎样写呢？
StringJoiner sj = new StringJoiner(",");
IntStream.range(1,10).forEach(i->sj.add(i+""));
有哪些平时用的还比较少的功能：
-
setEmptyValue, 默认情况下的emptyValue是前缀加后缀， 用户可自定义emptyValue
-
merge(StringJoiner other),合并另外一个joiner
-
length, 当前长度，为空看emptyValue的长度
二、实现StringJoiner
-
维护一个List,最后toString的时候join一下就好了 优势：实现非常方便 缺点：list太浪费空间(扩容时都是按照系数扩容的)
-
在StringBuilder基础上改造（jdk实现方式就是以组合的形式增强的StringBuilder）
2.1.jdk实现的源码分析
-
成员变量
private final String prefix;
private final String delimiter;
private final String suffix;
/*
* StringBuilder value -- at any time, the characters constructed from the
* prefix, the added element separated by the delimiter, but without the
* suffix, so that we can more easily add elements without having to jigger
* the suffix each time.
*/
private StringBuilder value;
/*
* By default, the string consisting of prefix+suffix, returned by
* toString(), or properties of value, when no elements have yet been added,
* i.e. when it is empty. This may be overridden by the user to be some
* other value including the empty String.
*/
private String emptyValue;
其实从成员变量的注释里就能看出他们的作用和需要注意的点了
-
构造函数
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 arguments
this.prefix = prefix.toString();
this.delimiter = delimiter.toString();
this.suffix = suffix.toString();
// ！！！构造时就直接将emptyValue拼接好了。
this.emptyValue = this.prefix + this.suffix;
}
为什么要一开始就构造好呢？如果我想直接自定义emptyValue直接用构造函数初始化不是更方便吗？是因为绝大多数场景下都不会自定义emptyValue的场景吗？不对啊，感觉这个场景非常必要啊。。。
-
添加元素
public StringJoiner add(CharSequence newElement) {
prepareBuilder().append(newElement);
return this;
}
private StringBuilder prepareBuilder() {
// 从构造函数和类变量的声明可以看出，没有添加元素前stringbuilder是没有初始化的
if (value != null) {
// 已经有元素存在的情况下，添加元素前先将分隔符添加进去
value.append(delimiter);
} else {
// 没有元素存在的情况下先把前缀加进去
value = new StringBuilder().append(prefix);
}
return value;
}
可以看出再添加元素的过程中就已经把前缀和分割字符什么的都处理好了，全部都在stringbuilde中了，唯一没有处理的就是后缀。为什么？这样做tostring什么的时候真的超级方便的有木有。。。。。
-
关键的toString
public String toString() {
if (value == null) {
// 这里如果没有自定义空值就是前缀+后缀咯。。
return emptyValue;
} else {
// 为什么不直接value.toString()+suffix?????
if (suffix.equals("")) {
return value.toString();
} else {
int initialLength = value.length();
String result = value.append(suffix).toString();
// reset value to pre-append initialLength
value.setLength(initialLength);
return result;
}
}
}
为什么不直接value.toString()+suffix？答案在merge方法
-
merge
public StringJoiner merge(StringJoiner other) {
Objects.requireNonNull(other);
if (other.value != null) {
final int length = other.value.length();
// 下面这段注释是说避免merge(this)时受影响，为什么？
// lock the length so that we can seize the data to be appended
// before initiate copying to avoid interference, especially when
// merge 'this'
StringBuilder builder = prepareBuilder();
builder.append(other.value, other.prefix.length(), length);
}
return this;
}
private StringBuilder prepareBuilder() {
if (value != null) {
value.append(delimiter);
} else {
value = new StringBuilder().append(prefix);
}
return value;
}
merge的思路是用当前的striingBuilder去append other的value（必须去掉前缀），源码注释中的merge 'this'问题是什么呢？prepareBuilder()的时候可能会先append(delimiter)，如果other就是this，那么length其实就多了一个delimiter，此时append还是得以添加前的length为准。
merge的实现方式决定了toString时不能直接value.append(suffix).toString(),因为 builder.append(other.value, other.prefix.length(), length);这行代码，默认加上suffix后这里的merge的length得减去suffix的length（嗯，看来作者是想得多好多），而且merge时得把另外一个sj的内容append到当前这个sj的suffix之前（想想就麻烦多了。。。。）
-
length
public int length() {
// Remember that we never actually append the suffix unless we return
// the full (present) value or some sub-string or length of it, so that
// we can add on more if we need to.
return (value != null ? value.length() + suffix.length() :
emptyValue.length());
}
没什么好说的，记住length不只是add的元素的length，还有前后缀。
总结
-
基于StringBuilder实现，add时就把prefix和分隔符给加上了，suffix永远都不加，知道toString和length调用时才加入计算。这样带来的merge操作实现的极大便利性！！！！！学到了，真的不错
-
emptyValue这个一定要构造时就生成吗？用户想有自己的默认值还需要先构造实例再注入吗。。。。这个觉得还是有点奇怪
-
Objects这个工具方法是返回的校验的值本身，不错。
public StringJoiner setEmptyValue(CharSequence emptyValue) {
// 注意这个Objects.requireNonNull方法是return的第一个参数。。。
this.emptyValue = Objects.requireNonNull(emptyValue,
"The empty value must not be null").toString();
return this;
}
只有当你开始，你才会到达你的理想和目的地，只有当你努力，
你才会获得辉煌的成功，只有当你播种，你才会有所收获。只有追求，
才能尝到成功的味道，坚持在昨天叫立足，坚持在今天叫进取，坚持在明天叫成功。欢迎所有小伙伴们点赞+收藏！！！
1532
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
