Java项目如何使用EasyExcel插件对Excel数据进行导入导出

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<>();@Overridepublic void invoke(TestExcelEntity data, AnalysisContext context) {System.out.println(data);  // 可以看到每一行的数据list.add(data);}@Overridepublic 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 ：数字格式化。