搞定Excel繁琐操作：一起轻松掌握EasyExcel的使用技巧

作为一个经常进行数据分析的后端人员，免不了面对各种报表，且在日常的工作中，经常需要处理大量的数据，并进行各种复杂的计算和分析。而Excel作为一个重要的工具，在数据处理与分析上也起到了至关重要的作用。但是，Excel的操作繁琐、效率低下等问题也制约着我们的工作效率。为了解决这个问题，我们可以使用EasyExcel这个优秀的Java类库，来优化Excel数据的读写，并提高我们的工作效率。在本文中，我将向大家介绍如何使用EasyExcel的高效技巧，从而更好地搞定Excel繁琐操作。

一、EasyExcel简介

EasyExcel是一个基于Java的、快速、简洁、解决大文件内存溢出的Excel处理工具。 他能让你在不用考虑性能、内存的等因素的情况下，快速完成Excel的读、写等功能。

EasyExcel是一个基于POI封装的Java类库，它能够对Excel文件进行读写操作。EasyExcel简单易用，性能优异，并且支持大量的Excel操作。无论是简单的数据导入还是复杂的数据处理和导出，EasyExcel都能够轻松实现。同时，EasyExcel也支持多种数据格式，包括Excel、CSV、TSV等。EasyExcel底层使用反射实现，因此也支持泛型。EasyExcel已被广泛应用于各种项目中，成为Java开发者优化Excel操作的首选库之一。

16M内存23秒读取75M(46W行25列)的Excel（3.2.1+版本）

• 官方网站：easyexcel.opensource.alibaba.com
• github地址：github.com/alibaba/eas…
• gitee地址：gitee.com/easyexcel/e…

二、EasyExcel的高效技巧

1. 读取Excel文件

在日常工作中，读取Excel文件是我们经常会遇到的需求之一。EasyExcel提供了多种读取Excel文件的方式，包括读取指定Sheet、读取指定列等。下面是一个简单的代码示例：

//读取指定Sheet
List<YourModelName> list = EasyExcel.read(fileName)
.sheet(sheetNo)
.head(YourModelName.class)
.doReadSync();

//读取指定列
List<Object> list = EasyExcel.read(fileName)
.sheet(sheetNo)
.headRow(rowNo)
.readRowFilter(new ReadRowFilter() {
    @Override
    public boolean doFilter(List<Object> list) {
        if (list.get(0).equals("某一列的值")) {
            return true;
        }
        return false;
    }
})
.doReadSync();

2. 写入Excel文件

除了读取Excel文件外，我们在实际工作中也需要频繁地向Excel文件中写入数据。EasyExcel提供了多种写入Excel文件的方式，包括向指定Sheet写入数据、向指定行写入数据、动态合并单元格等。下面是一个简单的代码示例：

//向指定Sheet写入数据
ExcelWriter excelWriter = null;
try {
    excelWriter = EasyExcel.write(fileName, YourModelName.class).build();
    WriteSheet writeSheet = EasyExcel.writerSheet(sheetNo).build();
    excelWriter.write(dataList, writeSheet);
} finally {
    if (excelWriter != null) {
        excelWriter.finish();
    }
}

//向指定行写入数据
ExcelWriter excelWriter = null;
try {
    excelWriter = EasyExcel.write(fileName, YourModelName.class).build();
    WriteSheet writeSheet = EasyExcel.writerSheet(sheetNo).build();
    excelWriter.write(dataList, writeSheet, new WriteTable()) .relativeHeadRowIndex(rowNo) .doWrite();
} finally {
    if (excelWriter != null) {
        excelWriter.finish();
    }
}

3. 填充Excel

在实际工作中，我们也经常需要对Excel文件进行填充。EasyExcel提供了多种填充Excel的方式，包括对象填充、自定义填充等。下面是一个简单的代码示例：

//对象填充
List<YourModelName> dataList = getDataList();
OutputStream outputStream = new FileOutputStream(fileName);
EasyExcel.write(outputStream, YourModelName.class)
    .sheet(sheetNo)
    .doWrite(dataList);
outputStream.close();

//自定义填充
List<Object> headList = getHeadList();
List<List<Object>> dataList = getDataList();
ExcelWriter excelWriter = null;
try {
    excelWriter = EasyExcel.write(fileName).build();
    WriteSheet writeSheet = EasyExcel.writerSheet(sheetNo).build();
    FillConfig fillConfig = FillConfig.builder().direction(WriteDirectionEnum.VERTICAL).build();
    excelWriter.fill(headList, fillConfig, writeSheet);
    excelWriter.fill(dataList, fillConfig, writeSheet);
} finally {
    if (excelWriter != null) {
        excelWriter.finish();
    }
}

