日常开发效率神器【Hutool工具类】的使用

悠悠 2022-11-03 10:52 1177阅读 0赞

# 0.前言 #

Hutool是一个Java工具包，也只是一个工具包，它帮助我们简化每一行代码，减少每一个方法。Hutool基本上覆盖了日常开发中涉及的所有工具方法。包括字符串操作、日期操作、Excel、HTTP客户端、JSON解析等等。强烈推荐大家使用。[官方文档][Link 1]。接下来通过项目源码中的**测试用例**来学习和入门Hutool，看完测试用例你就会惊叹：牛掰！Gitee和GitHub上都有这个项目，这里使用[Gitee][]，clone会快一点。GitHub clone慢的问题也可以通过Gitee导入GitHub项目的方式解决  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2FzY18xMjM0NTY_size_16_color_FFFFFF_t_70_pic_center]

# 1. 项目结构 #

<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中有完备的注释，在实际使用中我们只需要大概知道你需要使用的工具类的名字，然后通过看源码的注释就可以直接使用了，例如：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2FzY18xMjM0NTY_size_16_color_FFFFFF_t_70]  
当然也可以直接看API文档：https://apidoc.gitee.com/loolly/hutool/

# 2.常用工具类介绍 #

Console.log();方法是Hutool提供在控制台打印的方法，类似System.out.printf。以下实例中将使用这个方法。

## 2.1 字符串工具类:StrUtil ##

[API文档][API] 此工具类包含有28个工具方法，在实际开发中使用的频率很大。同时还继承CharSequenceUtil  
**字符分割可忽略空格**：

@Test
    public void splitTest() { 
    	String str = "a,b ,c,d,,e";
    	List<String> split = StrUtil.split(str, ',', -1, true, true);
        Console.log(split);
    }
    
    Console:
    [a, b, c, d, e]

字符串处理不可见字符:

@Test
    public void trimTest() { 
    	String blank = " 哈哈 　";
    	String trim = StrUtil.trim(blank);
    	Console.log(trim);
    }
    
    Console:
    哈哈

按指定长度分割字符串

@Test
    public void cutTest() { 
    	String str = "aaabbbcccdddaadfdfsdfsdf0";
    	String[] cut = StrUtil.cut(str, 4);
    	Console.log(cut);
    }
    Console:
    [aaab, bbcc, cddd, aadf, dfsd, fsdf, 0]

