个人项目

GitHub地址:https://github.com/83945105/holygrail

Maven坐标: 目前最新版0.0.5

<groupId>com.github.83945105</groupId>
<artifactId>holygrail</artifactId>
欢迎到官网搜索最新版:

地址一:点击打开链接

地址二:点击打开链接

导入导出目前实现了常用功能,后续我会不断完善,如添加字体设置

开始教程



一、导出



  • 1、废话不多说,先来2个最简单的例子
        /*模拟从数据库获取数据开始*/
        Collection<Map<String, Object>> records = new ArrayList<>();
        Map<String, Object> record01 = new HashMap<>();
        Map<String, Object> record02 = new HashMap<>();
        Map<String, Object> record03 = new HashMap<>();
        record01.put("username", "张三1");
        record01.put("password", "666");
        record02.put("username", "张三2");
        record02.put("password", "666");
        record03.put("username", "张三3");
        record03.put("password", "666");
        records.add(record01);
        records.add(record02);
        records.add(record03);
        /*模拟从数据库获取数据结束*/


        Export.buildSXSSFExportExcelWorkBook()//构建查询对象
                .createSheet()//创建一个Sheet,可以传参设置Sheet名
                .setColumnFields("username","password")//设置列字段,对应Map集合的key
                .importData(records)//导入数据,支持多次导入
                .export("E://测试.xlsx");//导出成Excel
        /*模拟从数据库获取数据开始*/
        Collection<User> records = new ArrayList<>();
        User user01 = new User();
        User user02 = new User();
        User user03 = new User();
        user01.setUsername("张三1");
        user01.setPassword("666");
        user02.setUsername("张三2");
        user02.setPassword("666");
        user03.setUsername("张三3");
        user03.setPassword("666");
        records.add(user01);
        records.add(user02);
        records.add(user03);
        /*模拟从数据库获取数据结束*/


        Export.buildSXSSFExportExcelWorkBook()//构建查询对象
                .createSheet()//创建一个Sheet,可以传参设置Sheet名
                .setColumnFields("username","password")//设置列字段,对应User对象的属性名
                .importData(records)//导入数据,支持多次导入
                .export("E://测试.xlsx");//导出成Excel

  • 2、连续创建Sheet表
        /*模拟从数据库获取数据开始*/
        Collection<User> records = new ArrayList<>();
        User user01 = new User();
        User user02 = new User();
        User user03 = new User();
        user01.setUsername("张三1");
        user01.setPassword("666");
        user01.setMobile("110");
        user02.setUsername("张三2");
        user02.setPassword("666");
        user01.setMobile("120");
        user03.setUsername("张三3");
        user03.setPassword("666");
        user01.setMobile("119");
        records.add(user01);
        records.add(user02);
        records.add(user03);
        /*模拟从数据库获取数据结束*/


        Export.buildSXSSFExportExcelWorkBook()
                .createSheet()
                .setColumnFields("username","password")
                .importData(records)
                .getOwnerWorkBook()
                .createSheet("SheetB")//创建第二个Sheet,设置了Sheet名
                .setColumnFields("mobile")
                .importData(records)
                .export("E://测试.xlsx");


  • 3、自定义标题(这种方式可以动态创建列)
        //构建用于描述标题的二维数组,获取数据代码略
        SXSSFExcelTitle[][] titles = new SXSSFExcelTitle[1][];
        SXSSFExcelTitle[] title = new SXSSFExcelTitle[3];
        title[0] = new SXSSFExcelTitle();
        title[1] = new SXSSFExcelTitle();
        title[2] = new SXSSFExcelTitle();
        title[0].setField("username");//设置标题所在列对应数据的字段
        title[1].setField("password");
        title[2].setField("mobile");
        title[0].setTitle("姓名");//设置标题名称
        title[1].setTitle("密码");
        title[2].setTitle("手机号");
        title[0].setWidth(50);//设置列宽,默认10,由于计算原因,实际效果稍有误差
        title[1].setWidth(60);
        title[2].setWidth(70);
        title[0].setHAlign(CellStyle.H_AlignType.LEFT);//设置水平对齐方式为左对齐,标题默认水平居中
        title[0].setVAlign(CellStyle.V_AlignType.BOTTOM);//设置垂直对齐方式为底部对齐,标题默认垂直居中
        title[0].setBorderLeft(CellStyle.BorderStyle.DASH_DOT);//设置左边框样式,同样还可以设置其它方向边框
        titles[0] = title;


        Export.buildSXSSFExportExcelWorkBook()
                .createSheet()
                .setTitles(titles)//设置标题
                .importData(records)
                .export("E://测试.xlsx");

 
  • 4、用js文件描述标题(这种方式正常操作不能动态创建列,你要是动态生成这个文件当我没说)
