com.sinosoftgz.starter.utils.lang

类 Strings

java.lang.Object

com.sinosoftgz.starter.utils.lang.Strings

public final class Strings
extends Object

提供各种对字符串进行处理的工具
类Strings是对java.lang.String在功能上的补充，包括了很多应用软件中经常使用的字符串处理功能， 例如：对字符串中空格的处理，字符串的比较，字符串的替换等等，大大增强了应用软件对字符串的处理能力

作者:

Roney

方法概要

限定符和类型	方法和说明
static String	absoluteTrim(String str) 剔除字符串中所有出现的空格字符.
static String	concat(Object... sources) 将不定长参数转换成一个字符串(直接相连，内部使用StringBuilder，比String的concat方法高效) 示例 Strings.concat() 返回 ""; Strings.concat("abc") 返回 "abc"; Strings.concat("ab","c","defg") 返回 "abcdefg";
static String	copyString(String str, int copyTimes) 将指定字符串复制指定的次数,并返回复制后的字符串.
static int	getBytesLength(String str, String charsetName) 获得指定字符串转化为Bytes数组后,数组的长度.
static int	indexOf(String str, String subStr, int occurrenceTimes) 获取从主字符串的起始位置开始,子字符串在主字符串中第n次出现的位置.
static int	indexOf(String str, String subStr, int fromIndex, boolean caseSensitive) 获取从主字符串的fromIndex位置开始,子字符串在主字符串中第1次出现的位置.
static int	indexOf(String str, String subStr, int startIndex, int occurrenceTimes) 获取从主字符串的指定位置开始,子字符串在主字符串中第n次出现的位置.
static boolean	isEmptyOrNull(String value) 是否空串或者null（或者"null"）
static String	leftTrim(String str) 截取字符串左边的空格.
static String	lowerCase(String str, int beginIndex, int endIndex) 将指定字符串的从beginIndex到endIndex的字符变为小写.
static String	lowerCaseFirstChar(String iString) 将字符串的第一个字符小写.
static String	native2ascii(String str) 本地编码转换为Ascii编码，同native2ascii.exe 示例: Strings.native2ascii("出险时保单信息");返回出险时保单信息
static String	newString(char ch, int length) 生成一个填充字符串.
static String	newString(String value, int length) 生成一个填充字符串.
static String	replace(String str, char searchChar, String replaceStr) 将字符串str中所有的searchChar都替换为newStr.
static String	replace(String str, int beginIndex, String replaceStr) 替换字符串中从指定位置开始的、替换字符串长度的信息.
static String	replace(String str, String searchStr, String replaceStr) 将字符串str中所有的oldStr都替换为newStr.
static String	replace(String str, String searchStr, String replaceStr, boolean caseSensitive) 将字符串str中所有的searchStr都替换为replaceStr.
static String	rightTrim(String str) 截取字符串右边的空格.
static Map<String,String>	sortEnglishNumberWord(Map<String,String> map) 英文数字排序
static String[]	split(String originalString, int splitByteLength, String charsetName) 将指定的字符串按给定的长度进行分割，返回分割后的字符串数组.如果最后一个字节是中文的半个字符，则该字节进入数组的下一条。
static String[]	split(String originalString, String delimiterString) 将指定的字符串按给定的分割符进行分割，返回分割后的字符串数组.
static Iterator<String>	splitIgnoreBlank(String str, String delimiters) 分割字符串并返回迭代器，其中分割后空白字符串将被忽略
static int	timesOf(String str, char ch) 获取字符在主字符串中出现的次数.
static int	timesOf(String str, String subStr) 获取子字符串在主字符串中出现的次数.
static String	toCamelCase(String in)
static String	toCapitalizeCamelCase(String in)
static Map<String,String>	toMap(String str, String splitString) 变为Map,如果一个条目包含等于号"="，则等于号前为Key，后为Value 示例 Map map = Strings.toMap("00010000,00020000,00030000,00040000", ","); Map map = Strings.toMap("1=true,0=false", ",");
static String	toUnderlineName(String in) 驼峰和下划线转换
static String	upperCase(String str, int beginIndex, int endIndex) 将指定字符串的从beginIndex到endIndex的字符变为大写.
static String	upperCaseFirstChar(String iString) 将字符串的第一个字符大写.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细资料

newString

public static String newString(String value,
                               int length)

生成一个填充字符串.

示例:

 Strings.newString("Sinosoft",3) 返回 "SinosoftSinosoftSinosoft"
 Strings.newString("Cmm",2) 返回 "CmmCmm"
 Strings.newString("a",2) 返回 "aa"
 