<table> 
 <thead> 
  <tr> 
   <th>返回类型</th> 
   <th>方法名</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>static StringBuilder</td> 
   <td>builder() <br> 创建StringBuilder对象</td> 
  </tr> 
  <tr> 
   <td>static StringBuilder</td> 
   <td>builder() <br> 创建StringBuilder对象</td> 
  </tr> 
  <tr> 
   <td>static StringBuilder</td> 
   <td>builder(int capacity) <br> 创建StringBuilder对象</td> 
  </tr> 
  <tr> 
   <td>static String</td> 
   <td>fill(String str, char filledChar, int len, boolean isPre) <br>将已有字符串填充为规定长度，如果已有字符串超过这个长度则返回这个字符串</td> 
  </tr> 
  <tr> 
   <td>static String</td> 
   <td>fillBefore(String str, char filledChar, int len) <br> 将已有字符串填充为规定长度，如果已有字符串超过这个长度则返回这个字符串 字符填充于字符串前</td> 
  </tr> 
  <tr> 
   <td>static String</td> 
   <td>format(CharSequence template, Map&lt;?,?&gt; map) <br>格式化文本，使用 {varName} 占位 map = {a: “aValue”, b: “bValue”} format("{a} and {b}", map) —=》 aValue and bValue</td> 
  </tr> 
  <tr> 
   <td>static String</td> 
   <td>format(CharSequence template, Map&lt;?,?&gt; map, boolean ignoreNull) <br> 格式化文本，使用 {varName} 占位 map = {a: “aValue”, b: “bValue”} format("{a} and {b}", map) —=》 aValue and bValue</td> 
  </tr> 
  <tr> 
   <td>static StringReader</td> 
   <td>getReader(CharSequence str) <br> 获得StringReader</td> 
  </tr> 
  <tr> 
   <td>static StringWriter</td> 
   <td>getWriter() <br> 获得StringWriter</td> 
  </tr> 
  <tr> 
   <td>static boolean</td> 
   <td>isBlankIfStr(Object obj) <br> 对象是字符串是否为空白</td> 
  </tr> 
  <tr> 
   <td>static boolean</td> 
   <td>isEmptyIfStr(Object obj) <br> 如果对象是字符串是否为空串.</td> 
  </tr> 
  <tr> 
   <td>static String</td> 
   <td>reverse(String str)<br>反转字符串 例如：abcd =》dcba</td> 
  </tr> 
  <tr> 
   <td>static double</td> 
   <td>similar(String str1, String str2) <br> 计算两个字符串的相似度</td> 
  </tr> 
  <tr> 
   <td>static String</td> 
   <td>similar(String str1, String str2, int scale)<br>计算两个字符串的相似度百分比</td> 
  </tr> 
  <tr> 
   <td>static String</td> 
   <td>str(byte[] data, Charset charset)<br>解码字节码</td> 
  </tr> 
  <tr> 
   <td>static String</td> 
   <td>str(Byte[] data, Charset charset) <br> 解码字节码</td> 
  </tr> 
  <tr> 
   <td>static String</td> 
   <td>str(byte[] bytes, String charset) <br> 将byte数组转为字符串</td> 
  </tr> 
  <tr> 
   <td>static String</td> 
   <td>str(Byte[] bytes, String charset) <br> 将Byte数组转为字符串</td> 
  </tr> 
  <tr> 
   <td>static String</td> 
   <td>str(ByteBuffer data, Charset charset) <br> 将编码的byteBuffer数据转换为字符串</td> 
  </tr> 
  <tr> 
   <td>static String</td> 
   <td>str(ByteBuffer data, String charset) <br>将编码的byteBuffer数据转换为字符串</td> 
  </tr> 
  <tr> 
   <td>static String</td> 
   <td>str(Object obj, Charset charset) <br> 将对象转为字符串</td> 
  </tr> 
  <tr> 
   <td>static String</td> 
   <td>uuid()<br>生成随机UUID</td> 
  </tr> 
 </tbody> 
</table>

## 2.2 数字工具类NumberUtil ##

[API文档][API] 以下选取常用的方法列出，详尽的API可查看文档或源码

<table> 
 <thead> 
  <tr> 
   <th>返回类型</th> 
   <th>方法名</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>static double</td> 
   <td>add(double v1, double v2)<br>提供精确的加法运算</td> 
  </tr> 
  <tr> 
   <td>static int</td> 
   <td>compare(byte x, byte y)<br>比较两个值的大小</td> 
  </tr> 
  <tr> 
   <td>static int</td> 
   <td>divisor(int m, int n)<br>最大公约数</td> 
  </tr> 
  <tr> 
   <td>static boolean</td> 
   <td>equals(BigDecimal bigNum1, BigDecimal bigNum2)<br>比较大小，值相等 返回true 此方法通过调用BigDecimal.compareTo(BigDecimal)方法来判断是否相等 此方法判断值相等时忽略精度的，即0.00 == 0</td> 
  </tr> 
  <tr> 
   <td>static boolean</td> 
   <td>equals(double num1, double num2)<br>比较大小，值相等 返回true 此方法通过调用Double.doubleToLongBits(double)方法来判断是否相等 此方法判断值相等时忽略精度的，即0.00 == 0</td> 
  </tr> 
  <tr> 
   <td>static boolean</td> 
   <td>equals(float num1, float num2)<br>比较大小，值相等 返回true 此方法通过调用Float.floatToIntBits(float)方法来判断是否相等 此方法判断值相等时忽略精度的，即0.00 == 0</td> 
  </tr> 
  <tr> 
   <td>static boolean</td> 
   <td>isInteger(String s)<br>判断String是否是整数 支持10进制</td> 
  </tr> 
  <tr> 
   <td>static boolean</td> 
   <td>isNumber(CharSequence str)<br>是否为数字，支持包括：</td> 
  </tr> 
  <tr> 
   <td>static BigDecimal</td> 
   <td>max(BigDecimal… numberArray)<br>取最大值</td> 
  </tr> 
  <tr> 
   <td>static double</td> 
   <td>max(double… numberArray)<br>取最大值</td> 
  </tr> 
  <tr> 
   <td>static int</td> 
   <td>parseInt(String number)<br>解析转换数字字符串为int型数字，规则如下：</td> 
  </tr> 
  <tr> 
   <td>static long</td> 
   <td>parseLong(String number)<br>解析转换数字字符串为long型数字，规则如下：</td> 
  </tr> 
  <tr> 
   <td>static Number</td> 
   <td>parseNumber(String numberStr)<br>将指定字符串转换为Number 对象</td> 
  </tr> 
  <tr> 
   <td>static int</td> 
   <td>partValue(int total, int partCount)<br>把给定的总数平均分成N份，返回每份的个数 当除以分数有余数时每份+1</td> 
  </tr> 
  <tr> 
   <td>static int[]</td> 
   <td>range(int stop)<br>从0开始给定范围内的整数列表，步进为1</td> 
  </tr> 
  <tr> 
   <td>static BigDecimal</td> 
   <td>round(BigDecimal number, int scale)<br>保留固定位数小数 采用四舍五入策略 RoundingMode.HALF_UP例如保留2位小数：123.456789 =》 123.46</td> 
  </tr> 
 </tbody> 
