1. Toy模板网首页
  2. > Toy博客

java的validation框架（参数校验）

8月前 作者：编程小飞侠 分类：Toy博客 阅读(37) 违法举报

这篇具有很好参考价值的文章主要介绍了java的validation框架（参数校验）。希望对大家有所帮助。如果存在错误或未考虑完全的地方，请大家不吝赐教，您也可以点击"举报违法"按钮提交疑问。

一.bean validation和hibernate validator参数校验常用约束注解：

空值校验类：@Null，@NotNull，@NotEmpty，@NotBlank等
范围校验类：@Min，@Size，@Digits，@Future，@Negative等
其它校验类：@Email，@URL，@AssertTrue，@Pattern等

二.初级约束注解：

1. @NotNull(message = “用户id不能为空”)

  • 没有设置值时会返回
  • 设置为userInfo.setUserId("");时不会返回
  • userInfo.setUserId(" ");时不会返回

2.@NotEmpty(message = “用户名不能为空”)

  • 不会自动去掉字符串前后的空格再判断是否为空
  • 没有设置值时会返回
  • userInfo.setUserName("");时返回
  • userInfo.setUserName(" ");时不返回

3.@NotBlank(message = “密码不能为空”)

  • 自动去掉字符串前后的空格再判断是否为空
  • 没有设置值时会返回
  • userInfo.setPassWord("");时返回
  • userInfo.setPassWord(" ");时返回

4.@Length(min = 6,max = 20,message = “密码不能少于6位，也不能多于20位”)

  • 可以直接不设置值
  • 即数量必须在6到20之间（包含6和20）

5.@Email(message = “邮箱不正确”)

  • 可以直接不设置值
  • 必须是正确的邮箱格式

6. @Min(value = 18, message = “年龄不能小于18岁”)

  • 可以直接不设置值
  • 即年龄必须大于或者等于18岁

7. @Max(value = 60, message = “年龄不能大于60岁”)

  • 可以直接不设置值
  • 即年龄必须等于小于60岁

8.@Past(message = “生日只能是过去的时间或者现在的时间”)

  • 可以直接不设置值
  • 传来的时间只能是过去的时间或者现在的时间，不能是未来时间

9.@Size(min = 1,message = “不能少于一个好友”)

  • 可以直接不设置值
  • 集合里面的内容不能少于1

三.中级约束注解：

1.@Valid

  • private List<@Valid UserInfo> friends;表示对UserInfo类中里面的每个属性进行验证

2.@NotNull(message = “注册时邮箱不能为空”,groups = RegisterGroup.class)

  • //注册场景 public interface RegisterGroup{}
    //登录场景 public interface LoginGroup{}
  • 注册时邮箱不能为空，登录时可以为空
  • set = validator.validate(userInfo,UserInfo.RegisterGroup.class);

3.//组排序场景
@GroupSequence({
LoginGroup.class,
RegisterGroup.class,
Default.class
})
public interface Group{}

  • set = validator.validate(userInfo,UserInfo.Group.class);
  • 先验证 LoginGroup组的，都通过才验证下面的，不通过直接返回验证错误信息，验证顺序按照上面的顺序进行验证

四.高级约束注解：

1.public void setUserInfo(@Valid UserInfo userInfo){ }
set1 = executableValidator.validateParameters(service,method1,paramObject);

  • @Valid对方法输入参数进行约束注解校验

2.public @Valid UserInfo getUserInfo(){return new UserInfo();}
set1 = executableValidator.validateReturnValue(userInfoService,method,returnValue);

  • @Valid对方法返回值进行约束校验

3.public UserInfoService(@Valid UserInfo userInfo){}
set1 = executableValidator.validateConstructorParameters(constructor,paramObject);

  • @Valid对构造函数输入参数进行校验

五.上面初，中，高级注解示例：

pom.xml

<!-- Validation 相关依赖 -->
        <dependency>
            <groupId>javax.validation</groupId>
            <artifactId>validation-api</artifactId>
            <version>2.0.1.Final</version>
        </dependency>
        <dependency>
            <groupId>org.hibernate</groupId>
            <artifactId>hibernate-validator</artifactId>
            <version>6.0.16.Final</version>
        </dependency>
        <dependency>
            <groupId>javax.el</groupId>
            <artifactId>javax.el-api</artifactId>
            <version>3.0.0</version>
        </dependency>
        <dependency>
            <groupId>org.glassfish.web</groupId>
            <artifactId>javax.el</artifactId>
            <version>2.2.6</version>
        </dependency>

