com.mbap.util.lang

Class StringUtil

java.lang.Object

com.mbap.util.lang.StringUtil

public class StringUtil
extends java.lang.Object

字符串处理工具类

Author:

Amanda.Z

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	EMPTY 空字符串 ""。
static int	INDEX_NOT_FOUND 未被找到的索引值： -1。

Constructor Summary

Constructors

Constructor and Description
StringUtil()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	abbreviate(java.lang.String str, int maxWidth) 功能描述：
static java.lang.String	capitalize(java.lang.String str) 功能描述：
static java.lang.String	collectionToDelimitedString(java.util.Collection<?> coll, java.lang.String delim, java.lang.String prefix, java.lang.String suffix) 功能描述:来自spring的stringutils 将coll中的每个元素用prefix和suffix包裹，返回用delim分割的字符串
static boolean	contains(java.lang.String str, java.lang.String searchStr) 功能描述：
static java.lang.String	deleteWhitespace(java.lang.String str) 功能描述：
static boolean	endsWith(java.lang.String str, java.lang.String suffix) 功能描述：
static boolean	endsWithIgnoreCase(java.lang.String str, java.lang.String suffix) 功能描述：
static boolean	equals(java.lang.String str1, java.lang.String str2) 功能描述：
static boolean	equalsIgnoreCase(java.lang.String str1, java.lang.String str2) 功能描述：
static int	indexOf(java.lang.String str, java.lang.String searchStr) 功能描述：
static int	indexOf(java.lang.String str, java.lang.String searchStr, int startPos) 功能描述：
static boolean	isAllLowerCase(java.lang.String str) 功能描述：
static boolean	isAllUpperCase(java.lang.String str) 功能描述：
static boolean	isAlpha(java.lang.String str) 功能描述：
static boolean	isAlphanumeric(java.lang.String str) 功能描述：
static boolean	isAlphanumericSpace(java.lang.String str) 功能描述：
static boolean	isAlphaSpace(java.lang.String str) 功能描述：
static boolean	isAsciiPrintable(java.lang.String str) 功能描述：
static boolean	isBlank(java.lang.String str) 功能描述：
static boolean	isEmpty(java.lang.String str) 功能描述：
static boolean	isNotBlank(java.lang.String str) 功能描述：
static boolean	isNotEmpty(java.lang.String str) 功能描述：
static boolean	isNumeric(java.lang.String str) 功能描述：
static boolean	isNumericSpace(java.lang.String str) 功能描述：
static boolean	isWhitespace(java.lang.String str) 功能描述：
static java.lang.String	join(java.util.Collection collection, java.lang.String separator) 功能描述：
static java.lang.String	join(java.util.Iterator iterator, java.lang.String separator) 功能描述：
static java.lang.String	join(java.lang.Object[] array) 功能描述：
static java.lang.String	join(java.lang.Object[] array, java.lang.String separator) 功能描述：
static int	lastIndexOf(java.lang.String str, java.lang.String searchStr) 功能描述：
static int	lastIndexOf(java.lang.String str, java.lang.String searchStr, int startPos) 功能描述：
static java.lang.String	lowerCase(java.lang.String str) 功能描述：
static java.lang.String	remove(java.lang.String str, java.lang.String remove) 功能描述：
static java.lang.String	replace(java.lang.String text, java.lang.String searchString, java.lang.String replacement) 功能描述：
static java.lang.String[]	split(java.lang.String str) 功能描述：
static java.lang.String[]	split(java.lang.String str, java.lang.String separatorChars) 功能描述：
static boolean	startsWith(java.lang.String str, java.lang.String prefix) 功能描述：
static boolean	startsWithIgnoreCase(java.lang.String str, java.lang.String prefix) 功能描述：
static java.lang.String	strip(java.lang.String str) 功能描述：
static java.lang.String	substring(java.lang.String str, int start) 功能描述：
static java.lang.String	substring(java.lang.String str, int start, int end) 功能描述：
static java.lang.String	trim(java.lang.String str) 功能描述：
static java.lang.String	trimAll(java.lang.String str) 功能描述：去掉字符串中所有的空格、制表符、换行、回车
static java.lang.String	uncapitalize(java.lang.String str) 功能描述：
static java.lang.String	upperCase(java.lang.String str) 功能描述：

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