</table>

## 2.3 BeanUtil ##

[API文档][API] 把一个拥有对属性进行set和get方法的类，我们就可以称之为JavaBean。日常开发中我们也时常遇到Bean之间转换的需求，map，list之间的转换。使用此工具类也会特别方便。

<table> 
 <thead> 
  <tr> 
   <th>返回类型</th> 
   <th>方法名</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>static Map&lt;String,Object&gt;</td> 
   <td>beanToMap(Object bean)<br>对象转Map，不进行驼峰转下划线，不忽略值为空的字段</td> 
  </tr> 
  <tr> 
   <td>static Map&lt;String,Object]]&gt;</td> 
   <td>beanToMap(Object bean, boolean isToUnderlineCase, boolean ignoreNullValue)<br>对象转Map</td> 
  </tr> 
  <tr> 
   <td>static void</td> 
   <td>copyProperties(Object source, Object target, boolean ignoreCase)<br>复制Bean对象属性</td> 
  </tr> 
  <tr> 
   <td>static void</td> 
   <td>descForEach(Class&lt;?&gt; clazz, Consumer&lt;? super PropDesc&gt; action)<br>遍历Bean的属性</td> 
  </tr> 
  <tr> 
   <td>static T</td> 
   <td>fillBeanWithMap(Map&lt;?,?&gt; map, T bean, boolean isIgnoreError)<br>使用Map填充Bean对象</td> 
  </tr> 
  <tr> 
   <td>static T</td> 
   <td>toBean(Class beanClass, ValueProvider valueProvider, CopyOptions copyOptions)<br>ServletRequest 参数转Bean</td> 
  </tr> 
  <tr> 
   <td>static T</td> 
   <td>toBean(Object source, Class clazz)<br>对象或Map转Bean</td> 
  </tr> 
  <tr> 
   <td>static T</td> 
   <td>toBean(Object source, Class clazz, CopyOptions options)<br>对象或Map转Bean</td> 
  </tr> 
  <tr> 
   <td>static T</td> 
   <td>toBeanIgnoreCase(Object source, Class clazz, boolean ignoreError)<br>对象或Map转Bean，忽略字段转换时发生的异常</td> 
  </tr> 
  <tr> 
   <td>static T</td> 
   <td>toBeanIgnoreError(Object source, Class clazz)<br>对象或Map转Bean，忽略字段转换时发生的异常</td> 
  </tr> 
  <tr> 
   <td>static T</td> 
   <td>trimStrFields(T bean, String… ignoreFields)<br>把Bean里面的String属性做trim操作。此方法直接对传入的Bean做修改。</td> 
  </tr> 
 </tbody> 
