上次我们分享了谷歌高大上的工具包Guava，这次我们来分享一款更接地气的国产工具包Hutool。

Hutool是国内程序员在工作中总结和积累而成的一套小而全的工具类库，相比于Guava，它更符合国内开发者的需求。

Hutool首次发布于2014年，最新版本为5.6.5，到目前为止已经在github上收获了1.9万个赞。

我们还是先来看一下学习Hutool的思维导图。

下面列举一些常用的api，仅供参考。

1. 基础工具1.1 日期时间处理

日期操作的亮点是可以通过ChineseDate类将公历日期转换为农历日期。此外，使用DateUtil可以很方便的操作Date类型数据，LocalDateTimeUtil则用于操作LocalDateTime类型数据。

// 获取年份int year = DateUtil.year(new Date());// 获取今天日期 yyyy-MM-dd格式String today = DateUtil.today();// 获取生肖String chineseZodiac = DateUtil.getChineseZodiac(1990);// 将毫秒转成方便阅读的时间，如3小时25分23秒232毫秒String readableTime = DateUtil.formatBetween(12323232);// 转为农历日期ChineseDate chineseDate = new ChineseDate(new Date());// 农历年份，如2021final int chineseYear = chineseDate.getChineseYear();// 农历月份，如腊月final String chineseMonthName = chineseDate.getChineseMonthName();// 农历日期，如初三final String chineseDay = chineseDate.getChineseDay();// 方便地将Date转换为LocalDateTimefinal LocalDateTime localDateTime = LocalDateTimeUtil.of(new Date());// 获取一天开始时间LocalDateTimeUtil.beginOfDay(localDateTime);// 获取一天结束时间LocalDateTimeUtil.endOfDay(localDateTime);

1.2 I/O

IoUtils可以方便地复制文件，其他相关api建议使用jdk的Files工具类。

// 从文件中获取缓冲流BufferedInputStream in = FileUtil.getInputStream("d:/test.txt");BufferedOutputStream out = FileUtil.getOutputStream("d:/test2.txt");// 拷贝文件IoUtil.copy(in, out);

1.3 字符串处理

一些简单易用的字符串处理api，以及正则表达式的api。

// 判断字符串是否为null或空串boolean isEmpty = StrUtil.isEmpty(str);// 判断字符串是否为null或空串或空白字符boolean isBlank = StrUtil.isBlank(str);// 将字符串用指定字符填充到指定长度String filled = StrUtil.fillAfter(str, '*', 10);// 填充字符串模板String format = StrUtil.format("a的值为{a}, b的值为{b}", Map.of("a", "aValue", "b", "bValue"));// 判断字符串是否为中文字符串boolean match = ReUtil.isMatch(ReUtil.RE_CHINESES, "中国人");

1.4 集合框架

可以用于创建集合和集合的交、并、差集操作。

// 新建一个HashSetSet<Integer> hashSet = CollUtil.newHashSet(1, 2, 3);Set<Integer> linkedHashSet = CollUtil.newLinkedHashSet(4, 2, 3);// 两个集合取交集Collection<Integer> intersection = CollUtil.intersection(hashSet, linkedHashSet);// 两个集合取并集Collection<Integer> union = CollUtil.union(hashSet, linkedHashSet);// 两个集合取差集Collection<Integer> disjunction = CollUtil.disjunction(hashSet, linkedHashSet);// 判断一个集合是否为null或空集boolean empty = CollUtil.isEmpty(hashSet);// 创建一个ArrayListList<Integer> arrayList = ListUtil.toList(1, 2, 3);// 创建一个LinkedListList<Integer> linkedList = ListUtil.toLinkedList(1, 2, 3);// 创建一个mapMap<String, Object> map = MapUtil.<String, Object>builder().put("a", 1).put("b", 2).build();

1.5 常见业务

身份证、社会信用代码、拼音操作、生成二维码、生成唯一ID等一些常见业务场景api。

// 根据身份证号获取出生日期String birth = IdcardUtil.getBirthByIdCard(idCard);// 根据身份证号获取省份String province = IdcardUtil.getProvinceByIdCard(idCard);// 判断身份证号是否合法boolean valid = IdcardUtil.isValidCard18(idCard);// 获取一个随机的社会信用代码String creditCode = CreditCodeUtil.randomCreditCode();// 判断社会信用代码是否合法boolean isCreditCode = CreditCodeUtil.isCreditCode(creditCode);// 将汉字转为拼音，需要引入TinyPinyin、JPinyin或Pinyin4j的jar包String china = PinyinUtil.getPinyin("中国");// 将字符串生成为二维码，需要引入com.google.zxing.core的jar包BufferedImage qrCodeImage = QrCodeUtil.generate(";, QrConfig.create());ImageIO.write(qrCodeImage, "png", new File("a.png"));// 生成uuidString uuid = IdUtil.fastSimpleUUID();// 创建基于Twitter SnowFlake算法的唯一ID，适用于分布式系统final Snowflake snowflake = IdUtil.createSnowflake(1, 1);final long id = snowflake.nextId();

2. 定时任务