EMPTY

public static final java.lang.String EMPTY

空字符串 ""。

See Also:

Constant Field Values

INDEX_NOT_FOUND

public static final int INDEX_NOT_FOUND

未被找到的索引值： -1。

See Also:

Constant Field Values

Constructor Detail

StringUtil

public StringUtil()

Method Detail

isEmpty

public static boolean isEmpty(java.lang.String str)

功能描述：

判断一个字符串是否为空字符串或者为null。

 StringUtil.isEmpty(null)      = true
 StringUtil.isEmpty("")        = true
 StringUtil.isEmpty(" ")       = false
 StringUtil.isEmpty("bob")     = false
 StringUtil.isEmpty("  bob  ") = false
 

Parameters:

str - 要判断的字符串

Returns:

如果str为空字符串或者为null，则返回true，否则返回false。

isNotEmpty

public static boolean isNotEmpty(java.lang.String str)

功能描述：

判断一个字符串不为空字符串或者不为null。

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

Parameters:

str - 要判断的字符串

Returns:

如果str为空字符串或者为null，则返回false，否则返回true。

isBlank

public static boolean isBlank(java.lang.String str)

功能描述：

判断一个字符串是否为空字符串、null或只包含空格。

 StringUtil.isBlank(null)      = true
 StringUtil.isBlank("")        = true
 StringUtil.isBlank(" ")       = true
 StringUtil.isBlank("bob")     = false
 StringUtil.isBlank("  bob  ") = false
 

Parameters:

str - 要判断的字符串

Returns:

如果str为空字符串、null或只包含空格，则返回true，否则返回false。

isNotBlank

public static boolean isNotBlank(java.lang.String str)

功能描述：

判断一个字符串非 空字符串、null或只包含空格。

 StringUtil.isNotBlank(null)      = false
 StringUtil.isNotBlank("")        = false
 StringUtil.isNotBlank(" ")       = false
 StringUtil.isNotBlank("bob")     = true
 StringUtil.isNotBlank("  bob  ") = true
 

Parameters:

str - 要判断的字符串

Returns:

如果str为空字符串、null或只包含空格，则返回false，否则返回true。

trim

public static java.lang.String trim(java.lang.String str)

功能描述：

删除字符串两端的空白字符或者返回null。

 StringUtil.trim(null)          = null
 StringUtil.trim("")            = ""
 StringUtil.trim("     ")       = ""
 StringUtil.trim("abc")         = "abc"
 StringUtil.trim("    abc    ") = "abc"
 

Parameters:

str - 要处理的字符串

Returns:

处理后的字符串，如果str为null，则返回null。

strip

public static java.lang.String strip(java.lang.String str)

功能描述：

删除字符串两端空格。

 StringUtil.strip(null)     = null
 StringUtil.strip("")       = ""
 StringUtil.strip("   ")    = ""
 StringUtil.strip("abc")    = "abc"
 StringUtil.strip("  abc")  = "abc"
 StringUtil.strip("abc  ")  = "abc"
 StringUtil.strip(" abc ")  = "abc"
 StringUtil.strip(" ab c ") = "ab c"
 

Parameters:

str - 要处理的字符串

Returns:

处理后的字符串，如果str为null，则返回null。

equals

public static boolean equals(java.lang.String str1,
                             java.lang.String str2)

功能描述：

比较两个字符串是否相等。

 StringUtil.equals(null, null)   = true
 StringUtil.equals(null, "abc")  = false
 StringUtil.equals("abc", null)  = false
 StringUtil.equals("abc", "abc") = true
 StringUtil.equals("abc", "ABC") = false
 

Parameters:

str1 - 要比较的字符串

str2 - 要比较的字符串

Returns:

如果两个字符串相等，返回true，否则返回false

equalsIgnoreCase

public static boolean equalsIgnoreCase(java.lang.String str1,
                                       java.lang.String str2)

功能描述：

