StringKit (blade-kit 1.2.9-alpha API)

java.lang.Object
- blade.kit.StringKit

```
public abstract class StringKit
extends Object
```
有关字符串处理的工具类。

从以下版本开始:

1.0

作者:

biezhi

字段概要

字段
限定符和类型	字段和说明
`static String`	`ANSWER`
`static String`	`BOSSANSWER`
`static String`	`BOSSIP`
`static String`	`BOSSIPS`
`static String`	`CREATE`
`static String`	`DELETE`
`static String`	`ERROR`
`static String`	`FAILED`
`static String`	`HOME`
`static String`	`INDEX`
`static String`	`IP`
`static String`	`LOGIN`
`static String`	`NORIGHT`
`static String[]`	`NUMBER`
`static String`	`QUERY`
`static String`	`SAVE`
`static String`	`SUCCESS`
`static String`	`UPDATE`

构造器概要

构造器
构造器和说明

StringKit()

构造器
构造器和说明
`StringKit()`

方法概要

All Methods Static Methods Concrete Methods
限定符和类型	方法和说明
`static String`	`applyRelativePath(String path, String relativePath)`
`static String`	`capitalize(String str)` 将字符串的首字符转成大写（`Character.toTitleCase`），其它字符不变。
`static boolean`	`checkFloat(String num, String type)` 检查浮点数
`static boolean`	`checkIsEnglish(String s)` 验证字符串是否含有特殊字符和中文
`static String`	`cleanPath(String path)`
`static String`	`collectionToDelimitedString(Collection<?> coll, String delim)`
`static String`	`collectionToDelimitedString(Collection<?> coll, String delim, String prefix, String suffix)`
`static String`	`decapitalize(String str)` 与 `uncapitalize(String)`不同，连续大写字符将不做改变如果字符串是`null`则返回`null`。
`static String`	`defaultIfNull(String str)` 如果字符串是`null`，则返回指定默认字符串，否则返回字符串本身。
`static String`	`defaultIfNull(String str, String defaultStr)` 如果字符串是`null`，则返回指定默认字符串，否则返回字符串本身。
`static String`	`deleteAny(String inString, String charsToDelete)`
`static String[]`	`delimitedListToStringArray(String str, String delimiter)`
`static String[]`	`delimitedListToStringArray(String str, String delimiter, String charsToDelete)`
`static boolean`	`equals(String str1, String str2)` 比较两个字符串（大小写敏感）。
`static boolean`	`equalsIgnoreCase(String[] as, String[] as1)` Compares two string arrays.
`static boolean`	`equalsIgnoreCase(String str1, String str2)` 比较两个字符串（大小写不敏感）。
`static int`	`equalsOne(String src, String[] dest)` Compares string with at least one from the provided array.
`static int`	`equalsOneIgnoreCase(String src, String[] dest)` Compares string with at least one from the provided array, ignoring case.
`static String`	`firstUpperCase(String str)`
`static String`	`FormatDecimalString(String decimal)` 格式化数据
`static String`	`fromCamelCase(String str, char separator)`
`static String`	`getChineseByStr(String str)` 提取字符串中的中文字符
`static String`	`getDelFormat(Object f)` 截取 float/double 类型一位小数
`static String`	`getDelFormat2(Object f)` 截取 float/double 类型两位小数
`static String`	`getDelFormat3(Object f)` 截取三位
`static String`	`getFilename(String path)` 获取文件名称
`static String`	`getNumberFormat(long source)` 格式化数据
`static String`	`getRandomChar(int size)` 获取随机字符
`static String`	`getRandomNumber(int size)` 获取指定长度的随机数字组成的字符串
`static String`	`getRandomNumber(int length, int max)` 获得0-max的随机数
`static int`	`getRound(double dSource)` 四舍五入返回int类型
`static String`	`getStrByCharset(String str, String charset)` 功能：获得配置文件中指定编码字符串
`static String`	`getStringsubstr(String source, int len)` 截取字符串先是一定的长多多余...
`static String`	`getUUID()` 随机获取UUID字符串(无中划线)
`static boolean`	`isAllBlank(String... strings)`
`static boolean`	`isAlpha(String str)` 判断字符串是否只包含unicode字母。
`static boolean`	`isAlphanumeric(String str)` 判断字符串是否只包含unicode字母和数字。
`static boolean`	`isAlphanumericSpace(String str)` 判断字符串是否只包含unicode字母数字和空格`' '`。
`static boolean`	`isAlphaSpace(String str)` 判断字符串是否只包含unicode字母和空格`' '`。
`static boolean`	`isAnyBlank(String... strings)`
`static boolean`	`isAnyEmpty(String... strings)`
`static boolean`	`isBlank(String str)` 检查字符串是否是空白：`null`、空字符串`""`或只有空白字符。
`static boolean`	`isChineseStr(String pValue)`
`static boolean`	`isEmpty(String str)` 检查字符串是否为`null`或空字符串`""`。
`static boolean`	`isLetter(char c)` 判断一个字符是Ascill字符还是其它字符（如汉，日，韩文字符）
`static boolean`	`isNotBlank(String str)` 检查字符串是否不是空白：`null`、空字符串`""`或只有空白字符。
`static boolean`	`isNotEmpty(String str)` 检查字符串是否不是`null`和空字符串`""`。
`static boolean`	`isNumber(String str)` 判断字符串是否为数字和有正确的值
`static boolean`	`isNumeric(String str)` 判断字符串是否只包含unicode数字。
`static boolean`	`isNumericSpace(String str)` 判断字符串是否只包含unicode数字和空格`' '`。
`static boolean`	`isWhitespace(String str)` 判断字符串是否只包含unicode空白。
`static String`	`join(Iterable<?> elements, String separator)`
`static String`	`join(Iterator<?> elements, String separator)`
`static <T> String`	`join(List<T> array, String separator)`
`static String`	`join(Object[] array, String separator)`
`static String`	`join(String... parts)`
`static String`	`join(String[] array, String separator)`
`static int`	`length(String s)` 得到一个字符串的长度,显示的长度,一个汉字或日韩文长度为2,英文字符长度为1
`static List<Long>`	`parseStringToLongList(String source, String token)` 将String to long list
`static String`	`parseStrInt(String strDouble)`
`static String`	`random(int length)` 随机获取字符串
`static String`	`replace(String inString, String oldPattern, String newPattern)` 替换字符串
`static double`	`round(double s)` 提供小数位四舍五入处理。
`static long`	`roundlong(double s)` 提供小数位四舍五入处理。
`static String[]`	`split(String str)` 将字符串按空白字符分割。
`static String[]`	`split(String str, char separatorChar)` 将字符串按指定字符分割。
`static List<String>`	`split(String str, int length)` 根据指定长度分隔字符串
`static String[]`	`split(String str, String separatorChars)` 将字符串按指定字符分割。
`static String[]`	`split(String str, String separatorChars, int max)` 将字符串按指定字符分割。
`static String[]`	`splitc(String src, char delimiter)`
`static String[]`	`splitc(String src, char[] delimiters)`
`static String[]`	`splitc(String src, String d)`
`static String[]`	`splitNoCompress(String src, String delimiter)` Splits a string in several parts (tokens) that are separated by delimiter.
`static String`	`stringConnect(String[] strings, String spilit_sign)` 用特殊的字符连接字符串
`static String`	`stringFilter(String str)` 过滤字符串里的的特殊字符
`static String`	`stringKeyWorldFilter(String str)`
`static String[]`	`stringSpilit(String str, String spilit_sign)` 分割字符串
`static String`	`swapCase(String str)` 反转字符串的大小写。
`static boolean`	`toBoolean(String s, boolean def)` String2Boolean
`static String`	`toChineseNumber(int number, int depth)` 将阿拉伯数字转为中文数字
`static double`	`toDouble(String s, double def)` String2Double
`static float`	`toFloat(String s, float def)` String2Float
`static int`	`toInt(String s, int def)` String2Int
`static long`	`toLong(String s, long def)` String2Long
`static String`	`toLowerCase(String str)` 将字符串转换成小写。
`static short`	`toShort(String s, short def)` String2Short
`static String`	`toString(Collection<String> collection)`
`static String`	`toString(Collection<String> collection, String split)`
`static String`	`toString(List<String> list, String separator)` 将字符串List转化为字符串，以分隔符间隔.
`static String`	`toString(Object value)`
`static String[]`	`toStringArray(Collection<String> collection)`
`static String`	`toUpperCase(String str)` 将字符串转换成大写。
`static String`	`trim(String str)` 除去字符串头尾部的空白，如果字符串是`null`，依然返回`null`。
`static String`	`trim(String str, String stripChars)` 除去字符串头尾部的指定字符，如果字符串是`null`，依然返回`null`。
`static void`	`trimAll(String[] strings)` Trims array of strings.
`static String`	`trimEnd(String str)` 除去字符串尾部的空白，如果字符串是`null`，则返回`null`。
`static String`	`trimEnd(String str, String stripChars)` 除去字符串尾部的指定字符，如果字符串是`null`，依然返回`null`。
`static String`	`trimStart(String str)` 除去字符串头部的空白，如果字符串是`null`，则返回`null`。
`static String`	`trimStart(String str, String stripChars)` 除去字符串头部的指定字符，如果字符串是`null`，依然返回`null`。
`static String`	`trimToEmpty(String str)` 除去字符串头尾部的空白，如果字符串是`null`，则返回空字符串`""`。
`static String`	`trimToEmpty(String str, String stripChars)` 除去字符串头尾部的空白，如果字符串是`null`，则返回空字符串`""`。
`static String`	`trimToNull(String str)` 除去字符串头尾部的空白，如果结果字符串是空字符串`""`，则返回`null`。
`static String`	`trimToNull(String str, String stripChars)` 除去字符串头尾部的空白，如果结果字符串是空字符串`""`，则返回`null`。
`static String`	`uncapitalize(String str)` 将字符串的首字符转成小写，其它字符不变。

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

