Google Guava 字符串工具使用详解

川长思鸟来 2024-02-17 09:50 117阅读 0赞

#### 文章目录 ####

*  字符串工具
 *   *  \- Strings
     *  \- Joiner
     *  \- Splitter
     *  \- CharMatcher
     *  \- CaseFormat

--------------------

## 字符串工具 ##

<table> 
 <thead> 
  <tr> 
   <th align="left">工具类</th> 
   <th align="left">描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">Strings</td> 
   <td align="left">用于对字符串进行各种操作，例如判空、拼接、截取、填充等</td> 
  </tr> 
  <tr> 
   <td align="left">Joiner</td> 
   <td align="left">用于将多个元素连接成一个字符串，并且可以指定连接符和处理null值的方式</td> 
  </tr> 
  <tr> 
   <td align="left">Splitter</td> 
   <td align="left">用于将一个字符串分割成多个部分，可以指定分隔符和分割结果的处理方式</td> 
  </tr> 
  <tr> 
   <td align="left">CharMatcher</td> 
   <td align="left">用于对字符进行匹配和操作</td> 
  </tr> 
  <tr> 
   <td align="left">CaseFormat</td> 
   <td align="left">用于不同命名格式之间的转换，例如驼峰命名、大写下划线命名、小写连字符命名等</td> 
  </tr> 
 </tbody> 
</table>

### \- Strings ###

**Strings类提供了一系列静态方法，用于对字符串进行各种操作，例如判空、拼接、截取、填充等。**

**主要方法：**

<table> 
 <thead> 
  <tr> 
   <th align="left">方法</th> 
   <th align="left">描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">isNullOrEmpty(String)</td> 
   <td align="left">判断字符串是否为null或空字符串。</td> 
  </tr> 
  <tr> 
   <td align="left">emptyToNull(String)</td> 
   <td align="left">将空字符串转换为null。</td> 
  </tr> 
  <tr> 
   <td align="left">nullToEmpty(String)</td> 
   <td align="left">将null转换为空字符串。</td> 
  </tr> 
  <tr> 
   <td align="left">repeat(String, int)</td> 
   <td align="left">指定字符串重复次数。</td> 
  </tr> 
  <tr> 
   <td align="left">padStart(String, int, char)</td> 
   <td align="left">在字符串的开头填充指定字符到指定长度。</td> 
  </tr> 
  <tr> 
   <td align="left">padEnd(String, int, char)</td> 
   <td align="left">在字符串的结尾填充指定字符到指定长度。</td> 
  </tr> 
  <tr> 
   <td align="left">commonPrefix(CharSequence, CharSequence)</td> 
   <td align="left">获取两个字符串的最长公共前缀。</td> 
  </tr> 
  <tr> 
   <td align="left">commonSuffix(CharSequence, CharSequence)</td> 
   <td align="left">获取两个字符串的最长公共后缀。</td> 
  </tr> 
 </tbody> 
</table>

**使用示例：**

public static void main(String[] args) {
        
            boolean b1 = Strings.isNullOrEmpty("");
            System.out.println("字符串是否为null或空字符串：" +b1);
    
            String b2 = Strings.emptyToNull("aa");
            System.out.println("将空字符串转换为null：" +b2);
    
            String b3 = Strings.emptyToNull("");
            System.out.println("将空字符串转换为null：" +b3);
    
            String b4 = Strings.repeat("123", 5);
            System.out.println("指定字符串重复次数：" +b4);
    
            String b5 = Strings.padStart("99", 5, '0');
            System.out.println("在字符串的开头填充指定字符到指定长度：" +b5);
    
            String b6 = Strings.padEnd("99", 5, '0');
            System.out.println("在字符串的结尾填充指定字符到指定长度：" +b6);
    
            String b7 = Strings.commonPrefix("abc666", "ab1555");
            System.out.println("获取两个字符串的最长公共前缀：" +b7);
    
            String b8 = Strings.commonSuffix("sds", "dfh345sds");
            System.out.println("获取两个字符串的最长公共后缀：" +b8);
        }