参数:

value - value

length - length

返回:

填充字符串

newString

public static String newString(char ch,
                               int length)

生成一个填充字符串.

示例:

 Strings.newString('C',3) 返回 "CCC"
 Strings.newString('a',2) 返回 "aa"
 

参数:

ch - 填充字符

length - 长度

返回:

填充字符串

copyString

public static String copyString(String str,
                                int copyTimes)

将指定字符串复制指定的次数,并返回复制后的字符串.

示例:

 Strings.copyString("Sinosoft",3) 返回 "SinosoftSinosoftSinosoft"
 Strings.copyString("Cmm",2) 返回 "CmmCmm"
 

参数:

str - 指定的字符串,字符串的值不能为null

copyTimes - 复制字符串的次数,有效范围是>0的自然数

返回:

复制后的字符串

getBytesLength

public static int getBytesLength(String str,
                                 String charsetName)

获得指定字符串转化为Bytes数组后,数组的长度.

示例:

 Strings.getBytesLength("中国人","GBK") 返回 6
 Strings.getBytesLength("Cmm","GBK") 返回 3
 Strings.getBytesLength("","GBK") 返回 0
 Strings.getBytesLength(null,"GBK") 返回 -1
 

参数:

str - 指定的字符串,字符串的值不能为null

charsetName - 字符串编码方式

返回:

指定字符串转化为Bytes数组后, 数组的长度

indexOf

public static int indexOf(String str,
                          String subStr,
                          int startIndex,
                          int occurrenceTimes)

获取从主字符串的指定位置开始,子字符串在主字符串中第n次出现的位置.

示例

 Strings.indexOf("Sinosoft is a software corpration","soft",0,2) 返回 14
 Strings.indexOf("ab ab ab ab","a",4,2) 返回 9
 Strings.indexOf("ab ab ab ab","a",4,3) 返回 -1
 

参数:

str - 主字符串,字符串的值不能为null

subStr - 子字符串,字符串的值不能为null

startIndex - 指定的位置,有效范围是>=0的整数

occurrenceTimes - 第几次出现,有效范围是>0的自然数

返回:

返回从主字符串的指定位置开始, 子字符串在主字符串中第n次出现的位置, 子字符串没有搜索到时返回-1

indexOf

public static int indexOf(String str,
                          String subStr,
                          int occurrenceTimes)

获取从主字符串的起始位置开始,子字符串在主字符串中第n次出现的位置.

示例

 Strings.indexOf("Sinosoft is a software corpration","soft",2) 返回 14
 Strings.indexOf("ab ab ab ab","a",2) 返回 3
 Strings.indexOf("ab ab ab ab","a",5) 返回 -1
 

参数:

str - 主字符串,字符串的值不能为null

subStr - 子字符串,字符串的值不能为null

occurrenceTimes - 第几次出现,有效范围是>0的自然数

返回:

返回从主字符串的起始位置开始, 子字符串在主字符串中第n次出现的位置, 子字符串没有搜索到时返回-1

indexOf

public static int indexOf(String str,
                          String subStr,
                          int fromIndex,
                          boolean caseSensitive)

获取从主字符串的fromIndex位置开始,子字符串在主字符串中第1次出现的位置.

示例

 Strings.indexOf("Tom's name is Tom", "tom", 0,true) 返回 -1
 Strings.indexOf("Tom's name is Tom", "Tom", 0,true) 返回 0
 Strings.indexOf("Tom's name is Tom", "Tom", 2,true) 返回 14
 

参数:

str - 主字符串,字符串的值不能为null

subStr - 子字符串,字符串的值不能为null

fromIndex - 起始位置

caseSensitive - 是否大小写敏感，true-敏感，false-不敏感

返回:

返回从主字符串的fromIndex位置开始, 子字符串在主字符串中第1次出现的位置, 子字符串没有搜索到时返回-1

replace

public static String replace(String str,
                             String searchStr,
                             String replaceStr,
                             boolean caseSensitive)

将字符串str中所有的searchStr都替换为replaceStr.

示例

 Strings.replace("Tom's name is Tom","Tom","Peter",true) 返回 "Peter's name is Peter"
 Strings.replace("Tom's name is Tom","tom","Peter",true) 返回 "Tom's name is Tom"
 Strings.replace("Tom's name is Tom","tom","Peter",false) 返回 "Peter's name is Peter"
 

参数:

str - 原字符串,字符串的值不能为null

searchStr - 被替换的字符串,字符串的值不能为null

