Apache Commons Lang StringUtils 常用方法詳解

Apache Commons Lang StringUtils 常用方法詳解

org.apache.commons.lang.StringUtils 是 Java 開發中極為實用的字串處理工具類，它補充了 JDK 標準 String 類缺失的許多高頻功能。本文整理了開發中最常用的方法，並附上代碼示例與輸出結果，方便快速查閱。

1. 空值檢查：isBlank / isNotBlank

判斷字串是否為 null、空字串 "" 或僅包含空白字符。

StringUtils.isBlank("a");      // false
StringUtils.isBlank("  ");     // true
StringUtils.isBlank(null);     // true
StringUtils.isNotBlank("abc"); // true

2. 字串縮略：abbreviate

將過長字串截斷並加上省略號 ...，最小寬度為 4（含省略號）。

StringUtils.abbreviate("abcdefg", 20); // "abcdefg"
StringUtils.abbreviate("abcdefg", 4);  // "a..."

3. 首字母大小寫轉換：capitalize / uncapitalize

StringUtils.capitalize("abcdefg");   // "Abcdefg"
StringUtils.uncapitalize("Abcdefg"); // "abcdefg"

4. 字串置中與填充：center、leftPad、rightPad

可指定填充字符，預設為空格。

StringUtils.center("abcdefg", 20);        // "      abcdefg       "
StringUtils.center("abcdefg", 20, "*_");  // "*_*_*_abcdefg*_*_*_*"
StringUtils.leftPad("abc", 10, "*");      // "*******abc"
StringUtils.rightPad("abc", 10, "*");     // "abc*******"

5. 重複字串：repeat

StringUtils.repeat("abc", 5); // "abcabcabcabcabc"

6. 大小寫全判斷（3.0+）：isAllUpperCase / isAllLowerCase

StringUtils.isAllLowerCase("abC"); // false
StringUtils.isAllUpperCase("ABC"); // true

7. 字符組成檢查：isAlpha、isNumeric、isAlphanumeric 等

系列方法可驗證是否純字母、純數字、字母數字混合、含空格等。

StringUtils.isAlpha("a2bdefg");        // false
StringUtils.isAlphanumeric("abc123");  // true
StringUtils.isNumeric("12345");        // true

8. 子字串出現次數：countMatches

StringUtils.countMatches("ababsssababa", "ab"); // 4

9. 字串反轉：reverse

StringUtils.reverse("abcdef"); // "fedcba"

10. 大小寫互換：swapCase

空格與非字母字符保持不變。

StringUtils.swapCase("I am a-A*a"); // "i AM A-a*A"

掌握這些方法能大幅減少手寫字串處理邏輯的錯誤，提升代碼可讀性與健壯性。建議專案中統一引入 commons-lang3 依賴。