[源码分析]StringJoiner的使用以及源码分析
StringJoiner是Java里1.8新增的类, 或许有一部分人没有接触过. 所以本文将从使用例子入手, 分析StringJoiner的源码.
基本好的同学, 其实只要把这段例子自己运行一下, 自己看看源码就可以了. 因为我觉得这个类挺简单的. 没必要看我下面的废话....
public class StringJoinerTest {
public static void main(String[] args) {
StringJoiner joiner = new StringJoiner("--", "[[[_", "_]]]");
System.out.println("toString: " + joiner.toString());
System.out.println("length: " + joiner.length());
System.out.println("******************(1)********************");
joiner.add("1");
joiner.add("2");
joiner.add("3");
joiner.add("4");
System.out.println("toString: " + joiner.toString());
System.out.println("length: " + joiner.length());
System.out.println("******************(2)********************");
StringJoiner joiner2 = new StringJoiner("...");
System.out.println("toString: " + joiner2.toString());
System.out.println("length: " + joiner2.length());
System.out.println("******************(3)********************");
joiner2.add("a");
joiner2.add("b");
joiner2.add("c");
System.out.println("toString: " + joiner2.toString());
System.out.println("length: " + joiner2.length());
System.out.println("******************(4)********************");
joiner.merge(joiner2);
System.out.println("toString: " + joiner.toString());
System.out.println("******************(5)********************");
StringJoiner joiner3 = new StringJoiner("==", "qianzhui", "houzhui");
joiner3.add("壹");
joiner3.add("贰");
joiner3.add("叁");
joiner.merge(joiner3);
System.out.println("toString: " + joiner.toString());
System.out.println("length: " + joiner.length());
System.out.println("******************(6)********************");
joiner.merge(joiner); // joiner.merge(this)
System.out.println("toString: " + joiner.toString());
System.out.println("length: " + joiner.length());
}
}
输出结果如下:
toString: [[[__]]] length: 8 ******************(1)******************** toString: [[[_1--2--3--4_]]] length: 18 ******************(2)******************** toString: length: 0 ******************(3)******************** toString: a...b...c length: 9 ******************(4)******************** toString: [[[_1--2--3--4--a...b...c_]]] ******************(5)******************** toString: [[[_1--2--3--4--a...b...c--壹==贰==叁_]]] length: 38 ******************(6)******************** toString: [[[_1--2--3--4--a...b...c--壹==贰==叁--1--2--3--4--a...b...c--壹==贰==叁_]]] length: 70
上面的例子看懂的同学, 其实没必要往下看下去了....下面的几个例子就当是我自己做了个总结吧.
例1
public class StringJoinerTest2 {
public static void main(String[] args) {
StringJoiner joiner = new StringJoiner("--", "[[[_ ", "_]]]");
System.out.println(joiner.toString());
System.out.println(joiner.length());
}
}
输出结果如下:
这个构造器要传入三个参数. 第一个是`分隔符` , 第二个是`前缀` , 第三个是 `后缀`. 现在不明白也没有关系, 下面待会儿会详细介绍.
咱们先把这个构造器对应的源码看了吧:
先是判断非空. 然后就开始赋值了. emptyValue被赋值为了prefix+suffix . 这段代码就是这么简单... 其中:
1. prefix 是前缀. (待会儿再讲)
2. delimiter 是分隔符 (待会儿再讲)
3. suffix 是后缀 (待会儿再讲)
4. emptyValue是本类的`空值`. 空值准确来说应该是null, 但StringJoiner类把emptyValue来当空值来处理. (马上就讲)
构造器看完了, 咱们再看看toString方法:
因为目前的代码里, 没有对value进行过赋值操作, 所以value肯定是null. 所以会执行第一个if.
也就是说真正的值value为空的时候, 就会返回本类默认的空值emptyValue. (大家有没有现在应该知道emptyValue的作用了吧)
toString就先分析这一小段if, 剩下的后面再讲. 接下来咱们看看length()方法:
value非空的时候, 长度就是value的长度+后缀的长度.(前缀呢? 前缀去哪儿了? 为什么不单独再加上前缀的长度呢? 带着这个疑惑往下看) .
value为空的时候, 长度就是emptyValue的长度.
例2
咱们往StringJoiner添加 "1"
public class StringJoinerTest2 {
public static void main(String[] args) {
StringJoiner joiner = new StringJoiner("--", "[[[_", "_]]]");
joiner.add("1");
System.out.println("toString: " + joiner.toString());
System.out.println("length: " + joiner.length());
}
}
输出结果如下:
这个时候, 或许大家对`前缀` `后缀` 有些理解了吧. (还没理解也无所谓, 往下看)
咱们看看add方法的源码吧:
通过append方法, 将咱们传入的"1"添加到了末尾. 那么prepareBuilder()方法返回的是什么呢?看看源码吧:
咱们调用add("1")的时候, value为空. 所以会执行else语句. 在这里新实例化了一个StringBuilder. 然后StringBuilder先追加了`前缀`. (if语句先不讲, 等执行到了再讲)
所以此时prepareBuilder方法返回的value实际上就是前缀: "[[[_"
回到add方法, 刚才咱们说了add方法即时在prepareBuilder返回的值后面追加了"1"而已.
所以执行完add方法之后, value就等于 "[[[_1" 所以value里就已经包含了前缀了. 所以length方法里"为什么不单独再计算前缀的长度呢?" 因为value里面就已经包含前缀了.
咱们再看看toString方法:
这次value非空. 所以执行这里else语句:
如果suffix等于空字符串, 那么就返回value.
如果suffix不等于空字符串, 那么就返回value+后缀.
再看看length()方法:
value不为空, 所以返回的值是 value的长度+后缀的长度.
例3
public class StringJoinerTest2 {
public static void main(String[] args) {
StringJoiner joiner = new StringJoiner("--", "[[[_", "_]]]");
joiner.add("1");
joiner.add("2");
joiner.add("3");
joiner.add("4");
System.out.println("toString: " + joiner.toString());
System.out.println("length: " + joiner.length());
}
}
输出结果如下:
add("1")和上一小节的执行流程一样. 这回看看add("2");的执行流程吧:
由于前面add("1")执行完了, 所以导致value已经不是null了. 所以这里会执行prepareBuilder方法里的if语句. 在value后直接追加一个delimiter分隔符. 然后返回这个value.
然后再add方法里, 把"2"追加到value后面.
例4
咱们发现add方法最后返回的是this.所以上面一小节的示例代码可以写成这样:
public class StringJoinerTest2 {
public static void main(String[] args) {
StringJoiner joiner = new StringJoiner("--", "[[[_", "_]]]");
joiner.add("1").add("2").add("3").add("4");
System.out.println("toString: " + joiner.toString());
System.out.println("length: " + joiner.length());
}
}
例5
StringJoiner还有一个构造器, 只需传入分隔符:
public class StringJoinerTest2 {
public static void main(String[] args) {
StringJoiner joiner2 = new StringJoiner("...");
System.out.println("toString: " + joiner2.toString());
System.out.println("length: " + joiner2.length());
System.out.println("**************************************");
joiner2.add("a");
joiner2.add("b");
joiner2.add("c");
System.out.println("toString: " + joiner2.toString());
System.out.println("length: " + joiner2.length());
}
}
输出结果如下:
构造器源码如下:
就是只指定了分割符, 把前缀和后缀都指定为了空字符串.
例6
接下来咱们看看merge方法
public class StringJoinerTest2 {
public static void main(String[] args) {
StringJoiner joiner = new StringJoiner("--", "[[[_", "_]]]");
joiner.add("1").add("2").add("3").add("4");
StringJoiner joiner2 = new StringJoiner("...");
joiner2.add("a").add("b").add("c");
joiner.merge(joiner2);
System.out.println(joiner.toString());
}
}
输出结果如下:
merge的源代码如下:
咱们看到了用append方法进行了字符串追加. (append的时候刨除去了other.value 的前缀).
总结
1. prepareBuilder方法在value为空的时候, 给value加上前缀.
2. prepareBuilder方法在value非空的时候, 给value加上分隔符.
3. 很多方法都不能传入null为参数. 因为用Objects.requireNonNul方法限定了.
4. 前缀是包含在value里的. 而后缀部分是toString的时候才会被临时添加到value里.