在日常開(kāi)發(fā)中，我們會(huì)使用很多工具類來(lái)提升項(xiàng)目開(kāi)發(fā)的速度，而國(guó)內(nèi)用的比較多的 Hutool 框架，就是其中之一。

先來(lái)看官方對(duì)于 Hutool 的定義：

Hutool 是一個(gè)小而全的 Java 工具類庫(kù)，通過(guò)靜態(tài)方法封裝，降低相關(guān) API 的學(xué)習(xí)成本，提高工作效率，使 Java 擁有函數(shù)式語(yǔ)言般的優(yōu)雅，讓 Java 語(yǔ)言也可以“甜甜的”。

Hutool 中的工具方法來(lái)自每個(gè)用戶的精雕細(xì)琢，它涵蓋了 Java 開(kāi)發(fā)底層代碼中的方方面面，它既是大型項(xiàng)目開(kāi)發(fā)中解決小問(wèn)題的利器，也是小型項(xiàng)目中的效率擔(dān)當(dāng)；

Hutool 是項(xiàng)目中“util”包友好的替代，它節(jié)省了開(kāi)發(fā)人員對(duì)項(xiàng)目中公用類和公用工具方法的封裝時(shí)間，使開(kāi)發(fā)專注于業(yè)務(wù)，同時(shí)可以最大限度的避免封裝不完善帶來(lái)的 bug。

Hutool 官方文檔：https://doc.hutool.cn/

1.包含模塊

Hutool 包含以下模塊：

模塊	介紹
hutool-aop	JDK 動(dòng)態(tài)代理封裝，提供非 IOC 下的切面支持。
hutool-bloomFilter	布隆過(guò)濾，提供一些 Hash 算法的布隆過(guò)濾。
hutool-cache	簡(jiǎn)單緩存實(shí)現(xiàn)。
hutool-core	核心，包括 Bean 操作、日期、各種Util等。
hutool-cron	定時(shí)任務(wù)模塊，提供類 Crontab 表達(dá)式的定時(shí)任務(wù)。
hutool-crypto	加密解密模塊，提供對(duì)稱、非對(duì)稱和摘要算法封裝。
hutool-db	JDBC 封裝后的數(shù)據(jù)操作，基于 ActiveRecord思想。
hutool-dfa	基于 DFA 模型的多關(guān)鍵字查找。
hutool-extra	擴(kuò)展模塊，對(duì)第三方封裝（模板引擎、郵件、Servlet、二維碼、Emoji、FTP、分詞等）。
hutool-http	基于 HttpUrlConnection 的 Http 客戶端封裝。
hutool-log	自動(dòng)識(shí)別日志實(shí)現(xiàn)的日志門(mén)面。
hutool-script	腳本執(zhí)行封裝，例如 Javascript。
hutool-setting	功能更強(qiáng)大的 Setting 配置文件和 Properties 封裝。
hutool-system	系統(tǒng)參數(shù)調(diào)用封裝（JVM 信息等）。
hutool-json	JSON 實(shí)現(xiàn)。
hutool-captcha	圖片驗(yàn)證碼實(shí)現(xiàn)。
hutool-poi	針對(duì) POI 中 Excel 和 Word 的封裝。
hutool-socket	基于 Java 的 NIO 和 AIO 的 Socket 封裝。
hutool-jwt	JSON Web Token（JWT）封裝實(shí)現(xiàn)。

2.引入框架

首先，在項(xiàng)目的 pom.xml 的 dependencies 中加入以下內(nèi)容：

    cn.hutool
    hutool-all
    5.8.16

3.常見(jiàn)使用場(chǎng)景

3.1 HTTP 請(qǐng)求類

在 Java 中，Apache 的 HttpClient 用的比較多，但是由于此包較為龐大，API 又比較難用，因此并不適用很多場(chǎng)景，而 Hutool 的 Hutool-http 針對(duì) JDK 的 HttpUrlConnection 做一層封裝，簡(jiǎn)化了 HTTPS 請(qǐng)求、文件上傳、Cookie 記憶等操作，使 Http 請(qǐng)求變得無(wú)比簡(jiǎn)單。