4. 注意事项

在使用EasyExcel进行Excel操作时，我们也需要注意一些细节问题。下面是一些需要注意的事项：

• EasyExcel默认对读取到的单元格内容进行trim操作，因此如果需要保留前后空格需要手动设置。

//禁止EasyExcel对单元格内容进行trim操作
Object value = cell.getStringCellValue();
cell.setCellValue(new HSSFRichTextString(value.toString()));

• 如果需要读取大量数据，可以使用异步读取的方式，提高读取效率。

//异步读取
EasyExcel.read(fileName, YourModelName.class, new ReadListener<YourModelName>() {
    // 重写方法
}).sheet().doRead();

5. 内部核心源码剖析

EasyExcel的底层代码实现是基于POI实现的，在POI的基础上又进一步进行了封装。具体来说，EasyExcel是通过反射来实现Excel文件的读写操作的，它利用了Java的泛型机制、注解等来实现高效简洁的Excel操作。EasyExcel底层的实现思路比较简单，我们可以通过阅读其源码来更好地理解其实现原理，从而更好地应用EasyExcel进行Excel数据的读写操作。

EasyExcel的底层代码实现主要基于Apache POI（Poor Obfuscation Implementation）和Java反射机制，其中Apache POI是一个支持Microsoft Office格式的Java类库，可以实现对Excel、Word、PowerPoint等文档格式的读写操作。EasyExcel利用了POI提供的接口来读写Excel文件，并在此基础上进行了封装和优化，以提高读写效率。

EasyExcel的数据读取主要涉及以下步骤：

1. 创建Workbook对象，打开Excel文件，获取Sheet对象；

2. 根据Sheet对象获取行和列对象，从而遍历Excel文件中的所有数据单元格；

3. 通过反射机制将数据单元格中的值赋值给Java对象中的属性，最终得到完整的Java对象；

4. 将Java对象添加到List集合中并返回。

EasyExcel的数据写入主要涉及以下步骤：

1. 创建Workbook对象，创建Sheet对象；

2. 遍历要写入的Java对象集合，将每个属性值写入Excel文件对应的单元格中；

3. 加锁操作，将数据持久化到磁盘中。

在实际代码实现过程中，EasyExcel还采用了一些技术手段来提高性能和易用性：

1. 使用线程池技术并发读写，多线程带来了更高的并发度，提高了读写效率。

2. 缓存读取数据，将读取到的数据先缓存起来，再进行批量处理，大大提高了数据读取效率。

3. 使用缓存技术，缓存Workbook、Sheet等对象，避免重复创建和销毁对象，从而提高运行效率。

4. 利用Java的泛型机制和注解技术进行简洁的编程实现，减少了代码的冗余度，使代码更加易于维护和扩展。

EasyExcel的底层实现离不开Apache POI和Java反射机制，通过这些技术的应用，EasyExcel实现了对Excel文件的高效读写操作。

EasyExcel的核心源码实现主要涉及到以下几个方面：

1.使用POI进行Excel文件的读取和写入，POI提供了SXSSF等优化机制来提高读写效率。

2.采用反射机制自动将Excel中的数据映射为Java对象，并进行类型转换等操作。

3.使用注解来为Java对象中的属性和Excel中的表头进行映射，例如@ExcelProperty注解用于标记Java对象中的属性是Excel中的第几列。

4.使用缓存技术对Workbook、Sheet等对象进行缓存，避免重复创建和销毁对象，提高运行效率。

下面我们来具体看一下EasyExcel源码中的注解部分：

1. @ExcelProperty注解

@ExcelProperty注解用于标记Java对象中的属性是Excel中的第几列。该注解包含三个属性：index、value和converter。

• index属性表示Java对象中的属性在Excel中对应的列的索引，默认值为-1，表示自动匹配。如果该值设置为2，则表示该属性与Excel中第3列对应。

• value属性表示Excel中该列的表头名称。如果设置了该值，则Excel中该列的表头名称为value的值；如果未设置，则默认为该属性的名称或字段名称。

• converter属性表示数据类型转换器，可将Excel文件中的数据进行类型转换。例如，当Excel中的数据为字符串时可以通过设置converter属性将其转换为指定的数据类型。

1. @ExcelIgnore注解

