EasyExcel判断导入时是否符合给定模板

问题描述

在做系统的导入导出模块时需要在导入时判断用户导入的表格是否符合给定的模板,该系统导入导出使用的是EasyExcel,因此在实现该功能时是基于EasyExcel的

解决方案

创建Spring Boot项目,并添加如下依赖

java 复制代码
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>easyexcel</artifactId>
    <version>2.2.7</version>
</dependency>

创建导入时数据对应的实体类,并使用@ExcelProperty注解配置模板表头

java 复制代码
public class EasyExcelData {
    @ExcelProperty(value = "学号", index = 0)
    private String no;
    @ExcelProperty(value = "姓名", index = 1)
    private String name;
    @ExcelProperty(value = "性别", index = 2)
    private String gender;

    private String errorReason;

    public String getNo() {
        return no;
    }

    public void setNo(String no) {
        this.no = no;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getGender() {
        return gender;
    }

    public void setGender(String gender) {
        this.gender = gender;
    }

    public String getErrorReason() {
        return errorReason;
    }

    public void setErrorReason(String errorReason) {
        this.errorReason = errorReason;
    }

    @Override
    public String toString() {
        return "EasyExcelData{" +
                "no='" + no + '\'' +
                ", name='" + name + '\'' +
                ", gender='" + gender + '\'' +
                ", errorReason='" + errorReason + '\'' +
                '}';
    }
}

创建监听类并继承AnalysisEventListener类,重写invokeHeadMap方法,在该方法中判断是否符合模板

java 复制代码
public class EasyExcelDemoListener extends AnalysisEventListener<EasyExcelData> {

    private List<EasyExcelData> correctData = new ArrayList<>();
    private List<EasyExcelData> errorData = new ArrayList<>();

    /**
     * 在这里进行模板的判断
     * @param headMap 存放着导入表格的表头,键是索引,值是名称
     * @param context
     */
    @Override
    public void invokeHeadMap(Map<Integer, String> headMap, AnalysisContext context) {
        /*
        count 记录模板表头有几个,用以判断用户导入的表格是否和模板完全一致
        如果用户导入表格较模板的表头多,但其余符合模板,这样不影响则不需要
         */
        int count = 0;
        // 获取数据实体的字段列表
        Field[] fields = EasyExcelData.class.getDeclaredFields();
        // 遍历字段进行判断
        for (Field field : fields) {
            // 获取当前字段上的ExcelProperty注解信息
            ExcelProperty fieldAnnotation = field.getAnnotation(ExcelProperty.class);
            // 判断当前字段上是否存在ExcelProperty注解
            if (fieldAnnotation != null) {
                ++count;
                // 存在ExcelProperty注解则根据注解的index索引到表头中获取对应的表头名
                String headName = headMap.get(fieldAnnotation.index());
                // 判断表头是否为空或是否和当前字段设置的表头名不相同
                if (StringUtils.isEmpty(headName) || !headName.equals(fieldAnnotation.value()[0])) {
                    // 如果为空或不相同,则抛出异常不再往下执行
                    throw new RuntimeException("模板错误,请检查导入模板");
                }
            }
        }

        // 判断用户导入表格的标题头是否完全符合模板
        if (count != headMap.size()) {
            throw new RuntimeException("模板错误,请检查导入模板");
        }
    }

    /**
     * 在这里可以进行数据的解析,每读取一条数据都会执行这个方法
     * @param easyExcelData 当前读取的数据
     * @param analysisContext
     */
    @Override
    public void invoke(EasyExcelData easyExcelData, AnalysisContext analysisContext) {
        if (StringUtils.isEmpty(easyExcelData.getNo())) {
            easyExcelData.setErrorReason("学号为空");
            errorData.add(easyExcelData);
        } else if (StringUtils.isEmpty(easyExcelData.getName())) {
            easyExcelData.setErrorReason("姓名为空");
            errorData.add(easyExcelData);
        } else if (StringUtils.isEmpty(easyExcelData.getGender())) {
            easyExcelData.setErrorReason("性别为空");
            errorData.add(easyExcelData);
        } else {
            correctData.add(easyExcelData);
        }

    }

    /**
     * 这里是读取完成后执行的方法
     * @param analysisContext
     */
    @Override
    public void doAfterAllAnalysed(AnalysisContext analysisContext) {
        // 打印没有错误的数据
        System.out.println(correctData);
        // 打印有错误的数据
        System.out.println(errorData);
    }
}

进行测试,测试用到的表格可到EasyExcel判断导入时是否符合给定模板测试表格获取

java 复制代码
@Test
public void testEasyExcelReadError() {
    // 读取错误表格
    String fileName = "excel" + File.separator + "demo-error.xlsx";
    EasyExcel.read(fileName, EasyExcelData.class, new EasyExcelDemoListener()).sheet().doRead();
}

@Test
public void testEasyExcelReadCorrect() {
    // 读取正确表格
    String fileName = "excel" + File.separator + "demo-correct.xlsx";
    EasyExcel.read(fileName, EasyExcelData.class, new EasyExcelDemoListener()).sheet().doRead();
}
相关推荐
假客套20 天前
2025 Java EasyExcel 基于Excel模板填充数据 SpringBoot+Mybatis-Flex
java·spring boot·mybatis·easyexcel
地平线here1 个月前
EasyExcel使用导出模版后设置 CellStyle失效问题解决
java·easyexcel·excel 导出
hqxstudying1 个月前
EasyExcel使用
java·easyexcel
递归尽头是星辰2 个月前
大数据场景下数据导出的架构演进与EasyExcel实战方案
大数据·系统架构·easyexcel·大数据导出·导出优化
_修铁路的2 个月前
解决 EasyExcel 填充图片占满单元格问题
java·easyexcel
LUCIAZZZ3 个月前
总结一下常见的EasyExcel面试题
java·spring·操作系统·springboot·poi·easyexcel
A尘埃3 个月前
EasyExcel导入导出
easyexcel
Moshow郑锴3 个月前
SpringBoot3+EasyExcel通过WriteHandler动态实现表头重命名
spring·excel·导出·阿里巴巴·easyexcel·speadsheet
小萌新上大分4 个月前
easyExcel使用案例有代码
java·java-ee·easyexcel·easyexcel使用·web文件导出·easyexcel入门教程
codefly-xtl4 个月前
EasyExcel构建复杂多级表头
java·easyexcel