Strings (Commons core 1.4 API)

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

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

作者:

Ponfee

构造器概要

构造器
构造器和说明

Strings()

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

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static String`	`cleanPath(String path)` 文件路径规范化，如“path/..”内部的点号注意：windows的文件分隔符“\”会替换为“/”
`static boolean`	`containsAny(String str, List<String> searches)`
`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`	`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`	`toCamelcaseName(String separatedName, char separator)` 带分隔符名字转驼峰，如下划线转换为驼峰：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
`static String`	`toSeparatedName(String camelcaseName, char separator)` 驼峰转为带分隔符名字，如驼峰转换为下划线：CaseFormat.LOWER_CAMEL.to(CaseFormat.LOWER_UNDERSCORE, camelCaseName);

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

- 构造器详细资料
  - 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 - the text
    
    p - the wildcard pattern
    
    返回:
    
    true if the string match pattern
  - 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 - 文件路径
    
    返回:
    
    规范的文件路径
  - toSeparatedName
```
public static String toSeparatedName(String camelcaseName,
                                     char separator)
```
    驼峰转为带分隔符名字，如驼峰转换为下划线：CaseFormat.LOWER_CAMEL.to(CaseFormat.LOWER_UNDERSCORE, camelCaseName);
    
    参数:
    
    camelcaseName - the camelcase name
    
    separator - the separator
    
    返回:
    
    with separator name
    
    另请参阅:
    
    CaseFormat.to(CaseFormat, String)
  - toCamelcaseName
```
public static String toCamelcaseName(String separatedName,
                                     char separator)
```
    带分隔符名字转驼峰，如下划线转换为驼峰：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
    
    参数:
    
    separatedName - the separated name
    
    separator - the separator
    
    返回:
    
    camelcase name
    
    另请参阅:
    
    CaseFormat.to(CaseFormat, String)
  - 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
  - containsAny
```
public static boolean containsAny(String str,
                                  List<String> searches)
```
  - 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

构造器详细资料

Strings

方法详细资料

join

join

hexadecimal

join

fromArgs

mask

mask

mask

count

slice

isMatch

safePath

cleanPath

toSeparatedName

toCamelcaseName

ifEmpty

ifBlank

escapeSql

escapeRegex

containsAny

csvSplit

csvSplit

csvSplit