StringUtils常用方法

官网API地址：http://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/StringUtils.html

Class StringUtils

• java.lang.Object
• • org.apache.commons.lang3.StringUtils

• ---

  
  

  public class StringUtilsextends Object

  Operations on String that are null safe.

  • IsEmpty/IsBlank - checks if a String contains text
  • Trim/Strip - removes leading and trailing whitespace
  • Equals - compares two strings null-safe
  • startsWith - check if a String starts with a prefix null-safe
  • endsWith - check if a String ends with a suffix null-safe
  • IndexOf/LastIndexOf/Contains - null-safe index-of checks
  • IndexOfAny/LastIndexOfAny/IndexOfAnyBut/LastIndexOfAnyBut - index-of any of a set of Strings
  • ContainsOnly/ContainsNone/ContainsAny - does String contains only/none/any of these characters
  • Substring/Left/Right/Mid - null-safe substring extractions
  • SubstringBefore/SubstringAfter/SubstringBetween - substring extraction relative to other strings
  • Split/Join - splits a String into an array of substrings and vice versa
  • Remove/Delete - removes part of a String
  • Replace/Overlay - Searches a String and replaces one String with another
  • Chomp/Chop - removes the last part of a String
  • AppendIfMissing - appends a suffix to the end of the String if not present
  • PrependIfMissing - prepends a prefix to the start of the String if not present
  • LeftPad/RightPad/Center/Repeat - pads a String
  • UpperCase/LowerCase/SwapCase/Capitalize/Uncapitalize - changes the case of a String
  • CountMatches - counts the number of occurrences of one String in another
  • IsAlpha/IsNumeric/IsWhitespace/IsAsciiPrintable - checks the characters in a String
  • DefaultString - protects against a null input String
  • Rotate - rotate (circular shift) a String
  • Reverse/ReverseDelimited - reverses a String
  • Abbreviate - abbreviates a string using ellipsis
  • Difference - compares Strings and reports on their differences
  • LevenshteinDistance - the number of changes needed to change one String into another

  The StringUtils class defines certain words related to String handling.

  • null - null
  • empty - a zero-length string ("")
  • space - the space character (' ', char 32)
  • whitespace - the characters defined by Character.isWhitespace(char)
  • trim - the characters <= 32 as in String.trim()

  StringUtils handles null input Strings quietly. That is to say that a null input will return null. Where a boolean or int is being returned details vary by method.

  A side effect of the null handling is that a NullPointerException should be considered a bug in StringUtils.

  Methods in this class give sample code to explain their operation. The symbol * is used to indicate any input including null.

  #ThreadSafe#

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

 

结果为：
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("\\.") 即可

