1. 简介
整合工具类的初衷其实比较简单,做了这么多年的项目每次新创建项目的时候总是会用到各种工具类,然后重新写或者从其他项目中拷贝过来,如此反反复复的进行着,如果将这些常用的工具类方法整合起来在新项目中直接引用不用关心如何去实现,想用的时候可以直接使用简单方面,于是这个简单、不复杂的工具包就产生了,也是希望能够带来方便。
2. 如何使用
工具包已经发布到maven仓库了,maven项目可以直接在pom.xml文件中引用就可以了。
<dependency>
<groupId>com.lingfengerick.commons</groupId>
<artifactId>commons-utils-spring-boot-starter</artifactId>
<version>${newVersion}</version>
</dependency>
可以看到起的名字是“commons-utils-spring-boot-starter” ,名字之前也想过其他的,最终确定叫这个,至于为什么会加上spring boot,是因为现在大多数都开始使用spring boot来开发,采用注解形式、配置化形式,简单方便,也想将这个工具包调整为配置,注解形式与spring boot整合在一起,灵活配置控制更好的进行使用。
3. 包含的内容
3.1 工具类总览
工具类名称 | 说明 |
---|---|
DateUtils | 时间工具类 |
CertificatesUtils | 证件工具类 |
HttpUtils | http请求工具类 |
LocalDateUtils | 基于jdk8的local时间工具类 |
FtpTemplate | ftp工具类 |
JsonParseUtils | json格式转换工具类 |
RegularVerificationUtils | 正则表达式工具类 |
WebServiceUtils | webservice工具类 |
Md5Utils | md5工具类 |
以上是目前支持的,会持续更新。
3.2 api接口
由于还未集成spring boot的配置方式,当前直接调用使用即可。
- 时间工具类 DateUtils
- strToDateExactDay(String date) : 字符串时间格式化为Date类型,参数精确到天。
- strToDateExactSec(String date) : 字符串时间格式化为Date类型,参数精确到秒。
- stringToDate(String date , String dateFormat) : 字符串时间格式化为Date类型,指定格式化格式。
- getCurrentYear() : 获取当前年。
- getCurrentMonth() : 获取当前月。
- getCurrentDay() : 获取当前天。
- getCurrentHour() : 获取当前小时。
- getTodayExactMilliSecond() : 获取当前时间精确到毫秒。
- getTodayExactDayChar() : 获取当前日期(汉字形式)精确到天,格式:yyyy年MM月dd日
- getTodayExactSecChar() : 获取当前日期(汉字形式)精确到秒,格式:yyyy年MM月dd日 HH:mm:ss
- getTodyExactDay() : 获取当前日期,格式:yyyy-MM-dd
- getTodayExactSec() : 获取当前时间,格式:yyyy-MM-dd HH:mm:ss
- getToday(String dateFormat) : 获取当前时间,格式化自定义。
- getAnyDay(String dateFormat , int interval) : 获取间隔天数,参数:格式化自定义,间隔时间。
- getTimeDiff(Date smTime , Date bigTime) : 计算时间差。
- getTimeDiffStr(String smTime , String bigTime , String dateFormat) : 获取时间差,格式化自定义。
- getTimeDiffExactDay(String smTime , String bigTime) : 计算时间差,参数时间精确到天,格式:yyyy-MM-dd
- getTimeDiffExactSec(String smTime , String bigTime) : 计算时间差,参数时间精确到秒,格式:yyyy-MM-dd HH:mm:ss
- dateToStr(Date date , String dateFormat):将Date类型转换为指定格式字符串时间。
- 证件号码工具类 CertificatesUtils
- checkIdentityNum : 校验身份证号码合法性
- getIdentityBirthDay(String identityNum):获取身份证号上的出生日期。
- getAreaNameByIdentityNum(String identityNum):根据证件号码获取市级行政区域代码
- getProvinceNameByIdentityNum(String identityNum):根据证件号码获取对应的省份
以上列举部分api说明,其他详细接口可以跳转到仓库中进行查看“commons-utils-spring-boot-starter”
4. 总结
虽然看起来简单,但是希望可以简化重复性的工作,不用去关心如何实现方便使用,把更多的精力放到项目设计中,刚刚起步也希望有好的想法或者其他常用的工具类可以提供出来,整合到工具包中,使其更加完善。