日志

字符串是否为null或空字符串：true
    将空字符串转换为null：aa
    将空字符串转换为null：null
    指定字符串重复次数：123123123123123
    在字符串的开头填充指定字符到指定长度：00099
    在字符串的结尾填充指定字符到指定长度：99000
    获取两个字符串的最长公共前缀：ab
    获取两个字符串的最长公共后缀：sds

### \- Joiner ###

**Joiner类用于将多个元素连接成一个字符串，并且可以指定连接符和处理null值的方式。**

**主要方法：**

<table> 
 <thead> 
  <tr> 
   <th align="left">方法</th> 
   <th align="left">描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">on(char)</td> 
   <td align="left">指定分隔符。</td> 
  </tr> 
  <tr> 
   <td align="left">join(Iterable)</td> 
   <td align="left">将可迭代对象中的元素连接成一个字符串。</td> 
  </tr> 
  <tr> 
   <td align="left">join(Object[])</td> 
   <td align="left">将对象数组连接成一个字符串。</td> 
  </tr> 
  <tr> 
   <td align="left">join(Object…)</td> 
   <td align="left">将多个对象连接成一个字符串。</td> 
  </tr> 
  <tr> 
   <td align="left">skipNulls()</td> 
   <td align="left">忽略null值。</td> 
  </tr> 
  <tr> 
   <td align="left">useForNull(String)</td> 
   <td align="left">指定在连接过程中将null值替换为指定字符串。</td> 
  </tr> 
 </tbody> 
</table>

**使用示例：**

public static void main(String[] args) {
        
            String s1 = Joiner.on(",").join(Arrays.asList("A", "B", "C"));
            System.out.println("将可迭代对象中的元素连接成一个字符串："+s1);
    
            String s2 = Joiner.on(",").join(Stream.of("A", "B", "C").toArray());
            System.out.println("将数组连接成一个字符串："+s2);
    
            String s3 = Joiner.on(",").join("A", "B", "C");
            System.out.println("将可变参数连接成一个字符串："+s3);
    
            String s4 = Joiner.on(",").useForNull("666").join("A", "B", null, "C");
            System.out.println("连接过程将null值替换为指定字符串："+s4);
    
            String s5 = Joiner.on(",").skipNulls().join("A", "B", null, "C");
            System.out.println("连接过程忽略null值："+s5);
        }

日志

已连接到目标 VM, 地址: ''127.0.0.1:56398'，传输: '套接字''
    将可迭代对象中的元素连接成一个字符串：A,B,C
    将数组连接成一个字符串：A,B,C
    将可变参数连接成一个字符串：A,B,C
    连接过程将null值替换为指定字符串：A,B,666,C
    连接过程忽略null值：A,B,C

### \- Splitter ###

**Splitter类用于将一个字符串分割成多个部分，可以指定分隔符和分割结果的处理方式。**

**主要方法：**

