# java-excel-utils

**Repository Path**: fanxingabc16/java-excel-utils

## Basic Information

- **Project Name**: java-excel-utils
- **Description**: 是JAVA操作 Excel 导入导出的工具类，目的是简化逻辑操作、可拓展 Excel 导入导出配置
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 16
- **Created**: 2020-03-12
- **Last Updated**: 2020-12-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# czy-nexus-commons-utils
   本库是发布到 [search.maven](https://search.maven.org/)  、 [mvnrepository](https://mvnrepository.com/)公共仓库的管理库。    
   (教程博客)[https://blog.csdn.net/JavaWebRookie/article/details/80843653]、可通过maven方式下载源码查看注释。                
   (工具类集库)[https://github.com/andyczy/czy-study-java-commons-utils]    
   (开源中国)[https://www.oschina.net/]          
   
   
   最新 maven 版本：        
        
        <dependency>        
            <groupId>com.github.andyczy</groupId>       
            <artifactId>java-excel-utils</artifactId>       
            <version>3.2</version>      
        </dependency> 
   
  [javadoc 文档](https://oss.sonatype.org/service/local/repositories/releases/archive/com/github/andyczy/java-excel-utils/3.2/java-excel-utils-3.2-javadoc.jar/!/com/github/andyczy/java/excel/ExcelUtils.html)
       
  [版本-2.0之前教程](https://github.com/andyczy/czy-nexus-commons-utils/blob/master/README-2.0.md)   
        
  [版本-3.1教程](https://github.com/andyczy/czy-nexus-commons-utils/blob/master/README-3.0.md)   
     
  [版本-3.2教程](https://github.com/andyczy/czy-nexus-commons-utils/blob/master/README-3.2.md)   
  
  亲自测试：WPS、office 08、10、11、12、16 能正常打开。
    
      
### 版本 3.2 -- 导出配置 ExcelUtils.exportForExcelsOptimize()
             
        ExcelUtils excelUtils = ExcelUtils.setExcelUtils();
        // 必填项--导出数据
        excelUtils.setDataLists(dataLists);      //   参数请看下面的格式 
        // 必填项--sheet名称
        excelUtils.setSheetName(sheetNameList);
        // 文件名称(可为空，默认是：sheet 第一个名称)
        excelUtils.setFileName(excelName);
        
        // 输出流：response 响应（输出流：必须选一）
        excelUtils.setResponse(response);
        // 输出流：可直接输出本地路径（输出流：必须选一）
        // excelUtils.setFilePath("F:\\test.xlsx"); 
 
        // 每个表格的大标题（可为空）
        excelUtils.setLabelName(labelName);
        // 自定义：固定表头（可为空）
        excelUtils.setPaneMap(setPaneMap);
        // 自定义：单元格合并（可为空）
        excelUtils.setRegionMap(regionMap);
        
        // 自定义：对每个单元格自定义列宽（可为空）
        excelUtils.setColumnMap(mapColumnWidth);
        // 自定义：某一行样式（可为空）
        excelUtils.setRowStyles(stylesRow);
        // 自定义：某一列样式（可为空）
        excelUtils.setColumnStyles(columnStyles);
        // 自定义：每一个单元格样式（可为空）
        excelUtils.setStyles(styles);
                
        // 自定义：对每个单元格自定义下拉列表（可为空）
        excelUtils.setDropDownMap(dropDownMap);
        // 自定义：忽略边框(可为空：默认是有边框)
        excelUtils.setNotBorderMap(notBorderMap);       
            
        // 执行导出
        excelUtils.exportForExcelsOptimize();       
        
### 2.0之前版本 -- 导出配置 ExcelUtils.exportForExcel(...)
        * 可提供模板下载           
        * 自定义下拉列表：对每个单元格自定义下拉列表         
        * 自定义列宽：对每个单元格自定义列宽         
        * 自定义样式：对每个单元格自定义样式  
        * 自定义样式：单元格自定义某一列或者某一行样式            
        * 自定义单元格合并：对每个单元格合并 
        * 自定义：每个表格的大标题          
        * 自定义：对每个单元格固定表头    
        
        
### 导入配置 ExcelUtils.importForExcelData(...)
        * 获取多单元数据         
        * 自定义：多单元从第几行开始获取数据            
        * 自定义：多单元根据那些列为空来忽略行数据         

  
        
### 数据格式
   [javadoc 文档](https://oss.sonatype.org/service/local/repositories/releases/archive/com/github/andyczy/java-excel-utils/3.2/java-excel-utils-3.2-javadoc.jar/!/com/github/andyczy/java/excel/ExcelUtils.html)


   1、导出数据：参数 dataLists
   
        @Override
           public List<List<String[]>> exportBill(String deviceNo,String snExt,Integer parentInstId,String startDate, String endDate){
               List<List<String[]>> dataLists = new ArrayList<>();
               List<String[]> stringList = new ArrayList<>();
               PageInfo<BillInfo> pagePageInfo = getBillPage(1,10000,null,snExt,deviceNo,parentInstId,startDate,endDate);
               String[] valueString = null;
               
               String[] headers = {"序号","标题一","标题一","标题二","标题三","标题四","标题五","标题六"};
               String[] headersTwo = {" ","标题一小标题（合并用）","标题一小标题（合并用）"," "," "," "," "};
               stringList.add(headers);
               stringList.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?"是":"否"};
                   stringList.add(valueString);
               }
               listArray.add(stringList);
               return dataLists;
           }       
   
   自定义列宽：参数 columnMap
   
       参数说明：
       HashMap<Integer, HashMap<Integer, Integer>> columnMap = new HashMap<>();
       HashMap<Integer, Integer> mapColumn = new HashMap<>();
       //自定义列宽
       mapColumn.put(0, 3);  //第一列、宽度为3
       mapColumn.put(1, 20);
       mapColumn.put(2, 15);
       //第一个单元格列宽
       columnMap.put(1, mapColumn);
       
   自定义固定表头：参数 paneMap
   
       参数说明：
       HashMap paneMap = new HashMap();
       //第一个表格、第三行开始固定表头
       paneMap.put(1, 1); 
       
   
   自定义合并单元格：参数 regionMap
   
        参数说明：
        List<List<Integer[]>> setMergedRegion = new ArrayList<>();
        List<Integer[]> sheet1 = new ArrayList<>();                  //第一个表格设置。
        Integer[] sheetColumn1 = new Integer[]{0, 1, 0, 2}         //代表起始行号，终止行号， 起始列号，终止列号进行合并。（excel从零行开始数）
        setMergedRegion.add(sheet1);
       
   自定义下拉列表值：参数 dropDownMap
   
        参数说明：
        HashMap dropDownMap = new HashMap();
        List<String[]> sheet1 = new ArrayList<>();                  //第一个表格设置。
        String[] sheetColumn1 = new String[]{"1", "2", "4"};        //必须放第一：设置下拉列表的列（excel从零行开始数）
        String[] sex = {"男,女"};                                   //下拉的值放在 sheetColumn1 后面。
        sheet1.add(sheetColumn1);
        sheet1.add(sex);
        dropDownMap.put(1,sheet1);                                      //第一个表格的下拉列表值   
        
   自定义每个表格第几行或者是第几列的样式：参数 rowStyles / columnStyles
           
        参数说明：
        HashMap columnStyles = new HashMap();
        List list = new ArrayList();
        list.add(new Boolean[]{true, false, false, false, true});                //1、样式（是否居中？，是否右对齐？，是否左对齐？， 是否加粗？，是否有边框？ ）
        list.add(new Integer[]{1, 3});                                           //2、第几行或者是第几列
        list.add(new Integer[]{10,14,null});                                     //3、颜色值（8是黑色、10红色等） 、颜色、字体、行高？（可不设置）
        columnStyles.put(1,list);                                                     //第一表格
        
   自定义每一个单元格样式：参数 styles
        
       参数说明：
       HashMap styles = new HashMap();
       List< List<Object[]>> list = new ArrayList<>();
       List<Object[]> objectsList = new ArrayList<>();
       List<Object[]> objectsListTwo = new ArrayList<>();
       objectsList.add(new Boolean[]{true, false, false, false, true});      //1、样式一（是否居中？，是否右对齐？，是否左对齐？， 是否加粗？，是否有边框？ ）
       objectsList.add(new Integer[]{10, 12});                               //1、颜色值 、字体大小、行高（必须放第二）
       objectsList.add(new Integer[]{5, 1});                                 //1、第五行第一列
       objectsList.add(new Integer[]{6, 1});                                 //1、第六行第一列
       
       objectsListTwo.add(new Boolean[]{false, false, false, true, true});   //2、样式二（必须放第一）
       objectsListTwo.add(new Integer[]{10, 12,null});                       //2、颜色值（8是黑色、10红色等） 、颜色、字体、行高？（可不设置）（必须放第二）
       objectsListTwo.add(new Integer[]{2, 1});                              //2、第二行第一列
       
       list.add(objectsList);
       list.add(objectsListTwo);
       styles.put(1, list);                                              //第一个表格所有自定义单元格样式 
             
   
   自定义忽略边框：参数 notBorderMap
   
       HashMap notBorderMap = new HashMap();
       notBorderMap.put(1, new Integer[]{1, 5});   //忽略边框（1行、5行）、默认是数据是全部加边框
   
   2、导入配置：
        
       @param indexMap 多单元从第几行开始获取数据，默认从第二行开始获取（可为空，如 hashMapIndex.put(1,3); 第一个表格从第三行开始获取）
       @param continueRowMap 多单元根据那些列为空来忽略行数据（可为空，如 mapContinueRow.put(1,new Integer[]{1, 3}); 第一个表格从1、3列为空就忽略）
                    
### License
java-excel-utils is Open Source software released under the Apache 2.0 license.