Hutool Java工具类库使用

我就是我 2023-01-09 15:45 319阅读 0赞

# 1 简介 #

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

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

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

# 2 包含组件 #

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

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

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

# 3 导入Maven依赖  #

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

# 4 核心（Hutool-core） #

## 4.1 工具类 ##

此包中的工具类为未经过分类的一些工具类，提供一些常用的工具方法。

此包中根据用途归类为XXXUtil，提供大量的工具方法。在工具类中，主要以类方法（static方法）为主，且各个类无法实例化为对象，一个方法是一个独立功能，无相互影响。

### 4.1.1 字符串工具-StrUtil ###

这个工具的用处类似于Apache Commons Lang中的`StringUtil`，之所以使用`StrUtil`而不是使用`StringUtil`是因为前者更短，而且`Str`这个简写我想已经深入人心了，大家都知道是字符串的意思。

### 4.1.2 数字工具-NumberUtil ###

数字工具针对数学运算做工具性封装。

[Hutool 数字工具-NumberUtil使用（加减乘除，保留小数，格式化数字，是否为数字，随机数，整数列表，阶乘，平方根，最大公约数和最小公倍数，进制转换，比较大小，去除多余的0）][Hutool _-NumberUtil_0]

## 4.2 类型转换 ##

### 4.2.1 类型转换工具类-Convert ###

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

## 4.3 日期时间 ##

日期时间包是Hutool的核心包之一，提供针对JDK中Date和Calendar对象的封装。

### 4.3.1 日期时间工具-DateUtil ###

考虑到Java本身对日期时间的支持有限，并且Date和Calendar对象的并存导致各种方法使用混乱和复杂，故使用此工具类做了封装。这其中的封装主要是日期和字符串之间的转换，以及提供对日期的定位（一个月前等等）。，Long、Date相互转化、星期几、日期时间偏移

对于Date对象，为了便捷，使用了一个DateTime类来代替之，继承自Date对象，主要的便利在于，覆盖了toString()方法，返回yyyy-MM-dd HH:mm:ss形式的字符串，方便在输出时的调用（例如日志记录等），提供了众多便捷的方法对日期对象操作。

[Hutool 日期时间工具-DateUtil使用（格式化输出，字符串转日期，日期时间差，Long、Date相互转换，星期几，日期时间偏移）][Hutool _-DateUtil_Long_Date]

## 4.4 IO流相关 ##

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

### 4.4.1 Io工具类-IoUtil ###

流操作工具类。

### 4.4.2 文件工具类-**FileUtil** ###

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

### 4.4.3 文件类型判断-**FileTypeUtil** ###

文件类型判断工具类。

## 4.5 JavaBean ##

针对JavaBean已经有BeanUtil的工具封装。

Dyna既Dynamic，顾名思义，通过Java反射机制操作JavaBean，以达到动态语言的某些特性。

bean包的另一个改进是针对PropertyDescriptor提供缓存。BeanInfoCache类缓存了通过内省获取到的PropertyDescriptor，以提高反射性能。

### 4.5.1 Bean工具-BeanUtil ###

把一个拥有对属性进行set和get方法的类，我们就可以称之为JavaBean。实际上JavaBean就是一个Java类，在这个Java类中就默认形成了一种规则——对属性进行设置和获得。而反之将说Java类就是一个JavaBean，这种说法是错误的，因为一个java类中不一定有对属性的设置和获得的方法（也就是不一定有set和get方法）。

通常Java中对Bean的定义是包含setXXX和getXXX方法的对象，在Hutool中，采取一种简单的判定Bean的方法：是否存在只有一个参数的setXXX方法。

Bean工具类主要是针对这些setXXX和getXXX方法进行操作，比如将Bean对象转为Map等等。

# 5 扩展（Hutool-extra） #

由于Hutool的原则是不依赖于其它配置文件，但是很多时候我们需要针对第三方非常棒的库做一些工具类化的支持，因此Hutoo-extra包主要用于支持第三方库的工具类支持。

## 5.1 拼音工具-PinyinUtil类 ##

拼音工具类。

[Hutool PinyinUtil(拼音工具类)使用详解][Hutool PinyinUtil]

# 6 http客户端(Hutool-http) #

Hutool-http针对JDK的HttpUrlConnection做一层封装，简化了HTTPS请求、文件上传、Cookie记忆等操作，使Http请求变得无比简单。

Hutool-http的核心集中在两个类：

*  HttpRequest
 *  HttpResponse

同时针对大部分情境，封装了HttpUtil工具类。

**Hutool-http优点**

1.  根据URL自动判断是请求HTTP还是HTTPS，不需要单独写多余的代码。
2.  表单数据中有File对象时自动转为`multipart/form-data`表单，不必单做做操作。
3.  默认情况下Cookie自动记录，比如可以实现模拟登录，即第一次访问登录URL后后续请求就是登录状态。
4.  自动识别304跳转并二次请求
5.  自动识别页面编码，即根据header信息或者页面中的相关标签信息自动识别编码，最大可能避免乱码。
6.  自动识别并解压Gzip格式返回内容

## 6.1 Http客户端工具类-HttpUtil ##

HttpUtil是应对简单场景下Http请求的工具类封装，这个工具类可以保证在一个方法之内完成Http请求。

[Hutool Http客户端工具类-HttpUtil使用][Hutool Http_-HttpUtil]

[Hutool _-NumberUtil_0]: https://blog.csdn.net/qq_38974638/article/details/117552537
[Hutool _-DateUtil_Long_Date]: https://blog.csdn.net/qq_38974638/article/details/115941890
[Hutool PinyinUtil]: https://blog.csdn.net/qq_38974638/article/details/113565296
[Hutool Http_-HttpUtil]: https://mp.csdn.net/console/editor/html/113852082