当前位置: 首页 > article >正文

JSR 303(即 Bean Validation)是一个通过​​注解在 Java Bean 上定义和执行验证规则​​的规范

🛠️ 一、JSR 303是什么?

JSR 303(Java Specification Requests 303)是Java EE 6的子规范,全称​​Bean Validation​​。它通过注解方式对JavaBean的属性值进行标准化校验,例如检查非空、长度、格式等规则。其参考实现是​​Hibernate Validator​​(与Hibernate ORM无关)

​核心价值​​:
✅ 将校验逻辑从业务代码剥离,提升代码可维护性
✅ 统一校验规则,避免重复编码
✅ 支持编译时和运行时校验,增强数据安全性(防止恶意绕过前端校验)


⚙️ 二、快速入门:基础使用

1️⃣ 环境搭建
  • ​Spring Boot项目​​:添加依赖:
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-validation</artifactId>
</dependency>
  • ​非Spring项目​​:需手动引入validation-apihibernate-validator
2️⃣ 常用内置注解
注解适用类型说明示例
@NotNull任意值不能为null@NotNull(message="ID不能为空")
@NotBlankString非null且去除空格后长度>0@NotBlank(message="用户名必填")
@Size集合/String长度在指定范围内@Size(min=6, max=20, message="密码需6-20位")
@EmailString邮箱格式校验@Email(message="邮箱格式无效")
@PatternString正则表达式匹配@Pattern(regexp="^1[3-9]\\d{9}$", message="手机号格式错误")
@Min/@Max数字类型数值范围限制@Min(value=18, message="年龄需≥18")
3️⃣ 在Controller中使用

通过@Valid@Validated触发校验:

@PostMapping("/user")
public ResponseEntity<String> createUser(@Valid @RequestBody UserDTO user) {// 校验通过才执行业务逻辑return ResponseEntity.ok("创建成功");
}
  • 校验失败会抛出MethodArgumentNotValidException,需全局异常处理

⚡ 三、进阶技巧

1️⃣ 分组校验

解决同一字段在不同场景(如新增/修改)下的差异化校验需求:

// 定义分组接口
public interface AddGroup {}
public interface UpdateGroup {}// 实体类中使用
public class User {@Null(groups = AddGroup.class, message = "新增时ID必须为空")@NotNull(groups = UpdateGroup.class, message = "修改时ID不能为空")private Long id;
}// Controller指定分组
@PostMapping("/update")
public R update(@Validated(UpdateGroup.class) @RequestBody User user) {// ...
}

注:未分组的注解在分组校验中不生效

2️⃣ 自定义校验

​步骤​​:

  1. ​定义注解​​:
    @Target({ElementType.FIELD})
    @Retention(RetentionPolicy.RUNTIME)
    @Constraint(validatedBy = ListValueConstraintValidator.class)
    public @interface ListValue {String message() default "值不在可选范围内";Class<?>[] groups() default {};Class<? extends Payload>[] payload() default {};int[] vals() default {};  // 允许的值列表,如[0,1]
    }

  2. ​实现校验器​​:
    public class ListValueConstraintValidator implements ConstraintValidator<ListValue, Integer> {private Set<Integer> set = new HashSet<>();@Overridepublic void initialize(ListValue constraintAnnotation) {for (int val : constraintAnnotation.vals()) {set.add(val);}}@Overridepublic boolean isValid(Integer value, ConstraintValidatorContext context) {return set.contains(value);}
    }

  3. ​使用自定义注解​​:
    @ListValue(vals = {0, 1}, message = "状态只能是0或1")
    private Integer status;


💎 四、常见问题

  • ​Q:@Valid vs @Validated?​

    • @Valid(JSR标准):不支持分组,可嵌套校验字段。
    • @Validated(Spring扩展):支持分组,不可用于字段
  • ​Q:校验失败如何获取具体错误?​
    在Controller参数中添加BindingResult result,通过result.getFieldErrors()遍历错误详情

  • ​Q:为什么int类型推荐用Integer?​
    @Min等注解在基本类型(如int)上无法处理空值,而Integer可兼容null校验


📚 总结

JSR 303通过​​声明式注解​​简化数据校验。初学者可逐步掌握:
1️⃣ 基础注解 → 2️⃣ Controller集成 → 3️⃣ 分组/自定义校验 → 4️⃣ 全局异常处理
结合Spring生态(如Spring MVC)能极大提升开发效率和系统健壮性

更多实践参考:Hibernate Validator文档或Spring官方教程。

http://www.lryc.cn/news/2394795.html

相关文章:

  • 5G 网络中的双向认证机制解析
  • DAY07:Vue Router深度解析与多页面博客系统实战
  • Drawio编辑器二次开发
  • 1.测试过程之需求分析和测试计划
  • 第三十七天打卡
  • Qt 窗口标志(Window Flags)详解:控制窗口样式与行为
  • ABP VNext + CRDT 打造实时协同编辑
  • 微信小程序真机调试时如何实现与本地开发环境服务器交互
  • Linux: network: dpdk, VF, ip link set down 对VF不生效
  • [春秋云镜] CVE-2023-23752 writeup
  • Java集合操作常见错误与最佳实践
  • CSS专题之水平垂直居中
  • python打卡day41@浙大疏锦行
  • vue3 基本语法 父子关系
  • 算法-js-子集
  • (新)MQ高级-MQ的可靠性
  • Android设置界面层级为最上层实现
  • 云原生微服务架构演进之路:理念、挑战与实践
  • Go语言使用阿里云模版短信服务
  • Leetcode 3231. 要删除的递增子序列的最小数量
  • 4.2.5 Spark SQL 分区自动推断
  • 基于昇腾MindSpeed训练加速库玩转智谱GLM-4-0414模型
  • 【图像处理入门】2. Python中OpenCV与Matplotlib的图像操作指南
  • Spring Boot微服务架构(九):设计哲学是什么?
  • GRCh38版本染色体位置转换GRCh37(hg19)
  • TC/BC/OC P2P/E2E有啥区别?-PTP协议基础概念介绍
  • 解决微信小程序中 Flex 布局下 margin-right 不生效的问题
  • Kafka数据怎么保障不丢失
  • 使用HTTPS进行传输加密
  • AI书签管理工具开发全记录(八):Ai创建书签功能实现