StringUtils 核心特性
- 套件:
org.apache.commons.lang3.StringUtils (舊版 org.apache.commons.lang)
- 所有方法 null-safe:輸入
null 不拋 NPE,回傳預設值 (通常為 null、""、false)。
- 130+ static 方法,涵蓋判斷、修剪、比較、搜尋、分割、連接等。
核心判斷方法對比表
| 輸入值 | isEmpty | isNotEmpty | isBlank | isNotBlank |
null | true | false | true | false |
"" | true | false | true | false |
" " | false | true | true | false |
"\t\n\f\r" | false | true | true | false |
"\b" | false | true | false | true |
"X-rapido" | false | true | false | true |
" X " | false | true | false | true |
關鍵差異
- isEmpty:僅判斷
null 或 length() == 0,不處理空白字元。
- isBlank:
trim() 後為空即為 true,**包含空白字元判斷** (空格、Tab、換行等)。
- 建議:表單驗證、業務非空檢查 **優先用
isBlank**,避免「全空白」偽裝通過。
修剪方法族群對比
| 方法 | null 輸入 | "" 輸入 | " " | "\t\n" | " b " | " X " | 說明 |
| trim | null | "" | "" | "" | "" | "X" | 標準 String.trim(),移除首尾 <= ' ' (含控制字元) |
| trimToNull | null | null | null | null | null | "X" | trim 後若為空回傳 null |
| trimToEmpty | "" | "" | "" | "" | "" | "X" | trim 後若為空回傳 "",null 轉 "" |
| strip | null | "" | "" | "" | "\b" | "X" | Unicode 感知,Character.isWhitespace(),保留 \b (退格) |
| stripToNull | null | null | null | null | "\b" | "X" | strip 後空回 null |
| stripToEmpty | "" | "" | "" | "" | "\b" | "X" | strip 後空回 "" |
trim vs strip 關鍵差異
trim():Java 早期定義,移除 codepoint <= ' ' (U+0020),包含控制字元 (U+0000~U+001F),但不包含 非中斷空格 (U+00A0)、全形空格 (U+3000) 等。
strip():Java 11+ / Commons Lang 3.6+,依 Character.isWhitespace(),**完整支援 Unicode 空白字元** (含全形空格、NBSP 等),不移除控制字元 (如 \b U+0008)。
- 選擇建議:處理現代 Web/多語言輸入用
strip;處理傳統控制字元混雜資料用 trim。
進階修剪:指定字元集
StringUtils.strip("xxHelloxx", "x"); // "Hello"
StringUtils.stripStart("xxHelloxx", "x"); // "Helloxx"
StringUtils.stripEnd("xxHelloxx", "x"); // "xxHello"
其他高頻實用方法
equals/equalsIgnoreCase:null-safe 比較。
join(Iterable, char) / split(String, int):高效連接/分割。
substringBetween(str, open, close):提取夾在兩字串間內容。
abbreviate(str, maxWidth):智慧截斷加省略號。
normalizeSpace(str):合併連續空白為單一空格並 trim。