1. 從一次“丑陋”的字符串拼接說起如果你寫過Java肯定干過這事兒把一堆字符串用某個分隔符比如逗號、橫杠拼接起來。最原始的做法可能就是用一個StringBuilder然后手動判斷是不是最后一個元素來決定要不要加分隔符。代碼寫出來大概是這個味兒ListString cities Arrays.asList(北京, 上海, 廣州, 深圳); StringBuilder sb new StringBuilder(); for (int i 0; i cities.size(); i) { sb.append(cities.get(i)); if (i cities.size() - 1) { sb.append(, ); } } String result sb.toString(); // 結果是“北京, 上海, 廣州, 深圳”這段代碼功能上沒問題但說實話有點啰嗦而且容易出錯。每次循環都要判斷索引一不小心就可能多一個或少一個分隔符。后來String.join()方法出現了對于集合或數組的拼接確實清爽了不少String result String.join(, , cities);String.join()很好但它有個局限它只接受一個CharSequence類型的可變參數或者一個Iterable。如果你想在拼接的結果前后加上前綴和后綴比如生成一個JSON數組字符串[北京, 上海, 廣州, 深圳]String.join()就無能為力了你最終還是得回到StringBuilder的老路上去。正是為了解決這種“格式化拼接”的需求并且提供一個比手動操作StringBuilder更優雅、更安全的APIJava 8 引入了StringJoiner這個類。它的名字直白地告訴了你它的工作專門用來“連接字符串”。但它的能力遠不止簡單的連接。很多人包括一些工作了幾年的開發者可能只是知道有這么個類或者僅限于在String.join()的內部實現里見過它并沒有真正去深入了解過它。今天我們就來徹底拆解一下這個看似簡單實則精巧的工具類。2. StringJoiner的核心三板斧構造、添加與合并StringJoiner的設計遵循了“單一職責”和“流暢接口”的原則它的API非常簡潔核心方法就幾個。我們先從最基礎的用法看起。2.1 構造函數與基礎狀態StringJoiner有兩個構造函數// 構造函數1只指定分隔符 StringJoiner sj new StringJoiner(, ); // 構造函數2指定分隔符、前綴和后綴 StringJoiner sj new StringJoiner(, , [, ]);第一個構造函數創建了一個只有分隔符的拼接器。此時它的“前綴”和“后綴”都是空字符串。第二個構造函數則完整地定義了拼接的格式每個元素之間用分隔符隔開整個結果字符串以指定的前綴開頭以后綴結尾。這直接解決了我們前面提到的生成JSON數組字符串的需求。這里有一個極易被忽略但非常重要的細節StringJoiner內部維護了一個StringBuilder實例名為value來真正構建字符串同時還維護了兩個String類型的變量prefix前綴和suffix后綴。關鍵在于前綴和后綴只在最終調用toString()方法生成結果時才會被添加到value的前后。在中間添加元素的過程中value里存儲的只是“已添加的元素分隔符”。2.2 add() 方法智能添加元素add()方法是往StringJoiner里添加新元素的主要方式StringJoiner sj new StringJoiner(, , [, ]); sj.add(北京); sj.add(上海);它的內部邏輯非常聰明第一次調用add(“北京”)時因為value是空的它不會先加分隔符而是直接追加“北京”。此時value北京。第二次調用add(“上海”)時它發現value不為空了于是先追加分隔符, 再追加“上海”。此時value北京, 上海。這種“非首次添加時自動補分隔符”的邏輯徹底把我們從手動判斷索引的繁瑣中解放了出來。這也是StringJoiner比手動使用StringBuilder優雅的核心所在。實操心得add()方法接受的是CharSequence這意味著你不僅可以傳String還可以傳StringBuilder、StringBuffer等。但要注意如果傳入null它會被轉換成字符串null追加進去。如果你不希望這樣需要在調用add()之前自己做空值判斷。2.3 merge() 方法拼接器的“合并”這是StringJoiner一個非常強大但常被低估的功能。merge()方法允許你將另一個StringJoiner的內容合并到當前這個里面。StringJoiner sj1 new StringJoiner(, , [, ]); sj1.add(北京).add(上海); StringJoiner sj2 new StringJoiner(-, (, )); sj2.add(廣州).add(深圳); sj1.merge(sj2); System.out.println(sj1.toString()); // 輸出[北京, 上海, 廣州, 深圳]注意看輸出結果。sj1合并了sj2的所有元素內容“廣州”和“深圳”但是忽略了sj2的前綴(和后綴)。合并時如果sj1的value不為空且sj2的value也不為空sj1會先追加自己的分隔符然后把sj2.value的整個字符串內容追加過來。merge()的設計意圖是用于組合多個相同格式的字符串片段。例如你可能有多個方法各自返回一個拼接了部分結果的StringJoiner最后你可以用一個主StringJoiner把它們全部merge()起來得到完整結果。踩坑提示merge()方法不會改變當前StringJoiner的分隔符、前綴和后綴。它只合并“內容”。這意味著如果你試圖合并一個分隔符不同的StringJoiner最終結果里可能會出現多種分隔符混用的情況這通常不是你想要的效果。所以merge()最好用在多個相同配置的StringJoiner之間。2.4 toString() 與 setEmptyValue()toString()方法的行為是理解StringJoiner的另一個關鍵點如果StringJoiner內部從未添加過任何元素即value為空那么toString()會返回一個“空值字符串”默認是prefix suffix。對于new StringJoiner(, , “[, “]”)空值時返回[]。如果添加過元素則返回prefix value suffix。有時候這個默認的空值結果可能不是你想要的。比如你希望當沒有元素時返回一個空字符串或者返回一個特定的提示如“無”。這時就可以用setEmptyValue()方法StringJoiner sj new StringJoiner(, ); sj.setEmptyValue(暫無數據); System.out.println(sj.toString()); // 輸出暫無數據 sj.add(數據1); System.out.println(sj.toString()); // 輸出數據1這里有一個非常重要的注意事項setEmptyValue()設置的字符串僅在StringJoiner為空value長度為0時toString()方法才會返回它。一旦你添加了任何元素toString()就會忽略這個設置按照prefixvaluesuffix的規則返回。這個方法常用于生成對用戶更友好的空狀態提示。3. 深入源碼看StringJoiner如何優雅工作理解一個類最好的方式就是看它的源碼。StringJoiner的源碼非常短小精悍不到200行我們挑核心部分看看。核心字段private final String prefix; // 前綴 private final String delimiter; // 分隔符 private final String suffix; // 后綴 private StringBuilder value; // 真正構建字符串的地方 private String emptyValue; // 空值時的默認字符串構造函數public StringJoiner(CharSequence delimiter) { this(delimiter, , ); // 調用另一個構造前綴后綴設為空字符串 } public StringJoiner(CharSequence delimiter, CharSequence prefix, CharSequence suffix) { // 關鍵對參數進行非空檢查并轉換為String存儲 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(); // 初始化emptyValue為 prefix suffix this.emptyValue this.prefix this.suffix; }可以看到前綴、分隔符、后綴在構造時就被確定并轉換為String存儲下來且不可變final。這保證了StringJoiner實例行為的確定性。add() 方法public StringJoiner add(CharSequence newElement) { prepareBuilder().append(newElement); return this; } private StringBuilder prepareBuilder() { if (value ! null) { value.append(delimiter); // 非首次添加先加分隔符 } else { value new StringBuilder().append(prefix); // 首次添加先加前綴 } return value; }prepareBuilder()是精髓所在。它處理了是否首次添加的邏輯并保證了前綴只在第一次添加元素時才被放入value。注意這里放入value的前綴在最終toString()時還會不會再加一次呢我們看toString()就明白了。toString() 方法public String toString() { if (value null) { return emptyValue; // 從未添加元素返回空值字符串 } else { // 如果后綴不為空才需要追加后綴 if (suffix.equals()) { return value.toString(); } else { // 追加后綴并轉換為String返回 int initialLength value.length(); String result value.append(suffix).toString(); // 將value回退到追加后綴之前的狀態以便后續繼續add value.setLength(initialLength); return result; } } }這里揭示了幾個關鍵點空值判斷以value是否為null為依據。后綴處理如果后綴不是空字符串toString()會在返回結果前臨時將后綴追加到value的末尾生成結果字符串然后再把value的長度設回之前的狀態setLength。這是一個非常巧妙的設計它保證了多次調用toString()不會重復追加后綴同時value本身并不永久包含后綴后續還可以繼續add()元素。前綴去哪了回顧prepareBuilder()前綴在第一次add()時就已經被加到value里了。所以對于非空的StringJoinervalue里已經包含了前綴和所有元素及分隔符。toString()只需要處理后綴即可。通過閱讀源碼我們就能徹底明白為什么StringJoiner能如此優雅地處理前綴、后綴和分隔符其內部的StringBuilder(value) 的狀態管理是核心。4. 實戰場景不止于集合拼接很多人以為StringJoiner只能用來拼接集合那就太小看它了。它的應用場景非常靈活。4.1 場景一構建動態SQL或查詢條件這是后端開發中非常常見的場景。我們需要根據前端傳入的多個條件動態拼接SQL的WHERE子句。public String buildQueryCondition(ListString tags, String author, Date startDate) { StringJoiner whereClause new StringJoiner( AND , WHERE , ); if (tags ! null !tags.isEmpty()) { // 假設tags需要構建成 IN (?, ?, ?) 的形式 StringJoiner placeholders new StringJoiner(, , (, )); tags.forEach(tag - placeholders.add(?)); whereClause.add(tags IN placeholders.toString()); } if (author ! null !author.trim().isEmpty()) { whereClause.add(author ?); } if (startDate ! null) { whereClause.add(create_time ?); } // 如果沒有條件whereClause.toString() 會返回空字符串因為setEmptyValue默認是 return whereClause.toString(); }使用StringJoiner我們可以清晰地以“AND”為分隔符構建條件子句并且自動處理了是否添加“WHERE”關鍵字的問題如果沒有條件toString()返回空字符串整個WHERE子句就不會出現。4.2 場景二生成特定格式的日志或消息當需要生成結構化的日志行或者組裝一個給用戶看的復合消息時StringJoiner很好用。public String formatLogEntry(String level, String clazz, String method, String message) { // 格式[LEVEL] ClassName#MethodName - Message return new StringJoiner( ) .add([ level ]) .add(clazz # method) .add(-) .add(message) .toString(); } // 使用 String log formatLogEntry(ERROR, UserService, login, Authentication failed for user: admin); // 輸出[ERROR] UserService#login - Authentication failed for user: admin4.3 場景三替代復雜的StringBuilder手動拼接任何你覺得用StringBuilder寫起來需要頻繁判斷分隔符是否該加、前綴后綴該怎么處理的地方都可以考慮用StringJoiner來簡化。// 傳統StringBuilder方式容易出錯 StringBuilder pathBuilder new StringBuilder(); pathBuilder.append(/api); if (version ! null) { pathBuilder.append(/v).append(version); } pathBuilder.append(/users); if (userId ! null) { pathBuilder.append(/).append(userId); } // 需要小心處理多余的斜杠 // 使用StringJoiner清晰且安全 StringJoiner pathJoiner new StringJoiner(/, /, ); pathJoiner.add(api); if (version ! null) { pathJoiner.add(v version); } pathJoiner.add(users); if (userId ! null) { pathJoiner.add(userId); } String path pathJoiner.toString(); // 例如/api/v1/users/123用StringJoiner來構建URL路徑或文件路徑邏輯一目了然完全不用擔心多余或缺少分隔符的問題。5. 性能考量與最佳實踐雖然StringJoiner的代碼很簡潔但作為一個工具類我們還是會關心它的性能。本質上它是對StringBuilder的一層封裝所以其性能特征與StringBuilder基本一致。5.1 與StringBuilder和String.join()的對比vs 手動StringBuilder在功能等價的前提下StringJoiner的性能開銷微乎其微多了一層方法調用和空值判斷。它帶來的代碼簡潔性和可維護性提升遠遠超過這點性能損耗。在絕大多數業務場景下應優先使用StringJoiner。vs String.join()String.join()內部就是使用StringJoiner實現的。對于簡單的、無前綴后綴的集合拼接直接使用String.join()是最簡潔的。String.join()是一個靜態工具方法而StringJoiner是一個對象后者在需要多次add或復雜格式控制時更靈活。5.2 預分配StringBuilder大小StringJoiner內部的StringBuilder在初始化時如果沒有內容其value是null。第一次添加元素時會創建一個默認容量16字符的StringBuilder。如果你能預估最終字符串的大致長度可以通過一個“小技巧”來優化先添加一個空字符串然后獲取內部的StringBuilder來預分配容量。ListString largeList // ... 一個包含很多字符串的列表 StringJoiner sj new StringJoiner(, ); if (!largeList.isEmpty()) { sj.add(); // 先添加一個空元素觸發內部StringBuilder的創建 // 預估容量 (平均字符串長度 分隔符長度) * 數量 int estimatedCapacity (10 2) * largeList.size(); // 注意這里是一個hack直接訪問了非公開的字段。實際中不推薦僅作原理演示。 // sj.value.ensureCapacity(estimatedCapacity); // 更實際的做法是如果你知道大概大小直接用StringBuilder可能更直接。 } // 然后正常添加largeList里的元素重要提示上面的代碼中直接訪問sj.value是不可行的因為value是私有字段。這里只是為了說明原理。實際上StringJoiner并沒有提供直接設置初始容量的公共API。對于極高性能敏感的場景如果你確需控制初始容量可能需要回歸到直接使用StringBuilder并手動管理分隔符邏輯。但這屬于非常極端的優化99%的情況下不需要考慮。5.3 線程安全和StringBuilder一樣StringJoiner不是線程安全的。如果多個線程同時操作同一個StringJoiner實例會導致不確定的結果。在并發環境下每個線程應該使用自己獨立的StringJoiner實例。6. 常見“坑”與最佳實踐總結即使是一個簡單的工具類用不好也會踩坑。下面是一些實踐中總結出來的要點。6.1 空值null處理策略StringJoiner.add(null)會把null這個字符串加進去。這有時是符合預期的比如日志記錄但有時可能不是。你需要根據業務邏輯決定是否在調用add前進行空值過濾。// 如果你不希望null被拼接進去 items.stream() .filter(Objects::nonNull) // 過濾null .forEach(sj::add);6.2 小心分隔符中的空格分隔符是一個CharSequence它可以是任意字符序列。常用的分隔符如, 逗號加空格、 - 橫杠加空格。定義分隔符時一定要想清楚你是否需要這些空格。例如在拼接URL路徑時分隔符/就不能有空格。6.3 merge() 的語義陷阱再次強調merge()只合并另一個StringJoiner的內容即其內部value字符串而忽略其前綴、后綴和分隔符。不要誤以為合并后格式也會統一。合并具有不同分隔符的StringJoiner通常會產生混亂的結果。6.4 與Stream API的完美結合StringJoiner和Java 8的Stream API是天作之合。Collectors.joining()收集器的底層實現就是StringJoiner。ListString list Arrays.asList(a, b, c); // 等價于使用StringJoiner String result1 list.stream().collect(Collectors.joining(, , [, ])); // 手動使用StringJoiner StringJoiner sj new StringJoiner(, , [, ]); list.forEach(sj::add); String result2 sj.toString(); // result1 和 result2 都是 [a, b, c]在流式處理中直接使用Collectors.joining()是更函數式、更簡潔的選擇。6.5 清晰勝于巧妙雖然StringJoiner的鏈式調用sj.add(“a”).add(“b”).add(“c”)很流暢但為了代碼可讀性如果添加邏輯很復雜夾雜很多條件判斷適當換行或使用臨時變量會讓代碼更清晰。// 清晰的寫法 StringJoiner sj new StringJoiner(\n); if (conditionA) { sj.add(generatePartA()); } if (conditionB) { sj.add(generatePartB()); } // ... 更多條件 return sj.toString();StringJoiner是一個典型的“小工具大用處”的JDK類。它沒有驚天動地的功能但通過一個精巧的設計解決了字符串拼接中的一個特定痛點并極大地提升了代碼的簡潔性和表達力。下次當你下意識地敲出StringBuilder來拼接帶分隔符的字符串時不妨先停下來想一想用StringJoiner是不是更合適理解和善用這些標準庫提供的精良工具正是我們寫出更優雅、更健壯代碼的關鍵一步。