ExcelWorkBookExport.exportTemplateJavaScriptFile("E://user.js");//你可以这样导出一个模板文件
[[{
    title: '姓名',
    field: 'username',
    width: 20,
    borderLeft: 'DASHED'
},{
    title: '密码',
    field: 'password',
    hAlign: 'Left',
    vAlign: 'top',
    width: 30
},{
    title: '手机号',
    field: 'mobile',
    width: 15
}]]
 基于模板我把表头文件修改成这种,如果你会使用easyui的datagrid的columns属性,

那你就很好理解为什么标题要用二维数组来描述
Export.buildSXSSFExportExcelWorkBook()
      .createSheet()
      //解析一个标题文件,文件放在你能加载到的位置就可以,这里我使用输入流的方式 
      .parseTitlesJson(Test.class.getResourceAsStream("/com/xx/xx/xx/xx/user.js"))         
      .importData(records)
      .export("E://测试.xlsx");

  • 5、复杂的标题(合并单元格,以js文件方式为例)
  • [[{
        title: '姓'
    }, {
        title: '名'
    }, {
        title: '密码+手机号',
        colSpan: 2
    }, {
        title: '占用2行',
        rowSpan: 2
    }], [
        {
            title: '姓名',
            field: 'username',
            width: 20,
            colSpan: 2
        }, {
            title: '密码',
            field: 'password',
            width: 15
        }, {
            title: '手机号',
            field: 'mobile',
            width: 15
        }
    ]]
     修改标题js如上,二维数组第一维表示一行,rowSpan表示占用行数,colSpan表示占用列数
 导出Excel效果如下

  • 6、格式化单元格
  • 除了标题单元格可以自定义,数据单元格同样可以自定义(格式化)
 
 我们将上面的标题js加入一个序号列,占用2行

Export.buildSXSSFExportExcelWorkBook()//构建查询对象
                .createSheet()//创建一个Sheet,可以传参设置Sheet名
                .parseTitlesJson(Test.class.getResourceAsStream("/com/xx/xx/xx/xx/user.js"))
                //使用lambda表达式作为第二个参数格式化单元格,如果你会写JavaScript可以理解为JS的回调函数
                .importData(records, (value, record, cellHandler, field, rowCursor, index) -> {
                    //value  => 当前单元格的值
                    //record => 当前行数据
                    //cellHandler  => 用于设置和获取单元格属性样式的对象,这个对象可以自己点进去看注释,可以干很多事情
                    //field  => 当前单元格对应的title field
                    //rowCursor  =>  行游标,记录当前写入行的游标号,该号从0开始
                    //index  =>  当前行数据也就是record在数据集合records中的下标
                    if("num".equals(field)) {//如果是序号列
                        cellHandler.setHAlign("center");//设置单元格为水平居中,支持直接传入字符串
                        cellHandler.setVAlign(CellStyle.V_AlignType.CENTER);//设置单元格为垂直居中
                        cellHandler.setType(CellOption.CellType.COMBOBOX);//设置单元格类型为下拉框
                        cellHandler.setOptions(new String[]{"下拉框值1", "下拉框值2"});//设置下拉框值

                        return index + 1;//使用下标号+1作为单元格值
                    }

                    return value;
                })//导入数据,支持多次导入
                .export("E://测试.xlsx");

 再来一个 更复杂点的例子

[[{
    title: '序号',
    field: 'num',
    rowSpan: '2'
}, {
    title: '姓'
}, {
    title: '名'
}, {
    title: '密码+手机号',
    colSpan: 2
}, {
    title: '占用2行',
    rowSpan: 2,
    writeEmpty: false
}], [
    {
        title: '姓名',
        field: 'username',
        width: 20,
        colSpan: 2
    }, {
        title: '密码',
        field: 'password',
        width: 15
    }, {
        title: '手机号',
        field: 'mobile',
        width: 15
    }
]]
主要说下writeEmpty属性,这个属性默认是true,表示当该列的单元格值为空的时候,也写入数据,
这里我将"占用2行"这列writeEmpty设为false,因为我接下来会格式化手机号列对应的数据单元格,来占用这个列,如果不将writeEmpty设为false,如果单元格值类型对应不上,将报异常,或者打开Excel会提示存在单元格值被覆盖之类的提示。

