commons lang包常用方法集锦

在开发代码的时候，有一些工具类帮助的情况下，会更高效的完成代码实现。我们经常用的有commons-lang和guava工具包。下面针对common-lang包下常用的几个工具类进行函数说明。

NumberUtils

numberUtils中定义的常数

常量名	值	说明
LONG_ZERO	0L	长整数类型的零
LONG_ONE	1L	长整数类型的一
LONG_MINUS_ONE	-1L	长整数类型的负一

NumberUtils中定义的常数有0、1、-1，除了上面展示的Long类型之外，还定义了Integer、Short、Byte、Double、FLoat类型的，另外Integer类型的还定义了2。

方法名	说明
toInt(String)	将字符串转换为整数类型
toInt(String, int)	将字符串转换为整数类型，如果转换失败则返回默认值
toLong(String)	将字符串转换为长整数类型
toLong(String, long)	将字符串转换为长整数类型，如果转换失败则返回默认值
toFloat(String)	将字符串转换为单精度浮点数类型
toFloat(String, float)	将字符串转换为单精度浮点数类型，如果转换失败则返回默认值
toDouble(String)	将字符串转换为双精度浮点数类型
toDouble(String, double)	将字符串转换为双精度浮点数类型，如果转换失败则返回默认值
toDouble(BigDecimal)	将BigDecimal类型转换为双精度浮点数类型
toDouble(BigDecimal, double)	将BigDecimal类型转换为双精度浮点数类型，如果转换失败则返回默认值
toByte(String)	将字符串转换为字节类型
toByte(String, byte)	将字符串转换为字节类型，如果转换失败则返回默认值
toShort(String)	将字符串转换为短整数类型
toShort(String, short)	将字符串转换为短整数类型，如果转换失败则返回默认值
toScaledBigDecimal(BigDecimal)	将BigDecimal类型转换为指定精度的BigDecimal类型
toScaledBigDecimal(BigDecimal, int, RoundingMode)	将BigDecimal类型转换为指定精度和舍入模式的BigDecimal类型
toScaledBigDecimal(Float)	将Float类型转换为指定精度的BigDecimal类型
toScaledBigDecimal(Float, int, RoundingMode)	将Float类型转换为指定精度和舍入模式的BigDecimal类型
toScaledBigDecimal(Double)	将Double类型转换为指定精度的BigDecimal类型
toScaledBigDecimal(Double, int, RoundingMode)	将Double类型转换为指定精度和舍入模式的BigDecimal类型
toScaledBigDecimal(String)	将字符串转换为指定精度的BigDecimal类型
toScaledBigDecimal(String, int, RoundingMode)	将字符串转换为指定精度和舍入模式的BigDecimal类型
createNumber(String)	将字符串转换为对应的数字类型
createFloat(String)	将字符串转换为Float类型
createDouble(String)	将字符串转换为Double类型
createInteger(String)	将字符串转换为Integer类型
createLong(String)	将字符串转换为Long类型
createBigInteger(String)	将字符串转换为BigInteger类型
createBigDecimal(String)	将字符串转换为BigDecimal类型
min(long...)	返回一组长整数中的最小值
min(int...)	返回一组整数中的最小值
min(short...)	返回一组短整数中的最小值
min(byte...)	返回一组字节中的最小值
min(double...)	返回一组双精度浮点数中的最小值
min(float...)	返回一组单精度浮点数中的最小值
max(long...)	返回一组长整数中的最大值
max(int...)	返回一组整数中的最大值
max(short...)	返回一组短整数中的最大值
max(byte...)	返回一组字节中的最大值
max(double...)	返回一组双精度浮点数中的最大值
max(float...)	返回一组单精度浮点数中的最大值
isDigits(String)	判断字符串是否只包含数字字符
isCreatable(String)	判断字符串是否可以转换为数字类型
isParsable(String)	判断字符串是否可以解析为数字类型
compare(int, int)	比较两个整数的大小
compare(long, long)	比较两个长整数的大小
compare(short, short)	比较两个短整数的大小
compare(byte, byte)	比较两个字节的大小

DateFormatUtils