待验证对象实体类UserInfo.java:

package com.mystudy.elastic.job.springboot.validation;

import org.hibernate.validator.constraints.Length;

import javax.validation.GroupSequence;
import javax.validation.Valid;
import javax.validation.constraints.*;
import javax.validation.groups.Default;
import java.util.Date;
import java.util.List;

/**
 * 待验证对象实体类
 * 用户信息类
 */
public class UserInfo {

    //登录场景
    public interface LoginGroup{}

    //注册场景
    public interface RegisterGroup{}

    //组排序场景
    @GroupSequence({
            LoginGroup.class,
            RegisterGroup.class,
            Default.class
    })
    public interface Group{}

    /**
     * 用户id
     */
    @NotNull(message = "用户id不能为空")
    private String userId;

    /**
     * 用户名
     */
    @NotEmpty(message = "用户名不能为空")
    private String userName;

    /**
     * 密码
     */
    @NotBlank(message = "密码不能为空")
    @Length(min = 6, max = 20, message = "密码不能少于6位，也不能多于20位")
    private String passWord;

    /**
     * 邮箱
     */
//    @NotNull(message = "注册时邮箱不能为空",groups = RegisterGroup.class)
    @Email(message = "邮箱不正确")
    private String email;

    /**
     * 年龄
     */
    @Min(value = 18, message = "年龄不能小于18岁")
    @Max(value = 60, message = "年龄不能大于60岁")
    private Integer age;

    /**
     * 手机号
     */
    @Phone(message = "手机号不是158后面随便的手机号")
    private String phone;

    /**
     * 生日
     */
    @Past(message = "生日只能是过去的时间或者现在的时间")
    private Date birthday;

    /**
     * 好友列表
     */
    @Size(min = 1,message = "不能少于一个好友")
    private List<@Valid UserInfo> friends;

    public String getUserId() {
        return userId;
    }

    public void setUserId(String userId) {
        this.userId = userId;
    }

    public String getUserName() {
        return userName;
    }

    public void setUserName(String userName) {
        this.userName = userName;
    }

    public String getPassWord() {
        return passWord;
    }

    public void setPassWord(String passWord) {
        this.passWord = passWord;
    }

    public String getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }

    public String getPhone() {
        return phone;
    }

    public void setPhone(String phone) {
        this.phone = phone;
    }

    public Date getBirthday() {
        return birthday;
    }

    public void setBirthday(Date birthday) {
        this.birthday = birthday;
    }

    public List<UserInfo> getFriends() {
        return friends;
    }

    public void setFriends(List<UserInfo> friends) {
        this.friends = friends;
    }

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }
}

用户信息服务类UserInfoService.java:

package com.mystudy.elastic.job.springboot.validation;

import javax.validation.Valid;

/**
 * 用户信息服务类
 */
public class UserInfoService {
    /**
     *  userInfo作为输入参数
     * @param userInfo
     */
    public void setUserInfo(@Valid UserInfo userInfo){

    }

    /**
     * userInfo作为输出参数
     * @return
     */
    public @Valid UserInfo getUserInfo(){
        return new UserInfo();
    }

    /**
     * 默认构造函数
     */
    public UserInfoService(){

    }

    /**
     * 接收userInfo作为参数的构造函数
     * @param userInfo
     */
    public UserInfoService(@Valid UserInfo userInfo){

    }
}

验证测试类ValidationTest.java:

package com.mystudy.elastic.job.springboot.validation;

import org.junit.After;
import org.junit.Before;
import org.junit.Test;

import javax.validation.ConstraintViolation;
import javax.validation.Validation;
import javax.validation.Validator;
import javax.validation.executable.ExecutableValidator;
import java.lang.reflect.Constructor;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;
import java.util.ArrayList;
import java.util.Date;
import java.util.Set;

/**
 * 验证测试类
 */
public class ValidationTest {