通过简单的api，实现全局统一的定时任务调度

// 添加新的定时任务final String scheduleId = CronUtil.schedule("*/2 * * * * *", (Task) () -> System.out.println("执行定时任务"));// 设置是否支持秒级别定时任务CronUtil.setMatchSecond(true);// 开启定时任务CronUtil.start();

3. 验证码

可以方便地生成图形验证码。

// 生成线段干扰的验证码LineCaptcha lineCaptcha = CaptchaUtil.createLineCaptcha(200, 100, 5, 3);lineCaptcha.write("/your/path/b.png");// 生成圆圈干扰的验证码CircleCaptcha captcha = CaptchaUtil.createCircleCaptcha(200, 100, 4, 20);captcha.write("/your/path/c.png");// 生成扭曲干扰的验证码ShearCaptcha shearCaptcha = CaptchaUtil.createShearCaptcha(200, 100, 4, 4);shearCaptcha.write("/your/path/d.png");

4. 缓存

可以方便地使用基于内存的缓存，并设置过期时间的策略。

// 创建先进先出的缓存，并设置过期时间FIFOCache<String, Object> cache = CacheUtil.newFIFOCache(1000, 3600 * 1000);// 向缓存中添加元素cache.put("a", 1);// 从缓存中读取元素cache.get("a");

5. Excel操作

// 将文件转换为ExcelReaderExcelReader reader = ExcelUtil.getReader("d:/aaa.xlsx");// 读取所有行和列的数据List<List<Object>> data = reader.read();// 读取为Map列表，默认excel第一行为标题行，Map中的key为标题，value为标题对应的单元格值。List<Map<String,Object>> dataMap = reader.readAll();//创建writerExcelWriter writer = ExcelUtil.getWriter("d:/bbb.xlsx");// 数据量特别大时，使用BigExcelWriter对象，可以避免内存溢出ExcelWriter bigWriter = ExcelUtil.getBigWriter("d:/bbb.xlsx");// 构造数据List<String> row1 = CollUtil.newArrayList("aa", "bb", "cc", "dd");List<String> row2 = CollUtil.newArrayList("aa1", "bb1", "cc1", "dd1");List<String> row3 = CollUtil.newArrayList("aa2", "bb2", "cc2", "dd2");List<String> row4 = CollUtil.newArrayList("aa3", "bb3", "cc3", "dd3");List<String> row5 = CollUtil.newArrayList("aa4", "bb4", "cc4", "dd4");List<List<String>> rows = CollUtil.newArrayList(row1, row2, row3, row4, row5);// 一次性将数据写入excel中writer.write(rows, true);

6. Http请求

Map<String, Object> params = MapUtil.<String, Object>builder().put("a", 1).build();// 发送get请求String getResult = HttpUtil.get(";, params);// 发送post请求String postResult = HttpUtil.post(";, params);// 以application/json方式发送post请求String jsonPostResult = HttpUtil.post(";, JSON.toJSONString(params));// 下载文件，提供生命周期钩子HttpUtil.downloadFile(fileUrl, FileUtil.file("e:/"), new StreamProgress() {    @Override    public void start() {        System.out.println("开始下载");    }    @Override    public void progress(long progressSize) {        System.out.println("下载中，已下载" + FileUtil.readableFileSize(progressSize));    }    @Override    public void finish() {        System.out.println("下载完成");    }});

7. 加密7.1 加密和解密

// md5摘要加密String md5 = SecureUtil.md5("abc");// sha1摘要加密String sha1 = SecureUtil.sha1("abc");// 生成非对称密钥对KeyPair keyPair = SecureUtil.generateKeyPair("RSA");String publicKey = Base64Encoder.encode(keyPair.getPublic().getEncoded());String privateKey = Base64Encoder.encode(keyPair.getPrivate().getEncoded());// 利用公钥加密String encryptBase64 = SecureUtil.rsa(privateKey, publicKey).encryptBase64("abc", KeyType.PublicKey);// 利用私钥解密String decrypt = new String(SecureUtil.rsa(privateKey, publicKey).decrypt(encryptBase64, KeyType.PrivateKey));

7.2 签名和验签

// 创建签名对象Sign sign = SecureUtil.sign(SignAlgorithm.MD5withRSA);// 生成签名final byte[] bytes = "abc".getBytes();byte[] signed = sign.sign(bytes);// 验证签名boolean verify = sign.verify(bytes, signed);System.out.println(verify);

8. 其他说明8.1 引入Hutool

在项目中可以通过maven引入Hutool库，方式如下：

<dependency>    <groupId>cn.hutool</groupId>    <artifactId>hutool-all</artifactId>    <version>5.6.5</version></dependency>

8.2 注意事项Hutool的定位是减少代码搜索成本，避免从网络上复制修改代码导致的潜在问题。所有的类都有自己的使用场景，没有银弹。应该多读使用文档，看这些工具是否符合自己的使用场景。本文仅列举了部分常用api，整个工具包的内容非常广泛。如有需要，可到官网进一步深入学习。

整理不易，觉得本文有用的话，请点赞支持一下~