Java类属性字段校验（validation的使用）

最新推荐文章于 2024-08-15 17:22:10 发布
最新推荐文章于 2024-08-15 17:22:10 发布
阅读量1.8w 收藏 87
点赞数 23
分类专栏： Java 文章标签： java validation
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/rao991207823/article/details/117001686
版权

Java类属性字段校验（validation的使用）

1、需求来源：日常校验需求

日常开发中，我们时常需要提供可靠的 API 接口，此时对于请求的入参就需要校验，以保证最终数据入库的正确性，这就成了必不可少的活。例如说，用户注册时，会校验手机格式的正确性、邮箱格式的正确性、密码非弱密码等。

但是如果使用 if-else 这种代码去校验， 那么需要校验的地方有很多情况下，代码量就会变的十分臃肿，若是一个类请求参数校验字段又多的化，相信各位小伙伴对不会开心，这么干肯定不合适，代码也不优雅，那么如何解决这个问题呢？

答案就是下面要介绍的 validation

2、validation介绍

validation 技术在Java中运用最早在2009 年，Java 官方提出了 Bean Validation 规范，而后经历了JSR303、JSR349、JSR380 三次标准的更迭，发展到了 2.0 。

Bean Validation 和 我们以前学习过的 JPA 一样，只提供规范，不提供具体的实现。因此实际使用过程，常用的是 hibernate 的校验组件：org.hibernate.hibernate-validator

2-1、常见的注解

  1. 通常情况下，在javax.validation.constraints 包下，定义了一系列的约束（constraint）注解，一共 22 个注解，快速略过即可。如下：

    • 空和非空检查

      • @NotBlank：只能用于字符串不为 null ，并且字符串 .trim() 以后 length 要大于 0 。
      • @NotEmpty：集合对象的元素不为 0 ，即集合不为空 。
      • @NotNull：不能为 null 。
      • @Null：必须为 null 。

    • 数值检查

      • @DecimalMax(value)：被注释的元素必须是一个数字，其值必须小于等于指定的最大值。
      • @DecimalMin(value)：被注释的元素必须是一个数字，其值必须大于等于指定的最小值。
      • @Digits(integer, fraction)：被注释的元素必须是一个数字，其值必须在可接受的范围内。
      • @Positive：判断正数。
      • @PositiveOrZero：判断正数或 0 。
      • @Max(value)：该字段的值只能小于或等于该值。
      • @Min(value)：该字段的值只能大于或等于该值。
      • @Negative：判断负数。
      • @NegativeOrZero：判断负数或 0 。

    • Boolean 值检查

      • @AssertFalse：被注释的元素必须为 true 。
      • @AssertTrue：被注释的元素必须为 false 。

    • 长度检查

      • @Size(max, min)：检查字段的 size 是否在 min 和 max 之间，可以是字符串、数组、集合、Map 等。

    • 日期检查

      • @Future：被注释的元素必须是一个将来的日期。
      • @FutureOrPresent：判断日期是否是将来或现在日期。
      • @Past：检查该字段的日期是在过去。
      • @PastOrPresent：判断日期是否是过去或现在日期。

    • 其它检查

      • @Email：被注释的元素必须是电子邮箱地址。
      • @Pattern(value)：被注释的元素必须符合指定的正则表达式。

  2. Hibernate Validator 附加的约束注解，在org.hibernate.validator.constraints 包下，定义了一系列的约束（constraint）注解。常见的如示。

    • @Range(min=, max=)：被注释的元素必须在合适的范围内。
    • @Length(min=, max=)：被注释的字符串的大小必须在指定的范围内。
    • @URL(protocol=,host=,port=,regexp=,flags=)：被注释的字符串必须是一个有效的 URL 。
    • @SafeHtml：判断提交的 HTML 是否安全。例如说，不能包含 javascript 脚本等等。

    其他的就不一一列举了，有感兴趣的小伙伴可以去源码包看看。

  3. @Valid和 @Validated

    • @Valid 注解，是 Bean Validation 所定义，可以添加在普通方法、构造方法、方法参数、方法返回、成员变量上，表示它们需要进行约束校验。

    • @Validated 注解，是 Spring Validation 锁定义，可以添加在类、方法参数、普通方法上，表示它们需要进行约束校验。同时，@Validated 有 value 属性，支持分组校验。

    对于初学者来说，很容易搞混 @Valid 和 @Validated 注解。

