java工具类大合集，集成了通用响应实体、对象拷贝、集合转换、加密工具、格式化工具、随机中文、JSR校验、常用自定义异常等

# 快速启动 本工具包主要集成了目前在项目开发过程中个人经常会使用到的一些工具类，对工具类进行了一下简单的封装。该工具常用的工具有： | 工具类路径 | 作用说明 | | ------------------------------------------------------------ | :--------------------: | | [com.yishuifengxiao.common.tool.bean](https://apidoc.gitee.com/zhiyubujian/tool/com/yishuifengxiao/common/tool/bean/package-summary.html) | java bean 操作工具| | [com.yishuifengxiao.common.tool.collections](https://apidoc.gitee.com/zhiyubujian/tool/com/yishuifengxiao/common/tool/collections/package-summary.html) | java 集合操作工具 | | [com.yishuifengxiao.common.tool.context](https://apidoc.gitee.com/zhiyubujian/tool/com/yishuifengxiao/common/tool/context/package-summary.html) | 数据存储工具 | | [com.yishuifengxiao.common.tool.converter](https://apidoc.gitee.com/zhiyubujian/tool/com/yishuifengxiao/common/tool/converter/package-summary.html) | 数据转换工具 | | [com.yishuifengxiao.common.tool.datetime](https://apidoc.gitee.com/zhiyubujian/tool/com/yishuifengxiao/common/tool/datetime/package-summary.html) | 日期时间工具 | | [com.yishuifengxiao.common.tool.encoder](https://apidoc.gitee.com/zhiyubujian/tool/com/yishuifengxiao/common/tool/encoder/package-summary.html) | 加解密工具 | | [com.yishuifengxiao.common.tool.entity](https://apidoc.gitee.com/zhiyubujian/tool/com/yishuifengxiao/common/tool/entity/package-summary.html) | 基础通用对象 | | [com.yishuifengxiao.common.tool.exception](https://apidoc.gitee.com/zhiyubujian/tool/com/yishuifengxiao/common/tool/exception/package-summary.html) | 自定义异常 | | [com.yishuifengxiao.common.tool.exception.constant](https://apidoc.gitee.com/zhiyubujian/tool/com/yishuifengxiao/common/tool/exception/constant/package-summary.html) | 异常错误码常量 | | [com.yishuifengxiao.common.tool.http](https://apidoc.gitee.com/zhiyubujian/tool/com/yishuifengxiao/common/tool/http/package-summary.html) | HTTP操作工具 | | [com.yishuifengxiao.common.tool.io](https://apidoc.gitee.com/zhiyubujian/tool/com/yishuifengxiao/common/tool/io/package-summary.html) | IO流和文件操作工具 | | [com.yishuifengxiao.common.tool.lang](https://apidoc.gitee.com/zhiyubujian/tool/com/yishuifengxiao/common/tool/lang/package-summary.html) | 常见数据类型的封装工具 | | [com.yishuifengxiao.common.tool.log](https://apidoc.gitee.com/zhiyubujian/tool/com/yishuifengxiao/common/tool/log/package-summary.html) | 日志工具 | | [com.yishuifengxiao.common.tool.random](https://apidoc.gitee.com/zhiyubujian/tool/com/yishuifengxiao/common/tool/random/package-summary.html) | 随机工具 | | [com.yishuifengxiao.common.tool.sensitive](https://apidoc.gitee.com/zhiyubujian/tool/com/yishuifengxiao/common/tool/sensitive/package-summary.html) | 脱敏工具 | | [com.yishuifengxiao.common.tool.utils](https://apidoc.gitee.com/zhiyubujian/tool/com/yishuifengxiao/common/tool/utils/package-summary.html) | 自定义工具 | | [com.yishuifengxiao.common.tool.validate](https://apidoc.gitee.com/zhiyubujian/tool/com/yishuifengxiao/common/tool/validate/package-summary.html) | 自定义校验工具 | 工具包已经发布到maven中央仓库，使用方法如下： ```xml <dependency> <groupId>com.yishuifengxiao.common</groupId> <artifactId>common-tool</artifactId> <version>4.3.0</version> </dependency> ``` 最新版的版本号参见 [https://mvnrepository.com/artifact/com.yishuifengxiao.common/common-tool](https://mvnrepository.com/artifact/com.yishuifengxiao.common/common-tool) 工具类说明文档的地址为 [https://apidoc.gitee.com/zhiyubujian/tool/](https://apidoc.gitee.com/zhiyubujian/tool/) # 一 Bean操作工具 ## 1.1 对象转换工具 该工具的主要目的是将源对象转换为目标对象，其主要功能如下: - 将源对象里属性值复制给目标对象 - 将Java对象序列化为二进制数据 - 将序列化化后的二进制数据反序列化为对象 工具路径: ```java com.yishuifengxiao.common.tool.bean.BeanUtil ``` 使用示例: ```java CustomException e = new CustomException(); DataException ex = new DataException(); //将CustomException复制为DataException // 在使用此方法时，属性名一致的将会被复制，该方法是一个线程安全类的 // 第一个参数为源对象，第二个参数为目标对象 DataException copy = BeanUtil.copy(e, ex); //将CustomException序列化为二进制数组 byte[] bytes = BeanUtil.objectToByte(e); // 将转换后的二进制数据反序列化为对象 Object object = BeanUtil.byteToObject(bytes); // 将转换后的二进制数据反序列化为指定的对象 CustomException exception = BeanUtil.byteToObject(bytes, CustomException.class); ``` # 二 集合操作工具 ## 2.1 集合元素处理工具 该工具的主要目的是对集合进行处理，让用户在无须考虑NPE的情况下安全地操作集合。主要作用如下： - 将集合转换成java8中的stream流 - 获取集合中的第一个元素 - 将数据转换成集合 - 安全地创建集合 > 该工具是线程安全类的 工具路径: ```java com.yishuifengxiao.common.tool.collections.DataUtil ``` 使用示例: ```java // 安全地创建集合，该方法与Arrays.asList不同， // 创建出来的是ArrayList，可以放心地对创建出来的list进行各种操作 //List<String> list = Arrays.asList("a", "b", "c", "d"); List<String> list = DataUtil.asList("a", "b", "c", "d"); //将集合转换成并行流 Stream<String> parallelStream = DataUtil.parallelStream(list); //将集合转换成串行流 Stream<String> stream = DataUtil.stream(list); // 获取集合的第一个元素 String first = DataUtil.first(list); //将数组转换成集合 String[] strs = {"a", "b", "c", "d"}; List<String> asList = DataUtil.asList(strs); ``` ## 2.2 空集合判断工具 该工具的主要目的在于快速地判断一个集合是否为空集合或者为NULL。其主要作用如下： - 判断集合是否为空 - 判断分页对象是否为空 - 判断集合是否仅有一个元素 工具路径: ```java com.yishuifengxiao.common.tool.collections.CollectionUtil ``` 使用示例: ```java //判断改分页对象是否为空或者null Page<FileRecord> page = Page.empty(); boolean empty = EmptyUtil.isEmpty(page); //判断该集合是否为空或者null List<String> list = new ArrayList<>(); boolean empty1 = EmptyUtil.isEmpty(list); //判断该集合是否仅有一个元素 boolean onlyOneElement = EmptyUtil.onlyOneElement(list); ``` ## 2.3 字典链式构建工具 该工具的主要目的是能通过链式方法快速地构建一个字典对象。 工具路径: ```java com.yishuifengxiao.common.tool.collections.MapUtil ``` 使用示例: ```java Map<String, Object> map = MapUtil.instance().put("k1", "v1"). put("k2", "v2").put("k3", "v3").build(); ``` # 三 日期时间工具 ## 3.1 Date时间工具 该工具主要是基于`java.util.Date`实现的日期时间获取工具，其主要作用如下: - 获取今天的开始时间点(00:00:00) - 获取昨天的开始时间点(00:00:00)和结束时间点(23:59:59) - 获取前天的开始时间点(00:00:00) - 获取7天前的那个时间的开始时间点(00:00:00) - 获取14天前的那个时间的开始时间点(00:00:00) - 获取本周一的那个时间的开始时间点(00:00:00) - 获取上周一的那个时间的开始时间点(00:00:00) - 获取过去指定时间的那个时间的开始时间点(00:00:00) - 获取本月1号的那个时间的开始时间点(00:00:00) - 获取过去指定月份的那个月份