具體使用，例如發(fā)送一個(gè) GET 請(qǐng)求：

// GET請(qǐng)求
String content = HttpUtil.get(url);

發(fā)送一個(gè) POST 請(qǐng)求：

// POST 請(qǐng)求
HashMap param = new HashMap<>();
paramMap.put("city", "西安");
String result1 = HttpUtil.post("www.javacn.site", param);

3.2 生成 N 位隨機(jī)驗(yàn)證碼

例如，生成手機(jī)驗(yàn)證碼（4 位或 6 位），使用 Hutool 的這個(gè)功能就再也合適不過(guò)了，具體實(shí)現(xiàn)代碼如下：

// 生成 4 位隨機(jī)驗(yàn)證碼
String verificationCode = RandomUtil.randomStringUpper(4);

3.3 拼音工具

Hutool 封裝了拼音的門(mén)面，用于兼容以下拼音庫(kù):

1. TinyPinyin
2. JPinyin
3. Pinyin4j

和其它門(mén)面模塊類似，采用 SPI 方式識(shí)別所用的庫(kù)。例如你想用 Pinyin4j，只需引入 jar，Hutool 即可自動(dòng)識(shí)別。

以下為 Hutool 支持的拼音庫(kù)的 pom 坐標(biāo)，你可以選擇任意一個(gè)引入項(xiàng)目中，如果引入多個(gè)，Hutool 會(huì)按照以上順序選擇第一個(gè)使用。

TinyPinyin 依賴：

  io.github.biezhi
  TinyPinyin
  2.0.3.RELEASE

JPinyin 依賴：

  com.belerweb
  pinyin4j
  2.5.1

Pinyin4j 依賴：

  com.github.stuxuhai
  jpinyin
  1.1.8

① 獲取全部拼音

// 輸出結(jié)果：ni hao
String pinyin = PinyinUtil.getPinyin("你好", " ");

這里定義的分隔符為空格，你也可以按照需求自定義分隔符，亦或者使用 "" 代表無(wú)分隔符。

② 獲取拼音首字母

// 輸出結(jié)果：h, s, d, y, g
String result = PinyinUtil.getFirstLetter("H是第一個(gè)", ", ");

③ 自定義拼音庫(kù)（拼音引擎）

Pinyin4jEngine engine = new Pinyin4jEngine();
// 輸出結(jié)果：ni hao h
String pinyin = engine.getPinyin("你好h", " ");

3.4 計(jì)時(shí)器

Hutool 通過(guò)封裝 TimeInterval 實(shí)現(xiàn)計(jì)時(shí)器功能，即可以計(jì)算方法或過(guò)程執(zhí)行的時(shí)間。

具體使用如下：

TimeInterval timer = DateUtil.timer();
// todo：執(zhí)行具體業(yè)務(wù)
timer.interval();  // 花費(fèi)毫秒數(shù)
timer.intervalRestart();// 返回花費(fèi)時(shí)間，并重置開(kāi)始時(shí)間
timer.intervalMinute(); // 花費(fèi)分鐘數(shù)

也可以實(shí)現(xiàn)分組計(jì)時(shí)：

final TimeInterval timer = new TimeInterval();
// 分組 1
timer.start("1");
ThreadUtil.sleep(1000);
// 分組 2
timer.start("2");
ThreadUtil.sleep(2000);
// 打印時(shí)間
Console.log("Timer 1 took {} ms", timer.intervalMs("1"));
Console.log("Timer 2 took {} ms", timer.intervalMs("2"));

3.5 數(shù)字工具

NumberUtil 數(shù)字工具針對(duì)數(shù)學(xué)運(yùn)算做工具性封裝。

我最喜歡使用它的保留小時(shí)和數(shù)字格式化，下面一起來(lái)看吧。

① 保留小數(shù)

