在 Java 開(kāi)發(fā)中，字符串操作是日常開(kāi)發(fā)高頻場(chǎng)景，但 JDK 原生的字符串工具類(lèi)功能相對(duì)基礎(chǔ)，處理復(fù)雜場(chǎng)景時(shí)往往需要編寫(xiě)大量冗余代碼。Google 開(kāi)源的 Guava 庫(kù)為字符串操作提供了一套簡(jiǎn)潔、高效且功能豐富的工具集，本文將深入解析 Guava 中核心的字符串操作 API，結(jié)合場(chǎng)景講解其用法與優(yōu)勢(shì)。

一、Guava 字符串工具概述

Guava 作為 Google 核心 Java 庫(kù)，其 com.google.common.base 包下封裝了大量字符串處理工具，涵蓋字符串空值處理、字符匹配、分割拼接、格式轉(zhuǎn)換等核心場(chǎng)景，相比 JDK 原生 API：

• 更簡(jiǎn)潔的調(diào)用方式，減少模板代碼；
• 更健壯的邊界處理（如空值、空字符串）；
• 更貼合業(yè)務(wù)場(chǎng)景的功能設(shè)計(jì)（如固定規(guī)則的字符匹配、分割）。

二、核心 API 詳解

1. Strings：基礎(chǔ)字符串工具

Strings 類(lèi)聚焦于最常用的字符串基礎(chǔ)操作，解決空值、空字符串處理的痛點(diǎn)。

空值/空字符串處理

Strings.isNullOrEmpty(CharSequence s)：判斷字符串是否為 null 或空字符串（""），替代 JDK 中 s == null || s.isEmpty() 的冗余寫(xiě)法；

Strings.nullToEmpty(CharSequence s)：將 null 轉(zhuǎn)換為空字符串，非 null 則返回原字符串；

Strings.emptyToNull(CharSequence s)：將空字符串轉(zhuǎn)換為 null，非空則返回原字符串；

Strings.padStart/Strings.padEnd：字符串補(bǔ)全，如左補(bǔ)空格/指定字符至固定長(zhǎng)度，示例：

// 輸出 "  abc"（左補(bǔ)2個(gè)空格至長(zhǎng)度5）
String padded = Strings.padStart("abc", 5, ' ');
// 輸出 "abc  "（右補(bǔ)2個(gè)空格至長(zhǎng)度5）
String paddedEnd = Strings.padEnd("abc", 5, ' ');

2. CharMatcher：靈活的字符匹配器

CharMatcher 是 Guava 字符串處理的核心工具，用于篩選、匹配、替換字符，可理解為「字符級(jí)別的正則表達(dá)式」，且性能更優(yōu)。

內(nèi)置常用匹配器

Guava 預(yù)定義了大量開(kāi)箱即用的 CharMatcher，覆蓋絕大多數(shù)場(chǎng)景：

• CharMatcher.WHITESPACE：匹配所有空白字符（空格、制表符、換行等）；
• CharMatcher.DIGIT：匹配數(shù)字字符；
• CharMatcher.LETTER：匹配字母；
• CharMatcher.ASCII：匹配 ASCII 字符；
• CharMatcher.is(char c)：匹配指定單個(gè)字符；
• CharMatcher.inRange(char start, char end)：匹配指定范圍的字符。

核心操作

保留匹配字符：retainFrom(CharSequence s)

// 提取字符串中的所有數(shù)字，輸出 "12345"
String digits = CharMatcher.DIGIT.retainFrom("abc123def45");

移除匹配字符：removeFrom(CharSequence s)

// 移除所有空白字符，輸出 "helloworld"
String noWhitespace = CharMatcher.WHITESPACE.removeFrom("hello  world\n");

替換匹配字符：replaceFrom(CharSequence s, char replacement)

// 將所有制表符替換為空格，輸出 "hello   world"
String replaced = CharMatcher.TAB.replaceFrom("hello\t\tworld", ' ');