比较两个字符串是否相等，忽略大小写。

 StringUtil.equalsIgnoreCase(null, null)   = true
 StringUtil.equalsIgnoreCase(null, "abc")  = false
 StringUtil.equalsIgnoreCase("abc", null)  = false
 StringUtil.equalsIgnoreCase("abc", "abc") = true
 StringUtil.equalsIgnoreCase("abc", "ABC") = true
 

Parameters:

str1 - 要比较的字符串

str2 - 要比较的字符串

Returns:

如果两个字符串相等，返回true，否则返回false

indexOf

public static int indexOf(java.lang.String str,
                          java.lang.String searchStr)

功能描述：

获取指定字符串在字符串中第一次出现处的索引。

 StringUtil.indexOf(null, *)          = -1
 StringUtil.indexOf(*, null)          = -1
 StringUtil.indexOf("", "")           = 0
 StringUtil.indexOf("aabaabaa", "a")  = 0
 StringUtil.indexOf("aabaabaa", "b")  = 2
 StringUtil.indexOf("aabaabaa", "ab") = 1
 StringUtil.indexOf("aabaabaa", "")   = 0
 

Parameters:

str - 要搜索的字符串

searchStr - 要查找的字符串

Returns:

第一次出现处的索引

如果str为null，或者没有找到指定字符串，则返回-1。

indexOf

public static int indexOf(java.lang.String str,
                          java.lang.String searchStr,
                          int startPos)

功能描述：

获取指定字符串在字符串中第一次出现处的索引，从指定索引处开始。

 StringUtil.indexOf(null, *, *)          = -1
 StringUtil.indexOf(*, null, *)          = -1
 StringUtil.indexOf("", "", 0)           = 0
 StringUtil.indexOf("aabaabaa", "a", 0)  = 0
 StringUtil.indexOf("aabaabaa", "b", 0)  = 2
 StringUtil.indexOf("aabaabaa", "ab", 0) = 1
 StringUtil.indexOf("aabaabaa", "b", 3)  = 5
 StringUtil.indexOf("aabaabaa", "b", 9)  = -1
 StringUtil.indexOf("aabaabaa", "b", -1) = 2
 StringUtil.indexOf("aabaabaa", "", 2)   = 2
 StringUtil.indexOf("abc", "", 9)        = 3
 

Parameters:

str - 要搜索的字符串

searchStr - 要查找的字符串

startPos - 开始索引

Returns:

第一次出现处的索引

如果str为null，或者没有找到指定字符串，则返回-1。

lastIndexOf

public static int lastIndexOf(java.lang.String str,
                              java.lang.String searchStr)

功能描述：

获取指定字符串在字符串中最后一次出现处的索引。

 StringUtil.lastIndexOf(null, *)          = -1
 StringUtil.lastIndexOf(*, null)          = -1
 StringUtil.lastIndexOf("", "")           = 0
 StringUtil.lastIndexOf("aabaabaa", "a")  = 0
 StringUtil.lastIndexOf("aabaabaa", "b")  = 2
 StringUtil.lastIndexOf("aabaabaa", "ab") = 1
 StringUtil.lastIndexOf("aabaabaa", "")   = 8
 

Parameters:

str - 要搜索的字符串

searchStr - 要查找的字符串

Returns:

最后一次出现处的索引

如果str为null，或者没有找到指定字符串，则返回-1。

lastIndexOf

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

功能描述：

获取指定字符串在字符串中最后一次出现处的索引，从指定索引处开始。

 StringUtil.lastIndexOf(null, *, *)          = -1
 StringUtil.lastIndexOf(*, null, *)          = -1
 StringUtil.lastIndexOf("aabaabaa", "a", 8)  = 7
 StringUtil.lastIndexOf("aabaabaa", "b", 8)  = 5
 StringUtil.lastIndexOf("aabaabaa", "ab", 8) = 4
 StringUtil.lastIndexOf("aabaabaa", "b", 9)  = 5
 StringUtil.lastIndexOf("aabaabaa", "b", -1) = -1
 StringUtil.lastIndexOf("aabaabaa", "a", 0)  = 0
 StringUtil.lastIndexOf("aabaabaa", "b", 0)  = -1
 

Parameters:

str - 要搜索的字符串

searchStr - 要查找的字符串

startPos - 开始索引

Returns:

最后一次出现处的索引