replaceStr - 用作替换的字符串,字符串的值如果为null，则自动按空串处理

caseSensitive - 是否大小写敏感，true-敏感，false-不敏感

返回:

替换后的字符串

replace

public static String replace(String str,
                             String searchStr,
                             String replaceStr)

将字符串str中所有的oldStr都替换为newStr.

示例

 Strings.replace(null, *, *) = null
 Strings.replace("", *, *) = ""
 Strings.replace("aba", null, null) = "aba"
 Strings.replace("aba", null, null) = "aba"
 Strings.replace("aba", "a", null) = "aba"
 Strings.replace("aba", "a", "") = "b"
 Strings.replace("aba", "a", "z") = "zbz"
 

参数:

str - 原字符串,字符串的值不能为null

searchStr - 被替换的字符串,字符串的值不能为null

replaceStr - 用作替换的字符串,字符串的值不能为null

返回:

替换后的字符串

replace

public static String replace(String str,
                             char searchChar,
                             String replaceStr)

将字符串str中所有的searchChar都替换为newStr.

示例

 Strings.replace(null, *, *) = null
 Strings.replace("", *, *) = ""
 Strings.replace("aba", null, null) = "aba"
 Strings.replace("aba", null, null) = "aba"
 Strings.replace("aba", 'a', null) = "aba"
 Strings.replace("aba", 'a', "") = "b"
 Strings.replace("aba", 'a', "z") = "zbz"
 

参数:

str - 原字符串,字符串的值不能为null

searchChar - 被替换的字符

replaceStr - 用作替换的字符串,字符串的值不能为null

返回:

替换后的字符串

replace

public static String replace(String str,
                             int beginIndex,
                             String replaceStr)

替换字符串中从指定位置开始的、替换字符串长度的信息.

示例

 Strings.replace("abcde f g",1,"xx") 返回 "axxde f g"
 

参数:

str - 原字符串,字符串的值不能为null

beginIndex - 起始位置

replaceStr - 用作替换的字符串,字符串的值不能为null

返回:

替换后的字符串

split

public static String[] split(String originalString,
                             int splitByteLength,
                             String charsetName)

将指定的字符串按给定的长度进行分割，返回分割后的字符串数组.如果最后一个字节是中文的半个字符，则该字节进入数组的下一条。

示例

 Strings.split("a123bcd12345",5,"GBK") 返回 new String[]{"a123b","cd123","45"}
 Strings.split("中国人民保险公司两千年特别条款",8,"GBK") 返回 new String[]{"中国人民","保险公司","两千年特","别条款"}

Strings.split("机动车险A类费率",7,"GBK") 返回 new String[]{"机动车","险A类费","率"}

参数:

originalString - 指定的字符串,字符串的值不能为null

splitByteLength - 给定字节的长度

charsetName - 字符串编码

返回:

返回按照给定长度分割后的字符串数组

split

public static String[] split(String originalString,
                             String delimiterString)

将指定的字符串按给定的分割符进行分割，返回分割后的字符串数组.

示例

 Strings.split("a123.bc.d12.34.5",".") 返回 new String []{"a123","bc","d12","34","5"}
 Strings.split("a123|bc|d12|34|5|","|") 返回 new String[]{"a123","bc","d12","34","5",""}
 Strings.split("ˆa123ˆbcˆd12ˆ34ˆ5ˆ","ˆ") 返回 new String[]{"","a123","bc","d12","34","5",""}
 Strings.split("abcd","ˆ") 返回 new String[]{"abcd"}
 Strings.split("ˆabcd","ˆ") 返回 new String[]{"","abcd"}
 Strings.split("abcdˆ","ˆ") 返回 new String[]{"abcd",""}
 Strings.split("ˆabcdˆ","ˆ") 返回 new String[]{"","abcd",""}
 Strings.split("a123._.bc._.d12._.34._.5","._.") 返回 new String[]{"a123","bc","d12","34","5"}
 

参数:

originalString - 指定的字符串

delimiterString - 给定的分割符

返回:

返回按照给定的分割符进行分割后的字符串数组

rightTrim

public static String rightTrim(String str)

截取字符串右边的空格.

示例

 Strings.rightTrim(" ab cd e ") 返回 " ab cd e"
 Strings.rightTrim(null) 返回 ""
 

参数:

str - 原字符串

返回:

返回截掉右边空格后的字符串

leftTrim

public static String leftTrim(String str)

截取字符串左边的空格.

示例

 Strings.leftTrim(" ab cd e ") 返回 "ab cd e "
 Strings.leftTrim(null) 返回 ""
 

参数:

