StringUtils工具類

StringUtils 方法的操作對象是 java.lang.String 類型的對象,是 JDK 提供的 String 類型操作方法的補充,並且是 null 安全的(即如果輸入參數 String 爲 null 則不會拋出 NullPointerException ,而是做了相應處理,例如,如果輸入爲 null 則返回也是 null 等,具體可以查看源代碼)。

除了構造器,StringUtils 中一共有130多個方法,並且都是 static 的,所以我們可以這樣調用 StringUtils.xxx()

下面分別對一些常用方法做簡要介紹:

1. public static boolean isEmpty(String str)
   判斷某字符串是否爲空,爲空的標準是 str==null 或 str.length()==0
   下面是 StringUtils 判斷是否爲空的示例:

StringUtils.isEmpty(null) = true
StringUtils.isEmpty("") = true
StringUtils.isEmpty(" ") = false //注意在 StringUtils 中空格作非空處理
StringUtils.isEmpty("   ") = false
StringUtils.isEmpty("bob") = false
StringUtils.isEmpty(" bob ") = false

2. public static boolean isNotEmpty(String str)
   判斷某字符串是否非空,等於 !isEmpty(String str)
   下面是示例:

      StringUtils.isNotEmpty(null) = false
      StringUtils.isNotEmpty("") = false
      StringUtils.isNotEmpty(" ") = true
      StringUtils.isNotEmpty("         ") = true
      StringUtils.isNotEmpty("bob") = true
      StringUtils.isNotEmpty(" bob ") = true

3. public static boolean isBlank(String str)
   判斷某字符串是否爲空或長度爲0或由空白符(whitespace) 構成
   下面是示例:
      StringUtils.isBlank(null) = true
      StringUtils.isBlank("") = true
      StringUtils.isBlank(" ") = true
      StringUtils.isBlank("        ") = true
      StringUtils.isBlank("\t \n \f \r") = true //對於製表符、換行符、換頁符和回車符

      StringUtils.isBlank() //均識爲空白符
      StringUtils.isBlank("\b") = false //"\b"爲單詞邊界符
      StringUtils.isBlank("bob") = false
      StringUtils.isBlank(" bob ") = false

4. public static boolean isNotBlank(String str)
   判斷某字符串是否不爲空且長度不爲0且不由空白符(whitespace) 構成,等於 !isBlank(String str)
   下面是示例:

      StringUtils.isNotBlank(null) = false
      StringUtils.isNotBlank("") = false
      StringUtils.isNotBlank(" ") = false
      StringUtils.isNotBlank("         ") = false
      StringUtils.isNotBlank("\t \n \f \r") = false
      StringUtils.isNotBlank("\b") = true
      StringUtils.isNotBlank("bob") = true
      StringUtils.isNotBlank(" bob ") = true

5. public static String trim(String str)
   去掉字符串兩端的控制符(control characters, char <= 32) , 如果輸入爲 null 則返回null
   下面是示例:
      StringUtils.trim(null) = null
      StringUtils.trim("") = ""
      StringUtils.trim(" ") = ""
      StringUtils.trim(" \b \t \n \f \r    ") = ""
      StringUtils.trim("     \n\tss   \b") = "ss"
      StringUtils.trim(" d   d dd     ") = "d   d dd"
      StringUtils.trim("dd     ") = "dd"
      StringUtils.trim("     dd       ") = "dd"

6. public static String trimToNull(String str)
   去掉字符串兩端的控制符(control characters, char <= 32) ,如果變爲 null 或"",則返回 null
   下面是示例:
      StringUtils.trimToNull(null) = null
      StringUtils.trimToNull("") = null
      StringUtils.trimToNull(" ") = null
      StringUtils.trimToNull("     \b \t \n \f \r    ") = null
      StringUtils.trimToNull("     \n\tss   \b") = "ss"
      StringUtils.trimToNull(" d   d dd     ") = "d   d dd"
      StringUtils.trimToNull("dd     ") = "dd"
      StringUtils.trimToNull("     dd       ") = "dd"

