日常工作中整理的一些经常使用的方法。
有可能不是特别通用，因为是工作中抽取的，可能会有一点业务逻辑在里面。
不定期更新方法，不定期添加类。
此次迁移主要是整理了代码风格与包名结构，并写了具体的测试类，以及重写了说明文档
注释采用的是方法注释，但举例使用的是测试用例。请勿吐槽。
/**
* 判断一个字符串是否包含任一列举的前缀
*
* @param checkStr 待检查字符串
* @param params 前缀
* @return true: 包含任一列举的前缀值 false:不包含其中的任意一个前缀
*/
boolean constains = UtilString.startWith(checkStr,prefix1,prefix2,...);/**
* 判断一个字符串是否包含任一列举的后缀
*
* @param checkStr 待检查字符串
* @param params 后缀
* @return true: 包含任一列举的后缀值 false:不包含其中的任意一个后缀
*/
boolean constains = UtilString.endWith(checkStr,prefix1,prefix2,...);String uuid = UtilString.randomUUID();String cleanStr = UtilHtml.cleanHtmlLabel(htmlStr);// 默认4位随机数
String randomSalt = UtilString.randomSalt();
// 指定位数随机数 参数为数字
String randomSalt = UtilString.randomSalt(6);// 参数str为待判断字符串
boolean isBlank = UtilString.isBlank(str);/**
* 将Byte数组转成字符串
*
* 参数一 digest Byte数组
* 返回值 字符串
*/
String result = UtilString.byteToHex(bytes);String jsonStr = UtilJsonAndXml.jsonToXml(json);String xmlStr = UtilJsonAndXml.XmlToJson(xml);// 默认转换方式 yyyy-MM-dd HH:mm:SS
Date date = UtilDate.stringToJavaUtilDate("2018-01-24 18:54:58");
// 指定转换方式
Date date = UtilDate.stringToJavaUtilDate("2018-01-24","yyyy-MM-dd");// 默认转换方式 yyyy-MM-dd HH:mm:SS
String dateStr = UtilDate.javaUtilDateToString(new Date());
// 指定转换方式
String dateStr = UtilDate.javaUtilDateToString(new Date(), "yyyy:MM:dd HH-mm-sss");java.sql.Date sqlDate = UtilDate.sqlDateToUtilDate(new java.sql.Date(11111232));java.util.Date utilDate = UtilDate.javaUtilDateToSqlDate(new Date());// 这个方法本来是用于Mybatis自定义插件的，但是插件没有什么实际使用场景，故此方法没什么实际用途
java.sql.Date sqlDate = UtilDate.dateTimeToSqlDate(DateTime.now());/**
* PDF文件转image图片
*
* 参数一 pdf文件路径
* 参数二 把转换的图片保存在哪里(路径)
*/
String filePath = UtilPDF.pdfTransformImg("xxxx.pdf","xxxxx/xxxx");/**
* 2018-01-25 更新
* 参数一 原文件
* 参数二 目标文件全路径
*/
boolean copyFileStatus = UtilFile.copyFileToDirectory(file,filePath);/**
* 删除文件
*
* 参数：文件路径
*/
boolean deleteStatus = UtilFile.deleteFile("/Users/xuan/Desktop/a.txt");
/**
* 删除文件
*
* 参数：java.io.file 文件对象
*/
boolean deleteStatus = UtilFile.deleteFile(file);/**
* 参数一 待上传文件
* 参数二 文件保存目录 全路径
* 返回值 将要保存的服务器文件名
*/
String fileName = UtilFile.uploadFile(multipartFile, filePath);/**
* 参数 原文件名
* 默认不保留原文件名
*/
String fileName = UtilFile.uniqueFileName(originalFilename);
/**
* 2018-01-25 更新
* 参数一 原文件名
* 参数二 是否保留原文件名 true:保留 false:不保留
*/
String fileName = UtilFile.uniqueFileName(originalFilename,true); /**
* 导入Excel表格并生成对应实体类的集合
* <b>[强制条件] Excel表头必须与实体类的属性名称一致</b>
* 注：
* 1.由于效率问题,当前暂支持一个工作薄的导入
* 2.表头必须以 (中文名-实体对象属性名)为头。否则导入失败
*
* @param excelFile Excel表格文件 支持.xls .xlsx
* @param clazz 映射的实体类类型
*
* @return 实体集合
*
* @throws StreamException 文件读取异常
* @throws FileException 文件异常
* @throws StreamCloseException 流关闭异常
*/
List<T> list = UtilExcelImport.importExcel(excelFile, clazz);/**
* 导入一个Excel文件
* <b>
* Excel文件中若有日期格式的单元格，
* 必须对此单元格的表头添加批注，否则日期将以天数记录
* </b>
*
* @param file Excel文件
* @param isNeedTableHeader 是否需要表头 true:需要表头 false:不需要表头
*
* @return 文件中所有Sheet数据封装成的Json数据数组。数组以Sheet为单位
*/
String[] strings = UtilExcelImport.importExcel(excelFile,isNeedTableHeader);/**
* 从Excel中导入数据到实体集合中
* <b>
* 要求：
* 1. 实体类字段属性顺序需与Excel文件中列顺序一致，排除serialVersionUID字段后，数量应与列数量一样多
* 2. 实体类对象数组顺序需与Excel中Sheet表中保存的数据对应的对象保持一致。
* </b>
*
* @param file Excel文件
* @param targetClassArray 要导入的实体类对象数组
*
* @return 实体集合对象
*
* @throws FileException 文件找不到异常
* @throws ParamException 入参不正确异常
* @throws FileTypeException 文件类型异常
* @throws IOException IO异常
* @throws ArrayIndexOutOfBoundsException 传入实体类数组长度与文件中工作表长度不一致
*/
Object[] objects = UtilExcelImport.importExcelIntoEntity(excelFile,new Class[]{});/**
* 导出到Excel表方法
*
* 参数一 表头 可为空 若为空则为实体类中文意义
* 参数二 表中的数据
* 参数三 工作薄名 若为空 则默认为WookBook
* 参数四 实体类类型
* 参数五 完成的文件名 （文件全路径 + 文件名）
* 返回值 生成的文件名
*/
String fileName = UtilExcelExport.UtilExcelExport();
/**
* 导出到Excel表方法
*
* 参数一 表头 可为空 若为空则为实体类中文意义
* 参数二 表中的数据
* 参数三 工作薄名 若为空 则默认为WookBook
* 参数四 实体类类型
* 返回值 生成的XSSFWorkBook对象, 可以以流的形式输出
*/
XSSFWorkbook xssfWorkBook = UtilExcelExport.UtilExcelExport(); /**
* 清理Maven家目录下无用目录与文件
*
* 参数一 maven资源库路径
* 返回值 返回清理成功与否 true:成功 false:失败
*/
boolean cleanResult = UtilMaven.clean(m2HomePath);// 这是一个业务系统响应到客户端的封装
/**
* 服务器异常
*
* @param <T> 泛型
* @return 封装的数据结构
*/
ResponseEntity<T> responseEntity = ResponseUtil.error();
/**
* 服务器异常
*
* @param <T> 泛型
* @param code 响应码
* @param message 响应信息中文说明
* @param descrpition 响应信息英文说明
* @return 封装的数据结构
*/
ResponseEntity<T> responseEntity = ResponseUtil.error(code,message,description);
/**
* 服务器异常
*
* @param <T> 泛型
* @param baseResponse 响应结构
* @return 封装的数据结构
*/
ResponseEntity<T> responseEntity = ResponseUtil.error(baseResponse);
/**
* 请求分页接口成功时返回的数据结构
*
* @param responseData 返回页面的分页数据
* @param <T> 泛型
* @param total 分页总条数
* @return 封装的数据结构
*/
ResponseEntity<T> responseEntity = ResponseUtil.success(responseData,total);
/**
* 请求成功时返回的数据结构
*
* @return 封装的数据结构
*/
ResponseEntity<T> responseEntity = ResponseUtil.success();
/**
* 请求成功时返回的数据结构
*
* @param responseData 返回页面的数据
* @param <T> 泛型
* @return 封装的数据结构
*/
ResponseEntity<T> responseEntity = ResponseUtil.success(responseData);// ResponseUtil.error()
{
"code":99999,
"message":"服务器异常，请联系管理员",
"description": "server error"
}
// ResponseUtil.error(123,"message","description")
{
"code":123,
"message":"message",
"description": "description"
}
// ResponseUtil.success()
{
"code":0,
"message":"请求成功",
"description": "request success"
}
// ResponseUtil.success(data)
{
"code":0,
"message":"请求成功",
"description": "request success",
"data": data
}
// ResponseUtil.success(data,10000)
{
"code":0,
"message":"请求成功",
"description": "request success",
"rows": data,
"total": 10000
}/**
* 加密字符串的方法
*
* @param proclaimed 明文
* @param randomStr 随机字符串
* @return 密文
* @throws ParamException 传入参数异常
*/
String encryptStr = UtilMD5.encryptString(proclaimed,randomStr);- 修改ResponseUtil为UtilResponse
重大变更
为了结合另外一个xf项目。更改了包结构！！！更改了依赖名！！！我保证！！！这是最后一次变更如此大的改动！！！！！
- 添加判断一个字符串是否包含任意列举的字符串为前缀的方法
- 添加判断一个字符串是否包含任意列举的字符串为后缀的方法
- 添加了一个清理Maven的工具类。后期可能会修改成自动获取系统中配置的Maven变量找到对应的setting.xml中配置的资源库的路径，以及提供一个Swing视图。
- 添加判断字符串是否为空字符串方法
- 添加将Byte数组转换为字符串方法
- 添加删除文件的重载方法
- 添加MD5工具类加密字符串的方法
- 添加HTTP响应给客户端实体封装的方法
- 整理代码，规范风格。
- 清理类ExcelEntity，向面向对象靠近。
- UtilFile.uniqueFileName更改为UtilFile.getUniqueFileName
- 新增多工作表导入方法，返回结果为json字符串数组。要求工作表必须有表头，如果表头中含有时间类型的数据列，要求在此列表头添加批注，批注内容包含date或者日期即可，否则时间将以1990年1月1日起到时间列的天数返回。
- 修改单元格数据获取工具类，添加日期单元格的判断。
- 添加多工作表导入方法。此方法支持导入数据后自动封装成实体对象集合。且，此对象可以有父类关系。要求：Excel文件中sheet表必须有表头，否则会丢失一行数据
- 将以流形式读入工具的方法私有化。提供一个公共的入口方法
- 修改单元格数据转换成实体时的逻辑。
- 实体类若有java.util.Date类属性时，对应单元格格式应已"yyyy-MM-dd"的方式输入，否则将出现异常。
- 实体类中如果有java.lang.Byte类属性时，对应单元格数据应不大于byte取值范围。
-
修正实体类有父类时，父类属性设置失败问题。
-
修正单元格中有空格时导致的数据丢失问题。
ps: 目前只支持一层继承关系。
- 添加新方法：
- 复制文件：UtilFile.copyFileToDirectory(File file, String filePath) {
- 获取唯一文件名：UtilFile.uniqueFileName(String originalFilename, boolean keepFileName);
- 清理代码。
- 整合旧资源库代码至新资源库。
- 更新项目名，包名，类名。
- 删除方法：
- 获取服务器文件名：FileUtil.getServerFileName(fileName,hasChar); 2. 获取分页第一条序列：PackingUtils.getFirstPageNum(pageNum,pageSize); 3. 从请求路径中获取http://ip:port/porjectName：ServletTools.getDomainAndContextPath(request);