不要再重復(fù)造輪子了，這款開(kāi)源工具類庫(kù)賊好使！

讀者群里有個(gè)小伙伴感慨說(shuō)，“Hutool 這款開(kāi)源類庫(kù)太厲害了，基本上該有該的工具類，它里面都有。”講真的，我平常工作中也經(jīng)常用 Hutool，它確實(shí)可以幫助我們簡(jiǎn)化每一行代碼，使 Java 擁有函數(shù)式語(yǔ)言般的優(yōu)雅，讓 Java 語(yǔ)言變得“甜甜的”。

PS：為了能夠幫助更多的 Java 初學(xué)者，已將《Java 程序員進(jìn)階之路》開(kāi)源到了 GitHub（本篇已收錄）。該專欄目前已經(jīng)收獲了 587 枚星標(biāo)，如果你也喜歡這個(gè)專欄，覺(jué)得有幫助的話，可以去點(diǎn)個(gè) star，這樣也方便以后進(jìn)行更系統(tǒng)化的學(xué)習(xí)！

https://github.com/itwanger/toBeBetterJavaer

Hutool 的作者在官網(wǎng)上說(shuō)，Hutool 是 Hu+tool 的自造詞（好像不用說(shuō)，我們也能猜得到），“Hu”用來(lái)致敬他的“前任”公司，“tool”就是工具的意思，諧音就有意思了，“糊涂”，寓意追求“萬(wàn)事都作糊涂觀，無(wú)所謂失，無(wú)所謂得”（一個(gè)開(kāi)源類庫(kù)，上升到了哲學(xué)的高度，作者厲害了）。

看了一下開(kāi)發(fā)團(tuán)隊(duì)的一個(gè)成員介紹，一個(gè) Java 后端工具的作者竟然愛(ài)前端、愛(ài)數(shù)碼，愛(ài)美女，嗯嗯嗯，確實(shí)“難得糊涂”（手動(dòng)狗頭）。

就連向這個(gè)開(kāi)源類庫(kù)提交的 PR（pull request）規(guī)范都非?！安B(tài)化”（哈哈哈）：

廢話就說(shuō)到這，來(lái)吧，實(shí)操走起！

01、引入 Hutool

Maven 項(xiàng)目只需要在 pom.xml 文件中添加以下依賴即可。

????cn.hutool
????hutool-all
????5.4.3

Hutool 的設(shè)計(jì)思想是盡量減少重復(fù)的定義，讓項(xiàng)目中的 util 包盡量少。一個(gè)好的輪子可以在很大程度上避免“復(fù)制粘貼”，從而節(jié)省我們開(kāi)發(fā)人員對(duì)項(xiàng)目中公用類庫(kù)和公用工具方法的封裝時(shí)間。同時(shí)呢，成熟的開(kāi)源庫(kù)也可以最大限度的避免封裝不完善帶來(lái)的 bug。

就像作者在官網(wǎng)上說(shuō)的那樣：

• 以前，我們打開(kāi)搜索引擎 -> 搜“Java MD5 加密” -> 打開(kāi)某篇博客 -> 復(fù)制粘貼 -> 改改，變得好用些

有了 Hutool 以后呢，引入 Hutool -> 直接 SecureUtil.md5()

Hutool 對(duì)不僅對(duì) JDK 底層的文件、流、加密解密、轉(zhuǎn)碼、正則、線程、XML等做了封裝，還提供了以下這些組件：

非常多，非常全面，鑒于此，我只挑選一些我喜歡的來(lái)介紹下（偷偷地告訴你，我就是想偷懶）。

02、類型轉(zhuǎn)換

類型轉(zhuǎn)換在 Java 開(kāi)發(fā)中很常見(jiàn)，尤其是從 HttpRequest 中獲取參數(shù)的時(shí)候，前端傳遞的是整形，但后端只能先獲取到字符串，然后再調(diào)用 parseXXX() 方法進(jìn)行轉(zhuǎn)換，還要加上判空，很繁瑣。

Hutool 的 Convert 類可以簡(jiǎn)化這個(gè)操作，可以將任意可能的類型轉(zhuǎn)換為指定類型，同時(shí)第二個(gè)參數(shù) defaultValue 可用于在轉(zhuǎn)換失敗時(shí)返回一個(gè)默認(rèn)值。

