為什么會新增這樣一個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, 默認(rèn)情況下的emptyValue是前綴加后綴榜贴， 用戶可自定義emptyValue
- merge(StringJoiner other),合并另外一個joiner
- length, 當(dāng)前長度，為空看emptyValue的長度
讓我實現(xiàn)StringJoiner妹田，我會怎么辦呢唬党？
- 維護一個List,最后toString的時候join一下就好了
優(yōu)勢：實現(xiàn)非常方便
缺點：list太浪費空間(擴容時都是按照系數(shù)擴容的) - 在StringBuilder基礎(chǔ)上改造（jdk實現(xiàn)方式就是以組合的形式增強的StringBuilder）
jdk實現(xiàn)的源碼分析
- 成員變量
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;
其實從成員變量的注釋里就能看出他們的作用和需要注意的點了
- 構(gòu)造函數(shù)
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();
// ＞楣病！初嘹！構(gòu)造時就直接將emptyValue拼接好了及汉。
this.emptyValue = this.prefix + this.suffix;
}
為什么要一開始就構(gòu)造好呢？如果我想直接自定義emptyValue直接用構(gòu)造函數(shù)初始化不是更方便嗎屯烦？是因為絕大多數(shù)場景下都不會自定義emptyValue的場景嗎坷随？不對啊赢底，感覺這個場景非常必要啊糊治。片拍。斋泄。
- 添加元素
public StringJoiner add(CharSequence newElement) {
prepareBuilder().append(newElement);
return this;
}
private StringBuilder prepareBuilder() {
// 從構(gòu)造函數(shù)和類變量的聲明可以看出，沒有添加元素前stringbuilder是沒有初始化的
if (value != null) {
// 已經(jīng)有元素存在的情況下楼雹，添加元素前先將分隔符添加進去
value.append(delimiter);
} else {
// 沒有元素存在的情況下先把前綴加進去
value = new StringBuilder().append(prefix);
}
return value;
}
可以看出再添加元素的過程中就已經(jīng)把前綴和分割字符什么的都處理好了辞做，全部都在stringbuilde中了莺掠，唯一沒有處理的就是后綴露懒。 為什么闯冷？這樣做tostring什么的時候真的超級方便的有木有。懈词。蛇耀。。坎弯。
- 關(guān)鍵的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的思路是用當(dāng)前的striingBuilder去append other的value（必須去掉前綴）崎脉，源碼注釋中的merge 'this'問題是什么呢拧咳？ prepareBuilder()的時候可能會先append(delimiter)，如果other就是this囚灼，那么length其實就多了一個delimiter呛踊，此時append還是得以添加前的length為準(zhǔn)。
merge的實現(xiàn)方式?jīng)Q定了toString時不能直接value.append(suffix).toString(),因為
builder.append(other.value, other.prefix.length(), length);這行代碼啦撮，默認(rèn)加上suffix后這里的merge的length得減去suffix的length（嗯，看來作者是想得多好多）汪厨，而且merge時得把另外一個sj的內(nèi)容append到當(dāng)前這個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，還有前后綴狭吼。
總結(jié)
基于StringBuilder實現(xiàn)层坠，add時就把prefix和分隔符給加上了，suffix永遠都不加刁笙，知道toString和length調(diào)用時才加入計算破花。 這樣帶來的merge操作實現(xiàn)的極大便利性！ＦＮＷ俊！摘悴！學(xué)到了峭梳，真的不錯
emptyValue這個一定要構(gòu)造時就生成嗎？用戶想有自己的默認(rèn)值還需要先構(gòu)造實例再注入嗎蹂喻。葱椭。。口四。這個覺得還是有點奇怪
Objects這個工具方法是返回的校驗的值本身孵运，不錯。
public StringJoiner setEmptyValue(CharSequence emptyValue) {
// 注意這個Objects.requireNonNull方法是return的第一個參數(shù)窃祝。掐松。。
this.emptyValue = Objects.requireNonNull(emptyValue,
"The empty value must not be null").toString();
return this;
}
