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、文档

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

    }