① 声明式校验：Spring Validation 仅对 @Validated 注解，实现声明式校验。

② 分组校验：Bean Validation 提供的 @Valid注解，因为没有分组校验的属性，所以无法提供分组校验。此时，我们只能使用 @Validated 注解。

③ 嵌套校验：相比来说，@Valid注解的地方，多了【成员变量】。这就导致，如果有嵌套对象的时候，只能使用@Valid注解。

2-2、快速入门

  • 在 pom.xml 文件中，引入相关依赖。
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.2.1.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.raos</groupId>
    <artifactId>validation-demo</artifactId>
    <version>1.0-SNAPSHOT</version>
    <dependencies>
        <!-- 实现对 Spring MVC 的自动化配置 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <!-- lombok依赖（代码简洁处理） -->
		<dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <scope>compile</scope>
        </dependency>
        <!-- 单元测试依赖 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

</project>

spring-boot-starter-web 依赖里，已经默认引入 hibernate-validator 依赖，所以本示例使用的是 Hibernate Validator 作为 Bean Validation 的实现框架。

1、简单校验

  • 编写实体类（这里以常用的用户注册为场景）
@Data
public class SysUser {
    private Long userId;
    /**
     * 账号
     */
    @NotBlank(message = "用户名不能为空")
    @Size(min = 6, message = "用户名长度不能小于6个字符")
    private String username;
    /**
     * 密码
     */
    @NotEmpty(message = "密码不能为空")
    @Size(min = 8, message = "密码长度不能小于8个字符")
    private String password;
    /**
     * 手机号
     */
    @NotBlank(message = "手机号不能为空")
    @Size(min = 11, max = 11, message = "手机号长度不对")
    private String mobile;
}
  • 编写前端控制器
@RestController
@RequestMapping("/user")
public class SysUserController {
    @PostMapping("/add")
    public R addUser(@RequestBody @Valid SysUser sysUser) {
        System.out.println("走到这里说明校验成功");
        System.out.println(sysUser);
        return R.ok(R.SUCCESS_MSG);
    }
}
  • 编写前端响应封装实体
public class R extends HashMap<String, Object> {
    private static final long serialVersionUID = 1L;
    public static final String SUCCESS_MSG = "操作成功！";
    public static final String FAIL_MSG = "操作失败！";
    public R() {
        this.put((String) "code", 0);
    }
    public static R error() {
        return error(500, "未知异常，请联系管理员");
    }

    public static R error(String msg) {
        return error(500, msg);
    }
    public static R error(int code, String msg) {
        R r = new R();
        r.put((String) "code", code);
        r.put((String) "msg", msg);
        return r;
    }
    public static R ok(String msg) {
        R r = new R();
        r.put((String) "msg", msg);
        return r;
    }
    public static R ok(Object object) {
        R r = new R();
        r.put("result", object);
        return r;
    }
    public static R ok(int code, String msg) {
        R r = new R();
        r.put((String) "code", code);
        r.put((String) "msg", msg);
        return r;
    }
    public static R ok(Map<String, Object> map) {
        R r = new R();
        r.putAll(map);
        return r;
    }
    public static R ok() {
        return new R();
    }
    public R put(String key, Object value) {
        super.put(key, value);
        return this;
    }
}
  • 编写自定义异常（用于后续业务抛出异常错误）
public class RRException extends RuntimeException {
    private static final long serialVersionUID = 1L;
    private String msg;
    private int code = 500;
    public RRException(String msg) {
        super(msg);
        this.msg = msg;
    }
    public RRException(String msg, Throwable e) {
        super(msg, e);
        this.msg = msg;
    }
    public RRException(String msg, int code) {
        super(msg);
        this.msg = msg;
        this.code = code;
    }
    public RRException(String msg, int code, Throwable e) {
        super(msg, e);
        this.msg = msg;
        this.code = code;
    }
    public String getMsg() {
        return msg;
    }
    public void setMsg(String msg) {
        this.msg = msg;
    }
    public int getCode() {
        return code;
    }
    public void setCode(int code) {
        this.code = code;
    }
}

当访问/user/add这个post接口时，如果参数不符合Model中定义的话，程序中就回抛出400异常状态码，并提示错误信息，如下所示。

