Java-Maven-POI 简单导入导出Excel通用工具,默认使用基于poi实现
·
个人项目
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、格式化单元格
- 除了标题单元格可以自定义,数据单元格同样可以自定义(格式化)
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、同样先来几个简单的例子
1、同样先来几个简单的例子
ArrayList<ArrayList<String>> records = Import.buildXSSFImportExcelWorkBook()
.parseFile(new File("E://测试.xlsx"))//解析一个Excel
.getSheet(0)//获取下标为0的Sheet
.readRows()//读取数据
.getReadData();//获得读取的数据集合
这种方式我会将每行数据塞入一个ArrayList,单元格值按照列顺序排列
2、指定列值获取数据
指定了列值后,默认会将数据注入HashMap,列值为Key,单元格值为Value,如果此时存在没指定列值的单元格,将会使用坐标作为Key,如A1表示第一行第一列,B4表示第四行第二列。
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());
});
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;
});
读取比较简单,就不详细说了。
更多推荐
已为社区贡献2条内容
所有评论(0)