方法名	说明
formatUTC(long, String)	将指定的时间戳（毫秒）转换为指定格式的字符串，使用UTC时区
formatUTC(Date, String)	将指定的日期对象转换为指定格式的字符串，使用UTC时区
formatUTC(long, String, Locale)	将指定的时间戳（毫秒）转换为指定格式的字符串，使用UTC时区和指定的Locale
formatUTC(Date, String, Locale)	将指定的日期对象转换为指定格式的字符串，使用UTC时区和指定的Locale
format(long, String)	将指定的时间戳（毫秒）转换为指定格式的字符串
format(Date, String)	将指定的日期对象转换为指定格式的字符串
format(Calendar, String)	将指定的日历对象转换为指定格式的字符串
format(long, String, TimeZone)	将指定的时间戳（毫秒）转换为指定格式的字符串，使用指定的时区
format(Date, String, TimeZone)	将指定的日期对象转换为指定格式的字符串，使用指定的时区
format(Calendar, String, TimeZone)	将指定的日历对象转换为指定格式的字符串，使用指定的时区
format(long, String, Locale)	将指定的时间戳（毫秒）转换为指定格式的字符串，使用默认时区和指定的Locale
format(Date, String, Locale)	将指定的日期对象转换为指定格式的字符串，使用默认时区和指定的Locale
format(Calendar, String, Locale)	将指定的日历对象转换为指定格式的字符串，使用默认时区和指定的Locale
format(long, String, TimeZone, Locale)	将指定的时间戳（毫秒）转换为指定格式的字符串，使用指定的时区和Locale
format(Date, String, TimeZone, Locale)	将指定的日期对象转换为指定格式的字符串，使用指定的时区和Locale
format(Calendar, String, TimeZone, Locale)	将指定的日历对象转换为指定格式的字符串，使用指定的时区和Locale

DateUtils

方法名	含义
isSameDay(Date date1, Date date2)	判断两个日期是否是同一天
isSameDay(Calendar cal1, Calendar cal2)	判断两个日历对象是否是同一天
isSameInstant(Date date1, Date date2)	判断两个日期是否是同一时刻
isSameInstant(Calendar cal1, Calendar cal2)	判断两个日历对象是否是同一时刻
isSameLocalTime(Calendar cal1, Calendar cal2)	判断两个日历对象是否是同一本地时间
parseDate(String str, String… parsePatterns)	解析日期字符串为Date对象
parseDate(String str, Locale locale, String… parsePatterns)	解析日期字符串为Date对象，指定Locale
parseDateStrictly(String str, String… parsePatterns)	严格解析日期字符串为Date对象
parseDateStrictly(String str, Locale locale, String… parsePatterns)	严格解析日期字符串为Date对象，指定Locale
addYears(Date date, int amount)	在日期上增加指定年数
addMonths(Date date, int amount)	在日期上增加指定月数
addWeeks(Date date, int amount)	在日期上增加指定周数
addDays(Date date, int amount)	在日期上增加指定天数
addHours(Date date, int amount)	在日期上增加指定小时数
addMinutes(Date date, int amount)	在日期上增加指定分钟数
addSeconds(Date date, int amount)	在日期上增加指定秒数
addMilliseconds(Date date, int amount)	在日期上增加指定毫秒数
setYears(Date date, int amount)	设置日期的年份
setMonths(Date date, int amount)	设置日期的月份
setDays(Date date, int amount)	设置日期的天数
setHours(Date date, int amount)	设置日期的小时数
setMinutes(Date date, int amount)	设置日期的分钟数
setSeconds(Date date, int amount)	设置日期的秒数
setMilliseconds(Date date, int amount)	设置日期的毫秒数
toCalendar(Date date)	将Date对象转换为Calendar对象
toCalendar(Date date, TimeZone tz)	将Date对象转换为指定时区的Calendar对象
round(Date date, int field)	对日期进行四舍五入
round(Calendar date, int field)	对日历对象进行四舍五入
truncate(Date date, int field)	对日期进行截断
truncate(Calendar date, int field)	对日历对象进行截断
ceiling(Date date, int field)	对日期进行向上取整
ceiling(Calendar date, int field)	对日历对象进行向上取整
getFragmentInMilliseconds(Date date, int fragment)	获取日期的指定精度的时间片段（毫秒）
getFragmentInSeconds(Date date, int fragment)	获取日期的指定精度的时间片段（秒）
getFragmentInMinutes(Date date, int fragment)	获取日期的指定精度的时间片段（分钟）
getFragmentInHours(Date date, int fragment)	获取日期的指定精度的时间片段（小时）
getFragmentInDays(Date date, int fragment)	获取日期的指定精度的时间片段（天）
getFragmentInMilliseconds(Calendar calendar, int fragment)	获取日历对象的指定精度的时间片段（毫秒）
getFragmentInSeconds(Calendar calendar, int fragment)	获取日历对象的指定精度的时间片段（秒）
getFragmentInMinutes(Calendar calendar, int fragment)	获取日历对象的指定精度的时间片段（分钟）
getFragmentInHours(Calendar calendar, int fragment)	获取日历对象的指定精度的时间片段（小时）
getFragmentInDays(Calendar calendar, int fragment)	获取日历对象的指定精度的时间片段（天）
truncatedEquals(Calendar cal1, Calendar cal2, int field)	判断两个日历对象在指定精度下是否相等
truncatedEquals(Date date1, Date date2, int field)	判断两个日期在指定精度下是否相等
truncatedCompareTo(Calendar cal1, Calendar cal2, int field)	比较两个日历对象在指定精度下的大小
truncatedCompareTo(Date date1, Date date2, int field)	比较两个日期在指定精度下的大小

