StringUtils (com.alipay.sofa:sofa-rpc-all 5.4.0 API)

java.lang.Object
- com.alipay.sofa.rpc.common.utils.StringUtils

```
public class StringUtils
extends Object
```
字符串操作工具类

字段概要

字段
限定符和类型	字段和说明
`static String`	`ALL` The string `"*"`.
`static String`	`CONTEXT_SEP` The context path separator String `"/"`.
`static String`	`DEFAULT` The string `"default"`.
`static String`	`EMPTY` The empty String `""`.
`static String[]`	`EMPTY_STRING_ARRAY` 空数组
`static String`	`FALSE` The string `"false"`.
`static String`	`NULL` The string `"null"`.
`static String`	`TRUE` The string `"true"`.

构造器概要

构造器
构造器和说明

StringUtils()

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

方法概要

方法
限定符和类型	方法和说明
`static String`	`defaultString(Object str)` Returns either the passed in String, or if the String is `null`, an empty String ("").
`static boolean`	`equals(CharSequence s1, CharSequence s2)` 字符串是否相同
`static boolean`	`isBlank(CharSequence cs)` Checks if a CharSequence is whitespace, empty ("") or null.
`static boolean`	`isEmpty(CharSequence cs)` Checks if a CharSequence is empty ("") or null.
`static boolean`	`isNotBlank(CharSequence cs)` Checks if a CharSequence is not empty (""), not null and not whitespace only.
`static boolean`	`isNotEmpty(CharSequence cs)` Checks if a CharSequence is not empty ("") and not null.
`static String`	`join(String[] strings, String separator)` 连接字符串数组
`static String`	`joinWithComma(String... strings)` 默认逗号分隔的字符串
`static String`	`objectsToString(Object[] args)` 对象数组转string
`static String[]`	`split(String src, String separator)` 按分隔符分隔的数组，包含空值例如 "1,2,,3," 返回 [1,2,,3,] 5个值
`static String[]`	`splitWithCommaOrSemicolon(String src)` 按逗号或者分号分隔的数组，排除空字符例如 " 1,2 ,, 3 , " 返回 [1,2,3] 3个值 " 1;2 ;; 3 ; " 返回 [1,2,3] 3个值
`static String`	`substringAfter(String str, String separator)` 取得第一个出现的分隔子串之后的子串。
`static String`	`toString(byte[] bytes, String charsetName)` Converts a `byte[]` to a String using the specified character encoding.
`static String`	`toString(Object o)` 对象转string
`static String`	`toString(Object o, String defaultVal)` 对象转string
`static String`	`trim(String str)` StringUtils.trim(null) = null StringUtils.trim("") = "" StringUtils.trim(" ") = "" StringUtils.trim("abc") = "abc" StringUtils.trim(" abc ") = "abc"
`static String`	`trimToEmpty(String str)` StringUtils.trimToEmpty(null) = "" StringUtils.trimToEmpty("") = "" StringUtils.trimToEmpty(" ") = "" StringUtils.trimToEmpty("abc") = "abc" StringUtils.trimToEmpty(" abc ") = "abc"
`static String`	`trimToNull(String str)` StringUtils.trimToNull(null) = null StringUtils.trimToNull("") = null StringUtils.trimToNull(" ") = null StringUtils.trimToNull("abc") = "abc" StringUtils.trimToNull(" abc ") = "abc"

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

- 字段详细资料
  - EMPTY
```
public static final String EMPTY
```
    The empty String "".
    
    从以下版本开始:
    
    5.0.0
    
    另请参阅:
    常量字段值
  - CONTEXT_SEP
```
public static final String CONTEXT_SEP
```
    The context path separator String "/".
    
    另请参阅:
    常量字段值
  - ALL
```
public static final String ALL
```
    The string "*".
    
    从以下版本开始:
    
    5.3.1
    
    另请参阅:
    常量字段值
  - DEFAULT
```
public static final String DEFAULT
```
    The string "default".
    
    从以下版本开始:
    
    5.3.1
    
    另请参阅:
    常量字段值
  - TRUE
```
public static final String TRUE
```
    The string "true".
    
    从以下版本开始:
    
    5.4.0
    
    另请参阅:
    常量字段值
  - FALSE
```
public static final String FALSE
```
    The string "false".
    
    从以下版本开始:
    
    5.4.0
    
    另请参阅:
    常量字段值
  - NULL
