Java操作百万数据量Excel导入导出工具类（程序代码教程）

Java操作百万数据量Excel导入导出工具类（程序代码教程）：

# 功能实现

1、自定义导入数据格式，支持配置时间、小数点类型（支持单/多sheet）（2种方式：本地文件路径导入（只支持xls、xlsx格式）、MultipartFile 请求方式 ）              
2、浏览器（response响应）导出Excel文件、模板文件（支持单/多sheet）           
3、指定路径导出Excel文件（支持单/多sheet）           
4、自定义样式：行、列、某个单元格（字体大小、字体颜色、左右对齐、居中、是否忽略边框。支持单/多sheet）           
5、自定义固定表头（支持单/多sheet）            
6、自定义下拉列表值（支持单/多sheet）           
7、自定义合并单元格、自定义列宽、自定义大标题（支持单/多sheet）
8、导出图片、图片地址和数据一样，只要是能访问的图片都可以导出（有需求、图片适应大小待解决），图片格式：.JPEG|.jpeg|.JPG|.jpg|.png|.gif


# czy-nexus-commons-utils
  推荐使用最新版本：        
          
         <!--
            maven：https://mvnrepository.com/artifact/com.github.andyczy/java-excel-utils
            教程文档：https://github.com/andyczy/czy-nexus-commons-utils/blob/master/README-Andyczy.md
         -->
        <dependency>        
            <groupId>com.github.andyczy</groupId>       
            <artifactId>java-excel-utils</artifactId>       
            <version>最新版本</version>      
        </dependency> 

  [教程说明](https://github.com/andyczy/czy-nexus-commons-utils/blob/master/README-Andyczy.md)   
  [本地输出测试](https://github.com/andyczy/czy-nexus-commons-utils/blob/master/README-Local-Test.md)   
   
  亲自测试：WPS、office 07、08、09、10、11、12、16 能正常打开。其他版本待测试！                                  
  注:POI SXSSFWorkbook 最高限制1048576行,16384列               
 
            
###  方式一：导出使用函数 ExcelUtils.exportForExcelsOptimize() 和  LocalExcelUtils.localNoResponse() 
        //【推荐使用该方式】【建议大数据量下不要过多设置样式】
             
        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);
        
        // 自定义：设置默认单元格列宽（可为空、默认16） 
        excelUtils.setDefaultColumnWidth(8);
                     
        // 自定义：设置默认字体（可为空、默认12号） 
        excelUtils.setFontSize(16);
        
        // 执行导出
        excelUtils.exportForExcelsOptimize();       
 
###  方式三:导出函数 ExcelUtils.exportForExcelsNoStyle()  和  LocalExcelUtils.localNoStyleNoResponse()  
    无样式（行、列、单元格样式）推荐使用这个函数、样式设置过多会影响速度   
        
       
### 导入使用函数： ExcelUtils.importForExcelData(......)
        * 获取多单元数据         
        * 自定义：多单元从第几行开始获取数据【看本文最底下参数说明】            
        * 自定义：多单元根据那些列为空来忽略行数据【看本文最底下参数说明】                 
        * 自定义：数据格式    

  
###  ExcelUtils 对象与 LocalExcelUtils 区别。
    ExcelUtils：     web响应有  response
    LocalExcelUtils：本地输出没 response
    
    
###  Test 测试【新增本地测试】

 
###  方式四:导出函数 ExcelUtils.exportForExcel(......)   过期注解（已经删除）
  


        
### 数据格式
#### 一、导出配置                                             
   1、参数 dataLists
   
       @Override
       public List<List<String[]>> exportData(String deviceNo,String snExt,Integer parentInstId,String startDate, String endDate){
           List<List<String[]>> dataLists = new ArrayList<>();
           List<String[]> oneList = new ArrayList<>();  // 表格一数据
           PageInfo<BillInfo> pagePageInfo = getBillPage(1,10000,null,snExt,deviceNo,parentInstId,startDate,endDate);
           String[] valueString = null;

           String[] headers = {"序号","标题一","标题一","标题二","标题三","标题四","标题五","标题六"};
           String[] headersTwo = {" ","标题一小标题（合并用）","标题一小标题（合并用）"," "," "," "," "};
           oneList.add(headers);
           oneList.add(headersTwo);
            
           for (int i = 0; i < pagePageInfo.getList().size(); i++) {
               valueString = new String[]{(i + 1) + "", pagePageInfo.getList().get(i).getSnExt(),
                       getNeededDateStyle(pagePageInfo.getList().get(i).getPayTime(),"yyyy-MM-dd hh:mm:ss"),
                       pagePageInfo.getList().get(i).getInstName(),pagePageInfo.getList().get(i).getStatisticsPrice()+"",
                       pagePageInfo.getList().get(i).getDeviceNo(),
                       pagePageInfo.getList().get(i).getWarning()==1?"是":"否"};
               oneList.add(valueString);
           }
           
           List<String[]> twoList = new ArrayList<>();  // 表格二数据格式与表一相同
           
           
           listArray.add(oneList);   // 多个表格导出就是多个sheet 
           listArray.add(twoList);   // 多个表格导出就是多个sheet 
           return dataLists;
       }  
           
   2、参数：sheetName(每个sheet名称)、fileName(导出Excel文件名称)、labelName(每个sheet大标题，与sheetName格式一样)
   
       需注意的是：如果是多表格导出、sheetName也要是多个值！
       如上面有两个数据导出： 
       String[] sheetNameList = new String[]{"表格一数据","表格二数据"};
       excelUtils.setSheetName(sheetNameList);
       
   2、自定义列宽：参数 mapColumnWidth
   
       HashMap<Integer, HashMap<Integer, Integer>> mapColumnWidth = new HashMap<>();
       HashMap<Integer, Integer> mapColumn = new HashMap<>();
       //第一列、宽度为 3[3的大小就是两个12号字体刚刚好的列宽]（注意：excel从零行开始数）
       mapColumn.put(0, 3);  
       mapColumn.put(1, 20);
       mapColumn.put(2, 15);
       //第一个单元格列宽
       mapColumnWidth.put(1, mapColumn);
       
   3、自定义固定表头：参数 paneMap
   
       HashMap paneMap = new HashMap();
       //第一个表格、第一行开始固定表头
       paneMap.put(1, 1); 
       
   
   4、自定义合并单元格：参数 regionMap

        HashMap regionMap = new HashMap();
        //合并单元格-代表起始行号，终止行号， 起始列号，终止列号进行合并。
        ArrayList<Integer[]> sheet1 = new ArrayList<>();
         
        //代表起始行号，终止行号， 起始列号，终止列号进行合并。（注意：excel从零行开始数）
        sheet1.add(new Integer[]{1, 1, 0, 10});
        sheet1.add(new Integer[]{2, 3, 1, 1});
        //第一个表格设置。
        regionMap.put(1, sheet1);
                                      
      
   5、自定义下拉列表值：参数 dropDownMap
      
       HashMap dropDownMap = new HashMap();
       List<String[]> dropList = new ArrayList<>();
       //必须放第一：设置下拉列表的列（excel从零行开始数）
       String[] sheetDropData = new String[]{"1", "2" };
       
       //下拉的值放在 sheetDropData 后面。
       String[] sex = {"男,女"};                      // 第一列显示的值
       String[] city = {"北京","山东","海南","湖南"};  // 第二列显示的值
       dropList.add(sheetDropData);
       dropList.add(sex);
       dropList.add(city);
       //第一个表格设置。
       dropDownMap.put(1, dropList);
       
       
   6、自定义每个(sheet)表格第几行或者是第几列的样式：参数 rowStyles / columnStyles (默认带边框)       
           
        参数说明：
        HashMap columnStyles = new HashMap();
        List list = new ArrayList();
        
        //1、样式（是否居中？，是否右对齐？，是否左对齐？， 是否加粗？，是否忽略边框？ ）
        list.add(new Boolean[]{true, false, false, false, true}); 
        
        //2、第几行或者是第几列（注意：excel从零行开始数）       
        list.add(new Integer[]{1, 3});   
        
        //3、颜色（8是黑色、10红色等） 、字体、行高（可不设置）                                       
        list.add(new Integer[]{10,14,null});   
         
        //第一表格                                 
        columnStyles.put(1,list);                                                     
        
   7、自定义每一个单元格样式：参数 styles (默认带边框)       
        
       参数说明：
       HashMap styles = new HashMap();
       List< List<Object[]>> stylesList = new ArrayList<>();
       List<Object[]> stylesObj = new ArrayList<>();
       List<Object[]> stylesObjTwo = new ArrayList<>();
       
       //1、样式一（是否居中？，是否右对齐？，是否左对齐？， 是否加粗？，是否忽略边框？ ）
       stylesObj.add(new Boolean[]{true, false, false, false, true});    
         
       //1、颜色（8是黑色、10红色等） 、字体、行高（可不设置）（必须放第二）
       stylesObj.add(new Integer[]{10, 12});         
                           
       //1、第五行、第一列（注意：excel从一开始算）
       stylesObj.add(new Integer[]{5, 1});                                  
       stylesObj.add(new Integer[]{6, 1});                                
       
       //样式二
       //样式三                          
       
       stylesList.add(stylesObj);
       //第一个表格所有自定义单元格样式 
       styles.put(1, stylesList);                                             
 

   
   
   
#### 二、导入配置
   1、(第几行开始获取数据)  参数 indexMap
       
       参数说明：多单元从第几行开始获取数据，默认从第二行开始获取（可为空)
       HashMap hashMapIndex = new HashMap();
       hashMapIndex.put(1,3);  //  第一个表格从第三行开始获取
       
  
   2、导入配置：(列为空来忽略行数据)  参数 continueRowMap
       
       参数说明：多单元根据那些列为空来忽略行数据（可为空)
       HashMap mapContinueRow = new HashMap();
       // 第一个表格第1、3列为空就忽略这行数据
       mapContinueRow.put(1,new Integer[]{1, 3});  
       
   
   
   3、数据格式
        导入时间格式（默认：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()
   
   
   

# 感谢支持、感谢你们（排名不分先后）
蒙蒙的雨（3元微信）、阿星支付宝（100支付宝）、李凯（5元微信）、blue（5元微信2019-03-28）、鹏飞（50支付宝2019-06-05）、啊哈（3元微信19-06-26）、84644574*(QQ 4元19-07-08)                  
                      
![支持一下](https://github.com/andyczy/czy-nexus-commons-utils/blob/master/sqm.png)                        
                   
### License
java-excel-utils is Open Source software released under the Apache 2.0 license.