文章目录
- 一、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<>();@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：数字格式化。
)