</table>

## 2.4 ObjectUtil 对象工具类 ##

[API文档][API] 对象工具类，包括判空、克隆、序列化等操作。比如一个集合的size为0，我们需要判断它的size才能知道它是不是为空。isEmpty方法就解决了这个问题。

<table> 
 <thead> 
  <tr> 
   <th>返回类型</th> 
   <th>方法名</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>static T</td> 
   <td>clone(T obj)<br>克隆对象 如果对象实现Cloneable接口，调用其clone方法 如果实现Serializable接口，执行深度克隆 否则返回null</td> 
  </tr> 
  <tr> 
   <td>static boolean</td> 
   <td>contains(Object obj, Object element)<br>对象中是否包含元素 支持的对象类型包括： String Collection Map Iterator Enumeration Array</td> 
  </tr> 
  <tr> 
   <td>static &lt;T extends CharSequence]]&gt; T</td> 
   <td>defaultIfBlank(T str, T defaultValue)<br>如果给定对象为null或者""或者空白符返回默认值</td> 
  </tr> 
  <tr> 
   <td>static T</td> 
   <td>defaultIfEmpty(String str, Supplier&lt;? extends T&gt; handle, T defaultValue)<br>如果给定对象为null或者""返回默认值, 否则返回自定义handle处理后的返回值</td> 
  </tr> 
  <tr> 
   <td>static boolean</td> 
   <td>equal(Object obj1, Object obj2)<br>比较两个对象是否相等。 相同的条件有两个，满足其一即可： obj1 == null &amp;&amp; obj2 == null obj1.equals(obj2) 如果是BigDecimal比较，0 == obj1.compareTo(obj2)</td> 
  </tr> 
  <tr> 
   <td>static boolean</td> 
   <td>hasEmpty(Object… objs)<br>是否存在null或空对象，通过isEmpty(Object) 判断元素</td> 
  </tr> 
  <tr> 
   <td>static boolean</td> 
   <td>hasNull(Object… objs)<br>是否存在null对象，通过isNull(Object) 判断元素</td> 
  </tr> 
  <tr> 
   <td>static boolean</td> 
   <td>isAllEmpty(Object… objs)<br>是否全都为null或空对象，通过isEmpty(Object) 判断元素</td> 
  </tr> 
  <tr> 
   <td>static boolean</td> 
   <td>isEmpty(Object obj)<br>判断指定对象是否为空，如果为集合，size为0也会认为为空</td> 
  </tr> 
  <tr> 
   <td>static String</td> 
   <td>toString(Object obj)<br>将Object转为String 策略为：</td> 
  </tr> 
 </tbody> 
</table>

## 2.5 时间工具类DateUtil ##

[API文档][API] 日期格式化，日期之间相隔多少天，一天的开始时间结束时间等等

<table> 
 <thead> 
  <tr> 
   <th>返回类型</th> 
   <th>方法名</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>static int</td> 
   <td>ageOfNow(String birthDay) <br> 生日转为年龄，计算法定年龄</td> 
  </tr> 
  <tr> 
   <td>static DateTime</td> 
   <td>beginOfDay(Date date) <br> 获取某天的开始时间</td> 
  </tr> 
  <tr> 
   <td>static DateTime</td> 
   <td>beginOfHour(Date date) <br> 获取某小时的开始时间</td> 
  </tr> 
  <tr> 
   <td>static DateTime</td> 
   <td>beginOfMonth(Date date) <br> 获取某月的开始时间</td> 
  </tr> 
  <tr> 
   <td>static long</td> 
   <td>betweenDay(Date beginDate, Date endDate, boolean isReset) <br> 判断两个日期相差的天数</td> 
  </tr> 
  <tr> 
   <td>static long</td> 
   <td>current() <br> 当前时间的时间戳</td> 
  </tr> 
  <tr> 
   <td>static DateTime</td> 
   <td>endOfHour(Date date) <br> 获取某小时的结束时间</td> 
  </tr> 
  <tr> 
   <td>static String</td> 
   <td>format(Date date, DateFormat format) <br> 根据特定格式格式化日期</td> 
  </tr> 
  <tr> 
   <td>static String</td> 
   <td>formatDateTime(Date date) <br> 格式化日期时间格式 yyyy-MM-dd HH:mm:ss</td> 
  </tr> 
  <tr> 
   <td>static boolean</td> 
   <td>isAM(Date date) <br> 是否为上午</td> 
  </tr> 
  <tr> 
   <td>static boolean</td> 
   <td>isLeapYear(int year) <br> 是否闰年</td> 
  </tr> 
  <tr> 
   <td>static String</td> 
   <td>today() <br> 当前日期，格式 yyyy-MM-dd</td> 
  </tr> 
  <tr> 
   <td>static DateTime</td> 
   <td>tomorrow() <br> 明天</td> 
  </tr> 
  <tr> 
   <td>static int</td> 
   <td>year(Date date) <br> 获得年的部分</td> 
  </tr> 
 </tbody> 
