Java核心类——3.StringJoiner

目录

• Java中的StringJoiner
  • StringJoiner的基本用法
    • 基本构造与使用
    • 带前缀和后缀的拼接
  • String.join()：简化的拼接方法
  • StringJoiner其他使用
    • 合并两个StringJoiner
    • 处理空值情况
  • 总结

---

Java中的StringJoiner

在Java开发中，我们经常需要将多个字符串或数组元素用指定分隔符拼接起来，例如生成CSV格式的文本、SQL语句中的字段列表等。虽然StringBuilder可以完成这类任务，但处理分隔符时往往需要额外的逻辑来避免首尾多余的分隔符。StringJoiner作为Java 8 引入的专门用于字符串拼接的工具类，完美解决了这一问题，让分隔符拼接变得简洁优雅。

StringJoiner的基本用法

StringJoiner的设计初衷就是简化带分隔符的字符串拼接操作，它能自动处理分隔符的添加，避免在首尾出现多余的分隔符。

基本构造与使用

import java.util.StringJoiner;

public class StringJoinerBasic {
    public static void main(String[] args) {
        // 创建StringJoiner，指定分隔符为逗号加空格
        StringJoiner sj = new StringJoiner(", ");

        // 添加元素
        sj.add("Apple");
        sj.add("Banana");
        sj.add("Orange");

        // 转换为字符串
        String result = sj.toString();
        System.out.println(result); // 输出：Apple, Banana, Orange
    }
}

这段代码实现了用", "分隔多个水果名称的功能，无需手动处理最后一个分隔符的去除，StringJoiner会自动管理分隔符的添加。

带前缀和后缀的拼接

StringJoiner的另一个实用特性是可以指定拼接结果的前缀和后缀：

public class StringJoinerWithPrefixSuffix {
    public static void main(String[] args) {
        // 构造方法：分隔符、前缀、后缀
        StringJoiner sj = new StringJoiner(", ", "Hello ", "!");

        sj.add("Bob");
        sj.add("Alice");
        sj.add("Grace");

        System.out.println(sj.toString()); // 输出：Hello Bob, Alice, Grace!
    }
}

在这个例子中：

• 第一个参数是分隔符（", "）
• 第二个参数是前缀（"Hello "）
• 第三个参数是后缀（"!"）

最终结果自动包含前缀和后缀，且元素间用指定分隔符分隔。

String.join()：简化的拼接方法

对于不需要前缀和后缀的简单拼接场景，String类提供了静态方法join()，它内部基于StringJoiner实现，使用更加简洁：

public class StringJoinExample {
    public static void main(String[] args) {
        String[] fruits = {"Apple", "Banana", "Orange"};

        // 使用String.join()拼接数组
        String result = String.join(" | ", fruits);
        System.out.println(result); // 输出：Apple | Banana | Orange

        // 拼接多个字符串字面量
        String names = String.join(" & ", "Alice", "Bob", "Charlie");
        System.out.println(names); // 输出：Alice & Bob & Charlie
    }
}

String.join()的语法非常直观：

• 第一个参数是分隔符
• 后续参数是要拼接的元素（可以是数组或可变参数）

StringJoiner其他使用

合并两个StringJoiner

StringJoiner提供了merge()方法，可以将另一个StringJoiner的内容合并进来，且会自动处理分隔符：

public class StringJoinerMerge {
    public static void main(String[] args) {
        StringJoiner sj1 = new StringJoiner(", ", "[", "]");
        sj1.add("A").add("B");

        StringJoiner sj2 = new StringJoiner(" | ", "<", ">");
        sj2.add("X").add("Y");

        // 合并sj2到sj1
        sj1.merge(sj2);

        System.out.println(sj1.toString()); // 输出：[A, B, X, Y]
    }
}

注意：合并时会使用当前StringJoiner的分隔符，而不是被合并对象的分隔符。

处理空值情况

当StringJoiner没有添加任何元素时，默认会返回空字符串。我们可以在构造时指定一个默认值，用于没有元素的情况：

public class StringJoinerEmptyValue {
    public static void main(String[] args) {
        // 指定空值时的默认字符串
        StringJoiner sj = new StringJoiner(", ", "{", "}", "empty");

        System.out.println(sj.toString()); // 输出：empty

        sj.add("test");
        System.out.println(sj.toString()); // 输出：{test}
    }
}

总结

• StringJoiner支持指定分隔符、前缀和后缀，自动管理分隔符添加
• String.join()是简化版的拼接方法，适合不需要前缀后缀的场景