String?param?=?"10";
int?paramInt?=?Convert.toInt(param);
int?paramIntDefault?=?Convert.toInt(param,?0);

把字符串轉(zhuǎn)換成日期：

String?dateStr?=?"2020年09月29日";
Date?date?=?Convert.toDate(dateStr);

把字符串轉(zhuǎn)成 Unicode：

String?unicodeStr?=?"沉默王二";
String?unicode?=?Convert.strToUnicode(unicodeStr);

03、日期時(shí)間

JDK 自帶的 Date 和 Calendar 不太好用，Hutool 封裝的 DateUtil 用起來(lái)就舒服多了！

獲取當(dāng)前日期：

Date?date?=?DateUtil.date();

DateUtil.date() 返回的其實(shí)是 DateTime，它繼承自 Date 對(duì)象，重寫(xiě)了 toString() 方法，返回 yyyy-MM-dd HH:mm:ss 格式的字符串。

有些小伙伴是不是想看看我寫(xiě)這篇文章的時(shí)間，輸出一下給大家看看：

System.out.println(date);//?2020-09-29?04:28:02

字符串轉(zhuǎn)日期：

String?dateStr?=?"2020-09-29";
Date?date?=?DateUtil.parse(dateStr);

DateUtil.parse() 會(huì)自動(dòng)識(shí)別一些常用的格式，比如說(shuō)：

• yyyy-MM-dd HH:mm:ss
• yyyy-MM-dd
• HH:mm:ss
• yyyy-MM-dd HH:mm
• yyyy-MM-dd HH:mm:ss.SSS

還可以識(shí)別帶中文的：

• 年月日時(shí)分秒

格式化時(shí)間差：

String?dateStr1?=?"2020-09-29?22:33:23";
Date?date1?=?DateUtil.parse(dateStr1);

String?dateStr2?=?"2020-10-01?23:34:27";
Date?date2?=?DateUtil.parse(dateStr2);

long?betweenDay?=?DateUtil.between(date1,?date2,?DateUnit.MS);

//?輸出：2天1小時(shí)1分4秒
String?formatBetween?=?DateUtil.formatBetween(betweenDay,?BetweenFormater.Level.SECOND);

星座和屬相：

//?射手座
String?zodiac?=?DateUtil.getZodiac(Month.DECEMBER.getValue(),?10);
//?蛇
String?chineseZodiac?=?DateUtil.getChineseZodiac(1989);

04、IO 流相關(guān)

IO 操作包括讀和寫(xiě)，應(yīng)用的場(chǎng)景主要包括網(wǎng)絡(luò)操作和文件操作，原生的 Java 類庫(kù)區(qū)分字符流和字節(jié)流，字節(jié)流 InputStream 和 OutputStream 就有很多很多種，使用起來(lái)讓人頭皮發(fā)麻。

Hutool 封裝了流操作工具類 IoUtil、文件讀寫(xiě)操作工具類 FileUtil、文件類型判斷工具類 FileTypeUtil 等等。

BufferedInputStream?in?=?FileUtil.getInputStream("hutool/origin.txt");
BufferedOutputStream?out?=?FileUtil.getOutputStream("hutool/to.txt");
long?copySize?=?IoUtil.copy(in,?out,?IoUtil.DEFAULT_BUFFER_SIZE);

在 IO 操作中，文件的操作相對(duì)來(lái)說(shuō)是比較復(fù)雜的，但使用頻率也很高，幾乎所有的項(xiàng)目中都躺著一個(gè)叫 FileUtil 或者 FileUtils 的工具類。Hutool 的 FileUtil 類包含以下幾類操作：

• 文件操作：包括文件目錄的新建、刪除、復(fù)制、移動(dòng)、改名等
• 文件判斷：判斷文件或目錄是否非空，是否為目錄，是否為文件等等
• 絕對(duì)路徑：針對(duì) ClassPath 中的文件轉(zhuǎn)換為絕對(duì)路徑文件
• 文件名：主文件名，擴(kuò)展名的獲取
• 讀操作：包括 getReader、readXXX 操作
• 寫(xiě)操作：包括 getWriter、writeXXX 操作