</table>

## 2.6 工具类JSONUtil ##

[API文档][API] 该工具类也是根据阿里的fastjson封装的。

<table> 
 <thead> 
  <tr> 
   <th>返回类型</th> 
   <th>方法名</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>static JSONArray</td> 
   <td>createArray()</td> 
  </tr> 
  <tr> 
   <td>static JSONArray</td> 
   <td>createArray(JSONConfig config)创建 JSONArray</td> 
  </tr> 
  <tr> 
   <td>static boolean</td> 
   <td>isJson(String str)<br>是否为JSON字符串，首尾都为大括号或中括号判定为JSON字符串</td> 
  </tr> 
  <tr> 
   <td>static JSONArray</td> 
   <td>parseArray(Object arrayOrCollection)JSON字符串转JSONArray</td> 
  </tr> 
  <tr> 
   <td>static JSONObject</td> 
   <td>parseObj(Object obj)<br>JSON字符串转JSONObject对象此方法会忽略空值，但是对JSON字符串不影响</td> 
  </tr> 
  <tr> 
   <td>static JSON</td> 
   <td>readJSON(File file, Charset charset)读取JSON</td> 
  </tr> 
  <tr> 
   <td>static T</td> 
   <td>toBean(JSON json, Type beanType, boolean ignoreError)转为实体类对象</td> 
  </tr> 
  <tr> 
   <td>static String</td> 
   <td>toJsonPrettyStr(Object obj)<br>转换为格式化后的JSON字符串</td> 
  </tr> 
 </tbody> 
</table>

## 2.7 工具类JSONObject ##

[API文档][API]

<table> 
 <thead> 
  <tr> 
   <th>返回类型</th> 
   <th>方法名</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>JSONObject</td> 
   <td>accumulate(String key, Object value)<br>积累值。类似于set，当key对应value已经存在时，与value组成新的JSONArray.</td> 
  </tr> 
  <tr> 
   <td>JSONObject</td> 
   <td>append(String key, Object value)<br>追加值，如果key无对应值，就添加一个JSONArray，其元素只有value，如果值已经是一个JSONArray，则添加到值JSONArray中。</td> 
  </tr> 
  <tr> 
   <td>Object</td> 
   <td>getByPath(String expression)<br>通过表达式获取JSON中嵌套的对象.表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值 []表达式，可以获取集合等对象中对应index的值</td> 
  </tr> 
  <tr> 
   <td>JSONObject</td> 
   <td>increment(String key)<br>对值加一，如果值不存在，赋值1，如果为数字类型，做加一操作</td> 
  </tr> 
  <tr> 
   <td>JSONObject</td> 
   <td>putOnce(String key, Object value)<br>一次性Put 键值对，如果key已经存在抛出异常，如果键值中有null值，忽略</td> 
  </tr> 
  <tr> 
   <td>JSONObject</td> 
   <td>putOpt(String key, Object value)<br>在键和值都为非空的情况下put到JSONObject中</td> 
  </tr> 
  <tr> 
   <td>JSONObject</td> 
   <td>set(String key, Object value)<br>设置键值对到JSONObject中，在忽略null模式下，如果值为null，将此键移除</td> 
  </tr> 
  <tr> 
   <td>JSONObject</td> 
   <td>setDateFormat(String format)<br>设置转为字符串时的日期格式，默认为时间戳（null值）此方法设置的日期格式仅对转换为JSON字符串有效，对解析JSON为bean无效。</td> 
  </tr> 
 </tbody> 
