java-excel-utils精简的 Excel 导入导出工具
java-excel-utils是JAVA操作 Excel 导入导出的工具类,目的是简化逻辑操作、可拓展 Excel 导入导出配置。
功能:
1、自定义导入数据格式,支持配置时间、小数点类型(支持单/多sheet)
2、浏览器导出Excel文件、模板文件(支持单/多sheet)
3、指定路径生成Excel文件(支持单/多sheet)
4、自定义样式:行、列、某个单元格(字体大小、字体颜色、左右对齐、居中、是否忽略边框。支持单/多sheet)
5、自定义固定表头(支持单/多sheet)
6、自定义下拉列表值(支持单/多sheet)
7、自定义合并单元格、自定义列宽、自定义大标题(支持单/多sheet)
8、导出图片、图片地址和数据一样,只要是能访问的图片都可以导出(有需求、图片适应大小待解决),图片格式:.JPEG|.jpeg|.JPG|.jpg|.png|.gif
教程文档:https://github.com/andyczy/czy-nexus-commons-utils/blob/master/README-Andyczy.md
CSDN博客:https://blog.csdn.net/JavaWebRookie/article/details/80843653
一、导出配置。
设置列宽举例:
HashMap mapColumnWidth = new HashMap<>(); HashMap mapColumn = new HashMap<>(); //自定义列宽 mapColumn.put(0, 3); //第一列、宽度为3 mapColumn.put(1, 20); //有人会问宽度3是多宽?两个中文刚刚好,设置序号的大小 mapColumn.put(2, 15); //样式多调就好了,没有什么事就一下次弄好的,而且是美观上。 mapColumnWidth.put(1, mapColumn); //第一个单元格列宽
设置表头举例:
HashMap setPaneMap = new HashMap(); setPaneMap.put(1, 3); //第一个表格、第三行开始固定表头
设置数据举例:(假设数据)
List> dataLists = new ArrayList<>(); //多表格数据
导出表格sheet名称:
String[] sheetNameList = new String[]{"今日交易记录","今日交易明细"}; //两个表格、可多个
方式一:导出使用函数 ExcelUtils.exportForExcelsOptimize() 和 LocalExcelUtils.exportForExcelsOptimize()
//【推荐使用该方式】【建议大数据量下不要过多设置样式】 ExcelUtils excelUtils = ExcelUtils.initialization(); // 必填项--导出数据(参数请看下面的格式) excelUtils.setDataLists(dataLists); // 必填项--sheet名称(如果是多表格导出、sheetName也要是多个值!) excelUtils.setSheetName(sheetNameList); // 文件名称(可为空,默认是:sheet 第一个名称) excelUtils.setFileName(excelName); // web项目response响应输出流:必须填 【ExcelUtils 对象】 excelUtils.setResponse(response); // 输出本地【LocalExcelUtils 对象】 // excelUtils.setFilePath("F://test.xlsx"); // 每个表格的大标题(可为空) excelUtils.setLabelName(labelName); // 自定义:固定表头(可为空) excelUtils.setPaneMap(setPaneMap); // 自定义:单元格合并(可为空) excelUtils.setRegionMap(regionMap); // 自定义:对每个单元格自定义列宽(可为空) excelUtils.setMapColumnWidth(mapColumnWidth); // 自定义:某一行样式(可为空) excelUtils.setRowStyles(stylesRow); // 自定义:某一列样式(可为空) excelUtils.setColumnStyles(columnStyles); // 自定义:每一个单元格样式(可为空) excelUtils.setStyles(styles); // 自定义:对每个单元格自定义下拉列表(可为空) excelUtils.setDropDownMap(dropDownMap); // 自定义:忽略边框(可为空:默认是有边框) excelUtils.setNotBorderMap(notBorderMap); // 执行导出 excelUtils.exportForExcelsOptimize();
方式三:导出函数 ExcelUtils.exportForExcelsNoStyle() 和 LocalExcelUtils.exportForExcelsNoStyle()
无样式(行、列、单元格样式)推荐使用这个函数、样式设置过多会影响速度
导入使用函数: ExcelUtils.importForExcelData(......) 和 LocalExcelUtils.importForExcelData(......)
* 获取多单元数据 * 自定义:多单元从第几行开始获取数据【看本文最底下参数说明】 * 自定义:多单元根据那些列为空来忽略行数据【看本文最底下参数说明】
ExcelUtils 对象与 LocalExcelUtils 区别。
ExcelUtils: web响应有 response LocalExcelUtils:本地输出没 response
Test 测试【新增本地测试】
方式四:导出函数 ExcelUtils.exportForExcel(......) 过期注解
* 可提供模板下载 * 自定义下拉列表:对每个单元格自定义下拉列表 * 自定义列宽:对每个单元格自定义列宽 * 自定义样式:对每个单元格自定义样式 * 自定义样式:单元格自定义某一列或者某一行样式 * 自定义单元格合并:对每个单元格合并 * 自定义:每个表格的大标题 * 自定义:对每个单元格固定表头
二、导入配置。
有的人会问了,为什么这个导入没有转换成对象呢?我是觉得不好用,因为导入导出都是公用的,而且都是多表格,也没必要转换也有空拿到值。
9、导入配置:(第几行开始获取数据) 参数 indexMap
参数说明:多单元从第几行开始获取数据,默认从第二行开始获取(可为空) HashMap hashMapIndex = new HashMap(); hashMapIndex.put(1,3); // 第一个表格从第三行开始获取
10、导入配置:(列为空来忽略行数据) 参数 continueRowMap
参数说明:多单元根据那些列为空来忽略行数据(可为空) HashMap mapContinueRow = new HashMap(); mapContinueRow.put(1,new Integer[]{1, 3}); // 第一个表格第1、3列为空就忽略这行数据
11、导入时间格式(默认:yyyy-MM-dd)、导入数字保留的小数点(默认:#.###### 六位)
ExcelUtils excelUtils = ExcelUtils.initialization(); excelUtils.setNumeralFormat("#.####"); // (可为空)期望保留小数的位数(#.####)这样保留四位。 // (可为空) (poi 只接受无中文的日期格式、如果你想转换别的格式,这个参数要和导入表中日期格式类似,如表格中为:2019年02月14日 12时12分)。 excelUtils.setDateFormatStr("yyyy年MM月dd日 HH时mm分"); excelUtils.setExpectDateFormatStr("yyyy-MM-dd HH-mm"); // (可为空、默认的值是:dateFormatStr 参数值) 期望转换后的日期格式。 // 执行导入函数 ExcelUtils.importForExcelData()
导入获取数据:(支持多表格数据)
for(........){ // 伪代码 String accountNo = hashMapList.get(j).get("0"); // 获取到Excel表格中第一列数据 // 多表格数据、想怎么处理怎么处理,这就是不想转成对象的原因 }
POM Maven 引入依赖:(推荐使用最新版本)
com.github.andyczy
java-excel-utils
4.0