Joiner
Guava Joiner
顧名思義就是將字符串連接起來
Joiner joiner = Joiner.on("; ").skipNulls();
System.out.println(joiner.join("Harry", null, "Ron", "Hermione"));
//可以傳集合、數組或多個參數
List<Integer> nums = List.of(1, 2, 3, 4, 5);
System.out.println(joiner.join(nums));
輸出：
Harry; Ron; Hermione
1; 2; 3; 4; 5
上面代碼中忽略了 null 也可以將 null 替換為其他字符串，比如：
System.out.println(Joiner.on("; ").useForNull("**").join(1,2,3,null));
Joiner 是線程安全的，一般你可以定義一個 static final的常量：
static final Joiner joiner = Joiner.on(",");
還可以將 map 也 join 起來：
Joiner.MapJoiner mapJoiner = Joiner.on("; ").withKeyValueSeparator("|");
Map<String, Integer> testMap = Map.of("a", 1, "b", 2);
System.out.println(mapJoiner.join(testMap));
輸出：
b|2; a|1
其他 Joiner
JDK 自身也有 String 的 Joiner API：
String PREFIX = "[";
String SUFFIX = "]";
StringJoiner jdkJoiner = new StringJoiner(",");
StringJoiner jdkJoiner2 = new StringJoiner(
",", PREFIX, SUFFIX);
System.out.println(jdkJoiner2.add("a").add("b").add("c").toString());
可以添加前、后綴，但元素只能一個一個 add，沒有 guava 方便 。
如果你是簡單的 join 需求，使用 JDK8 以后的 API，直接用 Stream 就完了。
//use JAVA8 stream
List<String> rgbList = Arrays.asList("Red", "Green", "Blue");
String commaSeparatedRGB = rgbList.stream()
.map(color -> color.toString())
.collect(Collectors.joining(","));
System.out.println(commaSeparatedRGB);
總結
簡單 join 直接 stream 流式一行代碼搞定，特殊點的看看 Guava 的 joiner 支不支持，一般 Guava 的 Joiner 夠用了。再搞不定的自己寫個工具類方法吧。
Splitter
JDK 內建
JDK 內建的字符串拆分工具有一些古怪的特性。比如，String.split悄悄丟棄了尾部的分隔符。
System.out.println(Arrays.toString(",a,,b,".split(",")));
//輸出 [, a, , b]
當然還有 StringTokenizer 這種更繁瑣的東西：
String str = "runoob,google,taobao,facebook,zhihu";
// 以 , 號為分隔符來分隔字符串
StringTokenizer st=new StringTokenizer(str,",");
while(st.hasMoreTokens()) {
System.out.println(st.nextToken());
}
Guava Splitter
Splitter使用令人放心的、直白的流暢 API 模式對這些混亂的特性作了完全的掌控。
Iterable<String> split = Splitter.on(',')
.trimResults()
.omitEmptyStrings()
.split("foo,bar,, qux");
System.out.println(split.toString());
//輸出 [foo, bar, qux]
Splitter 可以被設置為按照任何 Pattern, char, String, 或者 CharMatcher拆分。
方法 描述 范例 Splitter.on(char) 按單個字符拆分 Splitter.on(';') Splitter.on(CharMatcher) 按字符匹配器拆分 Splitter.on(CharMatcher.anyOf(";,.")) Splitter.on(String) 按字符串拆分 Splitter.on(",") Splitter.on(Pattern) Splitter.onPattern(String) 按正則表達式拆分 Splitter.onPattern("r?n") Splitter.fixedLength(int) 按固定長度拆分；最后一段可能比給定長度短，但不會為空。 Splitter.fixedLength(3)
列舉一些 Splitter 的方法
方法 描述 omitEmptyStrings() 從結果中自動忽略空字符串 trimResults() 移除結果字符串的前導空白和尾部空白 trimResults(CharMatcher) 給定匹配器，移除結果字符串的前導匹配字符和尾部匹配字符 limit(int) 限制拆分出的字符串數量
注意 trimResults(CharMatcher) ，它是把所有前導字符干掉外加尾部能匹配上的字符，舉個例子：
// 可以看到，前綴都沒了，尾部與 “_” 匹配上的只有 “c__”，所以干掉了一個 “_”，剩下 “c_”
System.out.println(Splitter.on(',').trimResults(CharMatcher.is('_')).split("_a ,_b_ ,c__").toString());
上面的代碼返回 ：[a , b_ , c] ，
同 Joiner 一樣，Splitter實例也是線程安全的，所以可以定義為 static final
static final Splitter splitter = Splitter.on(",").omitEmptyStrings().trimResults();
還可以利用 MapSplitter 把字符串反序列化成 Map，例如：
@Test
public void testMapSplitter() {
String startSring = "Washington D.C=Redskins#New York City=Giants#Philadelphia=Eagles#Dallas=Cowboys";
Map<String, String> testMap = Maps.newLinkedHashMap();
testMap.put("Washington D.C", "Redskins");
testMap.put("New York City", "Giants");
testMap.put("Philadelphia", "Eagles");
testMap.put("Dallas", "Cowboys");
Splitter.MapSplitter mapSplitter = Splitter.on("#").withKeyValueSeparator("=");
Map<String, String> splitMap = mapSplitter.split(startSring);
assertEquals(testMap, splitMap);
}
CharMatcher
Guava 為我們提供了字符匹配器，你可以認為一個CharMatcher實例代表著某一類字符，如數字或空白字符。CharMatcher 還提供了一系列方法，讓你對字符進行特定類型的操作：修剪 [trim]、折疊 [collapse]、移除 [remove]、保留 [retain] 等等。
所以使用 CharMatcher，大致分兩步
- 第一步：定義 CharMatcher，定義怎樣算“匹配” 到字符
- 第二步：如何處理匹配到的這些字符
下面我們用一些小例子來說明：
將 " 1 2 3 4 6 9 " 轉換成 "1 2 3 4 6 9" 去掉多余的空格，用空格間隔每個字符
// 我們先定義“空白” 然后折疊連續的空白并用一個空格代替，同時修剪掉首尾的空格
String tmpStr = " 1 2 3 4 6 9 " ;
String result = CharMatcher.whitespace().trimAndCollapseFrom(tmpStr,' ');
System.out.println(result);
獲取 0-6 范圍內的數字字符
String tmpStr = "df67sn18kj9" ;
String result = CharMatcher.inRange('0','6').retainFrom(tmpStr) ;
System.out.println( result);
獲取 d-k 范圍內的數字字符
String tmpStr = "df67sn18kj9" ;
String result = CharMatcher.inRange('d','k').retainFrom(tmpStr) ;
System.out.println( result);
去掉特殊字符
String input = "H*el.lo,}12";
CharMatcher matcher = CharMatcher.javaLetterOrDigit();
String result = matcher.retainFrom(input);
assertEquals("Hello12", result);
去掉非 ASCII 碼字符
String input = "あ hello?";
String result = CharMatcher.ascii().retainFrom(input);
assertEquals("hello", result);
result = CharMatcher.inRange('0', 'z').retainFrom(input);
assertEquals("hello", result);
過濾或篩選字符串中的漢字
//單字節匹配器（漢字是雙字節） 不要漢字
System.out.println("去除雙字節，獲取單字節：" + CharMatcher.singleWidth().retainFrom(matchStr));
//只留漢字
System.out.println("去除單字節，獲取雙字節：" + CharMatcher.singleWidth().removeFrom(matchStr));
方法分類
看完上面的例子，你可能對 CharMatcher 的方法感興趣了，CharMatcher 一類分三類
第一類是判定型函數，判斷 Charmacher 和入參字符串的匹配關系。
CharMatcher.is('a').matchesAllOf("aaa");//true
CharMatcher.is('a').matchesAnyOf("aba");//true
CharMatcher.is('a').matchesNoneOf("aba");//true
第二類是計數型函數，查找入參字符串中第一次、最后一次出現目標字符的位置，或者目標字符出現的次數，比如 indexIn，lastIndexIn 和 countIn。
CharMatcher.is('a').countIn("aaa"); // 3
CharMatcher.is('a').indexIn("java"); // 1
第三類就是對匹配字符的操作。包括 removeFrom、retainFrom、replaceFrom、trimFrom、collapseFrom 等。
方法清單
拉個單子方便查
CaseFormat
CaseFormat 被用來方便地在各種 ASCII 大小寫規范間轉換字符串——比如，編程語言的命名規范。CaseFormat 支持的格式如下：
格式 范例 LOWER_CAMEL lowerCamel LOWER_HYPHEN lower-hyphen LOWER_UNDERSCORE lower_underscore UPPER_CAMEL UpperCamel UPPER_UNDERSCORE UPPER_UNDERSCORE
CaseFormat 的用法很直接：
CaseFormat.UPPER_UNDERSCORE.to(CaseFormat.LOWER_CAMEL, "CONSTANT_NAME")); // returns "constantName"
CaseFormat 在某些時候尤其有用，比如編寫代碼生成器的時候。
Strings
Strings 工具類也提供了許多好用的處理字符串的方法，比如簡單和見名知義就不多說了。
參考
- https://www.runoob.com/w3cnote/java-stringtokenizer-intro.html
- https://www.baeldung.com/guava-string-charmatcher
- https://github.com/google/guava/wiki/StringsExplained#splitter
- https://mindawei.github.io/2018/03/17/Guava 學習之 CharMatcher/
