关于如何在Springboot项目中通过excel批量导入数据

接口文档

2.5 批量导入学生账号

2.5.1 基本信息

请求路径：/admin/students/batch-import

请求方式：POST

接口描述：通过上传Excel文件批量导入学生账号信息。

2.5.2 请求参数

参数格式：multipart/form-data

参数说明：

参数名称	参数类型	是否必须	备注
file	file	是	包含学生信息的Excel文件。列应对应学生信息字段，如准考证号、姓名、学校等。

2.5.3 响应数据

参数格式：application/json

参数说明：

参数名	类型	是否必须	备注
code	number	必须	响应码，1 代表成功，0 代表失败
msg	string	非必须	提示信息
data	object	非必须	返回的导入结果统计
|- successCount	number	非必须	成功导入的数量
|- failureCount	number	非必须	失败导入的数量
|- errors	array	非必须	导入失败的记录及原因列表（可选）

响应数据样例：

{
   
    "code": 1,
    "msg": "部分导入成功",
    "data": {
   
        "successCount": 98,
        "failureCount": 2,
        "errors": [
            {
    "rowNumber": 5, "examCard": "INVALID_EXAM_CARD", "reason": "准考证号格式错误" },
            {
    "rowNumber": 20, "examCard": "DUPLICATE_EXAM_CARD", "reason": "准考证号已存在" }
        ]
    }
}

具体实现

1.导入依赖

首先在项目的maven仓库中引入poi 相关依赖：

      <!-- poi -->
        <dependency>
            <groupId>org.apache.poi</groupId>
            <artifactId>poi</artifactId>
            <version>3.16</version>
        </dependency>
        <!-- poi-ooxml-->
        <dependency>
            <groupId>org.apache.poi</groupId>
            <artifactId>poi-ooxml</artifactId>
            <version>3.16</version>
        </dependency>

2.批量导入学生账号接口

    /**
     * 批量导入学生账号
     * @param file Excel文件
     * @return 导入结果
     */
    @PostMapping(value = "/students/batch-import")
    @ApiOperation("批量导入学生账号")
    public Result<BatchImportResultVO> batchImportStudents(
            @ApiParam(value = "包含学生信息的Excel文件", required = true)
            @RequestPart("file") MultipartFile file) {
   
        BatchImportResultVO importResult = studentService.batchImportStudents(file);
        
        String message = "导入处理完成.";
        if (importResult.getFailureCount() > 0 && importResult.getSuccessCount() > 0) {
   
            message = "部分导入成功.";
        }
        else if (importResult.getFailureCount() > 0 && importResult.getSuccessCount() == 0) {
   
            message = "导入失败.";
        }
        else if (importResult.getFailureCount() == 0 && importResult.getSuccessCount() > 0) {
   
            message = "全部导入成功.";
        } else if (importResult.getSuccessCount() == 0 && importResult.getFailureCount() == 0) {
   
             message = "未导入任何数据或文件内容为空."; // More specific for no data processed
        }
        // Corrected order: data first, then message
        return Result.success(importResult, message)