什么是Hutool
Hutool是一个Java工具包,也就是一个工具箱,一个utils集合,它帮助我们简化每一行代码,减少每一个方法,让Java语言也可以简单粗暴。Hutool最初是作者项目中“util”包的一个整理,后来慢慢积累并加入更多非业务相关功能,并广泛学习其它开源项目精髓,经过自己整理修改,最终形成丰富的开源工具集。
Hutool功能
一个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 扩展模块,对第三方封装(模板引擎、邮件等)
hutool-http 基于HttpUrlConnection的Http客户端封装
hutool-log 自动识别日志实现的日志门面
hutool-script 脚本执行封装,例如Javascript
hutool-setting 功能更强大的Setting配置文件和Properties封装
hutool-system 系统参数调用封装(JVM信息等)
hutool-json JSON实现
hutool-captcha 图片验证码实现
Maven引入
<dependency>
<groupId>cn.hutool</groupId>
<artifactId>hutool-all</artifactId>
<version>4.1.19</version>
</dependency>
实用方法推荐
具体的使用方法可以到hutool.mydoc.io去探索,这里列举几个。
1、Http客户端工具类-HttpUtil
//POST请求栗子:
HashMap<String, Object> paramMap = new HashMap<>();
paramMap.put("city", "北京");
String result= HttpUtil.post("https://www.baidu.com", paramMap);
//文件上传只需将参数中的键指定(默认file),值设为文件对象即可,对于使用者来说,文件上传与普通表单提交并无区别
paramMap.put(“file”, FileUtil.file(“D:\face.jpg”));
String result= HttpUtil.post(“https://www.baidu.com”, paramMap);
- HttpUtil.encode和HttpUtil.decode 两个方法封装了JDK的URLEncoder.encode和URLDecoder.decode方法,可以方便的对URL参数进行URL编码和解码。
- HttpUtil.toParams和HttpUtil.decodeParams 两个方法是将Map参数转为URL参数字符串和将URL参数字符串转为Map对象
- HttpUtil.urlWithForm是将URL字符串和Map参数拼接为GET请求所用的完整字符串使用
2、Bean工具-BeanUtil
基于BeanUtil.fillBean方法Hutool还提供了Map对象键值对注入Bean,其方法有:
- BeanUtil.fillBeanWithMap
- BeanUtil.fillBeanWithMapIgnoreCase
同时提供了map转bean的方法,与fillBean不同的是,此处并不是传Bean对象,而是Bean类,Hutool会自动调用默认构造方法创建对象。当然,前提是Bean类有默认构造方法(空构造),这些方法有:
-
BeanUtil.mapToBean
-
BeanUtil.mapToBeanIgnoreCase
在Java Web应用中,我们经常需要将ServletRequest对象中的参数注入bean(http表单数据),BeanUtil类提供了两个便捷方法: -
BeanUtil.fillBeanWithRequestParam 将http表单数据注入Bean对象
-
BeanUtil.requestParamToBean 将http表单数据注入新建的Bean对象
Bean转为Map
- BeanUtil.beanToMap方法则是将一个Bean对象转为Map对象。
Bean转Bean
- Bean之间的转换主要是相同属性的复制,因此方法名为copyProperties。
- BeanUtil.copyProperties方法同样提供一个CopyOptions参数用于自定义属性复制。
3、日期时间工具-DateUtil
DateUtil.parse方法会自动识别一些常用格式,包括:
yyyy-MM-dd HH:mm:ss
yyyy-MM-dd
HH:mm:ss
yyyy-MM-dd HH:mm
yyyy-MM-dd HH:mm:ss.SSS
String dateStr = "2017-03-01";
Date date = DateUtil.parse(dateStr);
我们也可以使用自定义日期格式转化:
String dateStr = "2017-03-01";
Date date = DateUtil.parse(dateStr, "yyyy-MM-dd");
格式化日期输出
String dateStr = "2018-05-01";
Date date = DateUtil.parse(dateStr);
//结果 2018/05/01
String format = DateUtil.format(date, “yyyy/MM/dd”);
//常用格式的格式化,结果:2018-05-01
String formatDate = DateUtil.formatDate(date);
//结果:2017-05-01 00:00:00
String formatDateTime = DateUtil.formatDateTime(date);
//昨天
DateUtil.yesterday()
//明天
DateUtil.tomorrow()
//上周
DateUtil.lastWeek()
//下周
DateUtil.nextWeek()
//上个月
DateUtil.lastMonth()
//下个月
DateUtil.nextMonth()
日期时间差
有时候我们需要计算两个日期之间的时间差(相差天数、相差小时数等等),Hutool将此类方法封装为between方法:
String dateStr1 = "2017-03-01 22:33:23";
Date date1 = DateUtil.parse(dateStr1);
String dateStr2 = “2017-04-01 23:33:23”;
Date date2 = DateUtil.parse(dateStr2);
//相差一个月,31天
long betweenDay = DateUtil.between(date1, date2, DateUnit.DAY);
有时候我们希望看到易读的时间差,比如XX天XX小时XX分XX秒,此时使用DateUtil.formatBetween方法:
//Level.MINUTE表示精确到分
String formatBetween = DateUtil.formatBetween(between, Level.MINUTE);
//输出:31天1小时
Console.log(formatBetween);
其他时间
//年龄
DateUtil.ageOfNow("1990-01-30");
//是否闰年
DateUtil.isLeapYear(2017);
4、XML工具-XmlUtil
在日常编码中,我们接触最多的除了JSON外,就是XML格式了,一般而言,我们首先想到的是引入Dom4j包,却不知JDK已经封装有XML解析和构建工具:w3c dom。但是由于这个API操作比较繁琐,因此Hutool中提供了XmlUtil简化XML的创建、读和写的过程。
读取XML:
- XmlUtil.readXML 读取XML文件
- XmlUtil.parseXml 解析XML字符串为Document对象
写XML:
- XmlUtil.toStr 将XML文档转换为String
- XmlUtil.toFile 将XML文档写入到文件
节点读取操作:
- XmlUtil.cleanInvalid 除XML文本中的无效字符
- XmlUtil.getElements 根据节点名获得子节点列表
- XmlUtil.getElement 根据节点名获得第一个子节点
- XmlUtil.elementText 根据节点名获得第一个子节点
- XmlUtil.transElements 将NodeList转换为Element列表
XML与对象转换:
- writeObjectAsXml 将可序列化的对象转换为XML写入文件,已经存在的文件将被覆盖。
- readObjectFromXml 从XML中读取对象。
5、ExcelUtil
- 从文件中读取Excel为ExcelReader
ExcelReader reader = ExcelUtil.getReader(FileUtil.file("test.xlsx"));
- 从流中读取Excel为ExcelReader(比如从ClassPath中读取Excel文件)
ExcelReader reader = ExcelUtil.getReader(ResourceUtil.getStream("aaa.xlsx"));
ExcelReader reader;
- //通过sheet编号获取
reader = ExcelUtil.getReader(FileUtil.file("test.xlsx"), 0);
- //通过sheet名获取
reader = ExcelUtil.getReader(FileUtil.file("test.xlsx"), "sheet1");
- 读取大数据量的Excel
private RowHandler createRowHandler() {
return new RowHandler() {
@Override
public void handle(int sheetIndex, int rowIndex, List<Object> rowlist) {
Console.log("[{}] [{}] {}", sheetIndex, rowIndex, rowlist);
}
};
}
ExcelUtil.readBySax("aaa.xlsx", 0, createRowHandler());
@@@好了,大概就是这样。更具体的内容可以到官网和wiki去挖
http://www.hutool.cn/
http://hutool.mydoc.io
</div>