EasyExcel 使用详解与示例

EasyExcel 详解

1. 简介

EasyExcel 是阿里巴巴开源的一款基于 Java 的 Excel 操作工具，专注于高性能、低内存占用的 Excel 读写。相比 Apache POI，EasyExcel 在处理大数据量时表现更优，尤其适合处理百万行级别的 Excel 文件。

2. 主要特性

• 高性能：采用流式读写模型，内存占用低，适合大数据量处理。
• 易用性：API 设计简洁，支持链式调用。
• 功能丰富：支持 Excel 的读写、样式设置、公式计算等。
• 扩展性强：支持自定义数据转换、样式设置等。

3. 使用步骤

3.1 引入依赖

在 Maven 项目中添加 EasyExcel 依赖：

<dependency>
    <groupId>com.alibabagroupId>
    <artifactId>easyexcelartifactId>
    <version>3.1.1version>
dependency>

3.2 写入 Excel

示例代码：

import com.alibaba.excel.EasyExcel;
import com.alibaba.excel.annotation.ExcelProperty;

import java.util.ArrayList;
import java.util.List;

public class EasyExcelWriteExample {

    public static void main(String[] args) {
        String fileName = "example.xlsx";
        List<DemoData> data = new ArrayList<>();
        for (int i = 0; i < 10; i++) {
            data.add(new DemoData("Name" + i, i));
        }

        EasyExcel.write(fileName, DemoData.class).sheet("Sheet1").doWrite(data);
    }

    public static class DemoData {
        @ExcelProperty("Name")
        private String name;
        @ExcelProperty("Age")
        private int age;

        public DemoData(String name, int age) {
            this.name = name;
            this.age = age;
        }

        // Getters and Setters
    }
}

说明：

• @ExcelProperty 注解用于映射 Excel 列名。
• EasyExcel.write() 方法用于创建写入对象。
• sheet() 方法指定工作表名称。
• doWrite() 方法执行写入操作。

3.3 读取 Excel

示例代码：

import com.alibaba.excel.EasyExcel;
import com.alibaba.excel.annotation.ExcelProperty;

import java.util.ArrayList;
import java.util.List;

public class EasyExcelReadExample {

    public static void main(String[] args) {
        String fileName = "example.xlsx";
        List<DemoData> data = EasyExcel.read(fileName).head(DemoData.class).sheet().doReadSync();

        for (DemoData demoData : data) {
            System.out.println(demoData);
        }
    }

    public static class DemoData {
        @ExcelProperty("Name")
        private String name;
        @ExcelProperty("Age")
        private int age;

        // Getters and Setters

        @Override
        public String toString() {
            return "DemoData{" +
                    "name='" + name + '\'' +
                    ", age=" + age +
                    '}';
        }
    }
}

说明：

• EasyExcel.read() 方法用于创建读取对象。
• head() 方法指定数据模型类。
• sheet() 方法指定工作表。
• doReadSync() 方法同步读取数据。

3.4 复杂样式设置

EasyExcel 支持通过 WriteCellStyle 和 WriteFont 设置单元格样式。

示例代码：

import com.alibaba.excel.EasyExcel;
import com.alibaba.excel.annotation.ExcelProperty;
import com.alibaba.excel.write.metadata.style.WriteCellStyle;
import com.alibaba.excel.write.style.HorizontalCellStyleStrategy;
import org.apache.poi.ss.usermodel.IndexedColors;

import java.util.ArrayList;
import java.util.List;

public class EasyExcelStyleExample {

    public static void main(String[] args) {
        String fileName = "styled_example.xlsx";
        List<DemoData> data = new ArrayList<>();
        for (int i = 0; i < 10; i++) {
            data.add(new DemoData("Name" + i, i));
        }

        WriteCellStyle headWriteCellStyle = new WriteCellStyle();
        headWriteCellStyle.setFillForegroundColor(IndexedColors.GREEN.getIndex());

        WriteCellStyle contentWriteCellStyle = new WriteCellStyle();
        contentWriteCellStyle.setFillForegroundColor(IndexedColors.YELLOW.getIndex());

        HorizontalCellStyleStrategy horizontalCellStyleStrategy = new HorizontalCellStyleStrategy(headWriteCellStyle, contentWriteCellStyle);

        EasyExcel.write(fileName, DemoData.class)
                .registerWriteHandler(horizontalCellStyleStrategy)
                .sheet("Sheet1")
                .doWrite(data);
    }

    public static class DemoData {
        @ExcelProperty("Name")
        private String name;
        @ExcelProperty("Age")
        private int age;

        public DemoData(String name, int age) {
            this.name = name;
            this.age = age;
        }

        // Getters and Setters
    }
}

说明：

• WriteCellStyle 用于设置单元格样式。
• HorizontalCellStyleStrategy 用于应用样式策略。

4. 高级功能

4.1 自定义数据转换

通过实现 Converter 接口，可以自定义数据转换逻辑。

4.2 多 Sheet 操作

支持在一个 Excel 文件中创建多个 Sheet，并进行读写操作。

4.3 大数据量处理

通过分批次读写数据，避免内存溢出。

5. 总结

EasyExcel 是一款功能强大且易于使用的 Excel 操作工具，特别适合处理大数据量的 Excel 文件。通过简洁的 API 和丰富的功能，开发者可以高效地进行 Excel 的读写操作。

6. 参考文档

• EasyExcel GitHub
• EasyExcel 官方文档

希望这份详解能帮助你更好地理解和使用 EasyExcel。如果有更多问题，欢迎继续提问！