8个开源类为:IOUtils、FileUtils、StringUtils、FilenameUtils、ArrayUtils、DigestUtils、StringEscapeUtils、BeanUtils
连接地址:https://blog.youkuaiyun.com/qing_gee/article/details/104387940
昨天在青铜时代群里看到读者朋友们在讨论 Java 最常用的工具类,我觉得大家推荐的确实都挺常见的,我自己用的频率也蛮高的。恰好我在 programcreek 上看到过一篇类似的文章,就想着梳理一下分享给大家。
在 Java 中,工具类通常用来定义一组执行通用操作的方法。本篇文章将会向大家展示 8 个工具类以及它们最常用的方法,类的排名和方法的排名均来自可靠的数据,从 GitHub 上最受欢迎的 50000 个开源 Java 项目中精心挑选。
为了方便大家的理解,我会在介绍每个类的方法时写一段小 Demo,这样大家就能知道每个方法该怎么用。放心吧,方法是干嘛的我也不会保密的。
1)IOUtils
org.apache.commons.io.IOUtils
,操作 IO 流的工具类,下面是其常用的方法。
closeQuietly()
,关闭 IO 流,并且忽略 null 值和异常。
IOUtils.closeQuietly(output);
toByteArray()
,以byte[]
的形式获取输入流中的内容。
URLConnection conn = new URL(url).openConnection();
InputStream is = conn.getInputStream();
byte[] result = IOUtils.toByteArray(is);
write()
,将字符或者字节写入输出流中。
IOUtils.write("沉默王二", response.getOutputStream(), "UTF-8");
toInputStream()
,将指定的字符转成输入流。
String content=req.getParameter("content");
InputStream inputStream=IOUtils.toInputStream(content,"utf-8");
readLines()
,从输入流中一行一行地读取,并按照指定的字符编码返回字符串列表。
List<String> lines = IOUtils.readLines(new InputStreamReader(new FileInputStream(file), "utf-8"));
copyLarge()
,从输入流中复制内容到输出流,超过 2GB。
private File downloadFile(HttpResponse response) {
File dir = new File("downloadedFiles");
if (!dir.exists()) {
dir.mkdir();
}
File outputFile = new File("downloadedFiles/temp" + RandomStringUtils.randomAlphanumeric(3));
try {
IOUtils.copyLarge(response.getEntity().getContent(), new FileOutputStream(outputFile));
return outputFile;
} catch (Exception e) {
throw new RuntimeException(e);
} finally {
request.releaseConnection();
}
}
readFully()
,把输入流中的内容读入到字节数组中。
byte[] intArray = new byte[Bytes.SIZEOF_INT];
IOUtils.readFully(in, intArray);
2)StringUtils
org.apache.commons.lang3.StringUtils
,操作字符串的工具类,并且是 null 安全的,下面是其常用的方法。
来自:https://blog.youkuaiyun.com/qidasheng2012/article/details/83378431
以3.7版本为例
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-lang3</artifactId>
<version>3.7</version>
</dependency>
// 判断字符串是否为""或者null
public static boolean isEmpty(CharSequence cs)
// 跟上面方法相反
public static boolean isNotEmpty(CharSequence cs)
// 判断字符对象是不是空字符串、“ ”、null,注意与isEmpty的区别
public static boolean isBlank(CharSequence cs)
// 和上一个方法相反
public static boolean isNotBlank(CharSequence cs)
// 移除字符串两端的空字符串
public static String trim(String str)
public static String trimToNull(String str)
public static String trimToEmpty(String str)
// 字符串比对方法,是比较实用的方法之一,两个比较的字符串都能为空,不会报空指针异常。
public static boolean equals(CharSequence cs1, CharSequence cs2)
// 上面方法的变体, 字符串比较(忽略大小写),在验证码……等字符串比较,真是很实用。
public static boolean equalsIgnoreCase(CharSequence str1, CharSequence str2)
// indexOf这个方法不必多说,这个方法主要处理掉了空字符串的问题,不会报空指针,有一定用处
public static int indexOf(CharSequence seq, int searchChar)
// 字符串在另外一个字符串里,出现第Ordinal次的位置
public static int ordinalIndexOf(CharSequence str, CharSequence searchStr, int ordinal)
// 字符串最后一次出现的位置
public static int lastIndexOf(CharSequence seq, int searchChar)
// 字符串seq是否包含searchChar
public static boolean contains(CharSequence seq, int searchChar)
// 包含后面数组中的任意对象,返回true
public static boolean containsAny(CharSequence cs, char... searchChars)
// 字符串截取
public static String substring(String str, int start)
// 这三个方法类似都是截取字符串
public static String left(String str, int len)
public static String right(String str, int len)
public static String mid(String str, int pos, int len)
// 字符串分割
public static String[] split(String str, String separatorChars)
// 字符串连接
public static <T> String join(T... elements)
// 特定字符串连接数组,很多情况下还是蛮实用,不用自己取拼字符串
public static String join(Object[] array, char separator)
// 删除空格
public static String deleteWhitespace(String str)
// 删除以特定字符串开头的字符串,如果没有的话,就不删除。
public static String removeStart(String str, String remove)
// 生成订单号,的时候还是很实用的。右边自动补齐。
public static String rightPad(String str, int size, char padChar)
// 左边自动补齐
public static String leftPad(String str, int size, char padChar)
// 将字符在某特定长度下,居中
public static String center(String str, int size)
// 首字母大写
public static String capitalize(String str)
// 反向大小写
public static String swapCase(String str)
// 判断字符串是否由字母组成
public static boolean isAlpha(CharSequence cs)
// 默认字符串,相当于三目运算,前面若为null,则返回后面一个参数
public static String defaultString(String str, String defaultStr)
// 字符串翻转
public static String reverse(String str)
// 缩略字符串,省略号要占三位。maxWith小于3位会报错。
public static String abbreviate(String str, int maxWidth)
// 缩略字符串的一些高级用法
public static String abbreviate(String str, int offset, int maxWidth)
// 包装,用后面的字符串对前面的字符串进行包装
public static String wrap(String str, char wrapWith)
StringUtils API详解
// 判断字符串是否为""或者null
public static boolean isEmpty(CharSequence cs)
StringUtils.isEmpty(null) = true
StringUtils.isEmpty("") = true
StringUtils.isEmpty(" “) = false
StringUtils.isEmpty(“bob”) = false
StringUtils.isEmpty(” bob ") = false
// 跟上面方法相反
public static boolean isNotEmpty(CharSequence cs)
StringUtils.isNotEmpty(null) = false
StringUtils.isNotEmpty("") = false
StringUtils.isNotEmpty(" “) = true
StringUtils.isNotEmpty(“bob”) = true
StringUtils.isNotEmpty(” bob ") = true
// 任意一个参数为空的话,返回true,如果这些参数都不为空的话返回false。
public static boolean isAnyEmpty(CharSequence... css)
在写一些判断条件的时候,这个方法还是很实用的。
StringUtils.isAnyEmpty(null) = true
StringUtils.isAnyEmpty(null, “foo”) = true
StringUtils.isAnyEmpty("", “bar”) = true
StringUtils.isAnyEmpty(“bob”, “”) = true
StringUtils.isAnyEmpty(" bob “, null) = true
StringUtils.isAnyEmpty(” ", “bar”) = false
StringUtils.isAnyEmpty(“foo”, “bar”) = false
// 和上一个方法相反
// 任意一个参数是空,返回false, 所有参数都不为空,返回true
public static boolean isNoneEmpty(CharSequence... css)
注意这些方法的用法
StringUtils.isNoneEmpty(null) = false
StringUtils.isNoneEmpty(null, “foo”) = false
StringUtils.isNoneEmpty("", “bar”) = false
StringUtils.isNoneEmpty(“bob”, “”) = false
StringUtils.isNoneEmpty(" bob “, null) = false
StringUtils.isNoneEmpty(” ", “bar”) = true
StringUtils.isNoneEmpty(“foo”, “bar”) = true
// 判断字符对象是不是空字符串,注意与isEmpty的区别
public static boolean isBlank(CharSequence cs)
StringUtils.isBlank(null) = true
StringUtils.isBlank("") = true
StringUtils.isBlank(" “) = true
StringUtils.isBlank(“bob”) = false
StringUtils.isBlank(” bob ") = false
// 和上一个方法相反
public static boolean isNotBlank(CharSequence cs)
StringUtils.isNotBlank(null) = false
StringUtils.isNotBlank("") = false
StringUtils.isNotBlank(" “) = false
StringUtils.isNotBlank(“bob”) = true
StringUtils.isNotBlank(” bob ") = true
public static boolean isAnyBlank(CharSequence... css)
StringUtils.isAnyBlank(null) = true
StringUtils.isAnyBlank(null, “foo”) = true
StringUtils.isAnyBlank(null, null) = true
StringUtils.isAnyBlank("", “bar”) = true
StringUtils.isAnyBlank(“bob”, “”) = true
StringUtils.isAnyBlank(" bob “, null) = true
StringUtils.isAnyBlank(” ", “bar”) = true
StringUtils.isAnyBlank(“foo”, “bar”) = false
public static boolean isNoneBlank(CharSequence... css)
StringUtils.isNoneBlank(null) = false
StringUtils.isNoneBlank(null, “foo”) = false
StringUtils.isNoneBlank(null, null) = false
StringUtils.isNoneBlank("", “bar”) = false
StringUtils.isNoneBlank(“bob”, “”) = false
StringUtils.isNoneBlank(" bob “, null) = false
StringUtils.isNoneBlank(” ", “bar”) = false
StringUtils.isNoneBlank(“foo”, “bar”) = true
// 移除字符串两端的空字符串
public static String trim(String str)
如果为空的话,返回空
StringUtils.trim(null) = null
StringUtils.trim("") = “”
StringUtils.trim(" “) = “”
StringUtils.trim(“abc”) = “abc”
StringUtils.trim(” abc ") = “abc”
变体有
public static String trimToNull(String str)
public static String trimToEmpty(String str)
不常用,跟trim()方法类似
public static String strip(String str)
// str:被处理的字符串,可为空; stripChars: 删除的字符串,
public static String strip(String str, String stripChars)
StringUtils.strip(null, *) = null
StringUtils.strip("", *) = “”
StringUtils.strip(“abc”, null) = “abc”
StringUtils.strip(" abc", null) = “abc”
StringUtils.strip(“abc “, null) = “abc”
StringUtils.strip(” abc “, null) = “abc”
StringUtils.strip(” abcyx”, “xyz”) = " abc"
// 字符串比对方法,是比较实用的方法之一,两个比较的字符串都能为空,不会报空指针异常。
public static boolean equals(CharSequence cs1, CharSequence cs2)
StringUtils.equals(null, null) = true
StringUtils.equals(null, “abc”) = false
StringUtils.equals(“abc”, null) = false
StringUtils.equals(“abc”, “abc”) = true
StringUtils.equals(“abc”, “ABC”) = false
// 上面方法的变体, 字符串比较(忽略大小写),在验证码……等字符串比较,真是很实用。
public static boolean equalsIgnoreCase(CharSequence str1, CharSequence str2)
StringUtils.equalsIgnoreCase(null, null) = true
StringUtils.equalsIgnoreCase(null, “abc”) = false
StringUtils.equalsIgnoreCase(“abc”, null) = false
StringUtils.equalsIgnoreCase(“abc”, “abc”) = true
StringUtils.equalsIgnoreCase(“abc”, “ABC”) = true
// indexOf这个方法不必多说,这个方法主要处理掉了空字符串的问题,不会报空指针,有一定用处
public static int indexOf(CharSequence seq, int searchChar)
StringUtils.indexOf(null, *) = -1
StringUtils.indexOf("", *) = -1
StringUtils.indexOf(“aabaabaa”, ‘a’) = 0
StringUtils.indexOf(“aabaabaa”, ‘b’) = 2
// 字符串在另外一个字符串里,出现第Ordinal次的位置
public static int ordinalIndexOf(CharSequence str, CharSequence searchStr, int ordinal)
StringUtils.ordinalIndexOf(null, *, ) = -1
StringUtils.ordinalIndexOf(, null, *) = -1
StringUtils.ordinalIndexOf("", “”, *) = 0
StringUtils.ordinalIndexOf(“aabaabaa”, “a”, 1) = 0
StringUtils.ordinalIndexOf(“aabaabaa”, “a”, 2) = 1
StringUtils.ordinalIndexOf(“aabaabaa”, “b”, 1) = 2
StringUtils.ordinalIndexOf(“aabaabaa”, “b”, 2) = 5
StringUtils.ordinalIndexOf(“aabaabaa”, “ab”, 1) = 1
StringUtils.ordinalIndexOf(“aabaabaa”, “ab”, 2) = 4
StringUtils.ordinalIndexOf(“aabaabaa”, “”, 1) = 0
StringUtils.ordinalIndexOf(“aabaabaa”, “”, 2) = 0
// 字符串最后一次出现的位置
public static int lastIndexOf(CharSequence seq, int searchChar)
StringUtils.lastIndexOf(null, *) = -1
StringUtils.lastIndexOf("", *) = -1
StringUtils.lastIndexOf(“aabaabaa”, ‘a’) = 7
StringUtils.lastIndexOf(“aabaabaa”, ‘b’) = 5
// 字符串searchStr在str里面出现倒数第ordinal出现的位置
public static int lastOrdinalIndexOf(CharSequence str, CharSequence searchStr, int ordinal)
StringUtils.lastOrdinalIndexOf(null, *, ) = -1
StringUtils.lastOrdinalIndexOf(, null, *) = -1
StringUtils.lastOrdinalIndexOf("", “”, *) = 0
StringUtils.lastOrdinalIndexOf(“aabaabaa”, “a”, 1) = 7
StringUtils.lastOrdinalIndexOf(“aabaabaa”, “a”, 2) = 6
StringUtils.lastOrdinalIndexOf(“aabaabaa”, “b”, 1) = 5
StringUtils.lastOrdinalIndexOf(“aabaabaa”, “b”, 2) = 2
StringUtils.lastOrdinalIndexOf(“aabaabaa”, “ab”, 1) = 4
StringUtils.lastOrdinalIndexOf(“aabaabaa”, “ab”, 2) = 1
StringUtils.lastOrdinalIndexOf(“aabaabaa”, “”, 1) = 8
StringUtils.lastOrdinalIndexOf(“aabaabaa”, “”, 2) = 8
// 字符串seq是否包含searchChar
public static boolean contains(CharSequence seq, int searchChar)
StringUtils.contains(null, *) = false
StringUtils.contains("", *) = false
StringUtils.contains(“abc”, ‘a’) = true
StringUtils.contains(“abc”, ‘z’) = false
// 包含后面数组中的任意对象,返回true
public static boolean containsAny(CharSequence cs, char... searchChars)
StringUtils.containsAny(null, ) = false
StringUtils.containsAny("", ) = false
StringUtils.containsAny(, null) = false
StringUtils.containsAny(, []) = false
StringUtils.containsAny(“zzabyycdxx”,[‘z’,‘a’]) = true
StringUtils.containsAny(“zzabyycdxx”,[‘b’,‘y’]) = true
StringUtils.containsAny(“aba”, [‘z’]) = false
// 字符串截取
public static String substring(String str, int start)
StringUtils.substring(null, *) = null
StringUtils.substring("", *) = “”
StringUtils.substring(“abc”, 0) = “abc”
StringUtils.substring(“abc”, 2) = “c”
StringUtils.substring(“abc”, 4) = “”
StringUtils.substring(“abc”, -2) = “bc”
StringUtils.substring(“abc”, -4) = “abc”
// 这三个方法类似都是截取字符串
public static String left(String str, int len)
public static String right(String str, int len)
public static String mid(String str, int pos, int len)
// 字符串分割
public static String[] split(String str, String separatorChars)
StringUtils.split(null, *) = null
StringUtils.split("", *) = []
StringUtils.split(“abc def”, null) = [“abc”, “def”]
StringUtils.split(“abc def”, " ") = [“abc”, “def”]
StringUtils.split(“abc def”, " ") = [“abc”, “def”]
StringUtils.split(“ab,cd,ef”, “,”) = [“ab”, “cd”, “ef”]
// 字符串连接
public static <T> String join(T... elements)
StringUtils.join(null) = null
StringUtils.join([]) = “”
StringUtils.join([null]) = “”
StringUtils.join([“a”, “b”, “c”]) = “abc”
StringUtils.join([null, “”, “a”]) = “a”
// 特定字符串连接数组,很多情况下还是蛮实用,不用自己取拼字符串
public static String join(Object[] array, char separator)
StringUtils.join(null, *) = null
StringUtils.join([], *) = “”
StringUtils.join([null], *) = “”
StringUtils.join([“a”, “b”, “c”], ‘,’) = “a,b,c”
StringUtils.join([“a”, “b”, “c”], null) = “abc”
StringUtils.join([null, “”, “a”], ‘;’) = “;;a”
// 删除空格
public static String deleteWhitespace(String str)
StringUtils.deleteWhitespace(null) = null
StringUtils.deleteWhitespace("") = “”
StringUtils.deleteWhitespace(“abc”) = “abc”
StringUtils.deleteWhitespace(" ab c ") = “abc”
// 删除以特定字符串开头的字符串,如果没有的话,就不删除。
public static String removeStart(String str, String remove)
StringUtils.removeStart(null, *) = null
StringUtils.removeStart("", ) = “”
StringUtils.removeStart(, null) = *
StringUtils.removeStart(“www.domain.com”, “www.”) = “domain.com”
StringUtils.removeStart(“domain.com”, “www.”) = “domain.com”
StringUtils.removeStart(“www.domain.com”, “domain”) = “www.domain.com”
StringUtils.removeStart(“abc”, “”) = “abc”
// 右边自动补齐。 (生成订单号,的时候还是很实用的)
public static String rightPad(String str, int size, char padChar)
StringUtils.rightPad(null, *, *) = null
StringUtils.rightPad("", 3, ‘z’) = “zzz”
StringUtils.rightPad(“bat”, 3, ‘z’) = “bat”
StringUtils.rightPad(“bat”, 5, ‘z’) = “batzz”
StringUtils.rightPad(“bat”, 1, ‘z’) = “bat”
StringUtils.rightPad(“bat”, -1, ‘z’) = “bat”
// 左边自动补齐
public static String leftPad(String str, int size, char padChar)
StringUtils.leftPad(null, *, *) = null
StringUtils.leftPad("", 3, ‘z’) = “zzz”
StringUtils.leftPad(“bat”, 3, ‘z’) = “bat”
StringUtils.leftPad(“bat”, 5, ‘z’) = “zzbat”
StringUtils.leftPad(“bat”, 1, ‘z’) = “bat”
StringUtils.leftPad(“bat”, -1, ‘z’) = “bat”
// 将字符在某特定长度下,居中
public static String center(String str, int size)
StringUtils.center(null, *) = null
StringUtils.center("", 4) = " "
StringUtils.center(“ab”, -1) = “ab”
StringUtils.center(“ab”, 4) = " ab "
StringUtils.center(“abcd”, 2) = “abcd”
StringUtils.center(“a”, 4) = " a "
// 首字母大写
public static String capitalize(String str)
StringUtils.capitalize(null) = null
StringUtils.capitalize("") = “”
StringUtils.capitalize(“cat”) = “Cat”
StringUtils.capitalize(“cAt”) = “CAt”
// 反向大小写(字符串中大写变成小写,小写变成大写)
public static String swapCase(String str)
StringUtils.swapCase(null) = null
StringUtils.swapCase("") = “”
StringUtils.swapCase(“The dog has a BONE”) = “tHE DOG HAS A bone”
// 判断字符串是否由字母组成
public static boolean isAlpha(CharSequence cs)
StringUtils.isAlpha(null) = false
StringUtils.isAlpha("") = false
StringUtils.isAlpha(" ") = false
StringUtils.isAlpha(“abc”) = true
StringUtils.isAlpha(“ab2c”) = false
StringUtils.isAlpha(“ab-c”) = false
// 默认字符串,相当于三目运算,前面若为null,则返回后面一个参数
public static String defaultString(String str, String defaultStr)
StringUtils.defaultString(null, “NULL”) = “NULL”
StringUtils.defaultString("", “NULL”) = “”
StringUtils.defaultString(“bat”, “NULL”) = “bat”
// 字符串翻转
public static String reverse(String str)
StringUtils.reverse(null) = null
StringUtils.reverse("") = “”
StringUtils.reverse(“bat”) = “tab”
// 缩略字符串,省略号要占三位。maxWith小于3位会报错。
public static String abbreviate(String str, int maxWidth)
StringUtils.abbreviate(null, *) = null
StringUtils.abbreviate("", 4) = “”
StringUtils.abbreviate(“abcdefg”, 6) = “abc…”
StringUtils.abbreviate(“abcdefg”, 7) = “abcdefg”
StringUtils.abbreviate(“abcdefg”, 8) = “abcdefg”
StringUtils.abbreviate(“abcdefg”, 4) = “a…”
StringUtils.abbreviate(“abcdefg”, 3) = IllegalArgumentException
// 缩略字符串的一些高级用法
public static String abbreviate(String str, int offset, int maxWidth)
StringUtils.abbreviate(null, *, *) = null
StringUtils.abbreviate("", 0, 4) = “”
StringUtils.abbreviate(“abcdefghijklmno”, -1, 10) = “abcdefg…”
StringUtils.abbreviate(“abcdefghijklmno”, 0, 10) = “abcdefg…”
StringUtils.abbreviate(“abcdefghijklmno”, 1, 10) = “abcdefg…”
StringUtils.abbreviate(“abcdefghijklmno”, 4, 10) = “abcdefg…”
StringUtils.abbreviate(“abcdefghijklmno”, 5, 10) = “…fghi…”
StringUtils.abbreviate(“abcdefghijklmno”, 6, 10) = “…ghij…”
StringUtils.abbreviate(“abcdefghijklmno”, 8, 10) = “…ijklmno”
StringUtils.abbreviate(“abcdefghijklmno”, 10, 10) = “…ijklmno”
StringUtils.abbreviate(“abcdefghijklmno”, 12, 10) = “…ijklmno”
StringUtils.abbreviate(“abcdefghij”, 0, 3) = IllegalArgumentException
StringUtils.abbreviate(“abcdefghij”, 5, 6) = IllegalArgumentException
// 包装,用后面的字符串对前面的字符串进行包装
public static String wrap(String str, char wrapWith)
StringUtils.wrap(null, *) = null
StringUtils.wrap("", *) = “”
StringUtils.wrap(“ab”, ‘\0’) = “ab”
StringUtils.wrap(“ab”, ‘x’) = “xabx”
StringUtils.wrap(“ab”, ‘’’) = “‘ab’”
StringUtils.wrap("“ab”", ‘"’) = “”“ab”""