java-excel-utils - 精简的 Excel 导入导出工具


Apache
跨平台
Java

软件简介

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