<table> 
 <thead> 
  <tr> 
   <th align="left">方法</th> 
   <th align="left">描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">on(char separator)</td> 
   <td align="left">指定单个字符作为分隔符。</td> 
  </tr> 
  <tr> 
   <td align="left">on(CharMatcher separatorMatcher)</td> 
   <td align="left">使用 CharMatcher 指定分隔符。</td> 
  </tr> 
  <tr> 
   <td align="left">on(final String separator)</td> 
   <td align="left">指定字符串作为分隔符。</td> 
  </tr> 
  <tr> 
   <td align="left">on(Pattern separatorPattern)</td> 
   <td align="left">使用正则表达式指定分隔符进行分割。</td> 
  </tr> 
  <tr> 
   <td align="left">onPattern(String separatorPattern)</td> 
   <td align="left">使用正则表达式指定分隔符进行分割。</td> 
  </tr> 
  <tr> 
   <td align="left">omitEmptyStrings()</td> 
   <td align="left">忽略结果中的空字符串。</td> 
  </tr> 
  <tr> 
   <td align="left">trimResults()</td> 
   <td align="left">去除结果字符串的前导和尾部空白字符。</td> 
  </tr> 
  <tr> 
   <td align="left">trimResults(CharMatcher trimmer)</td> 
   <td align="left">使用 CharMatcher 去除结果字符串的前导和尾部空白字符。</td> 
  </tr> 
  <tr> 
   <td align="left">limit(int)</td> 
   <td align="left">限制分割的结果数量。</td> 
  </tr> 
  <tr> 
   <td align="left">withKeyValueSeparator(String separator)</td> 
   <td align="left">用于指定键值对的分隔符。</td> 
  </tr> 
  <tr> 
   <td align="left">withKeyValueSeparator(char separator)</td> 
   <td align="left">用于指定键值对的分隔符。</td> 
  </tr> 
  <tr> 
   <td align="left">withKeyValueSeparator(Splitter keyValueSplitter)</td> 
   <td align="left">用于指定键值对的分隔符。</td> 
  </tr> 
  <tr> 
   <td align="left">split(final CharSequence sequence)</td> 
   <td align="left">将字符序列分割为多个部分。</td> 
  </tr> 
  <tr> 
   <td align="left">splitToList(CharSequence sequence)</td> 
   <td align="left">将字符序列分割为列表形式的结果。</td> 
  </tr> 
  <tr> 
   <td align="left">splitToStream(CharSequence sequence)</td> 
   <td align="left">将字符序列分割为流形式的结果。</td> 
  </tr> 
 </tbody> 
</table>

**使用示例：**

public static void main(String[] args) {
        
            // 指定逗号作为分隔符，并忽略空字符串和去除前导和尾部空白字符
            String input = "apple, banana, ,orange,  ";
            Iterable<String> result = Splitter.on(',')
                    .omitEmptyStrings()
                    .trimResults()
                    .split(input);
            for (String s : result) {
        
                System.out.println(s);
            }
            System.out.println("------------------------------------------");
            // 使用正则表达式作为分隔符，并将字符串分割为数字部分和非数字部分
            input = "a1b2c3d4e5";
            result = Splitter.onPattern("\\d")
                    .split(input);
            for (String s : result) {
        
                System.out.println(s);
            }
        }

日志

apple
    banana
    orange
    ------------------------------------------
    a
    b
    c
    d
    e

### \- CharMatcher ###

**CharMatcher类用于对字符进行匹配和操作。**

**主要方法：**

