[1128]commons-lang里面StringUtils方法说明以及案例（stringutils isblank）

25-02-21 15

如果您对[1128]commons-lang里面StringUtils方法说明以及案例和stringutilsisblank感兴趣，那么这篇文章一定是您不可错过的。我们将详细讲解[1128]commo

如果您对[1128]commons-lang里面StringUtils方法说明以及案例和stringutils isblank感兴趣，那么这篇文章一定是您不可错过的。我们将详细讲解[1128]commons-lang里面StringUtils方法说明以及案例的各种细节，并对stringutils isblank进行深入的分析，此外还有关于apache commons StringUtils、apache commons StringUtils介绍、apache commons StringUtils工具类使用、Apache Commons 包 StringUtils 工具类深入整理的实用技巧。

本文目录一览：

[1128]commons-lang里面StringUtils方法说明以及案例（stringutils isblank）
apache commons StringUtils
apache commons StringUtils介绍
apache commons StringUtils工具类使用
Apache Commons 包 StringUtils 工具类深入整理

[1128]commons-lang里面StringUtils方法说明以及案例（stringutils isblank）

文章目录

- - 1.public static boolean isBlank(String str)
  - 2. public static boolean isEmpty(String str)
  - 3. public static boolean isNotEmpty(String str)
  - 4. public static boolean isNotBlank(String str)
  - 5. public static String trim(String str)
  - 6. public static String trimToNull(String str)
  - 7. public static String trimToEmpty(String str)
  - 9. public static String stripToNull(String str)
  - 10. public static String stripToEmpty(String str)
  - 11. public static String strip(String str, String stripChars)
  - 12. public static String stripStart(String str, String stripChars)
  - 13. public static String stripEnd(String str, String stripChars)
  - 14. public static String[] stripAll(String[] strs)
  - 15. public static String[] stripAll(String[] strs, String stripChars)
  - 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)
  - 19. public static int indexOf(String str, char searchChar, int startPos)
  - 20. public static int indexOf(String str, String searchStr)
  - 21. public static int ordinalIndexOf(String str, String searchStr, int ordinal)
  - 22. public static int indexOf(String str, String searchStr, int startPos)
  - 23. public static int lastIndexOf(String str, char searchChar)
  - 24. public static int lastIndexOf(String str, char searchChar, int startPos)
  - 25. public static int lastIndexOf(String str, String searchStr)
  - 26. public static int lastIndexOf(String str, String searchStr, int startPos)

StringUtil是commons-lang里面的哦，不是lang3里面的哈

下面总结了StringUtil里面的常用的方法：

1.public static boolean isBlank(String str)

在校验一个String类型的变量是否为空时，通常存在3中情况

（1）是否为 null
（2）是否为 “”
（3）是否为空字符串(引号中间有空格) 如： " "。

StringUtils的isBlank()方法可以一次性校验这三种情况，返回值都是true,否则为false

示例：

     StringUtils.isBlank(null) = true
     StringUtils.isBlank("") = true
     StringUtils.isBlank("  ") = true
     StringUtils.isBlank("        ") = true
     StringUtils.isBlank("\t \n \f \r") = true   //对于制表符、换行符、换页符和回车
     StringUtils.isBlank()=true  //均识为空白符
     StringUtils.isBlank("\") = false   //"\b"为单词边界
     StringUtils.isBlank("fff") = false
     StringUtils.isBlank("ffff ") = false

2. 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("fff") = false
     StringUtils.isEmpty(" fff ") = false

3. 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

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)

返回字符 searchChar 在字符串 str 中最后一次出现的位置。
如果 searchChar 没有在 str 中出现则返回-1，
如果 str 为 null 或 “” ，则也返回-1

24. public static int lastIndexOf(String str, char searchChar, int startPos)

返回字符 searchChar 从 startPos 开始在字符串 str 中最后一次出现的位置。
如果从 startPos 开始 searchChar 没有在 str 中出现则返回-1，
如果 str 为 null 或 “” ，则也返回-1