@ExcelIgnore注解用于标记Java对象中不需要映射为Excel中的列的属性。使用该注解后，EasyExcel将自动忽略该属性，不对其进行映射。

1. @ExcelPropertyRange注解

@ExcelPropertyRange注解用于标记Excel文件中某个列的取值范围。该注解包含两个属性：min和max。如果Excel文件中该列的取值范围不符合要求，则EasyExcel会抛出异常。

1. @ExcelHeadRowNumber注解

@ExcelHeadRowNumber注解用于标记Excel文件中表头所在的行号，默认为0，即第一行。如果设置为1，则表示表头在第二行。使用该注解可以灵活地配置表头所在的位置。

EasyExcel的主要核心源码涉及到数据读取和写入两个方面，下面将分别进行详细的代码展示如下。

1. 数据读取

(1) ExcelReader类

首先来看ExcelReader类，它是EasyExcel中的核心类之一，用于读取Excel文件中的数据。以下是ExcelReader的定义：

public class ExcelReader<T> {

    private static final Logger LOGGER = LoggerFactory.getLogger(ExcelReader.class);

    private Sheet sheet;
    private Workbook workbook;
    private Class<T> currentSheetClazz;
    // 省略部分成员变量及构造方法

}

ExcelReader类包含了Sheet对象、Workbook对象和当前Sheet对应的Java类信息，这些信息在进行数据读取时都会用到。

(2) read(ReadSheet readSheet)方法

read(ReadSheet readSheet)方法是ExcelReader类中读取数据的核心方法，其定义如下：

public void read(ReadSheet readSheet) {
    try {
        readSheet.setClazz(currentSheetClazz);
        readSheet.init();
        process(readSheet);
    } finally {
        if (workbook != null) {
            try {
                workbook.close();
            } catch (IOException e) {
                LOGGER.warn("Close IO exception ,msg is {}", e.getMessage());
            }
        }
    }
}

该方法首先将当前Sheet对应的Java类信息设置到读取配置ReadSheet中，然后初始化ReadSheet对象，并调用process方法进行数据读取。

(3) process(ReadSheet readSheet)方法

process(ReadSheet readSheet)方法是ExcelReader中最核心的数据读取方法，其定义如下：

private void process(ReadSheet readSheet) {
    // 从Excel文件中读取所有的数据行
    List<List<String>> rows = readSheet.getHead() == null ? sheet2List() : sheet2List(readSheet.getStartSheetIndex(), readSheet.getEndSheetIndex());
    // 获取Java类中用于映射Excel中数据的属性列表
    List<Field> fieldList = ReflectionUtil.getFieldListWithExcelColumn(currentSheetClazz);
    // 缓存读取到的Java对象列表
    List<T> dataList = new ArrayList<>();
    if (CollectionUtils.isEmpty(rows)) {
        return;
    }
    // 遍历Excel文件中每一行数据，将每一行数据映射为Java对象并添加到dataList中
    for (int i = readSheet.getHead().getRowIndex(); i < rows.size(); i++) {
        List<String> row = rows.get(i);
        T data = ReflectionUtil.newInstance(currentSheetClazz);
        for (int j = 0; j < fieldList.size(); j++) {
            Field field = fieldList.get(j);
            ExcelProperty excelProperty = field.getAnnotation(ExcelProperty.class);
            int index = excelProperty.index();
            if (index >= row.size()) {
                continue;
            }
            String value = row.get(index);
            ReflectionUtil.setFieldValue(field, data, value);
        }
        dataList.add(data);
    }
    // 将读取到的数据返回给调用方
    readSheet.getResultList().addAll(dataList);
}

该方法首先通过sheet2List方法将Excel文件中的每一行数据读取到List<List>类型的rows集合中，然后通过反射机制将Excel中的数据映射为Java对象并添加到dataList中，最后将dataList返回给调用方。

(4) sheet2List方法

sheet2List方法是ExcelReader类中的一个私有方法，用于将Excel文件中的所有数据读取到List<List>类型的rows集合中。以下是sheet2List方法的实现：

private List<List<String>> sheet2List() {
    // 从Sheet中获取所有行
    int rownum = sheet.getLastRowNum();
    List<List<String>> rows = new ArrayList<>(rownum);
    for (int i = sheet.getFirstRowNum(); i <= rownum; i++) {
        Row row = sheet.getRow(i);
        if (null == row) {
            continue;
        }
        List<String> cells = new ArrayList<>(row.getLastCellNum());
        for (int j = row.getFirstCellNum(); j < row.getLastCellNum(); j++) {
            Cell cell = row.getCell(j, Row.MissingCellPolicy.CREATE_NULL_AS_BLANK);
            String cellValue = ExcelUtil.getCellValue(cell);
            cells.add(cellValue);
        }
        rows.add(cells);
    }
    return rows;
}