<table> 
 <thead> 
  <tr> 
   <th align="left">方法</th> 
   <th align="left">描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">anyOf(String chars)</td> 
   <td align="left">匹配给定字符串中的任意字符。</td> 
  </tr> 
  <tr> 
   <td align="left">inRange(char startInclusive, char endInclusive)</td> 
   <td align="left">匹配在给定范围内的字符。</td> 
  </tr> 
  <tr> 
   <td align="left">is(char match)</td> 
   <td align="left">匹配与给定字符相同的字符。</td> 
  </tr> 
  <tr> 
   <td align="left">isNot(char match)</td> 
   <td align="left">匹配与给定字符不同的字符。</td> 
  </tr> 
  <tr> 
   <td align="left">whitespace()</td> 
   <td align="left">匹配空白字符。</td> 
  </tr> 
  <tr> 
   <td align="left">collapseFrom(CharSequence sequence, char replacement)</td> 
   <td align="left">将匹配的字符替换为给定的字符。</td> 
  </tr> 
  <tr> 
   <td align="left">retainFrom(CharSequence sequence)</td> 
   <td align="left">保留匹配的字符，删除其他字符。</td> 
  </tr> 
  <tr> 
   <td align="left">removeFrom(CharSequence sequence)</td> 
   <td align="left">删除匹配的字符。</td> 
  </tr> 
  <tr> 
   <td align="left">matchesAllOf(CharSequence sequence)</td> 
   <td align="left">判断字符序列是否完全匹配 CharMatcher。</td> 
  </tr> 
  <tr> 
   <td align="left">countIn(CharSequence sequence)</td> 
   <td align="left">统计字符序列中匹配的字符数量。</td> 
  </tr> 
  <tr> 
   <td align="left">trimFrom(CharSequence sequence)</td> 
   <td align="left">删除字符序列开头和结尾的匹配字符。</td> 
  </tr> 
  <tr> 
   <td align="left">trimLeadingFrom(CharSequence sequence)</td> 
   <td align="left">删除字符序列开头的匹配字符。</td> 
  </tr> 
  <tr> 
   <td align="left">trimTrailingFrom(CharSequence sequence)</td> 
   <td align="left">删除字符序列结尾的匹配字符。</td> 
  </tr> 
  <tr> 
   <td align="left">replaceFrom(CharSequence sequence, char replacement)</td> 
   <td align="left">将匹配的字符替换为给定的字符。</td> 
  </tr> 
  <tr> 
   <td align="left">trimAndCollapseFrom(CharSequence sequence, char replacement)</td> 
   <td align="left">删除字符序列开头和结尾的匹配字符，并将连续的匹配字符替换为给定的字符。</td> 
  </tr> 
  <tr> 
   <td align="left">replaceFrom(CharSequence sequence, char replacement)</td> 
   <td align="left">将匹配的字符替换为给定的字符。</td> 
  </tr> 
  <tr> 
   <td align="left">matchesNoneOf(CharSequence sequence)</td> 
   <td align="left">判断字符序列是否没有匹配 CharMatcher。</td> 
  </tr> 
  <tr> 
   <td align="left">indexIn(CharSequence sequence)</td> 
   <td align="left">返回第一个匹配字符的索引。</td> 
  </tr> 
  <tr> 
   <td align="left">indexOf(CharSequence sequence, int start)</td> 
   <td align="left">返回从指定索引开始的第一个匹配字符的索引。</td> 
  </tr> 
  <tr> 
   <td align="left">lastIndexIn(CharSequence sequence)</td> 
   <td align="left">返回最后一个匹配字符的索引。</td> 
  </tr> 
  <tr> 
   <td align="left">or(CharMatcher other)</td> 
   <td align="left">返回一个新的 CharMatcher，其匹配条件是原始 CharMatcher 和另一个 CharMatcher 条件的逻辑或关系。</td> 
  </tr> 
  <tr> 
   <td align="left">and(CharMatcher other)</td> 
   <td align="left">返回一个新的 CharMatcher，其匹配条件是原始 CharMatcher 和另一个 CharMatcher 条件的逻辑与关系。</td> 
  </tr> 
  <tr> 
   <td align="left">negate()</td> 
   <td align="left">返回一个新的 CharMatcher，其匹配条件是原始 CharMatcher 的否定。</td> 
  </tr> 
 </tbody> 
</table>

**使用示例：**