保留小數(shù)的方法主要有兩種：

• NumberUtil.round 方法主要封裝 BigDecimal 中的方法來(lái)保留小數(shù)，返回 BigDecimal，這個(gè)方法更加靈活，可以選擇四舍五入或者全部舍棄等模式。
• NumberUtil.roundStr 方法主要封裝 String.format 方法,舍棄方式采用四舍五入。

具體實(shí)現(xiàn)如下。

NumberUtil.round 方法使用：

double te1=123456.123456;
double te2=123456.128456;
Console.log(round(te1,4)); // 結(jié)果:123456.1235
Console.log(round(te2,4)); // 結(jié)果:123456.1285

NumberUtil.roundStr 方法使用：

double te1=123456.123456;
double te2=123456.128456;
Console.log(roundStr(te1,2));//結(jié)果:123456.12
Console.log(roundStr(te2,2));//結(jié)果:123456.13

② 時(shí)間格式化

針對(duì) DecimalFormat.format 進(jìn)行簡(jiǎn)單封裝。按照固定格式對(duì) double 或 long 類型的數(shù)字做格式化操作，具體實(shí)現(xiàn)如下：

long c = 299792458; // 光速
String format = NumberUtil.decimalFormat(",###", c); // 299,792,458

格式中主要以 # 和 0 兩種占位符號(hào)來(lái)指定數(shù)字長(zhǎng)度。0 表示如果位數(shù)不足則以 0 填充，# 表示只要有可能就把數(shù)字拉上這個(gè)位置。

• 0 -> 取一位整數(shù)。
• 0.00 -> 取一位整數(shù)和兩位小數(shù)。
• 00.000 -> 取兩位整數(shù)和三位小數(shù)。
• # -> 取所有整數(shù)部分。
• #.##% -> 以百分比方式計(jì)數(shù)，并取兩位小數(shù)。
• #.#####E0 -> 顯示為科學(xué)計(jì)數(shù)法，并取五位小數(shù)。
• ,### -> 每三位以逗號(hào)進(jìn)行分隔，例如：299,792,458。
• 光速大小為每秒,###米 -> 將格式嵌入文本。

③ 校驗(yàn)數(shù)字

• NumberUtil.isNumber：是否為數(shù)字。
• NumberUtil.isInteger：是否為整數(shù)。
• NumberUtil.isDouble：是否為浮點(diǎn)數(shù)。
• NumberUtil.isPrimes：是否為質(zhì)數(shù)。

④ 隨機(jī)數(shù)

• NumberUtil.generateRandomNumber 生成不重復(fù)隨機(jī)數(shù) 根據(jù)給定的最小數(shù)字和最大數(shù)字，以及隨機(jī)數(shù)的個(gè)數(shù)，產(chǎn)生指定的不重復(fù)的數(shù)組。
• NumberUtil.generateBySet 生成不重復(fù)隨機(jī)數(shù) 根據(jù)給定的最小數(shù)字和最大數(shù)字，以及隨機(jī)數(shù)的個(gè)數(shù)，產(chǎn)生指定的不重復(fù)的數(shù)組。

3.6 數(shù)據(jù)脫敏

在數(shù)據(jù)處理或清洗中，可能涉及到很多隱私信息的脫敏工作，因此Hutool針對(duì)常用的信息封裝了一些脫敏方法。

現(xiàn)階段支持的脫敏數(shù)據(jù)類型包括：

1. 用戶 id
2. 中文姓名
3. 身份證號(hào)
4. 座機(jī)號(hào)
5. 手機(jī)號(hào)
6. 地址
7. 電子郵件
8. 密碼
9. 中國(guó)大陸車牌，包含普通車輛、新能源車輛
10. 銀行卡

整體來(lái)說(shuō)，所謂脫敏就是隱藏掉信息中的一部分關(guān)鍵信息，用*代替，自定義隱藏可以使用 StrUtil.hide 方法完成。

我們以身份證號(hào)碼為例：