{
    "timestamp": "2021-05-20T01:08:28.831+0000",
    "status": 400,
    "error": "Bad Request",
    "errors": [
        {
            "codes": [ "Size.sysUser.mobile", "Size.mobile", "Size.java.lang.String", "Size" ],
            "arguments": [ { "codes": [ "sysUser.mobile", "mobile" ], "arguments": null, "defaultMessage": "mobile", "code": "mobile" },
             11,
             11
            ], 
            "defaultMessage": "手机号长度不对",
            "objectName": "sysUser",
            "field": "mobile",
            "rejectedValue": "155833013",
            "bindingFailure": false,
            "code": "Size"
        }
    ],
    "message": "Validation failed for object='sysUser'. Error count: 1",
    "path": "/user/add"
}

2、自定义校验注解

虽然 JSR303 和 Hibernate Validtor 已经提供了很多校验注解，但是当面对复杂参数校验时，还是不能满足我们的要求，这时候我们就需要 自定义校验注解。

下面以“List数组中不能含有null元素”为实例自定义校验注解
1、注解定义如示。

@Target({ElementType.ANNOTATION_TYPE, ElementType.METHOD, ElementType.FIELD})
@Retention(RUNTIME)
@Documented
@Constraint(validatedBy = ListNotHaveNullValidatorImpl.class)//此处指定了注解的实现类
public @interface ListNotHaveNull {
    /**
     * 添加value属性，可以作为校验时的条件,若不需要，可去掉此处定义
     */
    int value() default 0;
    String message() default "List集合中不能含有null元素";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
    /**
     * 定义List，为了让Bean的一个属性上可以添加多套规则
     */
    @Target({METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER})
    @Retention(RUNTIME)
    @Documented
    @interface List {
        ListNotHaveNull[] value();
    }
}

2、编写自定义校验实现类

@Service
public class ListNotHaveNullValidatorImpl implements ConstraintValidator<ListNotHaveNull, List> {
    private int value;
    @Override
    public void initialize(ListNotHaveNull constraintAnnotation) {
        //传入value 值，可以在校验中使用
        this.value = constraintAnnotation.value();
    }
    public boolean isValid(List list, ConstraintValidatorContext constraintValidatorContext) {
        for (Object object : list) {
            if (object == null) {
                //如果List集合中含有Null元素，校验失败
                return false;
            } else if (object instanceof String) {
                String value = object.toString();
                if (value.trim().length() == 0){
                    return false;
                }
            }
        }
        return true;
    }
}

3、model中添加注解：

@Data
public class SysRole {

    private Long roleId;

    @NotBlank(message = "角色名不能为空")
    private String name;

    @NotEmpty(message = "资源列表不能为空")
    @ListNotHaveNull(message = "List 中不能含有null元素")
    @Valid
    private List<String> paths;

}

4、编写前端控制器

    @PostMapping("/addRole")
    public R addRole(@RequestBody @Valid SysRole sysRole) {
        System.out.println("走到这里说明校验成功");
        System.out.println(sysRole);
        return R.ok(R.SUCCESS_MSG);
    }

使用方法同 “简单校验”，在在需要校验的Model上面加上@Valid即可。

3、通用的Validtor校验工具类

public class ValidatorUtils {
    private ValidatorUtils() { }

    private static Validator validator;
    static {
        validator = Validation.buildDefaultValidatorFactory().getValidator();
    }

    /**
     * 校验对象
     *
     * @param object 待校验对象
     * @param groups 待校验的组
     * @throws RRException 校验不通过，则报RRException异常
     */
    public static void validateEntity(Object object, Class<?>... groups) throws RRException {
        Set<ConstraintViolation<Object>> constraintViolations = validator.validate(object, groups);

        if (!constraintViolations.isEmpty()) {
            Iterator<ConstraintViolation<Object>> iterator = constraintViolations.iterator();
            StringBuilder msg = new StringBuilder();
            while (iterator.hasNext()) {
                ConstraintViolation<Object> constraint = iterator.next();
                msg.append(constraint.getMessage()).append(',');
            }
            throw new RRException(msg.toString().substring(0,msg.toString().lastIndexOf(',')));
        }
    }
}

使用方式，在接收到前端传递的参数后，使用ValidatorUtils.validateEntity(【参数名】);即可校验，支持分组校验，分组需要定义分组接口。
以上待续。