順帶說(shuō)說(shuō) classpath。

在實(shí)際編碼當(dāng)中，我們通常需要從某些文件里面讀取一些數(shù)據(jù)，比如配置文件、文本文件、圖片等等，那這些文件通常放在什么位置呢？

放在項(xiàng)目結(jié)構(gòu)圖中的 resources 目錄下，當(dāng)項(xiàng)目編譯后，會(huì)出現(xiàn)在 classes 目錄下。對(duì)應(yīng)磁盤(pán)上的目錄如下圖所示：

當(dāng)我們要讀取文件的時(shí)候，我是不建議使用絕對(duì)路徑的，因?yàn)椴僮飨到y(tǒng)不一樣的話，文件的路徑標(biāo)識(shí)符也是不一樣的。最好使用相對(duì)路徑。

假設(shè)在 src/resources 下放了一個(gè)文件 origin.txt，文件的路徑參數(shù)如下所示：

FileUtil.getInputStream("origin.txt")

假設(shè)文件放在 src/resources/hutool 目錄下，則路徑參數(shù)改為：

FileUtil.getInputStream("hutool/origin.txt")

05、字符串工具

Hutool 封裝的字符串工具類 StrUtil 和 Apache Commons Lang 包中的 StringUtils 類似，作者認(rèn)為優(yōu)勢(shì)在于 Str 比 String 短，盡管我不覺(jué)得。不過(guò)，我倒是挺喜歡其中的一個(gè)方法的：

String?template?=?"{}，一枚沉默但有趣的程序員，喜歡他的文章的話，請(qǐng)微信搜索{}";
String?str?=?StrUtil.format(template,?"沉默王二",?"沉默王二");
//?沉默王二，一枚沉默但有趣的程序員，喜歡他的文章的話，請(qǐng)微信搜索沉默王二

06、反射工具

反射機(jī)制可以讓 Java 變得更加靈活，因此在某些情況下，反射可以做到事半功倍的效果。Hutool 封裝的反射工具 ReflectUtil 包括：

• 獲取構(gòu)造方法
• 獲取字段
• 獲取字段值
• 獲取方法
• 執(zhí)行方法（對(duì)象方法和靜態(tài)方法）

package?com.itwanger.hutool.reflect;

import?cn.hutool.core.util.ReflectUtil;

import?java.lang.reflect.Constructor;
import?java.lang.reflect.Field;
import?java.lang.reflect.Method;

/**
?*?@author?微信搜「沉默王二」，回復(fù)關(guān)鍵字?PDF
?*/
public?class?ReflectDemo?{
????private?int?id;

????public?ReflectDemo()?{
????????System.out.println("構(gòu)造方法");
????}

????public?void?print()?{
????????System.out.println("我是沉默王二");
????}

????public?static?void?main(String[]?args)?throws?IllegalAccessException?{
????????//?構(gòu)建對(duì)象
????????ReflectDemo?reflectDemo?=?ReflectUtil.newInstance(ReflectDemo.class);

????????//?獲取構(gòu)造方法
????????Constructor[]?constructors?=?ReflectUtil.getConstructors(ReflectDemo.class);
????????for?(Constructor?constructor?:?constructors)?{
????????????System.out.println(constructor.getName());
????????}

????????//?獲取字段
????????Field?field?=?ReflectUtil.getField(ReflectDemo.class,?"id");
????????field.setInt(reflectDemo,?10);
????????//?獲取字段值
????????System.out.println(ReflectUtil.getFieldValue(reflectDemo,?field));

????????//?獲取所有方法
????????Method[]?methods?=?ReflectUtil.getMethods(ReflectDemo.class);
????????for?(Method?m?:?methods)?{
????????????System.out.println(m.getName());
????????}

????????//?獲取指定方法
????????Method?method?=?ReflectUtil.getMethod(ReflectDemo.class,?"print");
????????System.out.println(method.getName());


????????//?執(zhí)行方法
????????ReflectUtil.invoke(reflectDemo,?"print");
????}
}

07、壓縮工具