    //验证器对象
    private Validator validator;

    //待验证对象
    private UserInfo userInfo;

    //验证结果集合
    private Set<ConstraintViolation<UserInfo>> set;

    //验证结果集合
    private Set<ConstraintViolation<UserInfoService>> set1;

    /**
     * 初始化操作
     */
    @Before
    public void init() {
        //初始化验证器
        validator = Validation.buildDefaultValidatorFactory().getValidator();
        //初始化待验证对象 用户信息
        userInfo = new UserInfo();
        userInfo.setUserId(" ");
        userInfo.setUserName("  ");
        userInfo.setPassWord("  ");
        userInfo.setPassWord("333333");
        userInfo.setAge(18);
        userInfo.setBirthday(new Date());
        userInfo.setPhone("15987377373");

        UserInfo friend = new UserInfo();
        friend.setUserId("wangxiaoxi");
        friend.setUserName("王小喜");
        friend.setPassWord("wangxiaoxi");
        userInfo.setFriends(new ArrayList() {{
            add(friend);
        }});

    }

    /**
     * 结果打印
     */
    @After
    public void print() {
        set.forEach(item -> {
            //输出验证错误信息
            System.out.println(item.getMessage());
        });
//        set1.forEach(item -> {
//            //输出验证错误信息
//            System.out.println(item.getMessage());
//        });
    }

    @Test
    public void nullValidation() {
        //使用验证器对对象进行验证
        set = validator.validate(userInfo);
    }

    /**
     * 级联验证测试方法
     */
    @Test
    public void graphValidation() {
        set = validator.validate(userInfo);
    }

    /**
     * 验证注册时，邮箱是否为空
     */
    @Test
    public void groupValidation() {
        set = validator.validate(userInfo, UserInfo.RegisterGroup.class);
    }

    /**
     * 组排序
     */
    @Test
    public void groupSequenceValidate() {
        set = validator.validate(userInfo, UserInfo.Group.class);
    }

    /**
     * 对方法输入参数进行约束注解校验
     */
    @Test
    public void paramValidation() throws NoSuchMethodException {
        //获取校验执行器
        ExecutableValidator executableValidator = validator.forExecutables();

        //待验证对象
        UserInfoService service = new UserInfoService();
        //待验证方法
        Method method1 = service.getClass().getMethod("setUserInfo", UserInfo.class);
        //方法的输入参数
        Object[] paramObject = new Object[]{new UserInfo()};

        //对方法的输入参数进行校验
        set1 = executableValidator.validateParameters(service, method1, paramObject);

    }

    /**
     * 对方法返回值进行约束校验
     */
    @Test
    public void returnValueValidation() throws NoSuchMethodException, InvocationTargetException, IllegalAccessException {
        //获取校验执行器
        ExecutableValidator executableValidator = validator.forExecutables();

        //构造要验证的方法对象
        UserInfoService userInfoService = new UserInfoService();
        Method method = userInfoService.getClass().getMethod("getUserInfo");

        //调用方法得到返回值
        Object returnValue = method.invoke(userInfoService);

        //校验方法返回值是否符合约束
        set1 = executableValidator.validateReturnValue(userInfoService, method, returnValue);
    }

    /**
     * 对构造函数输入参数进行校验
     */
    @Test
    public void constructorValidation() throws NoSuchMethodException {

        //获取验证执行器
        ExecutableValidator executableValidator = validator.forExecutables();

        //获取构造函数
        Constructor<UserInfoService> constructor = UserInfoService.class.getConstructor(UserInfo.class);
        Object[] paramObject = new Object[]{new UserInfo()};

        //校验构造函数
        set1 = executableValidator.validateConstructorParameters(constructor, paramObject);

    }
}

六.自定义注解：

自定义手机号注解@interface Phone：

package com.mystudy.elastic.job.springboot.validation;

import javax.validation.Constraint;
import javax.validation.Payload;
import java.lang.annotation.*;

/**
 * 自定义手机号注解
 */
@Documented
//注解的作用目标(可以设置作用在类，方法等等）
@Target({ElementType.FIELD})
//注解的保留策略（注解的生命周期)
@Retention(RetentionPolicy.RUNTIME)
//不同之处：与注解关联的验证器
@Constraint(validatedBy = PhoneValidator.class)
public @interface Phone {