Export.buildSXSSFExportExcelWorkBook()
                .createSheet()
                .parseTitlesJson(Test.class.getResourceAsStream("/com/xx/xx/xx/xx/user.js"))
                .importData(records, (value, record, cellHandler, field, rowCursor, index) -> {

                    //设置所有数据单元格为水平垂直居中
                    cellHandler.setHAlign("center");
                    cellHandler.setVAlign("center");

                    if("num".equals(field)) {
                        //如果是序号列,将值改为当前数据下标+1
                        return index + 1;
                    }

                    if("username".equals(field)) {
                        //如果是用户名列,将单元格改为占用3列
                        cellHandler.setColSpan(3);
                    }

                    if("password".equals(field)) {
                        //如果是密码列,将单元格起始行下移一行
                        cellHandler.setStartRowNum(cellHandler.getStartRowNum() + 1);
                        //占用行改为3行
                        cellHandler.setRowSpan(3);
                    }
                    if("mobile".equals(field)) {//如果是手机号列
                        //手机号列占用行改为5行
                        cellHandler.setRowSpan(5);
                        //占用列改为2行
                        cellHandler.setColSpan(2);
                        //将值格式化成数值类型
                        return Integer.parseInt(value == null ? "" : value.toString());
                    }

                    return value;
                })//导入数据,支持多次导入
                .export("E://测试.xlsx");//导出成Excel


  • 7、最后再丢几个批量创建Sheet的例子


    Export.buildSXSSFExportExcelWorkBook()
                    //批量创建10个sheet
                    .createSheets(10, (sheet, sheetIndex, index, totalAllSheetDataSize, totalSheetDataSize) -> {
                        //sheet   =>   当前创建的sheet对象
                        //sheetIndex   =>   当前创建的sheet在整个工作簿中的下标
                        //index   =>   当前创建的sheet在这个批次sheet的下标
                        //totalAllSheetDataSize   =>   整个工作簿已经导入的数据总数
                        //totalSheetDataSize     =>   这个批次sheet已经导入的数据总数
    
                        sheet.setColumnFields("")
                                .importData(new ArrayList<>());
    
                    }).export("E://批量Sheet.xlsx");

    Export.buildSXSSFExportExcelWorkBook()
                    //批量创建10个sheet
                    .createSheets(10, (sheetIndex, index) -> "格式化Sheet名", (sheet, sheetIndex, index, totalAllSheetDataSize, totalSheetDataSize) -> {
    
                        sheet.setColumnFields("")
                                .importData(new ArrayList<>());
    
                    }).export("E://批量Sheet.xlsx");

    Export.buildSXSSFExportExcelWorkBook()
                    .createSheets((sheet, sheetIndex, index, totalAllSheetDataSize, totalSheetDataSize) -> {
    
                        sheet.parseTitlesJson("")
                                .importData(new HashSet<>());
    
                        if(totalSheetDataSize > 1000) {
                            //当导入的数据大于1000条,停止创建Sheet
                            return false;
                        }
    
                        return true;//继续创建Sheet,内部限制最大100个
                    }).export("E://批量Sheet.xlsx");


    此外还有一些方法,我就不贴代码了,如设置行号,设置列号控制导入数据的起始行之类的,方法都有详细的注释,用IDE提示就能看到所有方法,基本什么功能都能猜到。


二、导入




所有例子读取以上模板
1、同样先来几个简单的例子
ArrayList<ArrayList<String>> records = Import.buildXSSFImportExcelWorkBook()
                .parseFile(new File("E://测试.xlsx"))//解析一个Excel
                .getSheet(0)//获取下标为0的Sheet
                .readRows()//读取数据
                .getReadData();//获得读取的数据集合
这种方式我会将每行数据塞入一个ArrayList,单元格值按照列顺序排列
Import.buildXSSFImportExcelWorkBook()
                .parseFile(new File("E://测试.xlsx"))//解析一个Excel
                .getSheet(0)//获取下标为0的Sheet
                .readRows((record, records, rowNum, index) -> {

                    ArrayList<?> _record = (ArrayList<?>) record;//一行行获取数据
                    System.out.println(_record.get(0));//取每条数据的第一列的值

                });
