Hutool 的学习

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"));
    }