ImmutablePair

方法名	含义
nullPair()	返回一个空的ImmutablePair对象
of(L left, R right)	创建一个包含指定左值和右值的ImmutablePair对象
getLeft()	获取ImmutablePair对象的左值
getRight()	获取ImmutablePair对象的右值
还有一个Pair类，和ImmutablePair是两个不同的类。Pair是可变的，而ImmutablePair是不可变的。

ImmutableTriple

方法名	含义
nullTriple()	返回一个空的ImmutableTriple对象
of(L left, M middle, R right)	创建一个包含指定左值、中值和右值的ImmutableTriple对象
getLeft()	获取ImmutableTriple对象的左值
getMiddle()	获取ImmutableTriple对象的中值
getRight()	获取ImmutableTriple对象的右值
还有一个Triple类，和ImmutableTriple是两个不同的类。Triple是可变的，而ImmutableTriple是不可变的。

ArrayUtils

方法名	含义
add	向数组中添加元素
addAll	向数组中添加多个元素
clone	克隆数组
contains	判断数组是否包含指定元素
containsAny	判断数组是否包含指定的任意一个元素
containsOnly	判断数组是否只包含指定的元素
containsOnlyOnce	判断数组是否只包含指定元素一次
containsAny	判断数组是否包含指定的任意一个元素
getLength	获取数组的长度
indexOf	获取指定元素在数组中的索引
insert	在指定位置插入元素
isEmpty	判断数组是否为空
isNotEmpty	判断数组是否不为空
isSameLength	判断两个数组是否长度相同
isSameType	判断两个数组是否类型相同
lastIndexOf	获取指定元素在数组中的最后一个索引
nullToEmpty	将null转换为空数组
remove	移除数组中指定位置的元素
removeAll	移除数组中指定元素
removeElement	移除数组中指定元素
removeElements	移除数组中指定元素
removeAllOccurrences	移除数组中所有指定元素的出现
reverse	反转数组
subarray	获取数组的子数组
swap	交换数组中两个位置的元素
toArray	将集合转换为数组
toMap	将数组转换为Map
toString	将数组转换为字符串
toPrimitive	将包装类型数组转换为基本类型数组
toObject	将基本类型数组转换为包装类型数组
nullToDefault	将null转换为默认值
defaultIfNull	如果数组为null，则返回默认数组
isSameLength	判断多个数组是否长度相同
isSameType	判断多个数组是否类型相同
addAll	合并多个数组
clone	克隆多个数组
indexOf	获取多个数组中指定元素的索引
lastIndexOf	获取多个数组中指定元素的最后一个索引
removeAllOccurrences	移除多个数组中所有指定元素的出现
reverse	反转多个数组
subarray	获取多个数组的子数组
swap	交换多个数组中两个位置的元素
toString	将多个数组转换为字符串
toPrimitive	将多个包装类型数组转换为基本类型数组
toObject	将多个基本类型数组转换为包装类型数组
nullToDefault	将多个数组中的null转换为默认值
defaultIfNull	如果多个数组中有任意一个为null，则返回默认数组

RandomUtils

方法名	含义
nextBoolean()	生成一个随机的布尔值
nextBytes(int count)	生成指定长度的随机字节数组
nextInt(int startInclusive, int endExclusive)	生成一个指定范围内的随机整数，包括起始值但不包括结束值
nextInt()	生成一个非负的随机整数
nextLong(long startInclusive, long endExclusive)	生成一个指定范围内的随机长整数，包括起始值但不包括结束值
nextLong()	生成一个非负的随机长整数
nextDouble(double startInclusive, double endInclusive)	生成一个指定范围内的随机双精度浮点数，包括起始值和结束值
nextDouble()	生成一个非负的随机双精度浮点数
nextFloat(float startInclusive, float endInclusive)	生成一个指定范围内的随机单精度浮点数，包括起始值和结束值
nextFloat()	生成一个非负的随机单精度浮点数

