Strings (Commons core 1.3 API)

java.lang.Object
- cn.ponfee.commons.util.Strings

```
public class Strings
extends Object
```
字符串工具类

作者:

Ponfee

字段概要

字段
限定符和类型字段和说明

static char BLANK_CHAR

字段
限定符和类型	字段和说明
`static char`	`BLANK_CHAR`

构造器概要

构造器
构造器和说明

Strings()

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

方法概要

所有方法静态方法具体方法已过时的方法
限定符和类型	方法和说明
`static String`	`camelCaseName(String underscoreName)` 已过时。 instead of CaseFormat#to(CaseFormat, String)
`static String`	`cleanPath(String path)` 文件路径规范化，如“path/..”内部的点号注意：windows的文件分隔符“\”会替换为“/”
`static int`	`count(String text, String str)` Count str occur on text.
`static List<String>`	`csvSplit(List<String> list, String s, int off, int len)` Split a quoted comma separated string to a list Handle rfc4180-like CSV strings, with the exceptions: quoted values may contain double quotes escaped with back-slash Non-quoted values are trimmed of leading trailing white space trailing commas are ignored double commas result in a empty string value
`static String[]`	`csvSplit(String s)` Parse a CSV string using `csvSplit(List,String, int, int)` use in {@link cn.ponfee.commons.web.WebContext.WebContextFilter)
`static String[]`	`csvSplit(String s, int off, int len)` Parse a CSV string using `csvSplit(List, String, int, int)`
`static String`	`escapeRegex(String text)` Escape the regex characters: $()*+.[]?
`static String`	`escapeSql(String str)` Escapes the characters in a `String` to be suitable to pass to an SQL query.
`static Map<String,String>`	`fromArgs(String[] args)` Parse main method args, such as: [name1=value,name2=value2,...]
`static String[]`	`hexadecimal(String text)` Convert to hexadecimal string array
`static String`	`ifBlank(String str, String defaultStr)`
`static String`	`ifEmpty(String str, String defaultStr)` 如果为空则设置默认
`static boolean`	`isBlank(Object value)`
`static boolean`	`isEmpty(Object value)` 判断是否为空字符串
`static boolean`	`isMatch(String s, String p)` '?'
`static String`	`join(Collection<?> coll)`
`static String`	`join(Collection<?> coll, String delimiter)`
`static <T> String`	`join(Collection<T> coll, String delimiter, Function<T,String> mapper, String open, String close)` 集合拼接为字符串 join(Arrays.asList("a","b","c"), ",", "(", ")") -> (a),(b),(c)
`static String`	`mask(String text, int start, int len)`
`static String`	`mask(String text, int start, int len, char maskChar)` 遮掩（如手机号中间4位加*）
`static String`	`mask(String text, String regex, String replacement)`
`static String`	`safePath(String path)` Returns a safe file system path that forbid access parent dir
`static String[]`	`slice(String str, int segment)` 字符串分片 slice("abcdefghijklmn", 5) -> ["abc","def","ghi","jkl","mn"]
`static String`	`underscoreName(String camelCaseName)` 已过时。 instead of CaseFormat#to(CaseFormat, String)

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

- 字段详细资料
  - BLANK_CHAR
```
public static final char BLANK_CHAR
```
    另请参阅:
    
    常量字段值
- 构造器详细资料
  - Strings
```
public Strings()
```
- 方法详细资料
  - join
```
public static String join(Collection<?> coll)
```
  - join
```
public static String join(Collection<?> coll,
                          String delimiter)
```
  - hexadecimal
```
public static String[] hexadecimal(String text)
```
    Convert to hexadecimal string array
    
    参数:
    
    text - the text
    
    返回:
    
    hexadecimal string array
  - join
```
public static <T> String join(Collection<T> coll,
                              String delimiter,
                              Function<T,String> mapper,
                              String open,
                              String close)
```
    集合拼接为字符串
    join(Arrays.asList("a","b","c"), ",", "(", ")") -> (a),(b),(c)
    
    参数:
    
    coll - 集合对象
    
    delimiter - 分隔符
    
    mapper - 对象转String
    
    open - 每个元素添加的前缀
    
    close - 每个元素添加的后缀
    
    返回:
    
    a String with joined
    
    另请参阅:
    
    IteratorUtils.toString(Iterator, org.apache.commons.collections4.Transformer, String, String, String), IterableUtils.toString(Iterable, org.apache.commons.collections4.Transformer, String, String, String), String.join(CharSequence, CharSequence...), Collectors.joining(CharSequence, CharSequence, CharSequence), StringUtils.join(List, String, int, int), Joiner.join(Object, Object, Object...), StringJoiner(CharSequence, CharSequence, CharSequence)
  - fromArgs
```
public static Map<String,String> fromArgs(String[] args)
```
    Parse main method args, such as: [name1=value,name2=value2,...]
    
    参数:
    
    args - the args
    
    返回:
    
    a map object params
  - mask
```
public static String mask(String text,
                          String regex,
                          String replacement)
```
  - mask
```
public static String mask(String text,
                          int start,
                          int len)
```
  - mask
```
public static String mask(String text,
                          int start,
                          int len,
                          char maskChar)
```
    遮掩（如手机号中间4位加*）
    
    参数:
    
    text - 需要处理的字符串
    
    start - 开始位置
    
    len - 要处理的字数长度
    
    maskChar - 替换的字符
    
    返回:
  - count
```
public static int count(String text,
                        String str)
```
    Count str occur on text.
    
    参数:
    
    text - the text
    
    str - the string
    
    返回:
    
    number of occur count
  - slice