25. public static int lastIndexOf(String str, String searchStr)

返回字符串 searchStr 在字符串 str 中最后一次出现的位置。
如果 str 为 null 或 searchStr 为 null 则返回-1，
如果 searchStr 为 “” ,且 str 为不为 null ，则返回0，
如果 searchStr 不在 str 中，则返回-1

26. public static int lastIndexOf(String str, String searchStr, int startPos)

返回字符串 searchStr 从 startPos 开始在字符串 str 中最后一次出现的位置。

注意事项：String 的 split(String regex) 和replaceAll（String a,String b）这两个方法有匹配正则表达式的，所以使用的时用"."是使用转义字符。不让”.“代表全部，结果会出错的哦。

本文同步分享在博客“周小董”（CSDN）。
如有侵权，请联系 support@oschina.cn 删除。
本文参与“OSC源创计划”，欢迎正在阅读的你也加入，一起分享。

apache commons 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"

apache commons StringUtils介绍

常用的方法

isNumeric() 方法：public static boolean isNumeric(CharSequence cs) 含义：判断传入的字符序列Unicode是否是数字，如果是则return true,否则return false。
equals 方法：public static boolean equals(CharSequence str1,CharSequence str2) 含义：比较传入的两个字符序列，如果相等则return true,否则return false。在该方法中，不会抛出null空指针异常，如果传入的两个字符都为null，将return true。
isEmpty,isNotEmpty,isBlank,isNotBlank 和前面一样，这些方法相对于jdk提供的isEmpty方法来说，多了一个“空指针安全”，即不用考虑传递参数的空值问题。

Blank和empty的区别：isBlank将在字符串含有空白字符的时候，返回true。

split 方法：public static String[] split(String str, char separatorChar) 含义：传入一个字符串和一个分割符，将返回一个字符串数组。相比于String.split，有两点优势：
- 相对于String.split是空指针安全的。当你尝试split一个null字符串的时候，将返回Null，一个Null的分隔符将按照空白字符分隔字符串。
- jdk自带的String.split由于支持正则表达式分离，所以可能会带来意想不到的结果，例如，分割符为".",jdk理解的“.”是正则表达式的任意字符，导致字符串内任意字符都匹配，将返回一个size=0的字符串数组。需要传递"\." 转义一次字符。

apache commons StringUtils工具类使用

StringUtils是apache commons lang库（http://commons.apache.org/lang)旗下的一个工具类，提供了很多有用的处理字符串的方法。

org.apache.commons.lang.StringUtils中方法的操作对象是java.lang.String类型的对象，是JDK提供的String类型操作方法的补充，用的最多的还是非空判断，“”、null、“ ”等，很实用的一个工具类

详见博客：http://blog.sina.com.cn/s/blog_4550f3ca0100qrsd.html

Apache Commons 包 StringUtils 工具类深入整理

字符串是在程序开发中最常见的，Apache Commons 开源项目在 org.apache.commons.lang3 包下提供了 StringUtils 工具类，该类相当于是对 jdk 自带的 String 类的增强，主要做了几方面的处理：

1. 核心设计理念就是对于 null 的进行内部处理，使用时不再需要进行繁琐的 null 值判定，同时也避免抛出空指针的异常

2. 作为工具类，通过增加额外处理的方式，尽量避免抛出异常，例如截取字符串，如指定长度超过了最大长度，不会抛出异常

3. 通过更多的重载方法，实现了忽略大小写、增加控制范围（左侧、右侧、中间）等常用操作

4. 增加了批量功能，如批量判定、批量比对等（个人认为批量功能适用的场景会比较少）

5. 通过对基本功能的综合应用，增加可直接实现特定开发场景的功能方法

