Apache StringUtils 工具类Api详解

导入maven依赖

<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-lang3</artifactId>
</dependency>

Api 作用及示例

Empty系列

boolean isEmpty(final CharSequence cs)

​ 作用：检查给定的字符串是否为 "" 或者 null

​ 示例：

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

boolean isNotEmpty(final CharSequence cs)

作用：检查给定的字符串是否不为 "" 或者 null

示例：

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

boolean isAnyEmpty(final CharSequence… css)

作用：检查给定的字符串序列，如果有一个为空""或者null,则返回true

示例：

StringUtils.isAnyEmpty((String) null)    = true
StringUtils.isAnyEmpty((String[]) null)  = false
StringUtils.isAnyEmpty(null, "foo")      = true
StringUtils.isAnyEmpty("", "bar")        = true
StringUtils.isAnyEmpty("bob", "")        = true
StringUtils.isAnyEmpty("  bob  ", null)  = true
StringUtils.isAnyEmpty(" ", "bar")       = false
StringUtils.isAnyEmpty("foo", "bar")     = false
StringUtils.isAnyEmpty(new String[]{})   = false
StringUtils.isAnyEmpty(new String[]{""}) = true

boolean isNoneEmpty(final CharSequence… css)

作用：和isAnyEmpty相反，检查给定的字符串序列，如果全都不为空""或者null,则返回true

示例：

StringUtils.isNoneEmpty((String) null)    = false
StringUtils.isNoneEmpty((String[]) null)  = true
StringUtils.isNoneEmpty(null, "foo")      = false
StringUtils.isNoneEmpty("", "bar")        = false
StringUtils.isNoneEmpty("bob", "")        = false
StringUtils.isNoneEmpty("  bob  ", null)  = false
StringUtils.isNoneEmpty(new String[] {})  = true
StringUtils.isNoneEmpty(new String[]{""}) = false
StringUtils.isNoneEmpty(" ", "bar")       = true
StringUtils.isNoneEmpty("foo", "bar")     = true

boolean isAllEmpty(final CharSequence… css)

作用：检查给定的字符串序列，如果全都为空""或者null，则返回true

示例：

StringUtils.isAllEmpty(null)             = true
StringUtils.isAllEmpty(null, "")         = true
StringUtils.isAllEmpty(new String[] {})  = true
StringUtils.isAllEmpty(null, "foo")      = false
StringUtils.isAllEmpty("", "bar")        = false
StringUtils.isAllEmpty("bob", "")        = false
StringUtils.isAllEmpty("  bob  ", null)  = false
StringUtils.isAllEmpty(" ", "bar")       = false
StringUtils.isAllEmpty("foo", "bar")     = false

Blank系列

boolean isBlank(final CharSequence cs)

​ 作用：检查给定的字符串是否为 "" 或者 " " (空格字符串) 或者 null

​ 示例：

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

String trim(final String str)

作用：移除给定字符串的首尾空格

示例：

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

String strip(final String str)

作用：与trim()类似，移除给定字符串的首位空格

示例：

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

String strip(String str, final String stripChars)

作用：从str的开头和结尾移除stripChars字符串中匹配的任意字符(可多个)； 如果stripChars为null，则按空格移除

示例：

StringUtils.strip(null, *)          = null
StringUtils.strip("", *)            = ""
StringUtils.strip("abc", null)      = "abc"
StringUtils.strip("  abc", null)    = "abc"
StringUtils.strip("abc  ", null)    = "abc"
StringUtils.strip(" abc ", null)    = "abc"
StringUtils.strip("  abcyx", "xyz") = "  abc"

String stripStart(final String str, final String stripChars)

作用：从str的开始位置移除stripChars中匹配的任意字符；如果stripChars为null，则按照空格移除

示例：

StringUtils.stripStart(null, *)          = null
StringUtils.stripStart("", *)            = ""
StringUtils.stripStart("abc", "")        = "abc"
StringUtils.stripStart("abc", null)      = "abc"
StringUtils.stripStart("  abc", null)    = "abc"
StringUtils.stripStart("abc  ", null)    = "abc  "
 StringUtils.stripStart(" abc ", null)    = "abc "
StringUtils.stripStart("yxabc  ", "xyz") = "abc  "

boolean equals(final CharSequence cs1, final CharSequence cs2)

作用：比较两个字符串是否相等，包含null，两个null值比较被视为相等，不区分大小写

示例：

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

boolean equalsIgnoreCase(final CharSequence str1, final CharSequence str2)

作用：比较两个字符串是否相等，包含null，两个null值比较被视为相等，区分大小写

示例：

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

int compare(final String str1, final String str2)

作用：按字典顺序比较两个字符串的大小。如果str1=str2,返回int=0；str1<str2，返回int<0,反之int>0.

示例：

StringUtils.compare(null, null)   = 0
StringUtils.compare(null , "a")   < 0
StringUtils.compare("a", null)    > 0
StringUtils.compare("abc", "abc")  = 0
StringUtils.compare("a", "b")     < 0
StringUtils.compare("b", "a")     > 0
StringUtils.compare("a", "B")     > 0
StringUtils.compare("ab", "abc")   < 0