修剪匹配字符：trimFrom(CharSequence s)（首尾）、trimLeadingFrom（開(kāi)頭）、trimTrailingFrom（結(jié)尾）

// 移除首尾數(shù)字，輸出 "abc"
String trimmed = CharMatcher.DIGIT.trimFrom("123abc456");

組合匹配器

通過(guò) and/or/negate 實(shí)現(xiàn)復(fù)雜匹配規(guī)則：

// 匹配「非字母且非數(shù)字」的字符，輸出 "!@#"
CharMatcher nonLetterDigit = CharMatcher.LETTER.or(CharMatcher.DIGIT).negate();
String specialChars = nonLetterDigit.retainFrom("abc123!@#def456");

3. Splitter：靈活的字符串分割

JDK 原生 String.split() 存在諸多痛點(diǎn)（如空字符串丟失、正則表達(dá)式陷阱），Guava Splitter 提供了更可控的分割能力。

基礎(chǔ)用法

// 按逗號(hào)分割，自動(dòng)忽略空字符串，輸出 ["a", "b", "c"]
List<String> split = Splitter.on(',')
    .omitEmptyStrings() // 忽略空元素
    .trimResults() // 去除每個(gè)元素的空白
    .splitToList("a,, b ,c");

核心特性

• on(char separator)：按單個(gè)字符分割；
• on(String separator)：按字符串分割；
• onPattern(String regex)：按正則表達(dá)式分割；
• limit(int limit)：限制分割結(jié)果數(shù)量；
• fixedLength(int length)：按固定長(zhǎng)度分割。

示例：按固定長(zhǎng)度分割字符串

// 輸出 ["abc", "def", "g"]
List<String> fixedSplit = Splitter.fixedLength(3).splitToList("abcdefg");

4. Joiner：字符串拼接

Joiner 解決了 JDK 中拼接集合/數(shù)組時(shí)「空值處理」「分隔符拼接」的痛點(diǎn)。

基礎(chǔ)用法

// 拼接列表，輸出 "a,b,c"
String joined = Joiner.on(',')
    .skipNulls() // 跳過(guò) null 元素
    .join(Arrays.asList("a", null, "b", "c"));

// 替換 null 元素，輸出 "a,空,b,c"
String joinedWithNull = Joiner.on(',').useForNull("空").join(Arrays.asList("a", null, "b", "c"));

拼接 Map

// 輸出 "k1=v1,k2=v2"
Map<String, String> map = ImmutableMap.of("k1", "v1", "k2", "v2");
String mapJoined = Joiner.on(',').withKeyValueSeparator('=').join(map);

5. CaseFormat：大小寫(xiě)格式轉(zhuǎn)換

CaseFormat 用于在不同命名規(guī)范（如駝峰、下劃線、連字符）之間轉(zhuǎn)換，適用于代碼生成、配置解析等場(chǎng)景。

常用格式枚舉

• LOWER_CAMEL：小駝峰（如 lowerCamel）；
• UPPER_CAMEL：大駝峰（如 UpperCamel）；
• LOWER_UNDERSCORE：下劃線小寫(xiě)（如 lower_underscore）；
• UPPER_UNDERSCORE：下劃線大寫(xiě)（如 UPPER_UNDERSCORE）；
• LOWER_HYPHEN：連字符小寫(xiě)（如 lower-hyphen）。

轉(zhuǎn)換示例

// 下劃線轉(zhuǎn)小駝峰，輸出 "helloWorld"
String camel = CaseFormat.LOWER_UNDERSCORE.to(CaseFormat.LOWER_CAMEL, "hello_world");
// 小駝峰轉(zhuǎn)連字符，輸出 "hello-world"
String hyphen = CaseFormat.LOWER_CAMEL.to(CaseFormat.LOWER_HYPHEN, "helloWorld");