整个工具类经过多年不断积累，非常庞大，官方按照功能，分了二十几个大类，方法总数达到了 200 多个，但其实常用和实用的其实并不没有那么多，因此从使用的角度，进行了重新整理，以便更好地利用起来，转换为开发生产力。

几个概念先明确下：

1.null：String 是引用类型而不是基本类型，所以取值可以为 null

2. 空串：即不包含任何元素的字符串，表示为 ""

3. 空格：即 " ", 对应 ascii 码是 32

4. 空白字符：是一组非可见的字符，对于文本处理来说，除了空格外，通常包括 tab（\t）、回车（\r）、换行（\n）、垂直制表符 (\v)、换页符 (\f)，当然，windows 系统常用的回车换行的组合 (\r\n) 也算在其中。

官方文档地址：http://commons.apache.org/proper/commons-lang/javadocs/api-3.8.1/index.html

以下是个人根据开发经验，站在使用者角度，重新整理和归类。
注：

1. 以下整理方法排除掉了官方标记为过时的方法

2. 涉及到正则表达式的方法，官方从 StringUtils 中移除，更换到了 RegExUtils 类中，不再在 StringUtils 中体现。

1 判断与验证

根据特定规则判断，不改变字符串自身

1.1 判断是否包含内容

提供了两类方法，empty 类和 blank 类，区别在对于前者只有为 null 或空串时，才返回 true，而后者则会包含所有空白字符（空格、tab、换行、回车等）的判定，使用时需根据要实现的目的来选择具体用哪一个。

两大类方法完全类似，只列出 empty 类方法

签名：

public static boolean isEmpty(CharSequence cs)

说明：

只有为 null 或空串时，才返回 true

示例：

StringUtils.isEmpty(null); // true

StringUtils.isEmpty(""); // true

扩展：

// 判定是否非空串

public static boolean isNotEmpty(CharSequence cs)

// 批量判断，不定数量参数或数组

public static boolean isAnyEmpty(CharSequence... css)

public static boolean isAllEmpty(CharSequence... css)

public static boolean isNoneEmpty(CharSequence... css)

1.2 比较字符串

基本用法 equals、equalsIgnoreCase、compareTo、compareToIgnoreCase，同 jdk.

扩展点：

1）扩展 equalsAny，可批量进行匹配判定，几乎不会用到，建议使用集合的 contains 方法更自然。

2）通过 compareTo 重载函数，可以指定 null 对象的优先级

1.3 检验字符串
通过一系列实现好的方法，来快速返回是否符合特定规则
// 判断是否只包含 unicode 字符（注意：汉字也是 unicode 字符）
public static boolean isAlpha(CharSequence cs)
// 判断是否只包含 unicode 字符及空格
public static boolean isAlphaSpace(CharSequence cs)
// 判断是否只包含 unicode 字符及数字
public static boolean isAlphanumeric(CharSequence cs)
// 判断是否只包含 unicode 字符、数字及空格
public static boolean isAlphanumericSpace(CharSequence cs)
// 判断是否只包含数字及空格
public static boolean isNumericSpace(CharSequence cs)
// 判断是否只包含可打印的 ascii 码字符（注意，空格不属于范围内）
public static boolean isAsciiPrintable(CharSequence cs)
// 判断是否为数字（注意：小数点和正负号，都会判定为 false）
public static boolean isNumeric(CharSequence cs)
// 判定是否只包括空白字符
public static boolean isWhitespace(CharSequence cs)
// 判定是否全部为大写
public static boolean isAllUpperCase(CharSequence cs)
// 判定是否全部为小写
public static boolean isAllLowerCase(CharSequence cs)
// 判定是否混合大小写（注意：包含其他字符，如空格，不影响结果判定）
public static boolean isMixedCase(CharSequence cs)

