Strings (org.l88:l88-jutils 0.1 API)

java.lang.Object
- org.l88.common.utils.Strings

```
public class Strings
extends Object
```
字符串处理工具

作者:

alexpaul@126.com

构造器概要

构造器
构造器和说明

Strings()

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

方法概要

方法
限定符和类型	方法和说明
`static String`	`capitalize(String name)` 将首字母大写,其它不变
`static String`	`compactSize(long num)` 转换为紧凑格式的字节数表示最多保留两位小数
`static boolean`	`equals(String val1, String val2)` 比较两个字符串是否相等
`static String`	`escapeHTML(String input)` 编码HTML标记为浏览器可显示格式.
`static String`	`escapeXML(String xml)` 编码XML标记.
`static int`	`gbStrLen(String str)` 取带汉字字串的length 将带字符串按Byte位长度取子字符串防止带汉字的字符串长度取错
`static String`	`gbsubstr(String src, int beginIndex, int endIndex)` 处理汉字字串的substr 将带字符串按Byte位长度取子字符串防止带汉字的字符串长度取错防止出现Exception 防止出现半个汉字
`static String`	`gbsubstr(String src, int beginIndex, int endIndex, boolean ifAdd)` 处理汉字字串的substr.
`static String`	`getDefaultCharacterEncoding()` 获取平台缺省的字符集
`static byte[]`	`hexToBytes(String hex)` 将16进制表示的字符串转换为字节数组.
`static boolean`	`isEmpty(String str)` 判断是否是空字符串 null和"" 都返回 true
`static String`	`join(List<?> list, String symbol)` 把string array or list用给定的符号symbol连接成一个字符串 null or empty item will be ignored.
`static String`	`lFillStr(String src, char ch, int len)` 左对齐填充定长字符串.
`static String`	`nullable(Object obj)` 将对象转换为字符串.
`static String`	`omit(String s, int maxlength)` 截断字符串，当字符长度超过指定长度时截断，并将最后3位用“...”替换(长度按字节计算)
`static String`	`omit(String s, String encoding, int maxlength)` 截断字符串，当字符长度超过指定长度时截断，并将最后3位用“...”替换(长度按字节计算)
`static String`	`replace(String input, String matchString, String newString)` 将源字符串中所有匹配的字符串替换为提供的新字符串(不使用正则表达式).
`static String`	`replaceVar(String value, Map<String,?> staticProp)` 用提供的属性替换字符串中的${NAME}变量
`static String`	`replicateStr(char ch, int len)` 用单个字符重复填充一定长度的字符串
`static String`	`rFillStr(String src, char ch, int len)` 右对齐填充定长字符串.
`static String`	`rFillStr(String src, char ch, int len, boolean gb)` 右对齐填充定长字符串.
`static List<String>`	`split(String input)` 按空白字符(空格)或逗号分隔字符串.
`static List<String>`	`split(String s, char delimiter)` 以单个字符为分隔符分割字符串，并截去前后空格.
`static List<String>`	`split(String s, char delimiter, boolean trim)` 以单个字符为分隔符分割字符串（可选是否截断空格).
`static List<String>`	`split(String input, String sep)` 使用指定的正则表达式分隔字符串.
`static String[]`	`splitLines(String str)` 将多行文本分割为字符串数组（每行一组）.
`static String`	`substr(String src, int beginIndex, int endIndex)` 将带字符串按Byte位长度取子字符串.
`static String`	`toHex(byte[] hash)` 将字节转换为16进制字符串显示.
`static String`	`toString(Object obj, String defaultValue)` 将对象转换为字符串.
`static String`	`trimPunct(String str)` 删除所有的标点符号
`static String`	`unCapitalize(String name)` 将首字母小写,其它不变
`static String`	`unescapeXML(String input)` 反编码XML内容字符串.

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

- 构造器详细资料
  - Strings
```
public Strings()
```
- 方法详细资料
  - isEmpty
```
public static boolean isEmpty(String str)
```
    判断是否是空字符串 null和"" 都返回 true
    
    参数:
    str - 判断的字符串
    
    返回:
    是否有效
  - toString
```
public static String toString(Object obj,
              String defaultValue)
```
    将对象转换为字符串. 若对象为NULL或空则返回缺省字符串. 相当于oracle的Nvl函数
    
    参数:
    obj - 待转换对象
    defaultValue - 缺省值
    
    返回:
    对象的字符串内容(调用toString()方法)
  - nullable
```
public static String nullable(Object obj)
```
    将对象转换为字符串. 若对象为NULL或空则返回空(0长度)字符串
    
    参数:
    obj - 待转换对象
    
    返回:
    对象的字符串内容(调用toString()方法)
  - join
```
public static String join(List<?> list,
          String symbol)
```
    把string array or list用给定的符号symbol连接成一个字符串
    null or empty item will be ignored.
    
    参数:
    list - 需要处理的列表
    symbol - 链接的符号
    
    返回:
    处理后的字符串
  - splitLines