7. public static String trimToEmpty(String str)
   去掉字符串兩端的控制符(control characters, char <= 32) ,如果變爲 null 或 "" ,則返回 ""
   下面是示例:
      StringUtils.trimToEmpty(null) = ""
      StringUtils.trimToEmpty("") = ""
      StringUtils.trimToEmpty(" ") = ""
      StringUtils.trimToEmpty("     \b \t \n \f \r    ") = ""
      StringUtils.trimToEmpty("     \n\tss   \b") = "ss"
      StringUtils.trimToEmpty(" d   d dd     ") = "d   d dd"
      StringUtils.trimToEmpty("dd     ") = "dd"
      StringUtils.trimToEmpty("     dd       ") = "dd"

8. public static String strip(String str)
   去掉字符串兩端的空白符(whitespace) ,如果輸入爲 null 則返回 null
   下面是示例(注意和 trim() 的區別):
      StringUtils.strip(null) = null
      StringUtils.strip("") = ""
      StringUtils.strip(" ") = ""
      StringUtils.strip("     \b \t \n \f \r    ") = "\b"
      StringUtils.strip("     \n\tss   \b") = "ss   \b"
      StringUtils.strip(" d   d dd     ") = "d   d dd"
      StringUtils.strip("dd     ") = "dd"
      StringUtils.strip("     dd       ") = "dd"

9. public static String stripToNull(String str)
   去掉字符串兩端的空白符(whitespace) ,如果變爲 null 或"",則返回 null
   下面是示例(注意和 trimToNull() 的區別):
      StringUtils.stripToNull(null) = null
      StringUtils.stripToNull("") = null
      StringUtils.stripToNull(" ") = null
      StringUtils.stripToNull("     \b \t \n \f \r    ") = "\b"
      StringUtils.stripToNull("     \n\tss   \b") = "ss   \b"
      StringUtils.stripToNull(" d   d dd     ") = "d   d dd"
      StringUtils.stripToNull("dd     ") = "dd"
      StringUtils.stripToNull("     dd       ") = "dd"

10. public static String stripToEmpty(String str)
    去掉字符串兩端的空白符(whitespace) ,如果變爲 null 或"" ,則返回""
    下面是示例(注意和 trimToEmpty() 的區別):
      StringUtils.stripToNull(null) = ""
      StringUtils.stripToNull("") = ""
      StringUtils.stripToNull(" ") = ""
      StringUtils.stripToNull("     \b \t \n \f \r    ") = "\b"
      StringUtils.stripToNull("     \n\tss   \b") = "ss   \b"
      StringUtils.stripToNull(" d   d dd     ") = "d   d dd"
      StringUtils.stripToNull("dd     ") = "dd"

      StringUtils.stripToNull("     dd       ") = "dd"

11. public static String strip(String str, String stripChars)
   去掉 str 兩端的在 stripChars 中的字符。
   如果 str 爲 null 或等於"" ,則返回它本身;
   如果 stripChars 爲 null 或"" ,則返回 strip(String str) 。

12. public static String stripStart(String str, String stripChars)
    和11相似,去掉 str 前端的在 stripChars 中的字符。

13. public static String stripEnd(String str, String stripChars)
    和11相似,去掉 str 末端的在 stripChars 中的字符。

14. public static String[] stripAll(String[] strs)
    對字符串數組中的每個字符串進行 strip(String str) ,然後返回。
    如果 strs 爲 null 或 strs 長度爲0,則返回 strs 本身

15. public static String[] stripAll(String[] strs, String stripChars)
    對字符串數組中的每個字符串進行 strip(String str, String stripChars) ,然後返回。
    如果 strs 爲 null 或 strs 長度爲0,則返回 strs 本身

16. public static boolean equals(String str1, String str2)
    比較兩個字符串是否相等,如果兩個均爲空則也認爲相等。

17. public static boolean equalsIgnoreCase(String str1, String str2)
    比較兩個字符串是否相等,不區分大小寫,如果兩個均爲空則也認爲相等。

18. public static int indexOf(String str, char searchChar)
    返回字符 searchChar 在字符串 str 中第一次出現的位置。
    如果 searchChar 沒有在 str 中出現則返回-1,
    如果 str 爲 null 或 "" ,則也返回-1

19. public static int indexOf(String str, char searchChar, int startPos)
    返回字符 searchChar 從 startPos 開始在字符串 str 中第一次出現的位置。
    如果從 startPos 開始 searchChar 沒有在 str 中出現則返回-1,
    如果 str 爲 null 或 "" ,則也返回-1