1.4 包含字符串
contains，同 jdk
public static boolean contains(CharSequence seq,int searchChar)
public static boolean contains(CharSequence seq,CharSequence searchSeq)
扩展：
// 忽略大小写
public static boolean containsIgnoreCase(CharSequence str,CharSequence searchStr)
// 是否包含空白字符
public static boolean containsWhitespace(CharSequence seq)
// 只包含指定字符
public static boolean containsOnly(CharSequence cs,char... searchChars)
public static boolean containsOnly(CharSequence cs,CharSequence searchChars)
// 批量判断包含任意一个
public static boolean containsAny(CharSequence cs,char... searchChars)
public static boolean containsAny(CharSequence cs,CharSequence searchChars)
// 批量判断不包含任何一个
public static boolean containsNone(CharSequence cs,char... searchChars)
public static boolean containsNone(CharSequence cs,CharSequence searchChars)

1.5 起止字符判定
//startWith
public static boolean startsWith(CharSequence str,CharSequence prefix)
public static boolean startsWithIgnoreCase(CharSequence str,CharSequence prefix)
public static boolean startsWithAny(CharSequence sequence,CharSequence... searchStrings)
//endWith
public static boolean endsWith(CharSequence str,CharSequence suffix)
public static boolean endsWithIgnoreCase(CharSequence str,CharSequence suffix)
public static boolean endsWithAny(CharSequence sequence,CharSequence... searchStrings)

2 处理字符串

不改变字符串实质内容，对首尾以及中间的空白字符进行处理

2.1 移除空白字符

去除首尾的空白字符，提供了两类方法，strip 类和 trim 类，

trim 类与 jdk 差异不大，去除包含控制字符（ascii 码 <=32）在内的控制字符（底层应用没做过，有可能会用到控制字符吧），主要是增加了对 null 的处理。

strip 类则做了很多增强，通过重载方法实现了很多其他功能，建议在开发中使用 strip 类。

注意：全角空格并不在处理范围内。

签名：

public static String strip(String str)

扩展：

// 去除并转化为 null 或 empty

public static String stripToNull(String str)

public static String stripToEmpty(String str)

// 去除指定字符串

public static String strip(String str,String stripChars)

// 控制去除范围

public static String stripStart(String str,String stripChars)

public static String stripEnd(String str,String stripChars)

// 批量操作
public static String[] stripAll(String... strs)
public static String[] stripAll(String[] strs,String stripChars)

相关方法：

// 对字符串基本处理的复合应用，将字符串中所有空白字符去除

public static String deleteWhitespace(String str)

// 去除首尾，但中间的空白字符，替换为单个空格

public static String normalizeSpace(String str)

// 去除声调音标，官方举例是将 ''à'' 转换为 ''a'', 很生僻，基本不会用到，不确定汉语拼音的音标是否能处理

public static String stripAccents(String input)

2.2 去除换行
去除结尾的一处换行符，包括三种情况 \r \n \r\n
public static String chomp(String str)
示例
StringUtils.chomp("\r") = ""
StringUtils.chomp("\n") = ""
StringUtils.chomp("\r\n") = ""
StringUtils.chomp("abc \r") = "abc "
StringUtils.chomp("abc\n") = "abc"
StringUtils.chomp("abc\r\n") = "abc"
StringUtils.chomp("abc\r\n\r\n") = "abc\r\n"
StringUtils.chomp("abc\n\r") = "abc\n"
StringUtils.chomp("abc\n\rabc") = "abc\n\rabc"

2.3 去除间隔符
去除末尾一个字符，常见使用场景是通过循环处理使用间隔符拼装的字符串，去除间隔符
注意：使用时需确保最后一位一定是间隔符，否则有可能破坏正常数据

public static String chop(String str)
示例：
StringUtils.chop("1,2,3,") = "1,2,3"
StringUtils.chop("a") = ""
StringUtils.chop("abc") = "ab"
StringUtils.chop("abc\nabc") = "abc\nab"