public static void main(String[] args) {
        
            String testString = "abc 123 def 456 ghi 789";
    
            // 匹配给定字符串中的任意字符
            CharMatcher anyOfMatcher = CharMatcher.anyOf("aeiou");
            System.out.println(anyOfMatcher.removeFrom(testString)); // 输出 bc 123 df 456 gh 789
    
            // 匹配在给定范围内的字符
            CharMatcher inRangeMatcher = CharMatcher.inRange('a', 'f');
            System.out.println(inRangeMatcher.removeFrom(testString)); // 输出 def 456 ghi 789
    
            // 匹配与给定字符相同的字符
            CharMatcher isMatcher = CharMatcher.is('o');
            System.out.println(isMatcher.countIn(testString)); // 输出 0
    
            // 匹配与给定字符不同的字符
            CharMatcher isNotMatcher = CharMatcher.isNot(' ');
            System.out.println(isNotMatcher.removeFrom(testString)); // 输出 abc123def456ghi789
    
            // 匹配空白字符
            CharMatcher whitespaceMatcher = CharMatcher.whitespace();
            System.out.println(whitespaceMatcher.trimFrom(testString)); // 输出 "abc 123 def 456 ghi 789"
    
            // 将匹配的字符替换为给定的字符
            CharMatcher digitMatcher = CharMatcher.digit();
            System.out.println(digitMatcher.replaceFrom(testString, '*')); // 输出 "abc *** def *** ghi ***"
    
            // 统计字符序列中匹配的字符数量
            CharMatcher anyMatcher = CharMatcher.any();
            System.out.println(anyMatcher.countIn(testString)); // 输出 20
    
            // 删除字符序列开头和结尾的匹配字符
            CharMatcher trimMatcher = CharMatcher.is(' ');
            System.out.println(trimMatcher.trimFrom(testString)); // 输出 "abc 123 def 456 ghi 789"
    
            // 删除字符序列开头的匹配字符
            CharMatcher leadingMatcher = CharMatcher.is('a');
            System.out.println(leadingMatcher.trimLeadingFrom(testString)); // 输出 "bc 123 def 456 ghi 789"
    
            // 删除字符序列结尾的匹配字符
            CharMatcher trailingMatcher = CharMatcher.is('9');
            System.out.println(trailingMatcher.trimTrailingFrom(testString)); // 输出 "abc 123 def 456 ghi 78"
    
            // 将匹配的字符替换为给定的字符
            CharMatcher replaceMatcher = CharMatcher.anyOf("aeiou");
            System.out.println(replaceMatcher.replaceFrom(testString, '*')); // 输出 "*b*c 123 d*f 456
    
    
            // 将字符序列中的多个连续匹配字符缩减为一个字符
            CharMatcher duplicateMatcher = CharMatcher.is(' ');
            String collapsedString = duplicateMatcher.collapseFrom(testString, ' ');
            System.out.println(collapsedString); // 输出 "abc 123 def 456 ghi 789"
    
            // 判断字符序列是否不包含任何匹配字符
            System.out.println(whitespaceMatcher.matchesNoneOf(testString)); // 输出 false
        }

日志：

bc 123 df 456 gh 789
     123  456 ghi 789
    0
         
    abc 123 def 456 ghi 789
    abc *** def *** ghi ***
    23
    abc 123 def 456 ghi 789
    bc 123 def 456 ghi 789
    abc 123 def 456 ghi 78
    *bc 123 d*f 456 gh* 789
    abc 123 def 456 ghi 789
    false

### \- CaseFormat ###

**CaseFormat类用于不同命名格式之间的转换，例如驼峰命名、大写下划线命名、小写连字符命名等。**

CaseFormat 支持的命名约定和格式包括：

*  LOWER\_CAMEL：首字母小写驼峰命名
 *  UPPER\_CAMEL：首字母大写驼峰命名
 *  LOWER\_UNDERSCORE：下划线小写命名
 *  UPPER\_UNDERSCORE：下划线大写命名
 *  LOWER\_HYPHEN：连字符小写命名

**主要方法：**

<table> 
 <thead> 
  <tr> 
   <th align="left">方法名</th> 
   <th align="left">描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">String to(CaseFormat format, String str)</td> 
   <td align="left">将给定格式的字符串转换为另一种格式</td> 
  </tr> 
 </tbody> 
</table>

**使用示例：**

public static void main(String[] args) {
        
            // 首字母小写驼峰 转换为 下划线大写
            String s1 = CaseFormat.LOWER_CAMEL.to(CaseFormat.UPPER_UNDERSCORE, "userId");
            System.out.println(s1);
    
            // 下划线大写 转换为 连字符小写
            String s2 = CaseFormat.UPPER_UNDERSCORE.to(CaseFormat.LOWER_HYPHEN, "USER_ID");
            System.out.println(s2);
    
           // 连字符小写 转换为 首字母大写驼峰
            String s3 = CaseFormat.LOWER_HYPHEN.to(CaseFormat.UPPER_CAMEL, "user-id");
            System.out.println(s3);
    
        }

日志

USER_ID
    user-id
    UserId