```
public static String[] splitLines(String str)
```
    将多行文本分割为字符串数组（每行一组）.
    分行符可以是：换行\n（Unix格式)，或回车加换行\r\n(Dos格式).
    
    参数:
    str - 待分割文本字符串
    
    返回:
    an array of lines that comprise the string, or null if the string specified was null
  - split
```
public static List<String> split(String s,
                 char delimiter,
                 boolean trim)
```
    以单个字符为分隔符分割字符串（可选是否截断空格).
    不使用正则表达式，提高性能。
    参数:
    s - 待分割字符串
    delimiter - 字符分融符
    trim - 是否截去前后空格
    
    返回:
    List
    
    空列表 如果对象为null.
    含一个空字符串的列表 如果对象是空字符串.
  - split
```
public static List<String> split(String s,
                 char delimiter)
```
    以单个字符为分隔符分割字符串，并截去前后空格. 不使用正则表达式，提高性能。相当于split(s, delimiter, true)的快捷方式.
    
    源串结果
    
    a, , ,, b [a,,,,b]
    
    a,b c ,d [a,b c,d]
    参数:
    s - 待分割字符串
    delimiter - 分融符
    
    返回:
    List
    
    空列表 如果对象为null.
    含一个空字符串的列表 如果对象是空字符串或全空格字符串.
  - split
```
public static List<String> split(String input)
```
    按空白字符(空格)或逗号分隔字符串. 本方法的返回结果中不包括零长字符串，示例如下：
    
    源串结果
    
    a,,,,b [a, b]
    
    a,b c,d [a, b, c, d]
    
    使用了正则表达式，注意性能问题，不能在调用频繁度的地方使用
    
    参数:
    input - 源串
    
    返回:
    字符串列表. null 如果源串为null
  - split
```
public static List<String> split(String input,
                 String sep)
```
    使用指定的正则表达式分隔字符串.
    本方法的返回结果中不包括零长字符串（这是与String.split方法的不同之处）
    
    参数:
    input - 源串
    sep - 正则表达式
    
    返回:
    字符串列表. null 如果源串为null
  - replace
```
public static final String replace(String input,
             String matchString,
             String newString)
```
    将源字符串中所有匹配的字符串替换为提供的新字符串(不使用正则表达式).
    
    参数:
    input - 源字符串
    matchString - 匹配字符串
    newString - 新字符串
    
    返回:
    替换后的新字符串
  - escapeXML
```
public static final String escapeXML(String xml)
```
    编码XML标记.
    将字符串中的XML关键字符用XML标记替换.使其可置于xml文档中.
    - & &
    - < <
    - > >
    - " "
    - ' '
    - \ \\
    参数:
    xml - 待编码字符串.
    
    返回:
    编码后的字符串.
  - unescapeXML
```
public static final String unescapeXML(String input)
```
    反编码XML内容字符串. 以得到编码前的内容.
    
    参数:
    input - 待反编码字符串
    
    返回:
    反编码后的字符串.
    另请参阅:
    Strings#escapeForXML(String)
  - escapeHTML
```
public static final String escapeHTML(String input)
```
    编码HTML标记为浏览器可显示格式.
    将字符串中的HTML关键字符用HTML标记替换 .将换行符转为<br>
    - & &
    - < <
    - > >
    - " "
    - ' '
    - 换行 <br>
    - 回车
    参数:
    input - 待编码字符串.
    
    返回:
    编码后的字符串.
    另请参阅:
    escapeXML(String).
  - capitalize
```
public static String capitalize(String name)
```
    将首字母大写,其它不变
    
    参数:
    name -
    
    返回:
  - unCapitalize
```
public static String unCapitalize(String name)
```
    将首字母小写,其它不变
    
    参数:
    name -
    
    返回:
  - replaceVar
```
public static String replaceVar(String value,
                Map<String,?> staticProp)
```
    用提供的属性替换字符串中的${NAME}变量
    
    参数:
    value - 待替换的字符串
    staticProp - 静态属性对照表
    
    返回:
    替换后的字符串
  - toHex
```
public static final String toHex(byte[] hash)
```
    将字节转换为16进制字符串显示.
    
    参数:
    hash - 待转换字节数组
    
    返回:
    16进制表示的字符串
  - hexToBytes
```
public static final byte[] hexToBytes(String hex)
```
    将16进制表示的字符串转换为字节数组.
    参数:
    hex - 待转换16进制表示的字符串
    
    返回:
    字节数组
    
    null:输入字符串为null
    new byte[0]:输入字符串为非法16进制字符串
  - compactSize
```
public static final String compactSize(long num)
```
    转换为紧凑格式的字节数表示
    最多保留两位小数
    
    参数:
    number - 字节数(单位:B)
    
    返回:
  - getDefaultCharacterEncoding
```
public static String getDefaultCharacterEncoding()
```
    获取平台缺省的字符集
    
    返回:
    JVM中配置使用的字符集
  - substr