</table>

## 2.8 JSONArray ##

[API文档][API]

<table> 
 <thead> 
  <tr> 
   <th>返回类型</th> 
   <th>方法名</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>JSONArray</td> 
   <td>put(int index, Object value)<br>加入或者替换JSONArray中指定Index的值，如果index大于JSONArray的长度，将在指定index设置值，之前的位置填充JSONNull.Null</td> 
  </tr> 
  <tr> 
   <td>JSONArray</td> 
   <td>setDateFormat(String format)<br>设置转为字符串时的日期格式，默认为时间戳（null值）</td> 
  </tr> 
  <tr> 
   <td>JSONObject</td> 
   <td>toJSONObject(JSONArray names)<br>根据给定名列表，与其位置对应的值组成JSONObject</td> 
  </tr> 
  <tr> 
   <td> List</td> 
   <td>toList(Class elementType)<br>转为ArrayList</td> 
  </tr> 
  <tr> 
   <td>String</td> 
   <td>toString()<br>转为JSON字符串，无缩进</td> 
  </tr> 
 </tbody> 
</table>

## 2.9 excel工具类ExcelUtil ##

[API文档][API] excel工具类引入了第三方的POI，对Excel读取文件流后使用ExcelReader工具对excel进行操作

<table> 
 <thead> 
  <tr> 
   <th>返回类型</th> 
   <th>方法名</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>static ExcelReader</td> 
   <td>getReader(File bookFile, int sheetIndex)<br>获取Excel读取器，通过调用ExcelReader的read或readXXX方法读取Excel内容</td> 
  </tr> 
  <tr> 
   <td>static ExcelReader</td> 
   <td>getReader(File bookFile, String sheetName)<br>获取Excel读取器，通过调用ExcelReader的read或readXXX方法读取Excel内容</td> 
  </tr> 
  <tr> 
   <td>static ExcelReader</td> 
   <td>getReader(InputStream bookStream)<br>获取Excel读取器，通过调用ExcelReader的read或readXXX方法读取Excel内容 默认调用第一个sheet，读取结束自动关闭流</td> 
  </tr> 
 </tbody> 
</table>

### ExcelReader ###

查看Hutool源码中的测试用例了解到，可以读取excel内容并转化为一个bean

@Test
    	public void excelReadToBeanListTest2() { 
    		ExcelReader reader = ExcelUtil.getReader("f:/test/toBean.xlsx");
    		reader.addHeaderAlias("姓名", "name");
    		reader.addHeaderAlias("年龄", "age");
    		reader.addHeaderAlias("性别", "gender");
    
    		List<Person> all = reader.read(0, 2, Person.class);
    		for (Person person : all) { 
    			Console.log(person);
    		}
    	}

当excel中数据量特别大的时候也可以使用Sax的方式进行读取。

### ExcelWriter ###

写入一个bean也是可以的

@Test
    	public void writeBeanTest() { 
    		List<cn.hutool.poi.excel.TestBean> rows = CollUtil.newArrayList(bean1, bean2);
    		// 通过工具类创建writer
    		String file = "e:/writeBeanTest.xlsx";
    		FileUtil.del(file);
    		ExcelWriter writer = ExcelUtil.getWriter(file);
    		// 自定义标题
    		writer.addHeaderAlias("name", "姓名");
    		writer.addHeaderAlias("age", "年龄");
    		writer.addHeaderAlias("score", "分数");
    		writer.addHeaderAlias("isPass", "是否通过");
    		writer.addHeaderAlias("examDate", "考试时间");
    		// 合并单元格后的标题行，使用默认标题样式
    		writer.merge(4, "一班成绩单");
    		// 一次性写出内容，使用默认样式
    		writer.write(rows, true);
    		// 关闭writer，释放内存
    		writer.close();
    	}

