Java8新方法String.join()

在《Java核心技术卷I》原书第10版中，第51页最下面，讲述了一个Java8新方法String.join(CharSequence delimiter, CharSequence... elements)返回一个新字符串，用给定的定界符连接所有元素。

演示代码如下：

public static void main(String[] args){
        //字符串数组
        String[] strArray = new String[]{"ni","zhen","hao","kan"};

        //字符串队列
        List<String> strList = new ArrayList<String>();
        //添加元素
        strList.add("ni");
        strList.add("zhen");
        strList.add("hao");
        strList.add("kan");

        //第2个参数是字符串数组
        String a = String.join("!",strArray);
        //第2个参数是字符串队列
        String b = String.join("!",strList);
        //第1个参数之后是多个字符串
        String c = String.join("!","ni","zhen","hao","kan");

        System.out.println(a);
        System.out.println(b);
        System.out.println(c);
    }

结果如下：

ni!zhen!hao!kan
ni!zhen!hao!kan
ni!zhen!hao!kan

从结果我们可以发现，在String.join()方法中，第1个参数是分隔符，第2个参数是需要进行拼接的元素，可以是多个字符串，可以是字符串数组，可以是字符串队列。

源码分析：

String.join()方法源码：

//delimiter 分隔符
//elements 需要连接的元素
public static String join(CharSequence delimiter, CharSequence... elements) {
    //判断是否为null，如果为null，抛出NullPointerException
    Objects.requireNonNull(delimiter);
    Objects.requireNonNull(elements);
    //构造一个分隔符为delimiter的实例
    StringJoiner joiner = new StringJoiner(delimiter);
    //循环拼接
    for (CharSequence cs: elements) {
        joiner.add(cs);
    }
    return joiner.toString();
}

StringJoiner构造器源码：

//1个参数构造器
public StringJoiner(CharSequence delimiter) {
    //调用3个参数构造器
    this(delimiter, "", "");
}

//3个参数构造器
//delimiter 分隔符
//prefix 前缀
//suffix 后缀
public StringJoiner(CharSequence delimiter,
                    CharSequence prefix,
                    CharSequence suffix) {
    //判断是否为null，如果为null，抛出NullPointerException
    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");
    //为成员变量赋值
    //前缀
    this.prefix = prefix.toString();
    //分隔符
    this.delimiter = delimiter.toString();
    //后缀
    this.suffix = suffix.toString();
    this.emptyValue = this.prefix + this.suffix;
}

String.join()方法中是通过add方法拼接字符串的，add()源码如下：

public StringJoiner add(CharSequence newElement) {
    //prepareBuilder()返回参数，调用append()方法
    prepareBuilder().append(newElement);
    return this;
}

perpareBuilder()方法源码如下：

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

perpareBuilder()方法返回值是一个StringBuilder对象，通过调用StringBuilder.append()方法拼接字符串。