```
public static String substr(String src,
            int beginIndex,
            int endIndex)
```
    将带字符串按Byte位长度取子字符串. 防止带汉字的字符串长度取错防止出现Exception
    
    参数:
    String - src 源字符串
    int - beginIndex 起始位置,0为第一位
    int - endIndex 终止位置,1为第一位
    
    返回:
    String
  - gbsubstr
```
public static String gbsubstr(String src,
              int beginIndex,
              int endIndex,
              boolean ifAdd)
```
    处理汉字字串的substr. 将带字符串按Byte位长度取子字符串防止带汉字的字符串长度取错防止出现Exception 防止出现半个汉字
    参数:
    String - src 源字符串
    int - beginIndex 起始位置,0为第一位
    int - endIndex 终止位置,1为第一位
    boolean - ifAdd
    
    ==true 如果最后是半个汉字，返回长度加一
    ==false 如果最后是半个汉字，返回长度减一
    返回:
    String
  - gbsubstr
```
public static String gbsubstr(String src,
              int beginIndex,
              int endIndex)
```
    处理汉字字串的substr 将带字符串按Byte位长度取子字符串防止带汉字的字符串长度取错防止出现Exception 防止出现半个汉字
    
    参数:
    String - src 源字符串
    int - beginIndex 起始位置,0为第一位
    int - endIndex 终止位置,1为第一位如果最后是半个汉字，返回长度减一
    
    返回:
    String
  - gbStrLen
```
public static int gbStrLen(String str)
```
    取带汉字字串的length 将带字符串按Byte位长度取子字符串防止带汉字的字符串长度取错
    
    参数:
    String - str 源字符串
    
    返回:
    int Byte位长度
  - replicateStr
```
public static String replicateStr(char ch,
                  int len)
```
    用单个字符重复填充一定长度的字符串
    
    参数:
    ch - 用于填充的字符
    len - 被填充的字符串长度
    
    返回:
    填充后的字符串
  - lFillStr
```
public static String lFillStr(String src,
              char ch,
              int len)
```
    左对齐填充定长字符串.
    长度不足，则向字符串尾部添加字符填充长度, 可以有汉字
    长度超长，则从后截断字符串
    
    参数:
    src - 源字符串
    ch - 用于填充的字符
    len - 新字符串总长度
    
    返回:
  - rFillStr
```
public static String rFillStr(String src,
              char ch,
              int len)
```
    右对齐填充定长字符串. 向字符串前部添加字符, 处理汉字
    
    参数:
    src -
    ch -
    len -
    
    返回:
  - rFillStr
```
public static String rFillStr(String src,
              char ch,
              int len,
              boolean gb)
```
    右对齐填充定长字符串.
    长度不足，向字符串前部添加字符, 可选是否处理汉字
    超长，从前部截断字符串
    
    参数:
    src - 源字符串
    ch - 用于填充的字符
    len - 新字符串长度
    gb - 源字符串是否包含有中文
    
    返回:
  - omit
```
public static String omit(String s,
          int maxlength)
```
    截断字符串，当字符长度超过指定长度时截断，并将最后3位用“...”替换(长度按字节计算)
    参数:
    s - 源字符串
    maxlength - 指定最大长度
    
    返回:
    字符串
    
    null 如果指定的编码不支持.
    原值 如果小于或等于指定长度.
    "" 如果字符串为null.
    新字符串 字节长度为指定长度，且最后三位替换为"...".
  - omit
```
public static String omit(String s,
          String encoding,
          int maxlength)
```
    截断字符串，当字符长度超过指定长度时截断，并将最后3位用“...”替换(长度按字节计算)
    参数:
    s - 源字符串
    encoding - 编码
    maxlength - 指定最大长度
    
    返回:
    字符串
    
    null 如果指定的编码不支持.
    原值 如果小于或等于指定长度.
    "" 如果字符串为null.
    "..." 当指定长度小于等于0,或(指定长度小于3,且字符串超长时).
    新字符串 字节长度为指定长度，且最后三位替换为"...".
  - trimPunct
```
public static String trimPunct(String str)
```
    删除所有的标点符号
    
    参数:
    str - 处理的字符串
  - equals
```
public static boolean equals(String val1,
             String val2)
```
    比较两个字符串是否相等
    参数:
    val1 -
    val2 -
    
    返回:
    都为null时，true
    
    仅一个为null,false
    
    其它,val1.equals(val2)

源串	结果
a, , ,, b	[a,,,,b]
a,b c ,d	[a,b c,d]

源串	结果
a,,,,b	[a, b]
a,b c,d	[a, b, c, d]

类 Strings

构造器概要

方法概要

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

构造器详细资料

Strings

方法详细资料

isEmpty

toString

nullable

join

splitLines

split

split

split

split

replace

escapeXML

unescapeXML

escapeHTML

capitalize

unCapitalize

replaceVar

toHex

hexToBytes

compactSize

getDefaultCharacterEncoding

substr

gbsubstr

gbsubstr

gbStrLen

replicateStr

lFillStr

rFillStr

rFillStr

omit

omit

trimPunct

equals