/*1.字符串以prefix开始*/StringUtils.startsWith("sssdf","");//结果是：trueStringUtils.startsWith("sssdf","");//结果是：trueStringUtils.startsWith("sssdf","s");//结果是：trueStringUtils.startsWith("sssdf","ss");//结果是：trueStringUtils.startsWith("sssdf","sss");//结果是：trueStringUtils.startsWith("sssdf","sssdf");//结果是：trueStringUtils.startsWith("sssdf","f");//结果是：falseStringUtils.startsWith("sssdf","sssdf");//结果是：true/*2.字符串以prefix开始,不区分大小写*/StringUtils.startsWithIgnoreCase("sssdf","Sssdf");//结果是：true/*3.字符串以数组中的字符串开始*/StringUtils.startsWithAny("aabcde",newString[]{"g","f"});//结果是：falseStringUtils.startsWithAny("aabcde",newString[]{"g","a"});//结果是：true/*4.字符串以suffix结束*/StringUtils.endsWith("aabcde","d");//结果是：falseStringUtils.endsWith("aabcde","e");//结果是：falseStringUtils.endsWithIgnoreCase("","");//结果是：false/*5.替换字符串:把text中的searchString替换成replacement，max是最大替换次数，默认是替换所有*/StringUtils.replaceOnce("sshhhss","ss","p");//只替换一次-->结果是：phhhssStringUtils.replace("sshhhs","ss","p");//全部替换--->结果是：phhhsStringUtils.replace("sshhhsshss","ss","7777",2);//max：最大替换次数-->结果是：7777hhh7777hssStringUtils.replaceChars("sshhhs","ss","p");//替换所有字符，区别于replace--->结果是：pphhhp而不是pphhhs/*6.按照数组进行替换，位置要匹配，数组长度要相等;暂时没发现下面replaceEach和replaceEachRepeatedly二者的区别*/StringUtils.replaceEach("www.baidu.com",newString[]{"baidu","com"},newString[]{"taobao","net"});//结果是：www.taobao.netStringUtils.replaceEach("www.baidu,baidu.com",newString[]{"baidu","com"},newString[]{"taobao","net"});//结果是：www.taobao,taobao.netStringUtils.replaceEachRepeatedly("www.baidu.com",newString[]{"baidu","com"},newString[]{"taobao","net"});//结果是：www.taobao.net/*7.比较两个字符串是否相等,如果两个均为null，则也认为相等*/StringUtils.equals("","");//结果是trueStringUtils.equals(null,null);//结果是trueStringUtils.equals("",null);//结果是falseStringUtils.equals(null,"");//结果是falseStringUtils.equalsIgnoreCase("ss","Ss");//不区分大小写--结果是true/*8.返回searchChar在字符串中第一次出现的位置,如果searchChar没有在字符串中出现，则返回-1*/StringUtils.indexOf("sdfsfsfdsf","4");/*结果是-1*/StringUtils.indexOf("sdfsfsfdsf","f");/*结果是2*///查找searchChar在字符串中最后一次出现的索引*/StringUtils.lastIndexOf("aFkyk","k");//结果是4StringUtils.lastIndexOf("aFkyk","");//结果是1/*9.找出字符数组searChars第一次出现在字符串中的位置*/StringUtils.indexOfAny("sdsfhhl0","f");//结果是3StringUtils.indexOfAny("sdsfhhl0",newString[]{"f","0"});//结果是3StringUtils.indexOfAny("sdsfhhl0",newString[]{"t","j"});//结果是-1StringUtils.indexOfAny("sdsfhhl0",newString[]{"t","j",""});//结果是3StringUtils.lastIndexOfAny("aFkyk",newString[]{"aFkyk","k"});//找出字符数组searChars最后一次出现在字符串中的位置--结果是5/*10.找出字符串中不在字符数组searchars中的第一个字符出现的位置(从0位开始)*如果都在，返回-1**/StringUtils.indexOfAnyBut("sdsfhhl0","h");//结果是0StringUtils.indexOfAnyBut("sdsfhhl0","s");//结果是1StringUtils.indexOfAnyBut("aa","aa");//结果是-1/*11.统计参数1和参数2开始部分共有的字符个数*/StringUtils.indexOfDifference("sdsfdsf","s");//结果是1StringUtils.indexOfDifference(newString[]{"sdsfdsf","s"});//结果是1/*12.去掉参数2在参数1开始部分共有的字符串*/StringUtils.difference("灌灌灌灌","灌灌灌灌啊啊");//结果是：啊啊/*13.查找，不区分大小写,没有找到返回-1*/StringUtils.indexOfIgnoreCase("aFabbSSdd","f");//返回1StringUtils.indexOfIgnoreCase("aFabbSSdd","f",2);//从指定位置开始查找，不区分大小写--返回-1StringUtils.indexOfIgnoreCase("aFabbSSdd","f",1);//返回1StringUtils.lastIndexOfIgnoreCase("","");StringUtils.lastIndexOfIgnoreCase("","",2);/*14.截取指定位置的字符串*/StringUtils.substring("dskabcee",3);/*结果是：abcee*/StringUtils.substring("dskabcee",3,5);/*结果是：ab*//*15.截取指定字符串之前的内容*/StringUtils.substringBefore("dskeabcee","e");/*结果是：dskeabce*/StringUtils.substringBeforeLast("dskeabcee","e");//一直找到最后一个指定的字符串/*结果是：dskeabce*/StringUtils.substringAfter("dskeabcedeh","");/*结果是：dskeabcedeh*/StringUtils.substringAfterLast("dskeabcedeh","");/*结果是：*//*16.截取参数2和参数3中间的字符*/StringUtils.substringBetween("dskeabcedeh","ds");/*结果是：null*/StringUtils.substringBetween("dskeabcedeh","ds","e");/*结果是：k*/StringUtils.substringsBetween("dskeabcedeh","ds","e");//以数组方式返回参数2和参数3中间的字符串/*结果是：[keabce]*//*1.分割字符串,可以设定得到数组的长度，但一般情况下不要设定，这样会发生冲突*/StringUtils.split("y5y,4454,545");//默认是按，来分割StringUtils.split("aaaa#sss","#");/*结果是：[aaaa,sss]*/StringUtils.split("aaaa#sss#","#",2);/*2.按不同类型进行分割字符串*/StringUtils.splitByCharacterType("aa3444张三Bcss");/*结果是：[aa,3444,张三,a,B,css,B]*/StringUtils.splitByCharacterTypeCamelCase("");/*结果是：[aa,3444,张三,a,Bcss,B]*//*3.分割字符串，""不会被忽略,可以设置分割字符串的数组长度*/StringUtils.splitByWholeSeparator("aaaa#sss#","#");//""不会被忽略/*结果是：[aaaa,sss,]StringUtils.split结果是：[aaaa,sss]*/StringUtils.splitByWholeSeparator("aaaa#sss#ggg","#");///*结果是：[aaaa,sss,ggg]*/StringUtils.splitByWholeSeparator("aaaa#sss#ggg","");//按空格分割/*结果是：[aaaa#,sss#ggg]*/StringUtils.splitByWholeSeparator("aaaa#sss#","#",2);//2设定返回数组的最大长度/*结果是：[aaaa,sss#]*//*4.分割字符串，""不会被忽略,可以设置分割字符串的数组长度*/StringUtils.splitByWholeSeparatorPreserveAllTokens("sddssfsfasfsaf",null);/*结果是：[sddssf,sfasfsaf,]*/StringUtils.splitByWholeSeparatorPreserveAllTokens("sddssfsfasfsaf","");/*结果是：[sddssf,sfasfsaf,]*//*5.同上*/StringUtils.splitPreserveAllTokens("");StringUtils.splitPreserveAllTokens("","");StringUtils.splitPreserveAllTokens("","",3);

转自：http://www.cnblogs.com/linjiqin/p/3425359.html

http://hai0378.iteye.com/blog/2038289