如果str为null，或者没有找到指定字符串，则返回-1。

contains

public static boolean contains(java.lang.String str,
                               java.lang.String searchStr)

功能描述：

判断字符串中是否包含指定字符。

 StringUtil.contains(null, *)     = false
 StringUtil.contains(*, null)     = false
 StringUtil.contains("", "")      = true
 StringUtil.contains("abc", "")   = true
 StringUtil.contains("abc", "a")  = true
 StringUtil.contains("abc", "z")  = false
 

Parameters:

str - 要搜索的字符串

searchStr - 要查找的字符串

Returns:

如果字符串中是否包含指定字符，则返回true，否则返回false

如果str为null，则返回false

substring

public static java.lang.String substring(java.lang.String str,
                                         int start)

功能描述：

截取字符串，从指定索引处开始。

 StringUtil.substring(null, *)   = null
 StringUtil.substring("", *)     = ""
 StringUtil.substring("abc", 0)  = "abc"
 StringUtil.substring("abc", 2)  = "c"
 StringUtil.substring("abc", 4)  = ""
 StringUtil.substring("abc", -2) = "bc"
 StringUtil.substring("abc", -4) = "abc"
 

Parameters:

str - 要截取的字符串

start - 开始索引

Returns:

子字符串，如果str为null，则返回null

substring

public static java.lang.String substring(java.lang.String str,
                                         int start,
                                         int end)

功能描述：

截取字符串，从指定索引处开始，到指定索引处结束。

 StringUtil.substring(null, *, *)    = null
 StringUtil.substring("", * ,  *)    = "";
 StringUtil.substring("abc", 0, 2)   = "ab"
 StringUtil.substring("abc", 2, 0)   = ""
 StringUtil.substring("abc", 2, 4)   = "c"
 StringUtil.substring("abc", 4, 6)   = ""
 StringUtil.substring("abc", 2, 2)   = ""
 StringUtil.substring("abc", -2, -1) = "b"
 StringUtil.substring("abc", -4, 2)  = "ab"
 

Parameters:

str - 要截取的字符串

start - 开始索引

end - 结束索引

Returns:

子字符串，如果str为null，则返回null

split

public static java.lang.String[] split(java.lang.String str)

功能描述：

分割字符串，使用空格作为分隔符。

 StringUtil.split(null)       = null
 StringUtil.split("")         = []
 StringUtil.split("abc def")  = ["abc", "def"]
 StringUtil.split("abc  def") = ["abc", "def"]
 StringUtil.split(" abc ")    = ["abc"]
 

Parameters:

str - 要分割的字符串

Returns:

字符串数组，如果str为null，则返回null

split

public static java.lang.String[] split(java.lang.String str,
                                       java.lang.String separatorChars)

功能描述：

分割字符串，使用指定的字符串作为分隔符。

 StringUtil.split(null, *)         = null
 StringUtil.split("", *)           = []
 StringUtil.split("abc def", null) = ["abc", "def"]
 StringUtil.split("abc def", " ")  = ["abc", "def"]
 StringUtil.split("abc  def", " ") = ["abc", "def"]
 StringUtil.split("ab:cd:ef", ":") = ["ab", "cd", "ef"]
 

Parameters:

str - 要分割的字符串

separatorChars - 分隔符

Returns:

字符串数组，如果str为null，则返回null

join

public static java.lang.String join(java.lang.Object[] array)

功能描述：

将数组中的所有元素拼凑成字符串。

 StringUtil.join(null)            = null
 StringUtil.join([])              = ""
 StringUtil.join([null])          = ""
 StringUtil.join(["a", "b", "c"]) = "abc"
 StringUtil.join([null, "", "a"]) = "a"
 

Parameters:

array - 要处理的数组

Returns:

拼凑成的字符串，如果array为null，则返回null

join

public static java.lang.String join(java.lang.Object[] array,
                                    java.lang.String separator)

功能描述：

将数组中的所有元素拼凑成字符串，使用指定的字符串作为分隔符。

 StringUtil.join(null, *)                = null
 StringUtil.join([], *)                  = ""
 StringUtil.join([null], *)              = ""
 StringUtil.join(["a", "b", "c"], "--")  = "a--b--c"
 StringUtil.join(["a", "b", "c"], null)  = "abc"
 StringUtil.join(["a", "b", "c"], "")    = "abc"
 StringUtil.join([null, "", "a"], ',')   = ",,a"
 