宇枫16
关注
专栏目录
Java实体类--字段校验
PUYALEI的博客
08-06 404
② 分组校验：Bean Validation 提供的 @Valid注解，因为没有分组校验的属性，所以无法提供分组校验。但是如果使用 if-else 这种代码去校验， 那么需要校验的地方有很多情况下，代码量就会变的十分臃肿，代码也不优雅，那么如何解决这个问题呢？日常开发中，我们时常需要提供可靠的 API 接口，此时对于请求的入参就需要校验，以保证最终数据入库的正确性，这就成了必不可少的活。因此实际使用过程，常用的是。例如说，用户注册时，会校验手机格式的正确性、邮箱格式的正确性、密码非弱密码等。
java entity校验_【java】【校验】使用java自带的Validator完成字段校验，完成请求入参属性校验...
weixin_36407256的博客
02-28 269
packagecom.sxd.swapping.validation;importorg.apache.commons.collections4.CollectionUtils;importorg.apache.commons.lang3.StringUtils;importjavax.validation.ConstraintViolation;importjavax.validation.Va...
二十七、Springboot整合Validation（验证）
热门推荐
panchang199266的博客
10-14 1万+
（一）常用注解 //开启验证，标注在待验证的Object对象上 @Valid //标注在待验证的字段上 @NotNull @Null @Size @Min @Max （二）具体使用 1、添加依赖 &lt;dependency&gt; &lt;groupId&gt;org.springframework.boot&lt;/groupId&gt; &lt;artifactId&gt...
SpringBoot之@Validated校验List集合参数类型失效的解决方案
最新发布
一个人的博客
08-15 543
记录一下@Validated校验参数是List集合的时候会失效的解决方案
Java Bean Validation
weixin_34310369的博客
01-02 125
案例概述 在这本文中，我们将介绍使用标准框架验证Java bean的基础知识 - JSR 380，也称为Bean Validation 2.0。 当然，验证用户输入在大多数应用程序中是一个超常见的要求，Java Bean Validation框架已经成为处理这种逻辑的事实上的标准。 JSR 380 JSR 380是用于bean验证的Java API的规范，是JavaEE和JavaSE的一部...
validation的简单使用
m0_56356631的博客
05-06 438
那么问题就是怎么写，我们找一个现成的 @NotNull复制一下，改改代码validatedBy = {MobileValidator.class}//注意，这里是需要我们自己写的String message() default "手机号码有误";Class<?Class<?/*这两个泛型，前者是注解类型 ，后者是 要检验的值是什么类型*/@Override/*s就是前端传过来的值*/@Data@ToString@NotBlank(message = "名字不能为空")
JAVA validation的使用
m0_37062111的博客
02-24 2230
validation 在Java中运用最早在2009 年，Java 官方提出了 Bean Validation 规范，而后经历了JSR303、JSR349、JSR380 三次标准的更迭，发展到了 2.0。Bean Validation只提供规范，不提供具体的实现。因此实际使用过程，常用的是Hibernate validation和Spring Validator校验机制。
Java字段校验
张音乐的博客
01-08 2126
1、校验测试 package com.video.base.utils; import java.util.ArrayList; import java.util.Arrays; import java.util.Iterator; import java.util.List; import java.util.Objects; import java.util.Optional; ...
java validator ip_【java】【校验】使用java自带的Validator完成字段校验，完成请求入参属性校验...
weixin_34723479的博客
02-24 182
packagecom.sxd.swapping.validation;importorg.apache.commons.collections4.CollectionUtils;importorg.apache.commons.lang3.StringUtils;importjavax.validation.ConstraintViolation;importjavax.validation.Va...
java实体数据校验validation
秋风未动蝉先觉
03-08 2544
<!--添加依赖--> <dependency> <groupId>javax.validation</groupId> <artifactId>validation-api</artifactId> <version>1.1.0.Final</version> </dependency> <dependency> <groupId>org.hi
教你学Java | 使用 @Valid 注解实现字段校验
m0_72533993的博客
07-04 6228
每一个应用软件都离不开数据的校验，比如在提交表单时需要对用户提交的字段内容进行长度验证、非空验证等等。有的小伙伴在做字段内容校验时采用的依然是最原始的校验方式——获取字段内容，用 if-else 对内容进行验证。这种校验方式当然没问题，但是却需要写很多行代码去实现校验的功能，也就让我们的编码效率和代码可读性都降低了很多，那么今天就给各位小伙伴介绍另一种方式——使用 @Valid 注解实现字段校验。首先我们先新建一个学生类（类也很简单，只有姓名和年龄两个字段）👇 接下来我们再新建一个 Cotroller.
Spring自带的校验框架Validation的使用实例
08-26
Spring 作为一个流行的 Java 框架，提供了一个内置的校验框架 Validation，用于验证用户输入数据的正确性。在本文中，我们将详细介绍如何使用 Spring 自带的校验框架 Validation 实现实例。 标题解释 本文的标题...
java 实体类校验_实体类的验证
weixin_33893111的博客
02-26 4321
@Valid注解用于校验，所属包为：javax.validation.Valid。① 首先需要在实体类的相应字段上添加用于充当校验条件的注解，如：@Min,如下代码(age属于Girl类中的属性)：@Min(value = 18,message = "未成年禁止入内")private Integer age;② 其次在controller层的方法的要校验的参数上添加@Valid注解，并且需要传入B...
java函数式接口-非空字段校验
weixin_36264102的博客
10-18 1007
一、概述 做一个，可以传入对象，方法声明的形式校验参数非空，想要实现的效果如下 //user类：Long id,String name; User user = new User(1L,""); JsonUtils.validEmpty(user,User::getId,User::getName); 说一下思路 传入对象，方法声明（即对象方法），可以用到有来有回的函数接口 R apply(T t)。 函数接口可以获取的信息有： 传入的类型 传入的调用方法 对象对应方法的返回值
java validation_Java Validation
weixin_32183107的博客
02-12 999
参数检查用得最多的是JSR 303，用法示例：http://blog.csdn.net/caihaijiang/article/details/7463514但JSR 303有个缺点，那就是当参数的限制发生变化时，例如某String类型的最大长度由10改为20，就需要改代码重新编译。那有没有办法只改配置文件重启程序就达到目的呢？网上还没有类似的解决方案，那就自己实现Java Validation。...
java中字段校验说明
ZHANGJNWEI的专栏
07-26 400
jakarta-validation-api的实现是org.hibernate.validator； hibernate具体的实现包在org.hibernate.validator.internal.constraintvalidators中；
validation的使用
okludawei的博客
04-16 560
@Data public class RegisterVo implements Serializable { //@NotBlank要求这个字符串不能为null或"",也不能只有空格 @NotBlank(message = "邀请码不能为空啊!") private String inviteCode; @NotBlank(message = "手机号不能为空") @Pattern(regexp = "^1\\d{10}$",message = "手机号格式不正确.
validation使用
dream_xsj的博客
11-23 199
javax.validation.constraints使用1、NotBlank 使用 1、NotBlank 使用 注意：NotBlank NotEmpty 只能用在String类型 notNull可以int 以上都需要配合@Valid 使用
Java validation（java验证器实现）
Java
03-18 1167
Java validation 1. java验证器 在java开发中我们有很多场景都会对java的属性值进行验证，如web开发中表单提交数据后台数据处理中需要对传入的值进行验证，当然目前java有很多开源属性值验证框架，如hibernate validation，spring框架中也提供了相应注解验证spring validation，相比两款验证本人觉得hibernate的提供的正则...
Java validation 怎么设置校验指定字段
05-26
可以使用 Java Bean Validation API (JSR 380) 来为特定字段设置校验规则。以下是一些示例代码： 假设我们有一个 User 类，其中包含 name 和 age 两个字段。我们想要在校验时只关注 name 字段。 首先，我们需要在 name 字段上添加注解来指定校验规则。例如，我们可以使用 @NotBlank 注解来确保 name 字段不为空： ``` public class User { @NotBlank(message = "Name cannot be blank") private String name; private int age; // getters and setters } ``` 然后，我们可以在校验时只校验 name 字段，而不是整个 User 对象。可以使用 Validator 实例的 validateProperty 方法来完成此操作： ``` Validator validator = Validation.buildDefaultValidatorFactory().getValidator(); User user = new User(); user.setName(""); user.setAge(20); Set<ConstraintViolation<User>> violations = validator.validateProperty(user, "name"); ``` 在此示例中，我们仅校验了 name 字段，并将结果存储在 ConstraintViolation 对象的集合中。如果 name 字段为空，violations 集合将包含一个 ConstraintViolation 对象，该对象包含有关校验失败的信息。 希望这可以帮助你实现校验指定字段。
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值