用EasyPOI轻松实现Excel导入导出_快速掌握数据交互技巧

使用EasyPOI轻松实现Excel导入导出

EasyPOI是基于Apache POI封装的工具库，简化了Excel、Word等文档的读写操作，尤其适合Java开发者快速实现Excel的导入导出功能。以下是基于EasyPOI实现Excel导入导出的完整指南。

一、环境准备

引入依赖
在Maven项目的pom.xml中添加EasyPOI依赖：

<dependency>
    <groupId>cn.afterturn</groupId>
    <artifactId>easypoi-base</artifactId>
    <version>4.4.0</version> <!-- 请根据版本调整 -->
</dependency>

基础要求
- JDK 8+
- Apache POI依赖已包含在EasyPOI中，无需额外引入。

二、Excel导出实现

1. 定义实体类

使用EasyPOI注解标注导出字段：
```java
import cn.afterturn.easypoi.excel.annotation.Excel;

public class User {
@Excel(name = "用户ID", orderNum = "0")
private Long id;

@Excel(name = "用户名", orderNum = "1")
private String name;

@Excel(name = "邮箱", orderNum = "2")
private String email;

// Getters and Setters

}
```

2. 导出代码示例

```java
import cn.afterturn.easypoi.excel.ExcelExportUtil;
import cn.afterturn.easypoi.excel.entity.ExportParams;
import org.apache.poi.ss.usermodel.Workbook;

import java.io.FileOutputStream;
import java.util.ArrayList;
import java.util.List;

public class ExcelExportExample {
public static void main(String[] args) throws Exception {
// 模拟数据
List userList = new ArrayList<>();
userList.add(new User(1L, "张三", "zhangsan@example.com"));
userList.add(new User(2L, "李四", "lisi@example.com"));

    // 导出参数
    ExportParams params = new ExportParams("用户信息表", "用户数据");

    // 生成Workbook
    Workbook workbook = ExcelExportUtil.exportExcel(params, User.class, userList);

    // 写入文件
    try (FileOutputStream fos = new FileOutputStream("用户信息表.xlsx")) {
        workbook.write(fos);
    }
    System.out.println("导出成功！");
}

}
```

三、Excel导入实现

1. 定义实体类（与导出一致）

确保字段注解与导出时相同，以便映射数据。

2. 导入代码示例

```java
import cn.afterturn.easypoi.excel.ExcelImportUtil;
import cn.afterturn.easypoi.excel.entity.ImportParams;

import java.io.File;
import java.util.List;

public class ExcelImportExample {
public static void main(String[] args) throws Exception {
// 导入参数
ImportParams params = new ImportParams();
params.setTitleRows(1); // 表头行数
params.setHeadRows(1); // 列头行数

    // 读取Excel文件
    File file = new File("用户信息表.xlsx");
    List<User> userList = ExcelImportUtil.importExcel(file, User.class, params);

    // 输出结果
    for (User user : userList) {
        System.out.println(user);
    }
}

}
```

四、关键功能解析

注解驱动
- @Excel：标注导出字段，支持name（列名）、orderNum（列顺序）等属性。
- @ExcelEntity：用于嵌套对象导出。
- @ExcelCollection：用于集合类型导出。
导出参数
- ExportParams：设置标题、sheet名称、是否需要创建表头等。
导入参数
- ImportParams：配置表头行数、起始行数、是否校验等。
模板导出
EasyPOI支持基于模板的导出，可通过.xls模板文件定义复杂格式。