HuTool 使用教程

HuTool

• 官网 Hutool — A set of tools that keep Java sweet.

一、简介

准备环境

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

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

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

1. 名称由来

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

2. Hutool如何改变我们的coding方式

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

以计算MD5为例：

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

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

---

二、包含组件

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

模块	介绍
hutool-aop	JDK动态代理封装，提供非IOC下的切面支持
hutool-bloomFilter	布隆过滤，提供一些Hash算法的布隆过滤
hutool-cache	简单缓存实现
hutool-core	核心，包括Bean操作、日期、各种Util等
hutool-cron	定时任务模块，提供类Crontab表达式的定时任务
hutool-crypto	加密解密模块，提供对称、非对称和摘要算法封装
hutool-db	JDBC封装后的数据操作，基于ActiveRecord思想
hutool-dfa	基于DFA模型的多关键字查找
hutool-extra	扩展模块，对第三方封装（模板引擎、邮件、Servlet、二维码、Emoji、FTP、分词等）
hutool-http	基于HttpUrlConnection的Http客户端封装
hutool-log	自动识别日志实现的日志门面
hutool-script	脚本执行封装，例如Javascript
hutool-setting	功能更强大的Setting配置文件和Properties封装
hutool-system	系统参数调用封装（JVM信息等）
hutool-json	JSON实现
hutool-captcha	图片验证码实现
hutool-poi	针对POI中Excel和Word的封装
hutool-socket	基于Java的NIO和AIO的Socket封装

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

---

三、使用HuTool

HuTool使用非常简单直接在项目中引入如下依赖即可:

<dependency>

<groupId>cn.hutoolgroupId>

<artifactId>hutool-allartifactId>

<version>5.3.7version>

dependency>

四、Convert类型转换

1. 痛点

在Java开发中我们要面对各种各样的类型转换问题，尤其是从命令行获取的用户参数、从HttpRequest获取的Parameter等等，这些参数类型多种多样，我们怎么去转换他们呢？常用的办法是先整成String，然后调用XXX.parseXXX方法，还要承受转换失败的风险，不得不加一层try catch，这个小小的过程混迹在业务代码中会显得非常难看和臃肿。

2. Convert类

Convert 类可以说是一个工具方法类，里面封装了针对Java常见类型的转换，用于简化类型转换。 Convert 类中大部分方法为toXXX，参数为Object，可以实现将任意可能的类型转换为指定类型。同时支持第二个参数 defaultValue 用于在转换失败时返回一个默认值。

3. 如何使用

1. 转换为字符串

int a = 1;

//aStr为"1"

String aStr = Convert.toStr(a);

long[] b = {1,2,3,4,5};

//bStr为："[1, 2, 3, 4, 5]"

String bStr = Convert.toStr(b);

2. 转换为指定类型数组

String[] b = { "1", "2", "3", "4" };

//结果为Integer数组

Integer[] intArray = Convert.toIntArray(b);

long[] c = {1,2,3,4,5};

//结果为Integer数组

Integer[] intArray2 = Convert.toIntArray(c);

3. 转换为日期对象

String str = "2012-12-12";

Date parse = new SimpleDateFormat("yyyy-MM-dd").parse(str);

Date date = Convert.toDate(str);

System.out.println(date);

String str1 = "2012/12/12";

Date date1 = Convert.toDate(str1);

System.out.println(date1);

4.转换为集合

Object[] a = {"a", "你", "好", "", 1};

List list = Convert.convert(List.class, a);

//从4.1.11开始可以这么用

List list = Convert.toList(a);

---

五、IO流操作

1.介绍

IO的操作包括 读 和 写 ，应用场景包括网络操作和文件操作。IO操作在Java中是一个较为复杂的过程，我们在面对不同的场景时，要选择不同的 InputStream 和 OutputStream 实现来完成这些操作。而如果想读写字节流，还需要 Reader 和 Writer 的各种实现类。这些繁杂的实现类，一方面给我我们提供了更多的灵活性，另一方面也增加了复杂性。

2.封装

- IoUtil 流操作工具类

- FileUtil 文件读写和操作的工具类。

- FileTypeUtil 文件类型判断工具类

- WatchMonitor 目录、文件监听，封装了JDK1.7中的WatchService

- ClassPathResource针对ClassPath中资源的访问封装

- FileReader 封装文件读取

- FileWriter 封装文件写入

3.IOUtil

# 1.说明

- 主要是用来操作IO流相关的操作

FileInputStream is = new FileInputStream(new File("/Users/chenyannan/IdeaProjects/180codes/HuTool/src/main/resources/aa.txt"));

FileOutputStream os = new FileOutputStream(new File("/Users/chenyannan/IdeaProjects/180codes/HuTool/src/main/resources/cc.txt"));

IoUtil.copy(is,os);

IoUtil.copy(is,os,2048);//指定缓冲区大小

IoUtil.copy(is,os,IoUtil.DEFAULT_BUFFER_SIZE);//指定缓冲区大小

4.FileUtil

//读取文件

FileUtil.file("/Users/chenyannan/IdeaProjects/180codes/HuTool/src/main/resources/bb.txt");

//追加字符串

FileUtil.appendString("我是小陈",file,"UTF-8");

//文件拷贝

FileUtil.copy(file,new File("/Users/chenyannan/IdeaProjects/180codes/HuTool/src/main/resources/bb.txt"),true);

//删除文件

// 需要注意的是，del方法会删除目录而不判断其是否为空，这一方面方便了使用，另一方面也可能造成一些预想不到的后果（比如拼写错路径而删除不应该删除的目录），所以请谨慎使用此方法。

FileUtil.del(file);

File file2 = new File("/Users/chenyannan/IdeaProjects/180codes/HuTool/src/main/resources/aa.txt");

//创建文件同时如果目录不存在也会一并创建

File touch = FileUtil.touch(file2);

//创建多级目录

File mkdir = FileUtil.mkdir(file2);

六、常用工具类

# 1.字符串工具-StrUtil

String str = "aa.txt";

boolean empty = StrUtil.isEmpty(str); //不判断空格

boolean b = StrUtil.isBlank(str); //判断空格

String s = StrUtil.removePrefix(str, "aa");//去掉前缀

String s1 = StrUtil.removeSuffix(str, ".txt");//去掉后缀

String sub = StrUtil.sub(str, 2, str.length());//截取字符串

byte[] bytes = StrUtil.bytes(str, "UTF-8");//指定字符集转为bytes

String tempalte = "姓名:{},年龄:{}";

String content = StrUtil.format(tempalte, "content", 23);

System.out.println(content);