文章目录
- 一、EasyExcel的示例
- 导入依赖
- 创建实体类
- 数据导入和导出
- 二、EasyExcel的作用
- 三、EasyExcel的注解
EasyExcel是一个阿里巴巴开源的excel处理框架,它以使用简单、节省内存著称。在解析Excel时,EasyExcel没有将文件数据一次性全部加载到内存中,而是从磁盘上一行行读取数据,逐个解析。这种一行一行的解析模式,使得EasyExcel在处理大数据量的Excel文件时,性能非常高效。
本文先展示示例,后对EasyExcel做些简单介绍。
一、EasyExcel的示例
本文简单介绍EasyExcel的使用,使用xlsx文件读入。
导入依赖
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>easyexcel</artifactId>
<version>3.3.1</version>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.18.20</version>
</dependency>
创建实体类
@Data
// 行高
@HeadRowHeight(15)
// 行宽
@ColumnWidth(20)
public class ExcelEntity implements Serializable {
// @ExcelProperty(index = 0, value = "data") 列顺序
@ExcelProperty("用户姓名")
private Integer name;
// @ExcelIgnore 不生效
@ExcelProperty("用户工号")
private String userId;
@ExcelProperty("用户权限")
private String role;
@ExcelProperty("用户部门")
private Integer part;
}
数据导入和导出
实现一个数据例子:将Excel文件中(初始sheet)所有用户部门的人员进行分类,导出到原Excel的(调整sheet)。这个例子是读取一个Excel的sheet表格
首先创建Excel表格,新建一个origin的sheet。新建一个Listener监听器,用于逐行读取数据。
public class TestDataListener extends AnalysisEventListener<TestExcelEntity>{
private List<TestExcelEntity> list = new ArrayList<>();
@Override
public void invoke(TestExcelEntity data, AnalysisContext context) {
System.out.println(data); // 可以看到每一行的数据
list.add(data);
}
@Override
public void doAfterAllAnalysed(AnalysisContext context) {
System.out.println("WriterExcelEntity All data analyzed");
}
public List<TestExcelEntity> getList() {
return list;
}
public void setList(List<TestExcelEntity> list) {
this.list = list;
}
}
新建执行代码
public class Test {
public static void main(String[] args) throws FileNotFoundException {
// 利用监听器读取Excel文件
TestDataListener testDataListener = new TestDataListener();
String path = "C:\\Users\\Desktop\\test.xlsx";
ExcelReader excelReader = EasyExcel.read(path, TestExcelEntity.class, testDataListener).build();
ReadSheet esgReadSheet = EasyExcel.readSheet(0, "origin").build();
excelReader.read(esgReadSheet);
excelReader.finish();
List<TestExcelEntity> greenBondEntities = testDataListener.getList();
// 对获取到的数据进行排序,并转换成 Map 数据格式
greenBondEntities.sort((u1, u2) -> u1.getRole().compareTo(u2.getRole()));
Map<String, List<TestExcelEntity>> map =
greenBondEntities.stream().collect(Collectors.groupingBy(TestExcelEntity::getRole));
// 根据业务操作
List<TestExcelEntity> res = new ArrayList<>();
map.entrySet().stream().forEach(entry -> {
List<TestExcelEntity> list = entry.getValue();
for (int i = 0; i < list.size(); i++) {
TestExcelEntity test = new TestExcelEntity();
if (i == 0) {
test.setRole(list.get(i).getRole());
test.setName(list.get(i).getName());
test.setUserId(list.get(i).getUserId());
test.setPart(list.get(i).getPart());
} else {
test.setName(list.get(i).getName());
test.setUserId(list.get(i).getUserId());
test.setPart(list.get(i).getPart());
}
res.add(test);
}
});
EasyExcel.write("C:\\Users\\Desktop\\res.xlsx", TestExcelEntity.class)
.sheet(0,"update")
.doWrite(res);
}
}
导出后的Excel如下图所示:
如果想要读取多个sheet表格:
// 读取多条sheet
@Test
public void read() {
TestDataListener testDataListener = new TestDataListener();
String path = "C:\\Users\\Desktop\\test.xlsx";
ExcelReader excelReader = EasyExcel.read(path, TestExcelEntity.class, testDataListener).build();
List<ReadSheet> sheets = excelReader.excelExecutor().sheetList();
for (ReadSheet sheet : sheets) {
String sheetName = sheet.getSheetName();
System.out.println(sheetName);
ReadSheet readSheet = EasyExcel.readSheet(sheetName).build();
excelReader.read(readSheet);
}
excelReader.finish();
}
二、EasyExcel的作用
高效性能
:EasyExcel在处理大型Excel文件时具有出色的性能。它采用了基于流的读写方式,能够快速处理大量数据,显著提高了读写效率。同时,EasyExcel针对大数据量处理进行了优化,提供了分批读写
、内存优化
等策略,保证了处理大型Excel文件时的高效性
和稳定性
。简洁易用
:EasyExcel提供了简洁而强大的API,可以轻松地读取、写入和操作Excel文件,减少了繁琐的操作和代码量。低内存占用
:与传统的Excel文件读取方式相比,EasyExcel显著降低了内存占用。它采用基于事件驱动
的模型,通过回调函数
来处理每一行数据,而不是一次性将整个文件读入内存。这种流式的处理方式极大地节省了内存资源,使得处理大文件时更加稳定可靠。支持多种格式和复杂操作
:EasyExcel支持多种Excel文件格式,包括.xls
、.xlsx
、.xlsm
等,使得它在处理不同版本的Excel文件时具有更大的灵活性。同时,它还支持处理复杂的Excel表格,包括合并单元格、样式、图表等,满足各种复杂场景的需求。强大的扩展性
:EasyExcel提供了丰富的扩展接口,开发者可以根据自己的需求轻松定制Excel文件的读写操作,满足各种复杂场景的需求。比如支持自定义转换器,使得数据格式的处理更为灵活。
EasyExcel在处理Excel文件时具有高效、简洁、低内存占用、支持多种格式和复杂操作以及强大的扩展性等优点,这使得它在 大数据量
的Excel操作场景下成为一个非常不错的选择。然而,也需要注意到,虽然EasyExcel有很多优点,但它可能还需要额外引入依赖包,这可能会增加项目的复杂度。因此,在选择是否使用EasyExcel时,需要综合考虑项目的具体需求和实际情况。
三、EasyExcel的注解
@ExcelProperty
:这是用于指定Java对象中的字段与Excel表格中的列的映射关系
的注解。通过设置该注解的value
属性,可以指定列名。设置index
属性,可以指定列名的序号,从而实现字段与列的对应关系。@ExcelIgnore
:这个注解用于指定Java对象中的字段在Excel中的读写操作中被忽略。当需要在Excel文件中忽略某个字段时,可以在该字段上添加此注解。@ContentFontStyle
:用于设置字体样式。@ContentLoopMerge
:用于合并单元格。@ContentRowHeight
:用于设置行高
。@ContentStyle
:用于设置内容格式。@HeadFontStyle
:用于定制标题字体格式。@HeadRowHeight
:用于设置标题行行高
。@HeadStyle
:用于设置标题样式。@ColumnWidth
:用于设置列宽
。@DateTimeFormat
:日期格式化。@NumberFormat
:数字格式化。