Java中使用SpringBoot和Apache POI实现Excel导入导出功能详解

在Java开发中，经常会遇到需要处理Excel文件的场景，例如报表的生成、数据的批量导入导出等。SpringBoot因其快速开发、简化配置的特点，配合Apache POI库强大的Excel处理能力，可以高效地完成这些任务。本文将详细介绍如何使用SpringBoot和Apache POI实现Excel的读取和写入操作。

环境搭建

首先，我们需要在项目的pom.xml文件中添加Apache POI的依赖。

<dependencies>
    <! Apache POI dependency for handling Excel files >
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi</artifactId>
        <version>RELEASE</version>
    </dependency>
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poiooxml</artifactId>
        <version>RELEASE</version>
    </dependency>
    <! Other dependencies >
</dependencies>

实现Excel读取

1. 创建实体类

以一个简单的用户信息表为例，创建对应的实体类UserDto。

@Data
@TableName("user")
public class UserDto {
    @ExcelImport("用户ID")
    private String id;
    @ExcelImport("用户名")
    private String username;
    @ExcelImport("密码")
    private String password;
    // 省略其他字段...
}

2. 编写读取Excel的工具类

创建一个工具类ExcelUtils，用于读取Excel文件。

public class ExcelUtils {
    public static <T> List<T> readMultipartFile&#40;MultipartFile file, Class<T> clazz&#41; throws IOException {
        // Apache POI读取Excel文件的逻辑...
        return Collections.emptyList(); // 返回读取的数据列表
    }
}

3. 创建Service接口及实现类

定义UserService接口和实现类，用于处理Excel数据的业务逻辑。

public interface UserService {
    void importUsers(MultipartFile file);
}

@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, UserDto> implements UserService {
    @Override
    public void importUsers(MultipartFile file) {
        List<UserDto> userDtos = excelUtils.readMultipartFile&#40;file, UserDto.class&#41;;
        // 处理读取的数据...
    }
}

实现Excel写入

1. 创建数据库实体类

创建与数据库表结构对应的实体类ReportDto。

@Data
@TableName("report")
public class ReportDto {
    @ExcelExport("报告ID")
    private String id;
    @ExcelExport("报告标题")
    private String title;
    @ExcelExport("创建日期")
    private Date createDate;
    // 省略其他字段...
}

2. 编写写入Excel的工具类

在ExcelUtils工具类中添加写入Excel文件的方法。

public class ExcelUtils {
    // ...读取Excel的逻辑...

    public static void writeListToExcel(List<?> list, HttpServletResponse response) throws IOException {
        // Apache POI写入Excel文件的逻辑...
    }
}

3. 创建Service接口及实现类

定义ReportService接口和实现类，用于生成报告并导出Excel。

public interface ReportService {
    void generateReportAndExportExcel(List<ReportDto> reportList);
}

@Service
public class ReportServiceImpl implements ReportService {
    @Autowired
    private ExcelUtils excelUtils;

    @Override
    public void generateReportAndExportExcel(List<ReportDto> reportList) {
        excelUtils.writeListToExcel(reportList, response);
        // 处理导出的逻辑...
    }
}

常见问题及解决方案

通过本文的介绍，我们学习了如何在SpringBoot项目中使用Apache POI库来处理Excel文件。我们创建了实体类，编写了读取和写入Excel的工具类，并在Service层中实现了业务逻辑。同时，我们还讨论了一些常见的问题及其解决方案。希望本文能够帮助到需要在Java项目中处理Excel文件的开发者。