easyExcel 注解校验导入不能为空

### EasyExcel 注解校验导入字段不能为空的解决方案 为了确保导入的数据满足特定条件，特别是防止某些字段为空的情况发生，在Java项目中可以利用EasyExcel库提供的注解机制来实现这一目标。具体来说，通过在实体类的相关属性上添加`@RequiredValid`注解，并指定当该字段为空时返回的信息。 #### 定义带有非空验证的实体类 下面是一个具体的例子，展示了如何创建一个用于表示用户信息的实体类`UserFileDataVO`，其中包含了两个必需填写的字段——用户名(`userName`)和电子邮件地址(`email`)： ```java import com.alibaba.excel.annotation.ExcelProperty; import lombok.Data; @Data public class UserFileDataVO { @RequiredValid(message = "姓名字段不能为空!") @ExcelProperty(value = "姓名") private String userName; @ExcelProperty(value = "年龄") private int age; @RequiredValid(message = "邮箱字段不能为空!") @ExcelProperty(value = "邮箱") private String email; } ``` 此代码片段中的`@RequiredValid`注解用来标记哪些字段是必填项以及提供相应的错误消息[^2]。 #### 自定义监听器并执行校验逻辑 除了设置好实体外，还需要编写自定义事件监听器继承于`AnalysisEventListener<T>`，以便能够在读取每一行记录之后立即对其进行有效性检查。在这个过程中调用之前提到过的`check()`方法完成实际的检验工作。对于不符合要求的数据条目，则将其对应的错误描述收集起来供后续反馈给最终使用者。 ```java @Override public void invoke(UserFileDataVO data, AnalysisContext context) { List<String> errors = new ArrayList<>(); if (data.getUserName() == null || "".equals(data.getUserName().trim())) { errors.add("第" + context.readRowHolder().getRowIndex() + "行 姓名字段不能为空!"); } if (data.getEmail() == null || "".equals(data.getEmail().trim())) { errors.add("第" + context.readRowHolder().getRowIndex() + "行 邮箱字段不能为空!"); } // 如果存在任何错误则保存至列表或其他存储结构中... if (!errors.isEmpty()) { errorList.addAll(errors); } } ``` 上述代码实现了对每一条记录的基本非空检测功能，并且能够定位到具体的哪一行出现了问题[^1]。 #### 封装通用的校验工具 考虑到不同业务场景下可能涉及到多种类型的约束条件（比如长度限制、格式匹配等），因此建议进一步抽象出一套灵活可扩展的价值核查框架。这可以通过定义类似于`ValueChecker`这样的接口来达成目的，它允许开发者针对不同的需求轻松地注册新的规则处理器[^3]。 ```java package com.zhou.util.easyexcel.checker; public interface ValueChecker { /** * 实现校验逻辑 */ boolean check(Object value); /** * 获取校验类型 */ RowCheckType getType(); /** * 获取默认校验提示 */ String getDefaultMessage(); } ``` 综上所述，借助于EasyExcel的强大特性和良好的设计模式支持，完全可以构建起既高效又易于维护的数据导入流程控制系统。