在 Java 中，對(duì)文件、文件夾打包壓縮是一件很繁瑣的事情，Hutool 封裝的 ZipUtil 針對(duì) java.util.zip 包做了優(yōu)化，可以使用一個(gè)方法搞定壓縮和解壓，并且自動(dòng)處理文件和目錄的問(wèn)題，不再需要用戶判斷，大大簡(jiǎn)化的壓縮解壓的復(fù)雜度。

ZipUtil.zip("hutool",?"hutool.zip");
File?unzip?=?ZipUtil.unzip("hutool.zip",?"hutoolzip");

08、身份證工具

Hutool 封裝的 IdcardUtil 可以用來(lái)對(duì)身份證進(jìn)行驗(yàn)證，支持大陸 15 位、18 位身份證，港澳臺(tái) 10 位身份證。

String?ID_18?=?"321083197812162119";
String?ID_15?=?"150102880730303";

boolean?valid?=?IdcardUtil.isValidCard(ID_18);
boolean?valid15?=?IdcardUtil.isValidCard(ID_15);

09、擴(kuò)展 HashMap

Java 中的 HashMap 是強(qiáng)類型的，而 Hutool 封裝的 Dict 對(duì)鍵的類型要求沒(méi)那么嚴(yán)格。

Dict?dict?=?Dict.create()
????????.set("age",?18)
????????.set("name",?"沉默王二")
????????.set("birthday",?DateTime.now());

int?age?=?dict.getInt("age");
String?name?=?dict.getStr("name");

10、控制臺(tái)打印

本地編碼的過(guò)程中，經(jīng)常需要使用 System.out 打印結(jié)果，但是往往一些復(fù)雜的對(duì)象不支持直接打印，比如說(shuō)數(shù)組，需要調(diào)用 Arrays.toString。Hutool 封裝的 Console 類借鑒了 JavaScript 中的 console.log()，使得打印變成了一個(gè)非常便捷的方式。

/**
?*?@author?微信搜「沉默王二」，回復(fù)關(guān)鍵字?PDF
?*/
public?class?ConsoleDemo?{
????public?static?void?main(String[]?args)?{
????????//?打印字符串
????????Console.log("沉默王二，一枚有趣的程序員");

????????//?打印字符串模板
????????Console.log("洛陽(yáng)是{}朝古都",13);

????????int?[]?ints?=?{1,2,3,4};
????????//?打印數(shù)組
????????Console.log(ints);
????}
}

11、字段驗(yàn)證器

做 Web 開(kāi)發(fā)的時(shí)候，后端通常需要對(duì)表單提交過(guò)來(lái)的數(shù)據(jù)進(jìn)行驗(yàn)證。Hutool 封裝的 Validator 可以進(jìn)行很多有效的條件驗(yàn)證：

• 是不是郵箱
• 是不是 IP V4、V6
• 是不是電話號(hào)碼
• 等等

Validator.isEmail("沉默王二");
Validator.isMobile("itwanger.com");

12、雙向查找 Map

Guava 中提供了一種特殊的 Map 結(jié)構(gòu)，叫做 BiMap，實(shí)現(xiàn)了一種雙向查找的功能，可以根據(jù) key 查找 value，也可以根據(jù) value 查找 key，Hutool 也提供這種 Map 結(jié)構(gòu)。

BiMap?biMap?=?new?BiMap<>(new?HashMap<>());
biMap.put("wanger",?"沉默王二");
biMap.put("wangsan",?"沉默王三");

//?get?value?by?key
biMap.get("wanger");
biMap.get("wangsan");

//?get?key?by?value
biMap.getKey("沉默王二");
biMap.getKey("沉默王三");

在實(shí)際的開(kāi)發(fā)工作中，其實(shí)我更傾向于使用 Guava 的 BiMap，而不是 Hutool 的。這里提一下，主要是我發(fā)現(xiàn)了 Hutool 在線文檔上的一處錯(cuò)誤，提了個(gè) issue（從中可以看出我一顆一絲不茍的心和一雙清澈明亮的大眼睛啊）。

13、圖片工具

Hutool 封裝的 ImgUtil 可以對(duì)圖片進(jìn)行縮放、裁剪、轉(zhuǎn)為黑白、加水印等操作。

縮放圖片：

ImgUtil.scale(
????????FileUtil.file("hutool/wangsan.jpg"),
????????FileUtil.file("hutool/wangsan_small.jpg"),
????????0.5f
);