Parameters:

array - 要处理的数组

separator - 分隔符

Returns:

拼凑成的字符串，如果array为null，则返回null

join

public static java.lang.String join(java.util.Iterator iterator,
                                    java.lang.String separator)

功能描述：

将迭代器中的所有元素拼凑成字符串，使用指定的字符串作为分隔符。

 StringUtil.join(null, *)                = null
 StringUtil.join([], *)                  = ""
 StringUtil.join([null], *)              = ""
 StringUtil.join(["a", "b", "c"], "--")  = "a--b--c"
 StringUtil.join(["a", "b", "c"], null)  = "abc"
 StringUtil.join(["a", "b", "c"], "")    = "abc"
 StringUtil.join([null, "", "a"], ',')   = ",,a"
 

Parameters:

iterator - 要处理的迭代器

separator - 分隔符

Returns:

拼凑成的字符串，如果array为null，则返回null

join

public static java.lang.String join(java.util.Collection collection,
                                    java.lang.String separator)

功能描述：

将集合中的所有元素拼凑成字符串，使用指定的字符串作为分隔符。

 StringUtil.join(null, *)                = null
 StringUtil.join([], *)                  = ""
 StringUtil.join([null], *)              = ""
 StringUtil.join(["a", "b", "c"], "--")  = "a--b--c"
 StringUtil.join(["a", "b", "c"], null)  = "abc"
 StringUtil.join(["a", "b", "c"], "")    = "abc"
 StringUtil.join([null, "", "a"], ',')   = ",,a"
 

Parameters:

collection - 要处理的集合

separator - 分隔符

Returns:

拼凑成的字符串，如果array为null，则返回null

deleteWhitespace

public static java.lang.String deleteWhitespace(java.lang.String str)

功能描述：

删除字符串中的空格字符。

 StringUtil.deleteWhitespace(null)         = null
 StringUtil.deleteWhitespace("")           = ""
 StringUtil.deleteWhitespace("abc")        = "abc"
 StringUtil.deleteWhitespace("   ab  c  ") = "abc"
 

Parameters:

str - 要处理的字符串

Returns:

处理后的字符串，如果str为null，则返回null

trimAll

public static java.lang.String trimAll(java.lang.String str)

功能描述：去掉字符串中所有的空格、制表符、换行、回车

Parameters:

str - 需要替换的字符串

Returns:

匹配替换后的字符串

remove

public static java.lang.String remove(java.lang.String str,
                                      java.lang.String remove)

功能描述：

从字符串中删除指定的子字符串。

 StringUtil.remove(null, *)        = null
 StringUtil.remove("", *)          = ""
 StringUtil.remove(*, null)        = *
 StringUtil.remove(*, "")          = *
 StringUtil.remove("queued", "ue") = "qd"
 StringUtil.remove("queued", "zz") = "queued"
 

Parameters:

str - 要处理的字符串

remove - 要删除的子字符串

Returns:

处理后的字符串，如果str为null，则返回null

replace

public static java.lang.String replace(java.lang.String text,
                                       java.lang.String searchString,
                                       java.lang.String replacement)

功能描述：

替换字符串。

 StringUtil.replace(null, *, *)        = null
 StringUtil.replace("", *, *)          = ""
 StringUtil.replace("any", null, *)    = "any"
 StringUtil.replace("any", *, null)    = "any"
 StringUtil.replace("any", "", *)      = "any"
 StringUtil.replace("aba", "a", null)  = "aba"
 StringUtil.replace("aba", "a", "")    = "b"
 StringUtil.replace("aba", "a", "z")   = "zbz"
 

Parameters:

text - 要处理的字符串

searchString - 要被替换的字符串

replacement - 要替换的字符串

Returns:

处理后的字符串，如果str为null，则返回null

upperCase

public static java.lang.String upperCase(java.lang.String str)

功能描述：