// 此外，末尾的换行符也视为字符，如果结尾是 \r\n，则一块去除，建议使用专用的 chomp, 以免造成非预期的结果
StringUtils.chop("\r") = ""
StringUtils.chop("\n") = ""
StringUtils.chop("\r\n") = ""

2.4 去除非数字
去除所有非数字字符，将剩余的数字字符拼接成字符串
public static String getDigits(String str)
示例：
StringUtils.getDigits("abc") = ""
StringUtils.getDigits("1000$") = "1000"
StringUtils.getDigits("1123~45") = "112345"
StringUtils.getDigits("(541) 754-3010") = "5417543010"

3. 查找字符串

3.1 查找字符串

indexOf 与 lastIndexOf, 可搜索字符、字符串以及指定起始搜索位置，同 jdk。

public static int indexOf(CharSequence seq,CharSequence searchSeq)

public static int indexOf(CharSequence seq,CharSequence searchSeq,int startPos)

扩展

// 增加忽略大小写控制
public static int indexOfIgnoreCase(CharSequence str,CharSequence searchStr)
// 返回第 n 次匹配的所在的索引数。
public static int ordinalIndexOf(CharSequence str,CharSequence searchStr,int ordinal)
// 同时查找多个字符
public static int indexOfAny(CharSequence cs,char... searchChars)
// 返回不在搜索字符范围内的第一个索引位置
public static int indexOfAnyBut(CharSequence cs,char... searchChars)

4. 编辑字符串

字符串的分割、合并、截取、替换

4.1 分割字符串

jdk 中的 split 使用正则表达式匹配，而字符串分割最常用场景是如下这种根据间隔符分割
String str="he,ll,o";
String [] reuslt=str.split(",");
虽然 split 的方式也能实现效果，但是还有有点别扭，而在 StringUtils，就是通过字符串匹配，而不是正则表达式
// 不设置间隔符，默认使用空白字符分割
public static String[] split(String str)
// 根据间隔符分割
public static String[] splitByWholeSeparator(String str,String separator)
// 限定返回，贪婪匹配
public static String[] splitByWholeSeparator(String str,String separator,int max),
示例：
StringUtils.splitByWholeSeparator("ab-!-cd-!-ef", "-!-", 5) = ["ab", "cd", "ef"]
StringUtils.splitByWholeSeparator("ab-!-cd-!-ef", "-!-", 2) = ["ab", "cd-!-ef"]
// 空白字符作为一个数组元素返回（其他方法默认去除空白字符元素）
public static String[] splitPreserveAllTokens(String str)
示例：
StringUtils.splitPreserveAllTokens("abc def") = ["abc", "def"]
StringUtils.splitPreserveAllTokens("abc def") = ["abc", "", "def"]
StringUtils.splitPreserveAllTokens(" abc ") = ["", "abc", ""]
// 特定场景，根据字符类型分割，同一类划为一个数组元素，驼峰命名情况下，最后一个大写字母归属后面元素而不是前面
public static String[] splitByCharacterTypeCamelCase(String str)
示例：
StringUtils.splitByCharacterTypeCamelCase("ab de fg") = ["ab", " ", "de", " ", "fg"]
StringUtils.splitByCharacterTypeCamelCase("ab de fg") = ["ab", " ", "de", " ", "fg"]
StringUtils.splitByCharacterTypeCamelCase("ab:cd:ef") = ["ab", ":", "cd", ":", "ef"]
StringUtils.splitByCharacterTypeCamelCase("number5") = ["number", "5"]
StringUtils.splitByCharacterTypeCamelCase("fooBar") = ["foo", "Bar"]
StringUtils.splitByCharacterTypeCamelCase("foo200Bar") = ["foo", "200", "Bar"]
StringUtils.splitByCharacterTypeCamelCase("ASFRules") = ["ASF", "Rules"]