裁剪圖片：

ImgUtil.cut(
????????FileUtil.file("hutool/wangsan.jpg"),
????????FileUtil.file("hutool/wangsan_cut.jpg"),
????????new?Rectangle(200,?200,?100,?100)
);

添加水?。?/p>

ImgUtil.pressText(//
????????FileUtil.file("hutool/wangsan.jpg"),
????????FileUtil.file("hutool/wangsan_logo.jpg"),
????????"沉默王二",?Color.WHITE,
????????new?Font("黑體",?Font.BOLD,?100),
????????0,
????????0,
????????0.8f
);

趁機(jī)讓大家欣賞一下二哥帥氣的真容。

14、配置文件

眾所周知，Java 中廣泛應(yīng)用的配置文件 Properties 存在一個(gè)特別大的詬?。翰恢С种形?。每次使用時(shí)，如果想存放中文字符，就必須借助 IDE 相關(guān)插件才能轉(zhuǎn)為 Unicode 符號(hào)，而這種反人類的符號(hào)在命令行下根本沒(méi)法看。

于是，Hutool 的 Setting 運(yùn)用而生。Setting 除了兼容 Properties 文件格式外，還提供了一些特有功能，這些功能包括：

• 各種編碼方式支持
• 變量支持
• 分組支持

先整個(gè)配置文件 example.setting，內(nèi)容如下：

name=沉默王二
age=18

再來(lái)讀取和更新配置文件：

/**
?*?@author?微信搜「沉默王二」，回復(fù)關(guān)鍵字?PDF
?*/
public?class?SettingDemo?{
????private?final?static?String?SETTING?=?"hutool/example.setting";
????public?static?void?main(String[]?args)?{
????????//?初始化?Setting
????????Setting?setting?=?new?Setting(SETTING);

????????//?讀取
????????setting.getStr("name",?"沉默王二");

????????//?在配置文件變更時(shí)自動(dòng)加載
????????setting.autoLoad(true);

????????//?通過(guò)代碼方式增加鍵值對(duì)
????????setting.set("birthday",?"2020年09月29日");
????????setting.store(SETTING);
????}
}

15、日志工廠

Hutool 封裝的日志工廠 LogFactory 兼容了各大日志框架，使用起來(lái)也非常簡(jiǎn)便。

/**
?*?@author?微信搜「沉默王二」，回復(fù)關(guān)鍵字?PDF
?*/
public?class?LogDemo?{
????private?static?final?Log?log?=?LogFactory.get();

????public?static?void?main(String[]?args)?{
????????log.debug("難得糊涂");
????}
}

先通過(guò) LogFactory.get() 自動(dòng)識(shí)別引入的日志框架，從而創(chuàng)建對(duì)應(yīng)日志框架的門(mén)面 Log 對(duì)象，然后調(diào)用 debug()、info() 等方法輸出日志。

如果不想創(chuàng)建 Log 對(duì)象的話，可以使用 StaticLog，顧名思義，一個(gè)提供了靜態(tài)方法的日志類。

StaticLog.info("爽啊?{}.",?"沉默王二的文章");

16、緩存工具

CacheUtil 是 Hutool 封裝的創(chuàng)建緩存的快捷工具類，可以創(chuàng)建不同的緩存對(duì)象：

• FIFOCache：先入先出，元素不停的加入緩存直到緩存滿為止，當(dāng)緩存滿時(shí)，清理過(guò)期緩存對(duì)象，清理后依舊滿則刪除先入的緩存。

Cache?fifoCache?=?CacheUtil.newFIFOCache(3);
fifoCache.put("key1",?"沉默王一");
fifoCache.put("key2",?"沉默王二");
fifoCache.put("key3",?"沉默王三");
fifoCache.put("key4",?"沉默王四");

//?大小為?3，所以?key3?放入后?key1?被清除
String?value1?=?fifoCache.get("key1");

• LFUCache，最少使用，根據(jù)使用次數(shù)來(lái)判定對(duì)象是否被持續(xù)緩存，當(dāng)緩存滿時(shí)清理過(guò)期對(duì)象，清理后依舊滿的情況下清除最少訪問(wèn)的對(duì)象并將其他對(duì)象的訪問(wèn)數(shù)減去這個(gè)最少訪問(wèn)數(shù)，以便新對(duì)象進(jìn)入后可以公平計(jì)數(shù)。