20. public static int indexOf(String str, String searchStr)
    返回字符串 searchStr 在字符串 str 中第一次出現的位置。
    如果 str 爲 null 或 searchStr 爲 null 則返回-1,
    如果 searchStr 爲 "" ,且 str 爲不爲 null ,則返回0,
    如果 searchStr 不在 str 中,則返回-1

21. public static int ordinalIndexOf(String str, String searchStr, int ordinal)
    返回字符串 searchStr 在字符串 str 中第 ordinal 次出現的位置。
    如果 str=null 或 searchStr=null 或 ordinal<=0 則返回-1
    舉例(*代表任意字符串):
      StringUtils.ordinalIndexOf(null, *, *) = -1
      StringUtils.ordinalIndexOf(*, null, *) = -1
      StringUtils.ordinalIndexOf("", "", *) = 0
      StringUtils.ordinalIndexOf("aabaabaa", "a", 1) = 0
      StringUtils.ordinalIndexOf("aabaabaa", "a", 2) = 1
      StringUtils.ordinalIndexOf("aabaabaa", "b", 1) = 2
      StringUtils.ordinalIndexOf("aabaabaa", "b", 2) = 5
      StringUtils.ordinalIndexOf("aabaabaa", "ab", 1) = 1
      StringUtils.ordinalIndexOf("aabaabaa", "ab", 2) = 4
      StringUtils.ordinalIndexOf("aabaabaa", "bc", 1) = -1
      StringUtils.ordinalIndexOf("aabaabaa", "", 1) = 0
      StringUtils.ordinalIndexOf("aabaabaa", "", 2) = 0

22. public static int indexOf(String str, String searchStr, int startPos)
    返回字符串 searchStr 從 startPos 開始在字符串 str 中第一次出現的位置。
    舉例(*代表任意字符串):
      StringUtils.indexOf(null, *, *) = -1
      StringUtils.indexOf(*, null, *) = -1
      StringUtils.indexOf("", "", 0) = 0
      StringUtils.indexOf("aabaabaa", "a", 0) = 0
      StringUtils.indexOf("aabaabaa", "b", 0) = 2
      StringUtils.indexOf("aabaabaa", "ab", 0) = 1
      StringUtils.indexOf("aabaabaa", "b", 3) = 5
      StringUtils.indexOf("aabaabaa", "b", 9) = -1
      StringUtils.indexOf("aabaabaa", "b", -1) = 2
      StringUtils.indexOf("aabaabaa", "", 2) = 2
      StringUtils.indexOf("abc", "", 9) = 3

23. public static int lastIndexOf(String str, char searchChar)
    基本原理同18

24. public static int lastIndexOf(String str, char searchChar, int startPos)
    基本原理同19

25. public static int lastIndexOf(String str, String searchStr)
    基本原理同20

26. public static int lastIndexOf(String str, String searchStr, int startPos)
    基本原理同22

另附:

String 的 split(String regex) 方法的用法
如果我們需要把某個字符串拆分爲字符串數組,則通常用 split(String regex) 來實現。

例如:
Java代碼

  1. String str = "aa,bb,cc,dd";      
  2. String[] strArray = str.split(",");       
  3. System.out.println(strArray.length);      
  4.   for (int i = 0; i < strArray.length; i++) {      
  5.         System.out.println(strArray[i]);      
  6. }  
String str = "aa,bb,cc,dd"; String[] strArray = str.split(","); System.out.println(strArray.length); for (int i = 0; i < strArray.length; i++) { System.out.println(strArray[i]); }

結果爲:
4
aa
bb
cc
dd

如果,
String str = "aa.bb.cc.dd";
String[] strArray = str.split(".");

則結果爲:0

爲什麼結果不是我們所想的呢,原因是參數 String regex 是正則表達式 (regular expression) 而不是普通字符串,而 "." 在正則表達式中有特殊含義,表示匹配所有單個字符。如果要那樣拆分,我們必須給 "." 進行轉義,String[] strArray = str.split(".") 修改爲 String[] strArray = str.split("\\.") 即可。
另外有關 StringUtils 的詳細 API 請參見官方網站: http://commons.apache.org/lang/api/org/apache/commons/lang/StringUtils.html


發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章