6. Ascii：ASCII 字符處理

Ascii 類(lèi)專注于 ASCII 字符的大小寫(xiě)轉(zhuǎn)換、校驗(yàn)，相比 JDK Character 更高效（無(wú)需處理 Unicode）：

// ASCII 小寫(xiě)轉(zhuǎn)大寫(xiě)，輸出 "HELLO"
String upper = Ascii.toUpperCase("hello");
// 校驗(yàn)是否為 ASCII 可打印字符
boolean isPrintable = Ascii.isPrintable('a');

三、實(shí)戰(zhàn)場(chǎng)景示例

場(chǎng)景 1：清洗用戶輸入

需求：過(guò)濾用戶輸入的昵稱，僅保留字母、數(shù)字和下劃線，其余字符替換為下劃線，且首尾無(wú)空白。

String nickname = "  張三123!@#_test  ";
// 1. 去除首尾空白 2. 非字母/數(shù)字/下劃線替換為下劃線 3. 合并連續(xù)下劃線
String cleaned = CharMatcher.WHITESPACE.trimFrom(nickname);
cleaned = CharMatcher.JAVA_LETTER_OR_DIGIT.or(CharMatcher.is('_'))
    .negate()
    .replaceFrom(cleaned, '_');
cleaned = CharMatcher.is('_').collapseFrom(cleaned, '_');
// 輸出 "張三123_test"（注：中文不在 ASCII 范圍內(nèi)，CharMatcher.JAVA_LETTER 包含中文）

場(chǎng)景 2：解析配置字符串

需求：解析形如 key1=value1;key2=value2;key3=value3 的配置字符串為 Map，忽略空行和注釋行（以 # 開(kāi)頭）。

String config = "# 配置示例\nkey1=value1;;key2=value2;key3=value3";
Map<String, String> configMap = Splitter.on(';')
    .omitEmptyStrings()
    .trimResults()
    .splitToStream(config)
    .filter(line -> !line.startsWith("#"))
    .map(line -> Splitter.on('=').limit(2).splitToList(line))
    .collect(Collectors.toMap(
        list -> list.get(0),
        list -> list.size() > 1 ? list.get(1) : ""
    ));
// 輸出 {key1=value1, key2=value2, key3=value3}

四、使用注意事項(xiàng)

依賴引入：確保項(xiàng)目中引入 Guava 依賴（Maven 示例）：

<dependency>
    <groupId>com.google.guava</groupId>
    <artifactId>guava</artifactId>
    <version>32.1.3-jre</version> <!-- 最新版本可參考 Guava 官方倉(cāng)庫(kù) -->
</dependency>

若為 Android 項(xiàng)目，使用 guava:32.1.3-android 版本。

空值處理：Guava 工具類(lèi)對(duì) null 大多做了友好處理，但需注意 Splitter/Joiner 默認(rèn)不處理 null，需顯式調(diào)用 skipNulls()/useForNull()。

性能考量：CharMatcher 是不可變類(lèi)，預(yù)定義的匹配器（如 DIGIT/WHITESPACE）可復(fù)用，避免重復(fù)創(chuàng)建。

五、總結(jié)

Guava 的字符串工具類(lèi)通過(guò)封裝高頻場(chǎng)景、優(yōu)化邊界處理，大幅提升了 Java 字符串操作的效率和可讀性。從基礎(chǔ)的空值處理（Strings）到靈活的字符匹配（CharMatcher），再到可控的分割/拼接（Splitter/Joiner），幾乎覆蓋了日常開(kāi)發(fā)中所有字符串處理需求。相比原生 JDK API，Guava 讓代碼更簡(jiǎn)潔、更健壯，是 Java 開(kāi)發(fā)者提升效率的必備工具。

以上就是一文詳解Java Guava核心字符串API操作的實(shí)用指南的詳細(xì)內(nèi)容，更多關(guān)于Java Guava字符串操作的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論