```
public static final String NULL
```
    The string "null".
    
    从以下版本开始:
    
    5.4.0
    
    另请参阅:
    常量字段值
  - EMPTY_STRING_ARRAY
```
public static final String[] EMPTY_STRING_ARRAY
```
    空数组
- 构造器详细资料
  - StringUtils
```
public StringUtils()
```
- 方法详细资料
  - isEmpty
```
public static boolean isEmpty(CharSequence cs)
```
    Checks if a CharSequence is empty ("") or null.
```
 StringUtils.isEmpty(null)      = true
 StringUtils.isEmpty("")        = true
 StringUtils.isEmpty(" ")       = false
 StringUtils.isEmpty("bob")     = false
 StringUtils.isEmpty("  bob  ") = false
 
```
    NOTE: This method changed in Lang version 2.0. It no longer trims the CharSequence. That functionality is available in isBlank().
    参数:
    cs - the CharSequence to check, may be null
    
    返回:
    true if the CharSequence is empty or null
    从以下版本开始:
    
    3.0 Changed signature from isEmpty(String) to isEmpty(CharSequence)
  - isNotEmpty
```
public static boolean isNotEmpty(CharSequence cs)
```
    Checks if a CharSequence is not empty ("") and not null.
```
 StringUtils.isNotEmpty(null)      = false
 StringUtils.isNotEmpty("")        = false
 StringUtils.isNotEmpty(" ")       = true
 StringUtils.isNotEmpty("bob")     = true
 StringUtils.isNotEmpty("  bob  ") = true
 
```
    参数:
    cs - the CharSequence to check, may be null
    
    返回:
    true if the CharSequence is not empty and not null
    从以下版本开始:
    
    3.0 Changed signature from isNotEmpty(String) to isNotEmpty(CharSequence)
  - isBlank
```
public static boolean isBlank(CharSequence cs)
```
    Checks if a CharSequence is whitespace, empty ("") or null.
```
 StringUtils.isBlank(null)      = true
 StringUtils.isBlank("")        = true
 StringUtils.isBlank(" ")       = true
 StringUtils.isBlank("bob")     = false
 StringUtils.isBlank("  bob  ") = false
 
```
    参数:
    cs - the CharSequence to check, may be null
    
    返回:
    true if the CharSequence is null, empty or whitespace
    从以下版本开始:
    
    3.0 Changed signature from isBlank(String) to isBlank(CharSequence)
  - isNotBlank
```
public static boolean isNotBlank(CharSequence cs)
```
    Checks if a CharSequence is not empty (""), not null and not whitespace only.
```
 StringUtils.isNotBlank(null)      = false
 StringUtils.isNotBlank("")        = false
 StringUtils.isNotBlank(" ")       = false
 StringUtils.isNotBlank("bob")     = true
 StringUtils.isNotBlank("  bob  ") = true
 
```
    参数:
    cs - the CharSequence to check, may be null
    
    返回:
    true if the CharSequence is not empty and not null and not whitespace
    从以下版本开始:
    
    3.0 Changed signature from isNotBlank(String) to isNotBlank(CharSequence)
  - trim
```
public static String trim(String str)
```
```
 StringUtils.trim(null)          = null
 StringUtils.trim("")            = ""
 StringUtils.trim("     ")       = ""
 StringUtils.trim("abc")         = "abc"
 StringUtils.trim("    abc    ") = "abc"
 
```
    参数:
    str - the String to be trimmed, may be null
    
    返回:
    the trimmed string, null if null String input
  - trimToNull
```
public static String trimToNull(String str)
```
```
 StringUtils.trimToNull(null)          = null
 StringUtils.trimToNull("")            = null
 StringUtils.trimToNull("     ")       = null
 StringUtils.trimToNull("abc")         = "abc"
 StringUtils.trimToNull("    abc    ") = "abc"
 
```
    参数:
    str - the String to be trimmed, may be null
    
    返回:
    the trimmed String, null if only chars <= 32, empty or null String input
    从以下版本开始:
    
    2.0
  - trimToEmpty
```
public static String trimToEmpty(String str)
```
```
 StringUtils.trimToEmpty(null)          = ""
 StringUtils.trimToEmpty("")            = ""
 StringUtils.trimToEmpty("     ")       = ""
 StringUtils.trimToEmpty("abc")         = "abc"
 StringUtils.trimToEmpty("    abc    ") = "abc"
 
```
    参数:
    str - the String to be trimmed, may be null
    
    返回:
    the trimmed String, or an empty String if null input
    从以下版本开始:
    
    2.0
  - toString