// 5***************1X
DesensitizedUtil.idCardNum("51343620000320711X", 1, 2);

對(duì)于約定俗成的脫敏，我們可以不用指定隱藏位數(shù)，比如手機(jī)號(hào)：

// 180****1999
DesensitizedUtil.mobilePhone("18049531999");

當(dāng)然還有一些簡(jiǎn)單粗暴的脫敏，比如密碼，只保留了位數(shù)信息：

// **********
DesensitizedUtil.password("1234567890");

3.7 郵件發(fā)送工具

在 Java 中發(fā)送郵件主要依靠 javax.mail 包，但是由于使用比較繁瑣，因此 Hutool 針對(duì)其做了封裝  MailUtil，它的使用主要需要兩步：

1. 添加 Java Mail 依賴（因?yàn)?MailUtil 是對(duì)它的封裝）。
2. 編寫(xiě)郵件發(fā)送代碼。

① 添加依賴

    com.sun.mail
    javax.mail
    1.6.2

② 編寫(xiě)發(fā)送代碼

// 發(fā)送普通文本郵件，最后一個(gè)參數(shù)可選是否添加多個(gè)附件
MailUtil.send("hutool@foxmail.com", "測(cè)試", "郵件來(lái)自磊哥測(cè)試", false);

// 發(fā)送 HTML 格式的郵件并附帶附件，最后一個(gè)參數(shù)可選是否添加多個(gè)附件：
MailUtil.send("hutool@foxmail.com", "測(cè)試", "
郵件來(lái)自磊哥測(cè)試
", true, FileUtil.file("d:/aaa.xml"));

// 群發(fā)郵件，可選 HTML 或普通文本，可選多個(gè)附件：
ArrayList tos = CollUtil.newArrayList( 
    "person1@bbb.com", 
    "person2@bbb.com", 
    "person3@bbb.com", 
    "person4@bbb.com"); 
MailUtil.send(tos, "測(cè)試", "郵件來(lái)自磊哥群發(fā)測(cè)試", false);

3.8 布隆過(guò)濾器

布隆過(guò)濾器（英語(yǔ)：Bloom Filter）是 1970 年由布隆提出的。它實(shí)際上是一個(gè)很長(zhǎng)的二進(jìn)制向量和一系列隨機(jī)映射函數(shù)。布隆過(guò)濾器可以用于檢索一個(gè)元素是否在一個(gè)集合中。它的優(yōu)點(diǎn)是空間效率和查詢時(shí)間都遠(yuǎn)遠(yuǎn)超過(guò)一般的算法，缺點(diǎn)是有一定的誤識(shí)別率和刪除困難。

布隆過(guò)濾器的原理是，當(dāng)一個(gè)元素被加入集合時(shí)，通過(guò) K 個(gè)散列函數(shù)將這個(gè)元素映射成一個(gè)位數(shù)組中的 K 個(gè)點(diǎn)，把它們置為 1。檢索時(shí)，我們只要看看這些點(diǎn)是不是都是 1 就（大約）知道集合中有沒(méi)有它了：如果這些點(diǎn)有任何一個(gè) 0，則被檢元素一定不在；如果都是 1，則被檢元素很可能在。這就是布隆過(guò)濾器的基本思想。參考：https://www.cnblogs.com/z941030/p/9218356.html

布隆過(guò)濾器的具體使用如下：

// 初始化
BitMapBloomFilter filter = new BitMapBloomFilter(10);
filter.add("123");
filter.add("abc");
filter.add("ddd");

// 查找
filter.contains("abc")

小結(jié)

不是代碼寫(xiě)不起，而是 Hutool 更有性價(jià)比。正如官方描述的那樣，使用 Hutool 會(huì)有種甜甜的感覺(jué)，磨刀不誤砍柴工，Hutool 用上之后代碼嘎嘎香，快去試試吧~

本文題目：效率工具：Hutool嘎嘎香，開(kāi)炫了！
URL鏈接：http://www.5511xx.com/article/coggooc.html