    //注解验证不通过时输出的信息
    String message() default "手机号验证错误";

    //约束注解在验证时所属的组别
    Class<?>[] groups() default {};

    //约束注解的有效负载
    Class<? extends Payload>[] payload() default {};
}

自定义手机号注解关联的验证器class PhoneValidator implements ConstraintValidator<Phone, String>：

package com.mystudy.elastic.job.springboot.validation;

import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;
import java.util.Optional;
import java.util.regex.Matcher;
import java.util.regex.Pattern;

/**
 * 自定义手机号注解关联的验证器
 */
public class PhoneValidator implements ConstraintValidator<Phone, String> {

    /**
     * 自定义校验逻辑方法
     *
     * @param s
     * @param constraintValidatorContext
     * @return
     */
    @Override
    public boolean isValid(String s, ConstraintValidatorContext constraintValidatorContext) {

        //手机号验证规则：158后面随便
        String check = "158\\d{8}";
        Pattern regex = Pattern.compile(check);

        String phone = Optional.ofNullable(s).orElse("");
        Matcher matcher = regex.matcher(phone);

        //返回是否匹配
        return matcher.matches();
    }
}

待验证对象实体类UserInfo：

package com.mystudy.elastic.job.springboot.validation;

/**
 * 待验证对象实体类
 * 用户信息类
 */
public class UserInfo {

    /**
     * 手机号
     */
    @Phone(message = "手机号不是158后面随便的手机号")
    private String phone;

    public String getPhone() {
        return phone;
    }

    public void setPhone(String phone) {
        this.phone = phone;
    }

}

验证测试类ValidationTest

package com.mystudy.elastic.job.springboot.validation;

import org.junit.After;
import org.junit.Before;
import org.junit.Test;

import javax.validation.ConstraintViolation;
import javax.validation.Validation;
import javax.validation.Validator;
import java.util.Set;

/**
 * 验证测试类
 */
public class ValidationTest {

    //验证器对象
    private Validator validator;

    //待验证对象
    private UserInfo userInfo;

    //验证结果集合
    private Set<ConstraintViolation<UserInfo>> set;

    /**
     * 初始化操作
     */
    @Before
    public void init() {
        //初始化验证器
        validator = Validation.buildDefaultValidatorFactory().getValidator();
        //初始化待验证对象 用户信息
        userInfo = new UserInfo();
        userInfo.setPhone("15987377373");
    }

    /**
     * 结果打印
     */
    @After
    public void print() {
        set.forEach(item -> {
            //输出验证错误信息
            System.out.println(item.getMessage());
        });
    }

    @Test
    public void nullValidation() {
        //使用验证器对对象进行验证
        set = validator.validate(userInfo);
    }

}

结果：
java validation,java,validation框架,java,validation框架,注解文章来源地址https://www.toymoban.com/news/detail-814639.html

到了这里，关于java的validation框架（参数校验）的文章就介绍完了。如果您还想了解更多内容，请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章，希望大家以后多多支持TOY模板网！

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处： 如若内容造成侵权/违法违规/事实不符，请点击违法举报进行投诉反馈，一经查实，立即删除！

分享到：
领支付宝红包 赞助服务器费用