NUMBER
```
public static String[] NUMBER
```

CREATE
```
public static final String CREATE
```
另请参阅:

常量字段值

DELETE
```
public static final String DELETE
```
另请参阅:

常量字段值

SAVE
```
public static final String SAVE
```
另请参阅:

常量字段值

UPDATE
```
public static final String UPDATE
```
另请参阅:

常量字段值

QUERY
```
public static final String QUERY
```
另请参阅:

常量字段值

ERROR
```
public static final String ERROR
```
另请参阅:

常量字段值

SUCCESS
```
public static final String SUCCESS
```
另请参阅:

常量字段值

FAILED
```
public static final String FAILED
```
另请参阅:

常量字段值

IP
```
public static final String IP
```
另请参阅:

常量字段值

ANSWER
```
public static final String ANSWER
```
另请参阅:

常量字段值

INDEX
```
public static final String INDEX
```
另请参阅:

常量字段值

HOME
```
public static final String HOME
```
另请参阅:

常量字段值

NORIGHT
```
public static final String NORIGHT
```
另请参阅:

常量字段值

BOSSIP
```
public static final String BOSSIP
```
另请参阅:

常量字段值

BOSSIPS
```
public static final String BOSSIPS
```
另请参阅:

常量字段值

BOSSANSWER
```
public static final String BOSSANSWER
```
另请参阅:

常量字段值

构造器详细资料
- StringKit
```
public StringKit()
```

方法详细资料

isEmpty

public static boolean isEmpty(String str)

检查字符串是否为null或空字符串""。

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

参数:: str - 要检查的字符串
返回:: 如果为空, 则返回true

isAnyEmpty

public static boolean isAnyEmpty(String... strings)

isNotEmpty

public static boolean isNotEmpty(String str)

检查字符串是否不是null和空字符串""。

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

参数:: str - 要检查的字符串
返回:: 如果不为空, 则返回true

isBlank

public static boolean isBlank(String str)

检查字符串是否是空白：null、空字符串""或只有空白字符。

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

参数:: str - 要检查的字符串
返回:: 如果为空白, 则返回true

isAllBlank

public static boolean isAllBlank(String... strings)

isAnyBlank

public static boolean isAnyBlank(String... strings)

isNotBlank

public static boolean isNotBlank(String str)

检查字符串是否不是空白：null、空字符串""或只有空白字符。

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

参数:: str - 要检查的字符串
返回:: 如果为空白, 则返回true

defaultIfNull

public static String defaultIfNull(String str)

如果字符串是null，则返回指定默认字符串，否则返回字符串本身。

 StringUtil.defaultIfNull(null, "default")  = "default"
 StringUtil.defaultIfNull("", "default")    = ""
 StringUtil.defaultIfNull("  ", "default")  = "  "
 StringUtil.defaultIfNull("bat", "default") = "bat"

参数:: str - 要转换的字符串; defaultStr - 默认字符串
返回:: 字符串本身或指定的默认字符串

defaultIfNull

public static String defaultIfNull(String str,
                                   String defaultStr)

如果字符串是null，则返回指定默认字符串，否则返回字符串本身。

 StringUtil.defaultIfNull(null, "default")  = "default"
 StringUtil.defaultIfNull("", "default")    = ""
 StringUtil.defaultIfNull("  ", "default")  = "  "
 StringUtil.defaultIfNull("bat", "default") = "bat"