```
public static String toString(byte[] bytes,
              String charsetName)
                       throws UnsupportedEncodingException
```
    Converts a byte[] to a String using the specified character encoding.
    
    参数:
    bytes - the byte array to read from
    charsetName - the encoding to use, if null then use the platform default
    
    返回:
    a new String
    
    抛出:
    
    UnsupportedEncodingException - If the named charset is not supported
    
    NullPointerException - if the input is null
    从以下版本开始:
    
    3.1
  - defaultString
```
public static String defaultString(Object str)
```
    Returns either the passed in String, or if the String is null, an empty String ("").
```
 StringUtils.defaultString(null)  = ""
 StringUtils.defaultString("")    = ""
 StringUtils.defaultString("bat") = "bat"
 
```
    参数:
    str - the String to check, may be null
    
    返回:
    the passed in String, or the empty String if it was null
    另请参阅:
    String.valueOf(Object)
  - toString
```
public static String toString(Object o,
              String defaultVal)
```
    对象转string
    
    参数:
    o - 对象
    defaultVal - 默认值
    
    返回:
    不为null执行toString方法
  - toString
```
public static String toString(Object o)
```
    对象转string
    
    参数:
    o - 对象
    
    返回:
    不为null执行toString方法
  - objectsToString
```
public static String objectsToString(Object[] args)
```
    对象数组转string
    
    参数:
    args - 对象
    
    返回:
    不为null执行toString方法
    从以下版本开始:
    
    5.4.0
  - equals
```
public static boolean equals(CharSequence s1,
             CharSequence s2)
```
    字符串是否相同
    
    参数:
    s1 - 字符串1
    s2 - 字符串2
    
    返回:
    是否相同
  - split
```
public static String[] split(String src,
             String separator)
```
    按分隔符分隔的数组，包含空值
    例如 "1,2,,3," 返回 [1,2,,3,] 5个值
    
    参数:
    src - 原始值
    separator - 分隔符
    
    返回:
    字符串数组
  - splitWithCommaOrSemicolon
```
public static String[] splitWithCommaOrSemicolon(String src)
```
    按逗号或者分号分隔的数组，排除空字符
    例如 " 1,2 ,, 3 , " 返回 [1,2,3] 3个值
    " 1;2 ;; 3 ; " 返回 [1,2,3] 3个值
    
    参数:
    src - 原始值
    
    返回:
    字符串数组
  - join
```
public static String join(String[] strings,
          String separator)
```
    连接字符串数组
    
    参数:
    strings - 字符串数组
    separator - 分隔符
    
    返回:
    按分隔符分隔的字符串
  - joinWithComma
```
public static String joinWithComma(String... strings)
```
    默认逗号分隔的字符串
    
    参数:
    strings - 字符串数组
    
    返回:
    按分隔符分隔的字符串
  - substringAfter
```
public static String substringAfter(String str,
                    String separator)
```
    取得第一个出现的分隔子串之后的子串。如果字符串为null，则返回null。如果分隔子串为null或未找到该子串，则返回原字符串。
```
 StringUtil.substringAfter(null, *)      = null
 StringUtil.substringAfter("", *)        = ""
 StringUtil.substringAfter(*, null)      = ""
 StringUtil.substringAfter("abc", "a")   = "bc"
 StringUtil.substringAfter("abcba", "b") = "cba"
 StringUtil.substringAfter("abc", "c")   = ""
 StringUtil.substringAfter("abc", "d")   = ""
 StringUtil.substringAfter("abc", "")    = "abc"
 
```
    参数:
    str - 字符串
    separator - 要搜索的分隔子串
    
    返回:
    子串，如果原始串为null，则返回null

类 StringUtils

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

EMPTY

CONTEXT_SEP

ALL

DEFAULT

TRUE

FALSE

NULL

EMPTY_STRING_ARRAY

构造器详细资料

StringUtils

方法详细资料

isEmpty

isNotEmpty

isBlank

isNotBlank

trim

trimToNull

trimToEmpty

toString

defaultString

toString

toString

objectsToString

equals

split

splitWithCommaOrSemicolon

join

joinWithComma

substringAfter