str - 原字符串

返回:

返回截掉左边空格后的字符串

absoluteTrim

public static String absoluteTrim(String str)

剔除字符串中所有出现的空格字符.

示例

 Strings.absoluteTrim(" ab cd e ") 返回 "abcde"
 

参数:

str - 原字符串

返回:

返回剔除掉所有出现的空格字符后的字符串

lowerCase

public static String lowerCase(String str,
                               int beginIndex,
                               int endIndex)

将指定字符串的从beginIndex到endIndex的字符变为小写.

示例

 Strings.lowerCase("aBcDefgHIJ",0,4) 返回 "abcdefgHIJ"
 Strings.lowerCase("Abc",0,0) 返回 "Abc"
 

参数:

str - 指定字符串

beginIndex - 起始位置

endIndex - 终止位置

返回:

返回字符串

upperCase

public static String upperCase(String str,
                               int beginIndex,
                               int endIndex)

将指定字符串的从beginIndex到endIndex的字符变为大写.

示例

 Strings.upperCase("aBcDefgHIJ",0,4) 返回 "ABCDefgHIJ"
 Strings.upperCase("policy",0,0) 返回 "policy"
 

参数:

str - 指定字符串

beginIndex - 起始位置

endIndex - 终止位置

返回:

返回字符串

lowerCaseFirstChar

public static String lowerCaseFirstChar(String iString)

将字符串的第一个字符小写.

示例

 Strings.lowerCaseFirstChar("ABc") 返回 "aBc"
 

参数:

iString - 传入字符串

返回:

传出字符串

upperCaseFirstChar

public static String upperCaseFirstChar(String iString)

将字符串的第一个字符大写.

示例

 Strings.upperCaseFirstChar("aBc") 返回 "ABc"
 

参数:

iString - 传入字符串

返回:

传出字符串

timesOf

public static int timesOf(String str,
                          String subStr)

获取子字符串在主字符串中出现的次数.

示例

 Strings.timesOf("2004-10-10 00:00:00:2005-10-11 00:00:00",":") 返回 5
 

参数:

str - 主字符串,字符串的值不能为null

subStr - 子字符串,字符串的值不能为null

返回:

返回子字符串在主字符串中出现的次数, 子字符串没有搜索到时返回0

timesOf

public static int timesOf(String str,
                          char ch)

获取字符在主字符串中出现的次数.

示例

 Strings.timesOf("2004-10-10 00:00:00:2005-10-11 00:00:00",':') 返回 5
 

参数:

str - 主字符串,字符串的值不能为null

ch - 字符,值不能为null

返回:

返回字符在主字符串中出现的次数, 字符没有搜索到时返回0

toMap

public static Map<String,String> toMap(String str,
                                       String splitString)

变为Map,如果一个条目包含等于号"="，则等于号前为Key，后为Value
示例

 Map map = Strings.toMap("00010000,00020000,00030000,00040000", ",");
 Map map = Strings.toMap("1=true,0=false", ",");
 

参数:

str -

splitString -

返回:

Map

native2ascii

public static String native2ascii(String str)

本地编码转换为Ascii编码，同native2ascii.exe
示例:

 Strings.native2ascii("出险时保单信息");返回出险时保单信息
 

参数:

str - 本地String.

返回:

转化后的Ascii编码，形如出险时保单信息

sortEnglishNumberWord

public static Map<String,String> sortEnglishNumberWord(Map<String,String> map)

英文数字排序

参数:

map -

返回:

Map

concat

public static String concat(Object... sources)

将不定长参数转换成一个字符串(直接相连，内部使用StringBuilder，比String的concat方法高效) 示例

 Strings.concat() 返回 "";
 Strings.concat("abc") 返回 "abc";
 Strings.concat("ab","c","defg") 返回 "abcdefg";
 

参数:

sources - 不定长度的生成源

返回:

连接而成的一个字符串

splitIgnoreBlank

public static Iterator<String> splitIgnoreBlank(String str,
                                                String delimiters)

分割字符串并返回迭代器，其中分割后空白字符串将被忽略

参数:

str - 字符串

delimiters - 分隔字符串

返回:

isEmptyOrNull

public static boolean isEmptyOrNull(String value)

是否空串或者null（或者"null"）

参数:

value - 传入字符串

返回:

是返回true，否则返回false

toUnderlineName

public static String toUnderlineName(String in)

驼峰和下划线转换

参数:

in -

返回:

toCamelCase

public static String toCamelCase(String in)

toCapitalizeCamelCase

public static String toCapitalizeCamelCase(String in)