参数:: str - 要转换的字符串; defaultStr - 默认字符串
返回:: 字符串本身或指定的默认字符串

trim
```
public static String trim(String str)
```
除去字符串头尾部的空白，如果字符串是null，依然返回null。
注意，和String.trim不同，此方法使用Character.isWhitespace 来判定空白，因而可以除去英文字符集之外的其它空白，如中文空格。
```
 StringUtil.trim(null)          = null
 StringUtil.trim("")            = ""
 StringUtil.trim("     ")       = ""
 StringUtil.trim("abc")         = "abc"
 StringUtil.trim("    abc    ") = "abc"
 
```
参数:

str - 要处理的字符串

返回:

除去空白的字符串，如果原字串为null，则返回null

trimAll
```
public static void trimAll(String[] strings)
```
Trims array of strings. null array elements are ignored.

trim

public static String trim(String str,
                          String stripChars)

除去字符串头尾部的指定字符，如果字符串是null，依然返回null。

 StringUtil.trim(null, *)          = null
 StringUtil.trim("", *)            = ""
 StringUtil.trim("abc", null)      = "abc"
 StringUtil.trim("  abc", null)    = "abc"
 StringUtil.trim("abc  ", null)    = "abc"
 StringUtil.trim(" abc ", null)    = "abc"
 StringUtil.trim("  abcyx", "xyz") = "  abc"

参数:: str - 要处理的字符串; stripChars - 要除去的字符，如果为null表示除去空白字符
返回:: 除去指定字符后的的字符串，如果原字串为null，则返回null

trimStart
```
public static String trimStart(String str)
```
除去字符串头部的空白，如果字符串是null，则返回null。
注意，和String.trim不同，此方法使用Character.isWhitespace 来判定空白，因而可以除去英文字符集之外的其它空白，如中文空格。
```
 StringUtil.trimStart(null)         = null
 StringUtil.trimStart("")           = ""
 StringUtil.trimStart("abc")        = "abc"
 StringUtil.trimStart("  abc")      = "abc"
 StringUtil.trimStart("abc  ")      = "abc  "
 StringUtil.trimStart(" abc ")      = "abc "
 
```
参数:

str - 要处理的字符串

返回:

除去空白的字符串，如果原字串为null或结果字符串为""，则返回 null

trimStart

public static String trimStart(String str,
                               String stripChars)

除去字符串头部的指定字符，如果字符串是null，依然返回null。

 StringUtil.trimStart(null, *)          = null
 StringUtil.trimStart("", *)            = ""
 StringUtil.trimStart("abc", "")        = "abc"
 StringUtil.trimStart("abc", null)      = "abc"
 StringUtil.trimStart("  abc", null)    = "abc"
 StringUtil.trimStart("abc  ", null)    = "abc  "
 StringUtil.trimStart(" abc ", null)    = "abc "
 StringUtil.trimStart("yxabc  ", "xyz") = "abc  "

参数:: str - 要处理的字符串; stripChars - 要除去的字符，如果为null表示除去空白字符
返回:: 除去指定字符后的的字符串，如果原字串为null，则返回null

trimEnd
```
public static String trimEnd(String str)
```
除去字符串尾部的空白，如果字符串是null，则返回null。
注意，和String.trim不同，此方法使用Character.isWhitespace 来判定空白，因而可以除去英文字符集之外的其它空白，如中文空格。
```
 StringUtil.trimEnd(null)       = null
 StringUtil.trimEnd("")         = ""
 StringUtil.trimEnd("abc")      = "abc"
 StringUtil.trimEnd("  abc")    = "  abc"
 StringUtil.trimEnd("abc  ")    = "abc"
 StringUtil.trimEnd(" abc ")    = " abc"
 
```
参数:

str - 要处理的字符串

返回:

除去空白的字符串，如果原字串为null或结果字符串为""，则返回 null

trimEnd

public static String trimEnd(String str,
                             String stripChars)

除去字符串尾部的指定字符，如果字符串是null，依然返回null。

 StringUtil.trimEnd(null, *)          = null
 StringUtil.trimEnd("", *)            = ""
 StringUtil.trimEnd("abc", "")        = "abc"
 StringUtil.trimEnd("abc", null)      = "abc"
 StringUtil.trimEnd("  abc", null)    = "  abc"
 StringUtil.trimEnd("abc  ", null)    = "abc"
 StringUtil.trimEnd(" abc ", null)    = " abc"
 StringUtil.trimEnd("  abcyx", "xyz") = "  abc"