相关文章

  • Java代码瘦身，巧用 @Valid，@Validated 的分组校验和嵌套检验，实现高阶参数校验操作

    Java代码瘦身，巧用 @Valid，@Validated 的分组校验和嵌套检验，实现高阶参数校验操作

            在 JavaEE 项目中， RestFull 层接收参数首先要对一些字段的格式进行校验，以防止所有查询都落到数据库，这也是一种合理的限流手段。以前基本上都是用 if...else...，这样的代码太啰嗦，除了使用策略模式进行优化，今天介绍一下校验注解@Valid，@Validated和@PathVariable，

    2024年02月04日
    浏览(35)

  • java如何优雅的实现参数非空校验，快速实现参数非空校验，使用@valid实现参数非空校验

    在java项目接口中，有些必传参数需要进行非空校验，如果参数过多，代码会繁杂且冗余，如何优雅的对参数进行非空校验，下面是实现流程 用实体类接收参数，使用非空注解编辑参数内容 使用 @Valid 注解对参数进行拦截，整体进行非空校验 如果是SpringBoot项目，引入web开发包

    2024年02月08日
    浏览(34)

  • Java参数校验@Valid中@Length和@Size的用法和区别

    在Spring框架中，@Length和@Size都是用于参数长度校验的注解，但它们之间存在一些关键的区别： @Length 是Hibernate Validator提供的一个注解，它用于校验字符串的长度。 @Size 也是Hibernate Validator提供的注解，但它可以用于多种数据类型，不仅仅是字符串。对于字符串，它可以校验长

    2024年04月15日
    浏览(30)

  • @Valid、@Validated参数校验详解

    [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-M6CfNsNC-1687851467867)(images/20200913110853722.png)] 说明：若不做异常处理，@Validated注解的默认异常消息如下（示例）： 因此我们在这里做了一个全局的异常处理类，用于处理参数校验失败后抛出的异常，同

    2024年02月11日
    浏览(29)
  • Springboot——@valid 做字段校验和自定义注解

    Springboot——@valid 做字段校验和自定义注解

    再项目开发中，针对前端传递的参数信息，有些接口中需要写大量的 if 判断，导致代码臃肿，不够优雅。 此时，可以使用 @Valid 实现基本的字段校验。 springboot 2.3之前 ，直接进行开发即可，无需引用额外的依赖 集成在 spring-boot-starter-web 中。 springboot 2.3之后 需要额外引入

    2023年04月26日
    浏览(50)
  • SpringBoot参数校验@Validated、@Valid

    SpringBoot参数校验@Validated、@Valid

    在实际开发中，前端校验并不安全，任何人都可以通过接口来调用我们的服务，就算加了一层token的校验，有心人总会转空子，来传各式各样错误的参数，如果后端不校验，导致数据库数据混乱、特别是关于金额的数据，可能一个接口把公司都给干倒了 0、返回类（可以不用看

    2024年01月23日
    浏览(33)
  • springboot使用@Valid 和 @Validated 注解校验详解以及编写一个自定义全局异常类

    springboot使用@Valid 和 @Validated 注解校验详解以及编写一个自定义全局异常类

    全局异常处理类 验证： ============================================== 导入所需要的包： 如果你是 springboot 项目，那么可以不用引入了，已经引入了，他就存在于最核心的 web 开发包里面。 如果你不是 springboot 项目，那么引入下面依赖即可： 新建三个实体类 实现一： 使用@Valid注解修

    2024年02月10日
    浏览(29)

  • spring参数校验@Validated及嵌套校验

    本文介绍项目中校验 @Validated的使用，主要分参数对象属性校验，嵌套校验，集合在对象属性中校验，集合作为参数校验。 controller层 测试输入 输出 这里作为参数，如果使用List接收是不起作用的，必须用ValidList，这个类中有标记 @Valid @Valid private ListE list = new ArrayList(); 如果在

    2024年02月09日
    浏览(36)
  • SpringBoot 使用validator进行参数校验（实例操作+注意事项+自定义参数校验）

    SpringBoot 使用validator进行参数校验（实例操作+注意事项+自定义参数校验）

    ①、引入依赖 ②、创建实体类 ③、建立控制层 ④、进行测试 作为测试demo，到这里就可以直接测试了 ①、@NotNull ，@NotEmpty 和 @NotBlank 三者的区别 @NotNull、@NotEmpty 和 @NotBlank 都是用于Java中进行参数校验的注解，它们之间的区别如下： @NotNull 注解用于限制参数不能为null。 @N

    2024年02月07日
    浏览(36)

  • Spring Boot 使用validation校验参数

    在看公司代码的时候，发现是用了 Spring Boot Validation 去检验参数的，但是后面又在代码里去检验参数去了，而且这个 Spring Boot Validation 校验好像并不生效。于是自己摸索研究了一下。 虽然项目使用的校验都是 javax.validation ，但是不引入这个依赖他是真的不生效。 gradle如下：

    2024年01月25日
    浏览(36)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包，优惠每天领

二维码1

领取红包

二维码2

领红包