之前一直使用阿里的easyExcel，发现hutool中excel相关的工具类也有很多包括Cell工具类、Sheet工具类等等，在实际开发中也可以方便的使用。具体的使用也可以直接看测试用例

## 2.10集合工具类CollUtil ##

[API文档][API]

<table> 
 <thead> 
  <tr> 
   <th>返回类型</th> 
   <th>方法名</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>static int</td> 
   <td>count(Iterable iterable, Matcher matcher)<br>集合中匹配规则的数量</td> 
  </tr> 
  <tr> 
   <td>static &lt;K,V&gt; Map&lt;K,V&gt;</td> 
   <td>createMap(Class&lt;?&gt; mapType)<br>创建Map传入AbstractMap和Map类将默认创建HashMap</td> 
  </tr> 
  <tr> 
   <td>static &lt;T extends Collection,E&gt;</td> 
   <td>filter(T collection, Filter filter)<br>去除指定元素，此方法直接修改原集合</td> 
  </tr> 
  <tr> 
   <td>static void</td> 
   <td>forEach(Enumeration enumeration, CollUtil.Consumer consumer)<br>循环遍历 Enumeration，使用CollUtil.Consumer 接受遍历的每条数据，并针对每条数据做处理</td> 
  </tr> 
  <tr> 
   <td>static T</td> 
   <td>getFirst(Iterable iterable)<br>获取集合的第一个元素</td> 
  </tr> 
  <tr> 
   <td>static T</td> 
   <td>getLast(Collection collection)<br>获取集合的最后一个元素</td> 
  </tr> 
  <tr> 
   <td>static boolean</td> 
   <td>hasNull(Iterable&lt;?&gt; iterable)<br>是否包含null元素</td> 
  </tr> 
  <tr> 
   <td>static &lt;K,V&gt; HashMap&lt;K,V&gt;</td> 
   <td>toMap(Iterable&lt;Map.Entry&lt;K,V&gt;&gt; entryIter)<br>将Entry集合转换为HashMap</td> 
  </tr> 
  <tr> 
   <td>static &lt;K,V&gt; List&lt;Map&lt;K,V&gt;&gt;</td> 
   <td>toMapList(Map&lt;K,? extends Iterable&gt; listMap)<br>列转行。将Map中值列表分别按照其位置与key组成新的map。是toListMap(Iterable)的逆方法</td> 
  </tr> 
  <tr> 
   <td>static &lt;K,V&gt; Map&lt;K,V&gt;</td> 
   <td>zip(Collection keys, Collection values)<br>映射键值（参考Python的zip()函数）例如：keys = [a,b,c,d]values = [1,2,3,4]则得到的Map是 {a=1, b=2, c=3, d=4}如果两个数组长度不同，则只对应最短部分</td> 
  </tr> 
 </tbody> 
</table>

## 3. 总结 ##

以上列出的工具只是冰山一角，具体的使用可以看官方文档，感觉业务系统中的工具类方法基本全覆盖了包括：类型转换、日期时间、IO流相关、系统资源、字符串、Hash算法、URL工具、对像工具、类工具、枚举工具、命令行工具、数字工具、随机工具、唯一ID工具、压缩工具、正则工具、身份证工具、集合、map、文本、图片、网络、加密解密、http客户端、图片验证码等等。学习里面的使用最好先看源码中的测试用例。同时看源码的过程中可以学习别人写的代码。

[Link 1]: https://www.hutool.cn/
[Gitee]: https://gitee.com/loolly/hutool/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2FzY18xMjM0NTY_size_16_color_FFFFFF_t_70_pic_center]: /images/20221024/cebcd0cc54704de2a55af0664e810134.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2FzY18xMjM0NTY_size_16_color_FFFFFF_t_70]: /images/20221024/0db23f81d974499bb56ec77994059629.png
[API]: https://apidoc.gitee.com/loolly/hutool/