参数:: str - 要处理的字符串; stripChars - 要除去的字符，如果为null表示除去空白字符
返回:: 除去指定字符后的的字符串，如果原字串为null，则返回null

trimToNull
```
public static String trimToNull(String str)
```
除去字符串头尾部的空白，如果结果字符串是空字符串""，则返回null。
注意，和String.trim不同，此方法使用Character.isWhitespace 来判定空白，因而可以除去英文字符集之外的其它空白，如中文空格。
```
 StringUtil.trimToNull(null)          = null
 StringUtil.trimToNull("")            = null
 StringUtil.trimToNull("     ")       = null
 StringUtil.trimToNull("abc")         = "abc"
 StringUtil.trimToNull("    abc    ") = "abc"
 
```
参数:

str - 要处理的字符串

返回:

除去空白的字符串，如果原字串为null或结果字符串为""，则返回 null

trimToNull
```
public static String trimToNull(String str,
                                String stripChars)
```
除去字符串头尾部的空白，如果结果字符串是空字符串""，则返回null。
注意，和String.trim不同，此方法使用Character.isWhitespace 来判定空白，因而可以除去英文字符集之外的其它空白，如中文空格。
```
 StringUtil.trim(null, *)          = null
 StringUtil.trim("", *)            = null
 StringUtil.trim("abc", null)      = "abc"
 StringUtil.trim("  abc", null)    = "abc"
 StringUtil.trim("abc  ", null)    = "abc"
 StringUtil.trim(" abc ", null)    = "abc"
 StringUtil.trim("  abcyx", "xyz") = "  abc"
 
```
参数:

str - 要处理的字符串

stripChars - 要除去的字符，如果为null表示除去空白字符

返回:

除去空白的字符串，如果原字串为null或结果字符串为""，则返回 null

trimToEmpty
```
public static String trimToEmpty(String str)
```
除去字符串头尾部的空白，如果字符串是null，则返回空字符串""。
注意，和String.trim不同，此方法使用Character.isWhitespace 来判定空白，因而可以除去英文字符集之外的其它空白，如中文空格。
```
 StringUtil.trimToEmpty(null)          = ""
 StringUtil.trimToEmpty("")            = ""
 StringUtil.trimToEmpty("     ")       = ""
 StringUtil.trimToEmpty("abc")         = "abc"
 StringUtil.trimToEmpty("    abc    ") = "abc"
 
```
参数:

str - 要处理的字符串

返回:

除去空白的字符串，如果原字串为null或结果字符串为""，则返回 null

trimToEmpty

public static String trimToEmpty(String str,
                                 String stripChars)

除去字符串头尾部的空白，如果字符串是null，则返回空字符串""。

注意，和String.trim不同，此方法使用Character.isWhitespace 来判定空白，因而可以除去英文字符集之外的其它空白，如中文空格。

 StringUtil.trim(null, *)          = ""
 StringUtil.trim("", *)            = ""
 StringUtil.trim("abc", null)      = "abc"
 StringUtil.trim("  abc", null)    = "abc"
 StringUtil.trim("abc  ", null)    = "abc"
 StringUtil.trim(" abc ", null)    = "abc"
 StringUtil.trim("  abcyx", "xyz") = "  abc"

参数:: str - 要处理的字符串
返回:: 除去空白的字符串，如果原字串为null或结果字符串为""，则返回 null

equals

public static boolean equals(String str1,
                             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

参数:: str1 - 要比较的字符串1; str2 - 要比较的字符串2
返回:: 如果两个字符串相同，或者都是null，则返回true

equalsIgnoreCase

public static boolean equalsIgnoreCase(String str1,
                                       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

参数:: str1 - 要比较的字符串1; str2 - 要比较的字符串2
返回:: 如果两个字符串相同，或者都是null，则返回true

equalsOne
```
public static int equalsOne(String src,
                            String[] dest)
```
Compares string with at least one from the provided array. If at least one equal string is found, returns its index. Otherwise, -1 is returned.

equalsOneIgnoreCase
```
public static int equalsOneIgnoreCase(String src,
                                      String[] dest)
```
Compares string with at least one from the provided array, ignoring case. If at least one equal string is found, it returns its index. Otherwise, -1 is returned.

equalsIgnoreCase

public static boolean equalsIgnoreCase(String[] as,
                                       String[] as1)

Compares two string arrays.

参数:: as - first string array; as1 - second string array
返回:: true if all array elements matches