4.2 合并字符串
jdk 使用 concat 方法，StringUtils 使用 join，这是一个泛型方法，建议实际使用过程中，还是只对 String 使用，不要对数值类型进行合并，会导致代码可读性降低
// 默认合并，注意：自动去除空白字符或 null 元素
public static <T> String join(T... elements)
示例:
StringUtils.join(null) = null
StringUtils.join([]) = ""
StringUtils.join([null]) = ""
StringUtils.join(["a", "b", "c"]) = "abc"
StringUtils.join([null, "", "a"]) = "a"

// 使用指定间隔符合并，注意：保留空白字符或 null 元素
public static String join(Object[] array,char separator)
示例：
StringUtils.join(["a", "b", "c"], '';'') = "a;b;c"
StringUtils.join([null, "", "a"], '';'') = ";;a"

// 拼接数值
public static String join(long[] array,char separator)
public static String join(int[] array,char separator)
示例：
StringUtils.join([1, 2, 3], '';'') = "1;2;3"
StringUtils.join([1, 2, 3], null) = "123"
（注意：实测与官网文档不符，StringUtils.join (new int []{1, 2, 3}, null); 返回结果是一个很奇怪的字符串 [I@77a82f1；使用 StringUtils.join (new Object []{1, 2, 3}, null)），才会返回期望的 “123”

相关方法：
//joinWith，基本就是把数组参数和间隔符的位置颠倒了一下，意义不大，建议弃用
StringUtils.joinWith(",", {"a", "b"}) = "a,b"

此外，还有大量重载函数，进一步指定起始元素和结束元素，实用性较低，不建议使用。

4.3 截取字符串

相关方法有多个，substring 和 truncate 基本用法同 jdk，内部处理异常

public static String substring(String str,int start)
public static String substring(String str,int start,int end)

public static String truncate(String str,int maxWidth)；
public static String truncate(String str,int offset,int maxWidth)

扩展：

// 直接实现从左侧、右侧或中间截取指定位数，实用性高
public static String left(String str,int len)
public static String right(String str,int len)
public static String mid(String str,int pos,int len)

// 直接实现特定规则，但总体来说适用场景不多
// 截取第一个指定字符前 / 后的字符串返回
public static String substringBefore(String str,String separator)
public static String substringAfter(String str,String separator)
// 截取最后一个指定字符前 / 后的字符串返回
public static String substringBeforeLast(String str,String separator)
public static String substringAfterLast(String str,String separator)
// 截取特定字符串中间部分
public static String substringBetween(String str,String tag)
示例：StringUtils.substringBetween ("tagabctag", "tag") = "abc"
// 返回起止字符串中间的字符串，且只返回第一次匹配结果
public static String substringBetween(String str,String open,String close)
// 返回起止字符串中间的字符串，返回所有匹配结果
public static String[] substringBetween(String str,String open,String close)

4.4 替换字符串
jdk 中使用 replace，StringUtils 使用同样名字，默认替换掉所有匹配项，扩展实现了忽略大小写、只替换一次、指定最大替换次数等
public static String replace(String text,String searchString,String replacement)
public static String replaceChars(String str,char searchChar,char replaceChar)
扩展：
// 忽略大小写
public static String replaceIgnoreCase(String text,String searchString,String replacement)
// 只替换一次
public static String replaceOnce(String text,String searchString,String replacement)
public static String replaceOnceIgnoreCase(String text,String searchString,String replacement)
// 最大替换次数
public static String replace(String text,String searchString,String replacement,int max)
示例：
StringUtils.replace("abaa", "a", "z", 0) = "abaa"
StringUtils.replace("abaa", "a", "z", 1) = "zbaa"
StringUtils.replace("abaa", "a", "z", 2) = "zbza"
StringUtils.replace("abaa", "a", "z", -1) = "zbzz"
注意：
max 是替换次数，0 代表不做替换，-1 代表替换所有，从代码可读性考虑，建议按照常规思维模式使用，别使用这些 0 或者 - 1 比较变态的用法

// 扩展批量，过于复杂，执行结果难以预期，不建议使用
public static String replaceEach(String text,String[] searchList,String[] replacementList)
public static String replaceEachRepeatedly(String text,String[] searchList,String[] replacementList)
public static String replaceChars(String str,String searchChars,String replaceChars)

4.5. 移除字符串
remove，移除字符
public static String remove(String str,char remove)
public static String remove(String str,String remove)
示例：
StringUtils.remove("queued", "ue") = "qd"
（注意，是第二个参数中所有字符，而不是匹配整个字符串）

扩展：
// 忽略大小写
public static String removeIgnoreCase(String str,String remove)
// 移除指定位置
public static String removeStart(String str,String remove)
public static String removeEnd(String str,String remove)
// 指定位置且忽略大小写
public static String removeStartIgnoreCase(String str,String remove)
public static String removeEndIgnoreCase(String str,String remove)

4.6. 覆盖部分字符串
public static String overlay(String str,String overlay,int start,int end)
典型应用场景，隐藏字符串如证件号码、地址或手机号码中部分字符
示例：：
StringUtils.overlay("13712345678","****",3,7)=“137****5678”
注意：实现时做了不少防止异常的处理，比如后面两个参数为止可以调换，会自动判断哪个数字小，哪个就是起始值，然后，如果是负数，则表示添加到开始，如果超出字符串自身长度，添加到末尾，但这些奇特的用法尽量避免使用，否则代码可读性会很差。

4.7 生成字符串
根据指定信息产生字符串
public static String repeat(String str,int repeat)
示例：
StringUtils.repeat("a", 3) = "aaa"
StringUtils.repeat("ab", 2) = "abab"
扩展：
// 指定间隔符
public static String repeat(String str,String separator,int repeat)
示例
StringUtils.repeat("?", ", ", 3) = "?, ?, ?"

4.8 前缀和后缀
// 追加前缀，如只有两个参数，则是无条件追加，超过两个参数，是在不匹配 prefixes 任何情况下才追加
public static String prependIfMissing(String str,CharSequence prefix,CharSequence... prefixes)
public static String prependIfMissingIgnoreCase(String str,CharSequence prefix,CharSequence... prefixes)
/ 追加后缀，如只有两个参数，则是无条件追加，超过两个参数，是在不匹配 suffixes 任何情况下才追加
public static String appendIfMissing(String str,CharSequence suffix,CharSequence... suffixes)
public static String appendIfMissingIgnoreCase(String str,CharSequence suffix,CharSequence... suffixes)

// 无条件同时增加前缀和后缀
public static String wrap(String str,char wrapWith)
public static String wrap(String str,String wrapWith)
// 有条件同时增加前缀和后缀
public static String wrapIfMissing(String str,char wrapWith)
public static String wrapIfMissing(String str,String wrapWith)
// 去除前缀和后缀
public static String unwrap(String str,char wrapChar)
public static String unwrap(String str,String wrapToken)

5. 字符串转换
字符串内容意义不变，形式变化

5.1 大小写转换
转换字符串至大写或小写状态
// 转换大写
public static String upperCase(String str)
public static String upperCase(String str,Locale locale)
// 转换小写
public static String lowerCase(String str)
public static String lowerCase(String str,Locale locale)
// 首字母大写
public static String capitalize(String str)
// 首字母小写
public static String uncapitalize(String str)
// 大小写交换，即大写变小写，小写变大写
public static String swapCase(String str)

5.2 字符串缩略
将字符串缩减为指定宽度
public static String abbreviate(String str,int maxWidth)
注意，maxWidth 必须 >=4，否则抛异常
如果字符长度小于 maxWidth，直接返回该字符串，否则缩减效果为 substring (str, 0, max-3) + "..."

示例：
StringUtils.abbreviate("abcdefg", 4) = "a..."
扩展：
// 可指定缩减字符的省略符号
public static String abbreviate(String str,String abbrevMarker,int maxWidth)
示例：
StringUtils.abbreviate("abcdefg", "..", 4) = "ab.."
StringUtils.abbreviate("abcdefg", "..", 3) = "a.."
另有其他重载函数，可指定起始位置，实现..ab.. 效果，同样过于复杂，会导致代码可读性变差，不建议使用

5.3 补齐字符串
自动补齐至指定宽度，可指定字符，如不指定，默认补空格，有三个，center、leftPad 和 rightPad
使用场景：
1) 显示时补充数据宽度一致使其对齐，更美观
2) 单据流水号，宽度固定，左侧补 0