```
public static String[] slice(String str,
                             int segment)
```
    字符串分片 slice("abcdefghijklmn", 5) -> ["abc","def","ghi","jkl","mn"]
    
    参数:
    
    str -
    
    segment -
    
    返回:
  - isMatch
```
public static boolean isMatch(String s,
                              String p)
```
    '?' Matches any single character. '*' Matches any sequence of characters (including the empty sequence). isMatch("aa","a") = false isMatch("aa","aa") = true isMatch("aaa","aa") = false isMatch("aa", "*") = true isMatch("aa", "a*") = true isMatch("ab", "?*") = true isMatch("aab", "c*a*b") = false
    
    参数:
    
    s - characters
    
    p - pattern
    
    返回:
    
    match result: true|false
  - safePath
```
public static String safePath(String path)
```
    Returns a safe file system path that forbid access parent dir
    
    参数:
    
    path - the path
    
    返回:
    
    a safe path
  - cleanPath
```
public static String cleanPath(String path)
```
    文件路径规范化，如“path/..”内部的点号注意：windows的文件分隔符“\”会替换为“/”
    
    参数:
    
    path - 文件路径
    
    返回:
    
    规范的文件路径
  - underscoreName
```
@Deprecated
public static String underscoreName(String camelCaseName)
```
    已过时。 instead of CaseFormat#to(CaseFormat, String)
    
    驼峰转换为下划线 CaseFormat.LOWER_CAMEL.to(CaseFormat.LOWER_UNDERSCORE, camelCaseName);
    
    参数:
    
    camelCaseName - 驼峰名
    
    返回:
    
    the underscore name
    
    另请参阅:
    
    CaseFormat.to(CaseFormat, String)
  - camelCaseName
```
@Deprecated
public static String camelCaseName(String underscoreName)
```
    已过时。 instead of CaseFormat#to(CaseFormat, String)
    
    下划线转换为驼峰 CaseFormat.LOWER_UNDERSCORE.to(CaseFormat.LOWER_CAMEL, underscoreName); 1 LOWER_HYPHEN 连字符的变量命名规范如lower-hyphen 2 LOWER_UNDERSCORE c++变量命名规范如lower_underscore 3 LOWER_CAMEL java变量命名规范如lowerCamel 4 UPPER_CAMEL java和c++类的命名规范如UpperCamel 5 UPPER_UNDERSCORE java和c++常量的命名规范如UPPER_UNDERSCORE
    
    参数:
    
    underscoreName - 下划线名
    
    返回:
    
    the camel case name
    
    另请参阅:
    
    CaseFormat.to(CaseFormat, String)
  - isEmpty
```
public static boolean isEmpty(Object value)
```
    判断是否为空字符串
    
    参数:
    
    value -
    
    返回:
  - isBlank
```
public static boolean isBlank(Object value)
```
  - ifEmpty
```
public static String ifEmpty(String str,
                             String defaultStr)
```
    如果为空则设置默认
    
    参数:
    
    str -
    
    defaultStr -
    
    返回:
  - ifBlank
```
public static String ifBlank(String str,
                             String defaultStr)
```
  - escapeSql
```
public static String escapeSql(String str)
```
```
 Escapes the characters in a String to be suitable to pass to
 an SQL query.

 For example,
  statement.executeQuery("SELECT * FROM MOVIES WHERE TITLE='" + 
  StringEscapeUtils.escapeSql("McHale's Navy") +  "'");

 At present, this method only turns single-quotes into doubled single-quotes
 ("McHale's Navy" => "McHale''s Navy"). It does not
 handle the cases of percent (%) or underscore (_) for use in LIKE clauses.

 see http://www.jguru.com/faq/view.jsp?EID=8881
 
```
    参数:
    
    str - the string to escape, may be null
    
    返回:
    
    a new String, escaped for SQL, null if null string input
  - escapeRegex
```
public static String escapeRegex(String text)
```
    Escape the regex characters: $()*+.[]?\^{},|
    
    参数:
    
    text - the text string
    
    返回:
    
    a new String, escaped for regex
  - csvSplit
```
public static String[] csvSplit(String s)
```
    Parse a CSV string using csvSplit(List,String, int, int) use in {@link cn.ponfee.commons.web.WebContext.WebContextFilter)
    
    参数:
    
    s - The string to parse
    
    返回:
    
    An array of parsed values.
  - csvSplit
```
public static String[] csvSplit(String s,
                                int off,
                                int len)
```
    Parse a CSV string using csvSplit(List, String, int, int)
    
    参数:
    
    s - The string to parse
    
    off - The offset into the string to start parsing
    
    len - The len in characters to parse
    
    返回:
    
    An array of parsed values.
  - csvSplit
```
public static List<String> csvSplit(List<String> list,
                                    String s,
                                    int off,
                                    int len)
```
    Split a quoted comma separated string to a list
    Handle rfc4180-like CSV strings, with the exceptions:
    - quoted values may contain double quotes escaped with back-slash
    - Non-quoted values are trimmed of leading trailing white space
    - trailing commas are ignored
    - double commas result in a empty string value
    参数:
    
    list - The Collection to split to (or null to get a new list)
    
    s - The string to parse
    
    off - The offset into the string to start parsing
    
    len - The len in characters to parse
    
    返回:
    
    list containing the parsed list values

类 Strings

字段概要

构造器概要

方法概要

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

字段详细资料

BLANK_CHAR

构造器详细资料

Strings

方法详细资料

join

join

hexadecimal

join

fromArgs

mask

mask

mask

count

slice

isMatch

safePath

cleanPath

underscoreName

camelCaseName

isEmpty

isBlank

ifEmpty

ifBlank

escapeSql

escapeRegex

csvSplit

csvSplit

csvSplit