Hutool 的学习

2022-12-23,

1、 Hutool 介绍

Hutool 是一个小而全的Java工具类库,通过静态方法封装,降低相关API的学习成本,提高工作效率,使Java拥有函数式语言般的优雅,让Java语言也可以“甜甜的”。

Hutool 中的工具方法来自每个用户的精雕细琢,它涵盖了Java开发底层代码中的方方面面,它既是大型项目开发中解决小问题的利器,也是小型项目中的效率担当;

Hutool 是项目中“util”包友好的替代,它节省了开发人员对项目中公用类和公用工具方法的封装时间,使开发专注于业务,同时可以最大限度的避免封装不完善带来的bug。

2、 Hutool 名称的由来

Hutool = Hu + tool,是原公司项目底层代码剥离后的开源库,“Hu”是公司名称的表示,tool表示工具。Hutool谐音“糊涂”,一方面简洁易懂,一方面寓意“难得糊涂”。

3、 Hutool 如何改变我们的coding方式

Hutool的目标是使用一个工具方法代替一段复杂代码,从而最大限度的避免“复制粘贴”代码的问题,彻底改变我们写代码的方式。

以计算MD5为例:

【以前】打开搜索引擎 -> 搜“Java MD5加密” -> 打开某篇博客-> 复制粘贴 -> 改改好用
【现在】引入Hutool -> SecureUtil.md5()

Hutool的存在就是为了减少代码搜索成本,避免网络上参差不齐的代码出现导致的bug。

4、️ 包含组件

一个Java基础工具类,对文件、流、加密解密、转码、正则、线程、XML等JDK方法进行封装,组成各种Util工具类,同时提供以下组件:

可以根据需求对每个模块单独引入,也可以通过引入hutool-all方式引入所有模块。

5、 文档

中文文档

中文备用文档

参考API

视频介绍

6、 安装

6.1、使用Maven添加依赖

在项目的 pom.xml dependencies 中加入以下内容:

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

6.2、使用Gradle构建工具导入

implementation 'cn.hutool:hutool-all:5.8.5'

6.3 、非Maven项目的需要下载jar

6.3.1、 点击以下链接,下载 hutool-all-X.X.X.jar即可:

Maven中央库

️注意 Hutool 5.x支持JDK8+,对Android平台没有测试,不能保证所有工具类或工具方法可用。 如果你的项目使用JDK7,请使用Hutool 4.x版本(不再更新)

6.3.2、编译安装

访问Hutool的Gitee主页:https://gitee.com/dromara/hutool 下载整个项目源码(v5-master或v5-dev分支都可)然后进入Hutool项目目录执行:

./hutool.sh install

然后就可以使用Maven引入了。

7、 Spring Boot中使用

7.1、 在 pom.xml 文件中添加依赖

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

7.2、 使用工具库,栗子如下:

7.2.1、 计算出当前日期为中国农历的日期

@Test
void ChineseDatesTest() {
ChineseDate chineseDate = new ChineseDate(new Date());
System.out.println(chineseDate.toString());
}

7.2.2、 md5 的加密

@Test
void DigestUtilTest() {
String pwd = DigestUtil.md5Hex("123456");
System.out.println("加密之后的密码为:"+pwd);
}

7.2.3、 读取剪贴板的内容

 @Test
void ClipboardUtilTest() {
System.out.println("当前剪贴板内容为:"+ClipboardUtil.getStr());
}

7.2.4、 身份证号码的验证

   @Test
void CardTest() {
// 身份证号码
String id = "445322200112052521"; // 1、isValidCard:验证身份证号码是否有效合法
boolean valid = IdcardUtil.isValidCard(id);
System.out.println(valid); // 2、getAgeByIdCard:根据身份证获取年龄
DateTime date = DateUtil.parse("2022-8-31");
// 传入身份证号码和当前时间两个参数,获取年龄
int age = IdcardUtil.getAgeByIdCard(id, date);
// 断言年龄是否等于20岁
Assertions.assertEquals(age, 20);
// 输出结果
System.out.println("该人年龄为:"+ age); //3、getBirthByIdCard:获取生日
String birth = IdcardUtil.getBirthByIdCard(id);
System.out.println("该人生日为:"+ birth); // 4、获取省份
String province = IdcardUtil.getProvinceByIdCard(id);
System.out.println("该人来自于:"+ province ); }

7.2.5、 生成验证码

  @Test
void verificationCodeTest() {
// 定义图形验证码的长和宽
LineCaptcha lineCaptcha = CaptchaUtil.createLineCaptcha(200,100);
// 图形验证码写出到指定的文件夹,可以写出到文件,也可以写出到流
lineCaptcha.write("d:/Pictures/Camera Roll/壁纸/插画/LineCaptcha.jpg");
// 输出code
System.out.println(lineCaptcha.getCode());
// 验证图形验证码的有效性,返回boolean值
lineCaptcha.verify("12345");
}   //重新生成验证码
  lineCaptcha.createCode();
  lineCaptcha.write("d:/line.png");
  //新的验证码
  Console.log(lineCaptcha.getCode());
  //验证图形验证码的有效性,返回boolean值
  lineCaptcha.verify("1234");

7.2.6、 生成二维码

1、引入 zxing

<dependency>
<groupId>com.google.zxing</groupId>
<artifactId>core</artifactId>
<version>3.3.3</version>
</dependency>

2、设置宽、高、背景色生成二维码

  @Test
void QrConfigTest() {
// 通过QrConfig可以自定义二维码的生成参数
QrConfig qrConfig = new QrConfig(300,300);
// 设置边距,既二维码和背景之间的边距
qrConfig.setMargin(3);
// 设置前景色,既二维码颜色(黑色)
qrConfig.setForeColor(Color.black);
// 设置背景色(白色)
qrConfig.setBackColor(Color.white); // 生成二维码到指定的文件,也可以到流
QrCodeUtil.generate("https://www.hutool.cn/",qrConfig, FileUtil.file("d:/Pictures/Camera Roll/壁纸/插画/QrConfig.jpg"));
}

Hutool 的学习的相关教程结束。

《Hutool 的学习.doc》

下载本文的Word格式文档,以方便收藏与打印。