public static String center(String str,int size)
public static String center(String str,int size,char padChar)
public static String center(String str,int size,String padStr)

public static String leftPad(String str,int size)
public static String leftPad(String str,int size,char padChar)
public static String leftPad(String str,int size,String padStr)

public static String rightPad(String str,int size)
public static String rightPad(String str,int size,char padChar)
public static String rightPad(String str,int size,String padStr)

5.4 旋转字符串
//shift 大于 0 则右旋，小于 0 则左旋
public static String rotate(String str,int shift)
示例：
StringUtils.rotate("abcdefg", 2) = "fgabcde"
StringUtils.rotate("abcdefg", -2) = "cdefgab"
// 完全颠倒字符串顺序
public static String reverse(String str)
// 颠倒字符串顺序，以间隔符为单位进行，单个元素内部不颠倒位置
public static String reverseDelimited(String str,char separatorChar)
示例：
StringUtils.reverseDelimited("a.bc.d",''.'')=“d.bc.a”

5.5 编码转换
// 将字节数组转换为指定编码的字符串
public static String toEncodedString(byte[] bytes,Charset charset)
应用场景：系统间交互时，字符编码不一致，如对方传递的参数编码为 GB2312, 我方编码为 UTF-8，可通过该方法进行转换

// 转换 unicode 位码
public static int[] toCodePoints(CharSequence str)