Cache?lfuCache?=?CacheUtil.newLFUCache(3);

lfuCache.put("key1",?"沉默王一");
//?使用次數(shù)+1
lfuCache.get("key1");
lfuCache.put("key2",?"沉默王二");
lfuCache.put("key3",?"沉默王三");
lfuCache.put("key4",?"沉默王四");

//?由于緩存容量只有?3，當(dāng)加入第?4?個(gè)元素的時(shí)候，最少使用的將被移除（2,3被移除）
String?value2?=?lfuCache.get("key2");
String?value3?=?lfuCache.get("key3");

• LRUCache，最近最久未使用，根據(jù)使用時(shí)間來(lái)判定對(duì)象是否被持續(xù)緩存，當(dāng)對(duì)象被訪問(wèn)時(shí)放入緩存，當(dāng)緩存滿了，最久未被使用的對(duì)象將被移除。

Cache?lruCache?=?CacheUtil.newLRUCache(3);

lruCache.put("key1",?"沉默王一");
lruCache.put("key2",?"沉默王二");
lruCache.put("key3",?"沉默王三");
//?使用時(shí)間近了
lruCache.get("key1");
lruCache.put("key4",?"沉默王四");

//?由于緩存容量只有?3，當(dāng)加入第?4?個(gè)元素的時(shí)候，最久使用的將被移除（2）
String?value2?=?lruCache.get("key2");
System.out.println(value2);

17、加密解密

加密分為三種：

• 對(duì)稱加密（symmetric），例如：AES、DES 等
• 非對(duì)稱加密（asymmetric），例如：RSA、DSA 等
• 摘要加密（digest），例如：MD5、SHA-1、SHA-256、HMAC 等

Hutool 針對(duì)這三種情況都做了封裝：

• 對(duì)稱加密 SymmetricCrypto
• 非對(duì)稱加密 AsymmetricCrypto
• 摘要加密 Digester

快速加密工具類 SecureUtil 有以下這些方法：

1）對(duì)稱加密

• SecureUtil.aes
• SecureUtil.des

2）非對(duì)稱加密

• SecureUtil.rsa
• SecureUtil.dsa

3）摘要加密

• SecureUtil.md5
• SecureUtil.sha1
• SecureUtil.hmac
• SecureUtil.hmacMd5
• SecureUtil.hmacSha1

只寫(xiě)一個(gè)簡(jiǎn)單的例子作為參考：

/**
?*?@author?微信搜「沉默王二」，回復(fù)關(guān)鍵字?PDF
?*/
public?class?SecureUtilDemo?{
????static?AES?aes?=?SecureUtil.aes();
????public?static?void?main(String[]?args)?{
????????String?encry?=?aes.encryptHex("沉默王二");
????????System.out.println(encry);
????????String?oo?=?aes.decryptStr(encry);
????????System.out.println(oo);
????}
}

18、其他類庫(kù)

Hutool 中的類庫(kù)還有很多，尤其是一些對(duì)第三方類庫(kù)的進(jìn)一步封裝，比如郵件工具 MailUtil，二維碼工具 QrCodeUtil，Emoji 工具 EmojiUtil，小伙伴們可以參考 Hutool 的官方文檔：https://www.hutool.cn/

項(xiàng)目源碼地址：https://github.com/looly/hutool

這是《Java 程序員進(jìn)階之路》專欄的第 69 篇。Java 程序員進(jìn)階之路，該專欄風(fēng)趣幽默、通俗易懂，對(duì) Java 初學(xué)者極度友好和舒適 ，內(nèi)容包括但不限于 Java 語(yǔ)法、Java 集合框架、Java IO、Java 并發(fā)編程、Java 虛擬機(jī)等核心知識(shí)點(diǎn)。

點(diǎn)擊上方名片，發(fā)送關(guān)鍵字「03」 就可以獲取離線版 PDF 了，15 萬(wàn)+字，妥妥的良心。亮白與暗黑兩個(gè)版本都有喲，讓我們一起成為更好的 Java 工程師吧。