在Java開發中，字符串拼接是高頻操作。無論是日志格式化、構建CSV數據，還是生成動態SQL，開發者常需處理分隔符、前綴和后綴的組合。傳統的StringBuilder雖然靈活，但代碼冗余且易出錯。Java 8推出的StringJoiner類，以簡潔的鏈式調用和自動處理邊界的能力，成為字符串拼接的優雅解決方案。本文將通過豐富的代碼示例，詳解StringJoiner的核心功能。

一、StringJoiner 的構造方法

StringJoiner提供了兩種構造方法，適應不同場景的字符串拼接需求。

1. ?僅指定分隔符

適用于無需前后綴的簡單拼接。

// 語法：StringJoiner(CharSequence delimiter)
StringJoiner joiner = new StringJoiner(", ");
joiner.add("蘋果").add("香蕉").add("橙子");
System.out.println(joiner.toString()); // 輸出：蘋果, 香蕉, 橙子

2. ?指定分隔符 + 前綴 + 后綴

適合需要包裹內容的場景，如JSON數組、帶括號的列表等。

// 語法：StringJoiner(CharSequence delimiter, CharSequence prefix, CharSequence suffix)
StringJoiner joiner = new StringJoiner(" | ", "[ ", " ]");
joiner.add("Java").add("Python").add("C++");
System.out.println(joiner.toString()); // 輸出：[ Java | Python | C++ ]

二、StringJoiner 的關鍵方法

通過鏈式調用，StringJoiner提供高效且直觀的操作方式。

1. ?add(CharSequence element)

添加元素，自動處理分隔符的插入位置。

StringJoiner joiner = new StringJoiner("-");
joiner.add("2023").add("08").add("20");
System.out.println(joiner.toString()); // 輸出：2023-08-20

2. ?merge(StringJoiner other)

合并兩個StringJoiner對象，保留當前對象的分隔符和前后綴。

StringJoiner joiner1 = new StringJoiner(",", "[", "]");
joiner1.add("A").add("B"); StringJoiner joiner2 = new StringJoiner("+", "<", ">");
joiner2.add("1").add("2");joiner1.merge(joiner2); 
System.out.println(joiner1.toString()); // 輸出：[A,B,1+2]

3. ?setEmptyValue(CharSequence emptyValue)

設置當無元素時的默認返回值，避免空輸出。

StringJoiner joiner = new StringJoiner("/");
joiner.setEmptyValue("暫無數據");
System.out.println(joiner.toString()); // 輸出：暫無數據

4. ?toString()

生成最終字符串，自動添加前后綴并移除末尾多余的分隔符。

StringJoiner joiner = new StringJoiner(", ", "{ ", " }");
joiner.add("Name").add("Age").add("City");
System.out.println(joiner.toString()); // 輸出：{ Name, Age, City }

三、實戰場景與進階技巧

1. ?與Stream API結合

將集合快速轉換為格式化字符串。

List<String> list = Arrays.asList("北京", "上海", "廣州");
String result = list.stream().collect(Collectors.joining(", ", "Cities: [", "]"));
System.out.println(result); // 輸出：Cities: [北京, 上海, 廣州]

2. ?處理空值或過濾元素

靈活跳過無效數據。

List<String> data = Arrays.asList("Java", "", "Python", null);
StringJoiner joiner = new StringJoiner("; ");
data.stream().filter(str -> str != null && !str.isEmpty()).forEach(joiner::add);
System.out.println(joiner.toString()); // 輸出：Java; Python

四、注意事項

1. ?版本兼容性：需Java 8及以上環境。
2. ?空值處理：默認允許添加null，但會轉換為字符串"null"，建議提前過濾。
3. ?性能：底層依賴StringBuilder，適用于常規數據量，超大數據建議直接操作StringBuilder。

結語

StringJoiner以極簡的設計解決了字符串拼接中的常見痛點，尤其在與Stream API結合時，能大幅提升代碼的簡潔性和可維護性。無論是日志格式化、數據導出，還是動態查詢構建，掌握StringJoiner都能讓你的代碼更加優雅高效。