6 其他

难以归类的一些功能性方法

6.1 取字符串长度
public static int length(CharSequence cs)

6.2. 计算匹配次数
public static int countMatches(CharSequence str,CharSequence sub)
public static int countMatches(CharSequence str,char ch)

6.3 默认值处理
// 获取默认字符串，null 及空格将会返回 “”，其他情况返回原始字符串
public static String defaultString(String str)
// 获取默认字符串，第一个参数为 null 及空格将会返回第二个参数指定值，其他情况返回原始字符串
public static String defaultString(String str,String defaultStr)
// 其他处理，如果为空白或空，返回指定值
public static <T extends CharSequence> T defaultIfBlank(T str,T defaultStr)
public static <T extends CharSequence> T defaultIfEmpty(T str,T defaultStr)
// 其他处理，返回数组中第一个不为空白或不为空的元素
public static <T extends CharSequence> T firstNonBlank(T... values)
public static <T extends CharSequence> T firstNonEmpty(T... values)

6.4. 字符串差异
// 返回字符串差异部分，实用性差，不建议使用
public static String difference(String str1,String str2)
// 返回字符串差异的索引位置
public static int indexOfDifference(CharSequence cs1,CharSequence cs2)
public static int indexOfDifference(CharSequence... css)

6.5 取字符串相同前缀
public static String getCommonPrefix(String... strs)
示例：
StringUtils.getCommonPrefix(new String[] {"abcde", "abxyz"}) = "ab"

原文出处：https://www.cnblogs.com/sealy321/p/10227131.html

关于[1128]commons-lang里面StringUtils方法说明以及案例和stringutils isblank的问题我们已经讲解完毕，感谢您的阅读，如果还想了解更多关于apache commons StringUtils、apache commons StringUtils介绍、apache commons StringUtils工具类使用、Apache Commons 包 StringUtils 工具类深入整理等相关内容，可以在本站寻找。

本文标签：