将字符串转换成大写。

 StringUtil.upperCase(null)  = null
 StringUtil.upperCase("")    = ""
 StringUtil.upperCase("aBc") = "ABC"
 

Parameters:

str - 要处理的字符串

Returns:

大写的字符串，如果str为null，则返回null

lowerCase

public static java.lang.String lowerCase(java.lang.String str)

功能描述：

将字符串转换成小写。

 StringUtil.lowerCase(null)  = null
 StringUtil.lowerCase("")    = ""
 StringUtil.lowerCase("aBc") = "abc"
 

Parameters:

str - 要处理的字符串

Returns:

小写的字符串，如果str为null，则返回null

capitalize

public static java.lang.String capitalize(java.lang.String str)

功能描述：

将字符串的首字母转换成大写。

 StringUtil.capitalize(null)  = null
 StringUtil.capitalize("")    = ""
 StringUtil.capitalize("cat") = "Cat"
 StringUtil.capitalize("cAt") = "CAt"
 

Parameters:

str - 要处理的字符串

Returns:

处理后的字符串

uncapitalize

public static java.lang.String uncapitalize(java.lang.String str)

功能描述：

将字符串的首字母转换成小写。

 StringUtil.uncapitalize(null)  = null
 StringUtil.uncapitalize("")    = ""
 StringUtil.uncapitalize("Cat") = "cat"
 StringUtil.uncapitalize("CAT") = "cAT"
 

Parameters:

str - 要处理的字符串

Returns:

处理后的字符串

isAlpha

public static boolean isAlpha(java.lang.String str)

功能描述：

判断字符串中是否只包含字母。

 StringUtil.isAlpha(null)   = false
 StringUtil.isAlpha("")     = true
 StringUtil.isAlpha("  ")   = false
 StringUtil.isAlpha("abc")  = true
 StringUtil.isAlpha("ab2c") = false
 StringUtil.isAlpha("ab-c") = false
 

Parameters:

str - 要判断的字符串

Returns:

如果字符串中只包含字母，则返回true，否则返回false

如果str为null，则返回false

isAlphaSpace

public static boolean isAlphaSpace(java.lang.String str)

功能描述：

判断字符串中是否只包含字母和空格。

 StringUtil.isAlphaSpace(null)   = false
 StringUtil.isAlphaSpace("")     = true
 StringUtil.isAlphaSpace("  ")   = true
 StringUtil.isAlphaSpace("abc")  = true
 StringUtil.isAlphaSpace("ab c") = true
 StringUtil.isAlphaSpace("ab2c") = false
 StringUtil.isAlphaSpace("ab-c") = false
 

Parameters:

str - 要判断的字符串

Returns:

如果字符串中是否只包含字母和空格，则返回true，否则返回false

如果str为null，则返回false

isAlphanumeric

public static boolean isAlphanumeric(java.lang.String str)

功能描述：

判断字符串中是否只包含字母和数字。

 StringUtil.isAlphanumeric(null)   = false
 StringUtil.isAlphanumeric("")     = true
 StringUtil.isAlphanumeric("  ")   = false
 StringUtil.isAlphanumeric("abc")  = true
 StringUtil.isAlphanumeric("ab c") = false
 StringUtil.isAlphanumeric("ab2c") = true
 StringUtil.isAlphanumeric("ab-c") = false
 

Parameters:

str - 要判断的字符串

Returns:

如果字符串中只包含字母和数字，则返回true，否则返回false

如果str为null，则返回false

isAlphanumericSpace

public static boolean isAlphanumericSpace(java.lang.String str)

功能描述：

判断字符串中是否只包含字母、空格和数字。

 StringUtil.isAlphanumericSpace(null)   = false
 StringUtil.isAlphanumericSpace("")     = true
 StringUtil.isAlphanumericSpace("  ")   = false
 StringUtil.isAlphanumericSpace("abc")  = true
 StringUtil.isAlphanumericSpace("ab c") = false
 StringUtil.isAlphanumericSpace("ab2c") = true
 StringUtil.isAlphanumericSpace("ab-c") = false
 

Parameters:

str - 要判断的字符串

Returns:

如果字符串中只包含字母、空格和数字，则返回true，否则返回false

如果str为null，则返回false

isAsciiPrintable