在lambda函数中获取当前读取行的数据
2、指定列值获取数据
ArrayList<HashMap<String, Object>> records = Import.buildXSSFImportExcelWorkBook()
                .parseFile(new File("E://测试.xlsx"))
                .getSheet(0)
                .setColumnFields("username", "password")//设置列值
                .readRows()
                .getReadData();

指定了列值后,默认会将数据注入HashMap,列值为Key,单元格值为Value,如果此时存在没指定列值的单元格,将会使用坐标作为Key,如A1表示第一行第一列,B4表示第四行第二列。
细心会发现,username对应了序号,这是因为设置列值必须自己控制顺序,默认从第一列开始
Import.buildXSSFImportExcelWorkBook()
                .parseFile(new File("E://测试.xlsx"))
                .getSheet(0)
                .setColumnFields(2,"num", "username", "password")//设置列值,2表示标题占用2行,那么接下来读取数据将从第三行开始
                .readRows((record, records, rowNum, index) -> {

                    HashMap<String, Object> _record = (HashMap<String, Object>) record;
                    System.out.println(_record.get(""));
                });
同样可以一行行获取数据

3、使用标题二维数组或者js文件读取Excel(详情见导出)
Import.buildXSSFImportExcelWorkBook()
                .parseFile(new File("E://测试.xlsx"))
                .getSheet(0)
                .parseTitlesJson(Test2.class.getResourceAsStream("/com/xx/xx/xx/xx/user.js"))
                .readRows((record, records, rowNum, index) -> {

                    HashMap<String, Object> _record = (HashMap<String, Object>) record;
                    System.out.println(_record.get(""));
                });
二维数组方式同导出,这里就不写了

4、自定义全局接收数据对象
Import.buildXSSFImportExcelWorkBook()
                .parseFile(new File("E://测试.xlsx"))
                .getSheet(0)
                //解析标题文件,并指定使用LinkedHashMap作为数据容器接收数据
                .parseTitlesJson(Test2.class.getResourceAsStream("/com/xx/xx/xx/xx/user.js"), LinkedHashMap.class)
                .readRows((record, records, rowNum, index) -> {
LinkedHashMap<String, Object> _record = (LinkedHashMap<String, Object>) record;
                    System.out.println(_record.get(""));
                });
Import.buildXSSFImportExcelWorkBook()
                .parseFile(new File("E://测试.xlsx"))
                .getSheet(0)
                //解析标题文件,并指定使用User对象作为数据容器接收数据
                .parseTitlesJson(Test2.class.getResourceAsStream("/com/xx/xx/xx/xx/user.js"), User.class)
                .readRows((record, records, rowNum, index) -> {
                    //这里可以转成User对象获取数据
                    User _record = (User) record;

                    System.out.println(_record.getUsername());
                });

5、自定义行接收对象
Import.buildXSSFImportExcelWorkBook()
                .parseFile(new File("E://测试.xlsx"))
                .getSheet(0)
                .parseTitlesJson(Test2.class.getResourceAsStream("/com/xx/xx/xx/xx/user.js"), HashMap.class)
                .readRows(User.class, (record, records, rowNum, index) -> {
                    //读取行时指定对象,覆盖全局,此时不用强转,可直接推导出类型
                    System.out.println(record.getUsername());
                });

6、连续读取存在的Sheet
Import.buildXSSFImportExcelWorkBook()
                .parseFile(new File("E://测试.xlsx"))
                .readSheets((sheet, index) -> {
                    //读取当前Sheet数据
                    sheet.setColumnFields("")
                            .readRows(User.class, (record, records, rowNum, index1) -> {
                                System.out.println(record.getUsername());
                            });

                });
Import.buildXSSFImportExcelWorkBook()
                .parseFile(new File("E://测试.xlsx"))
                .readSheets((sheet, index) -> {
                    //读取当前Sheet数据
                    sheet.setColumnFields("")
                            .readRows(User.class, (record, records, rowNum, index1) -> {
                                System.out.println(record.getUsername());
                            });

                    if(sheet.getAllReadData().size() > 1000) {
                        //当读取的数据总数大于1000,停止读取下一个Sheet
                        return false;
                    }
                    return true;
                });
读取比较简单,就不详细说了。





Logo

旨在为数千万中国开发者提供一个无缝且高效的云端环境,以支持学习、使用和贡献开源项目。

更多推荐