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 代码

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请参见官方网站：