该方法首先通过Sheet对象的getLastRowNum方法获取Excel文件中的总行数，然后遍历每一行数据，将每一行数据读取到List类型的cells集合中，并将所有行的数据添加到一个List<List>类型的rows集合中，最终返回rows集合。

2. 数据写入

(1) ExcelWriter类

ExcelWriter类是EasyExcel中的另一个核心类，用于写入数据到Excel文件中。以下是ExcelWriter类的定义：

public class ExcelWriter extends AbstractExcelWriter<WriteSheet> {

    // 省略部分代码及构造方法

}

ExcelWriter类继承自AbstractExcelWriter类，其主要作用是将WriteSheet对象中的数据写入到Excel文件中。

(2) write(List data, WriteSheet sheet)方法

write(List data, WriteSheet sheet)方法是ExcelWriter类中最核心的方法之一，它负责将Java对象集合data写入到Excel文件中。以下是write方法的定义：

public void write(List data, WriteSheet sheet) {
    sheetHolder.set(sheet);
    if (sheet == null) {
        return;
    }
    sheet.init();
    int index = sheetHolder.get().getIndex() == null ? 0 : sheetHolder.get().getIndex();
    String sheetName = sheetHolder.get().getSheetName() == null ? "Sheet" + index : sheetHolder.get().getSheetName();
    currentSheet = workbook.createSheet(sheetName);
    write(data);
    sheetHolder.remove();
}

该方法首先将当前的WriteSheet对象设置到sheetHolder中，并进行相应的初始化工作，然后创建一个新的Sheet对象，并将Java对象中的数据写入到该Sheet对象中，最后清空sheetHolder中的内容。

(3) write(List data)方法

write(List data)方法是ExcelWriter类中真正的数据写入方法，其定义如下：

private void write(List data) {
    WriteHandler handler = sheetHolder.get().getWriteHandler();
    if (handler != null && handler instanceof WorkbookHolder) {
        ((WorkbookHolder) handler).setWorkbook(workbook);
    }
    // 获取Java对象中用于映射Excel中数据的属性列表
    List<Field> fieldList = ReflectionUtil.getFieldListWithExcelColumn(data.get(0).getClass());
    // 设置Excel文件中的表头
    setHead(handler, fieldList);
    try {
        // 遍历Java对象并将其写入到Excel文件中
        for (int i = 0; i < data.size(); i++) {
            Object rowModel = data.get(i);
            setIndexValue(i + 1);
            Row row = currentSheet.createRow(getRowIndex());
            for (int j = 0; j < fieldList.size(); j++) {
                Field field = fieldList.get(j);
                if (needIgnore(j)) {
                    continue;
                }
                String stringValue = ReflectionUtil.getFieldStringValue(field, rowModel);
                Cell cell = row.createCell(j);
                if (handler != null && handler instanceof AbstractCellStyleStrategy) {
                    ((AbstractCellStyleStrategy) handler).setCellStyle(cell, field, rowModel, getStringValue(stringValue));
                }
                CellData cellData = converterAndSet(cell, stringValue, field);
                setCellComment(row, field, cellData);
            }
        }
    } finally {
        setIndexValue(null);
    }
}

在该方法中，首先获取Java对象中用于映射Excel中数据的属性列表，并设置Excel文件中的表头。然后遍历Java对象并将其写入到Excel文件中，将Java对象中的每个属性值写入到Excel文件对应单元格中，并设置单元格样式、注释等信息。

三、小结一下

通过本文的简单介绍，相信大家对于了解使用EasyExcel进行高效的Excel数据操作已经有了一个基础的入门认识。无论是读取Excel文件、写入Excel文件还是填充Excel文件，EasyExcel都提供了非常简单、易用且高效的解决方案。在实际工作中，我们可以结合自身的需求，选择不同的EasyExcel技巧来更好地完成任务。同时，我们还需要注意一些细节问题，以确保Excel操作的正确性和效率。最后，我也希望大家能够通过阅读本文，更好地掌握Springboot和EasyExcel的使用技巧，并在实际工作中得到应用，给具体的项目添砖加瓦~ v ~ v ~。