public static boolean isAsciiPrintable(java.lang.String str)

功能描述：

判断字符串中是否只包含ASCII可打印的字符。

 StringUtil.isAsciiPrintable(null)     = false
 StringUtil.isAsciiPrintable("")       = true
 StringUtil.isAsciiPrintable(" ")      = true
 StringUtil.isAsciiPrintable("Ceki")   = true
 StringUtil.isAsciiPrintable("ab2c")   = true
 StringUtil.isAsciiPrintable("!ab-c~") = true
 StringUtil.isAsciiPrintable(" ") = true
 StringUtil.isAsciiPrintable("!") = true
 StringUtil.isAsciiPrintable("~") = true
 StringUtil.isAsciiPrintable("") = false
 StringUtil.isAsciiPrintable("Ceki Gülcü") = false
 

Parameters:

str - 要判断的字符串

Returns:

如果字符串中是否只包含ASCII可打印的字符，则返回true，否则返回false

如果str为null，则返回false

isNumeric

public static boolean isNumeric(java.lang.String str)

功能描述：

判断字符串中是否只包含数字。

 StringUtil.isNumeric(null)   = false
 StringUtil.isNumeric("")     = true
 StringUtil.isNumeric("  ")   = false
 StringUtil.isNumeric("123")  = true
 StringUtil.isNumeric("12 3") = false
 StringUtil.isNumeric("ab2c") = false
 StringUtil.isNumeric("12-3") = false
 StringUtil.isNumeric("12.3") = false
 

Parameters:

str - 要判断的字符串

Returns:

如果字符串中只包含数字，则返回true，否则返回false

如果str为null，则返回false

isNumericSpace

public static boolean isNumericSpace(java.lang.String str)

功能描述：

判断字符串中是否只包含数字和空格。

 StringUtil.isNumericSpace(null)   = false
 StringUtil.isNumericSpace("")     = true
 StringUtil.isNumericSpace("  ")   = true
 StringUtil.isNumericSpace("123")  = true
 StringUtil.isNumericSpace("12 3") = true
 StringUtil.isNumericSpace("ab2c") = false
 StringUtil.isNumericSpace("12-3") = false
 StringUtil.isNumericSpace("12.3") = false
 

Parameters:

str - 要判断的字符串

Returns:

如果字符串中是否只包含数字和空格，则返回true，否则返回false

如果str为null，则返回false

isWhitespace

public static boolean isWhitespace(java.lang.String str)

功能描述：

判断字符串中是否只包含空格。

 StringUtil.isWhitespace(null)   = false
 StringUtil.isWhitespace("")     = true
 StringUtil.isWhitespace("  ")   = true
 StringUtil.isWhitespace("abc")  = false
 StringUtil.isWhitespace("ab2c") = false
 StringUtil.isWhitespace("ab-c") = false
 

Parameters:

str - 要判断的字符串

Returns:

如果字符串中是否只包含空格，则返回true，否则返回false

如果str为null，则返回false

isAllLowerCase

public static boolean isAllLowerCase(java.lang.String str)

功能描述：

判断字符串中是否只包含小写字符。

 StringUtil.isAllLowerCase(null)   = false
 StringUtil.isAllLowerCase("")     = false
 StringUtil.isAllLowerCase("  ")   = false
 StringUtil.isAllLowerCase("abc")  = true
 StringUtil.isAllLowerCase("abC") = false
 

Parameters:

str - 要判断的字符串

Returns:

如果字符串中是否只包含小写字符，则返回true，否则返回false

如果str为null，则返回false

isAllUpperCase

public static boolean isAllUpperCase(java.lang.String str)

功能描述：

判断字符串中是否只包含大写字符。

 StringUtil.isAllUpperCase(null)   = false
 StringUtil.isAllUpperCase("")     = false
 StringUtil.isAllUpperCase("  ")   = false
 StringUtil.isAllUpperCase("ABC")  = true
 StringUtil.isAllUpperCase("aBC") = false
 

Parameters:

str - 要判断的字符串

Returns:

如果字符串中是否只包含大写字符，则返回true，否则返回false

如果str为null，则返回false

abbreviate

public static java.lang.String abbreviate(java.lang.String str,
                                          int maxWidth)