StringUtils

方法名	含义
abbreviate	缩略字符串
abbreviateMiddle	缩略字符串并在中间添加省略号
appendIfMissing	如果字符串不以指定后缀结尾，则追加后缀
appendIfMissingIgnoreCase	如果字符串不以指定后缀结尾（忽略大小写），则追加后缀
capitalize	将字符串的首字母大写
center	将字符串居中对齐
chomp	删除字符串末尾的指定字符
chop	删除字符串末尾的最后一个字符
contains	判断字符串是否包含指定字符
containsAny	判断字符串是否包含指定的任意一个字符
containsIgnoreCase	判断字符串是否包含指定字符（忽略大小写）
countMatches	统计字符串中指定字符的出现次数
defaultIfBlank	如果字符串为空或只包含空白字符，则返回默认值
defaultIfEmpty	如果字符串为空，则返回默认值
deleteWhitespace	删除字符串中的空白字符
difference	获取两个字符串的不同部分
endsWith	判断字符串是否以指定后缀结尾
endsWithIgnoreCase	判断字符串是否以指定后缀结尾（忽略大小写）
equals	判断两个字符串是否相等
equalsIgnoreCase	判断两个字符串是否相等（忽略大小写）
getCommonPrefix	获取多个字符串的共同前缀
indexOf	获取指定字符在字符串中的索引
indexOfIgnoreCase	获取指定字符在字符串中的索引（忽略大小写）
isAllBlank	判断多个字符串是否全部为空或只包含空白字符
isAllEmpty	判断多个字符串是否全部为空
isAnyBlank	判断多个字符串是否存在为空或只包含空白字符的情况
isAnyEmpty	判断多个字符串是否存在为空的情况
isBlank	判断字符串是否为空或只包含空白字符
isEmpty	判断字符串是否为空
isNotBlank	判断字符串是否不为空且不只包含空白字符
isNotEmpty	判断字符串是否不为空
join	将多个字符串连接起来
joinWith	使用指定的分隔符将多个字符串连接起来
lastIndexOf	获取指定字符在字符串中的最后一个索引
left	获取字符串的左侧指定长度的子串
length	获取字符串的长度
lowerCase	将字符串转换为小写
normalizeSpace	去除字符串中的多余空白字符
ordinalIndexOf	获取字符串中指定字符的第N次出现的索引
overlay	在字符串指定位置插入另一个字符串
prependIfMissing	如果字符串不以指定前缀开头，则在开头添加前缀
prependIfMissingIgnoreCase	如果字符串不以指定前缀开头（忽略大小写），则在开头添加前缀
remove	删除字符串中的指定字符
removeEnd	删除字符串末尾的指定后缀
removeEndIgnoreCase	删除字符串末尾的指定后缀（忽略大小写）
removeStart	删除字符串开头的指定前缀
removeStartIgnoreCase	删除字符串开头的指定前缀（忽略大小写）
repeat	重复字符串指定次数
replace	替换字符串中的指定字符
replaceChars	替换字符串中的指定字符序列
replaceEach	替换字符串中的指定字符序列
replaceIgnoreCase	替换字符串中的指定字符（忽略大小写）
replaceOnce	替换字符串中的第一个匹配项
reverse	反转字符串
right	获取字符串的右侧指定长度的子串
split	分割字符串
startsWith	判断字符串是否以指定前缀开头
startsWithIgnoreCase	判断字符串是否以指定前缀开头（忽略大小写）
------	----
strip	去除字符串首尾的空白字符
stripToNull	去除字符串首尾的空白字符，并将空字符串转换为null
stripToEmpty	去除字符串首尾的空白字符，并将空字符串转换为空字符串
substring	获取字符串的子串
substringAfter	获取指定字符之后的子串
substringAfterLast	获取最后一个指定字符之后的子串
substringBefore	获取指定字符之前的子串
substringBeforeLast	获取最后一个指定字符之前的子串
swapCase	大小写互换
trim	去除字符串首尾的空白字符
trimToEmpty	去除字符串首尾的空白字符，并将空字符串转换为空字符串
trimToNull	去除字符串首尾的空白字符，并将空字符串转换为null
uncapitalize	将字符串的首字母小写
upperCase	将字符串转换为大写
wrap	使用指定字符包裹字符串