功能描述：

缩写字符串。

 StringUtil.abbreviate(null, *)      = null
 StringUtil.abbreviate("", 4)        = ""
 StringUtil.abbreviate("abcdefg", 6) = "abc..."
 StringUtil.abbreviate("abcdefg", 7) = "abcdefg"
 StringUtil.abbreviate("abcdefg", 8) = "abcdefg"
 StringUtil.abbreviate("abcdefg", 4) = "a..."
 StringUtil.abbreviate("abcdefg", 3) = IllegalArgumentException
 

Parameters:

str - 要处理的字符串

maxWidth - 缩写后的字符串的最大长度

Returns:

处理后的字符串，如果str为null，则返回null

Throws:

java.lang.IllegalArgumentException - 如果maxWidth太小

startsWith

public static boolean startsWith(java.lang.String str,
                                 java.lang.String prefix)

功能描述：

判断字符串是否以指定的字符串开始。

Parameters:

str - 要判断的字符串

prefix - 开始字符串

 StringUtil.startsWith(null, null)      = true
 StringUtil.startsWith(null, "abc")     = false
 StringUtil.startsWith("abcdef", null)  = false
 StringUtil.startsWith("abcdef", "abc") = true
 StringUtil.startsWith("ABCDEF", "abc") = false
 

Returns:

如果字符串是否以指定的字符串开始，则返回true，否则返回false

startsWithIgnoreCase

public static boolean startsWithIgnoreCase(java.lang.String str,
                                           java.lang.String prefix)

功能描述：

判断字符串是否以指定的字符串开始，忽略大小写。

Parameters:

str - 要判断的字符串

prefix - 开始字符串

 StringUtil.startsWithIgnoreCase(null, null)      = true
 StringUtil.startsWithIgnoreCase(null, "abc")     = false
 StringUtil.startsWithIgnoreCase("abcdef", null)  = false
 StringUtil.startsWithIgnoreCase("abcdef", "abc") = true
 StringUtil.startsWithIgnoreCase("ABCDEF", "abc") = true
 

Returns:

如果字符串是否以指定的字符串开始，则返回true，否则返回false

endsWith

public static boolean endsWith(java.lang.String str,
                               java.lang.String suffix)

功能描述：

判断字符串是否以指定的字符串结束。

Parameters:

str - 要判断的字符串

suffix - 结束字符串

 StringUtil.endsWith(null, null)      = true
 StringUtil.endsWith(null, "def")     = false
 StringUtil.endsWith("abcdef", null)  = false
 StringUtil.endsWith("abcdef", "def") = true
 StringUtil.endsWith("ABCDEF", "def") = false
 StringUtil.endsWith("ABCDEF", "cde") = false
 

Returns:

如果字符串是否以指定的字符串结束，则返回true，否则返回false

endsWithIgnoreCase

public static boolean endsWithIgnoreCase(java.lang.String str,
                                         java.lang.String suffix)

功能描述：

判断字符串是否以指定的字符串结束，忽略大小写。

Parameters:

str - 要判断的字符串

suffix - 结束字符串

 StringUtil.endsWithIgnoreCase(null, null)      = true
 StringUtil.endsWithIgnoreCase(null, "def")     = false
 StringUtil.endsWithIgnoreCase("abcdef", null)  = false
 StringUtil.endsWithIgnoreCase("abcdef", "def") = true
 StringUtil.endsWithIgnoreCase("ABCDEF", "def") = true
 StringUtil.endsWithIgnoreCase("ABCDEF", "cde") = false
 

Returns:

如果字符串是否以指定的字符串结束，则返回true，否则返回false

collectionToDelimitedString

public static java.lang.String collectionToDelimitedString(java.util.Collection<?> coll,
                                                           java.lang.String delim,
                                                           java.lang.String prefix,
                                                           java.lang.String suffix)

功能描述:来自spring的stringutils 将coll中的每个元素用prefix和suffix包裹，返回用delim分割的字符串

Parameters:

coll - 待处理的集合

delim - 集合元素分割字符

prefix - 包裹集合元素的前缀

suffix - 包裹集合元素的后缀

Returns:

最后的处理结果