Java如何使用JSR303校验数据与自定义校验注解

 更新时间:2020年09月02日 10:57:20   作者:码上好运  
这篇文章主要介绍了Java如何使用JSR303校验数据与自定义校验注解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧

一、自带校验注解实现数据校验

1、web项目导入依赖

<!-- 该依赖默认导入了 hibernate-validator 所以不需要再单独导入 -->
  <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
  </dependency>

下图可以看到spring-boot-starter-web依赖自动引入了hibernate-validator;

如果感兴趣的话还可以进入hibernate-validator查看引入了什么相关依赖

2、默认注解的使用

在需要校验的字段添加不同校验类型的注解

	/**
   * 品牌id
   */
  @NotNull(message = "必须提交品牌id")
  @TableId
  private Long brandId;
  /**
   * 品牌名
   */
  @NotBlank(message = "品牌名不可为空")
  private String name;
  /**
   * 品牌logo地址
   */
  @NotBlank(message = "logo必须提交")
  @URL(message = "logo地址格式错误")
  private String logo;
  /**
   * 介绍
   */
  private String descript;
  /**
   * 显示状态[0-不显示;1-显示]
   */private Integer showStatus;
  /**
   * 检索首字母 - 正则校验实现
   */
  @NotNull(message = "首字母必须提交")
  @Pattern(message = "首字母必须是一个字母,且a-z或A-Z", regexp = "/^[a-zA-Z]$/")
  private String firstLetter;

下图是自带的所有校验注解,可以进入查看源码的注释查看如何使用

3、设置谁需要进行数据校验!!!

在接口参数需要校验的对象前标注注解**@Valid** - 标明前台提交数据时该对象的字段需要进行数据校验

/**
   * 修改
   */
  @RequestMapping("/update")
  public R update(@Valid @RequestBody AttrGroupEntity attrGroup){
    attrGroupService.updateById(attrGroup);

    return R.ok();
  }

二、如何使用分组校验?

由于不同功能的接口接收的对象数据可能需要校验的字段不同,并不是每一个接口接收的对象的所有字段都需要校验的,所以则需要使用"分组校验"来区分不同的业务需要校验不同的字段,在这里我使用新增业务和修改业务为例。


根据上图可以看到,默认的注解源码不仅可以设置message(消息)还有一个可以设置group(分组)

1、创建分组接口

/**
 * 新增业务分组校验 - 不需要实现任何业务,只是用来标识身份
 */
public interface AddGroup {
}
/**
 * 修改业务分组校验 - 不需要实现任何业务,只是用来标识身份
 */
public interface UpdateGroup {
}

2、如何使用分组校验?

2.1、修改Bean每个字段上校验注解,设置group值

	/**
	 * 品牌id
	 */
	@NotNull(message = "修改必须提交品牌id", groups = {UpdateGroup.class})
	@Null(message = "新增不需要提交品牌id", groups = {AddGroup.class})
	@TableId
	private Long brandId;
	/**
	 * 品牌名
	 */
	@NotBlank(message = "品牌名不可为空", groups = {AddGroup.class, UpdateGroup.class})
	private String name;
	/**
	 * 品牌logo地址
	 */
	@NotBlank(message = "logo必须提交", groups = {AddGroup.class})
	@URL(message = "logo地址格式错误", groups = {AddGroup.class, UpdateGroup.class})
	private String logo;
	/**
	 * 介绍
	 */
	private String descript;
	/**
	 * 显示状态[0-不显示;1-显示]
	 */
	private Integer showStatus;
	/**
	 * 检索首字母
	 */
	@NotNull(message = "首字母必须提交", groups = {AddGroup.class})
	@Pattern(message = "首字母必须是一个字母,且a-z或A-Z", regexp = "/^[a-zA-Z]$/", groups = {AddGroup.class, UpdateGroup.class})
	private String firstLetter;
	/**
	 * 排序
	 */
	@Min(value = 0, groups = {AddGroup.class, UpdateGroup.class})
	private Integer sort;

2.2、设置什么业务需要使用什么分组进行校验

/**
   * 保存 - 使用添加分组校验接口参数对象的字段
   */
  @RequestMapping("/save")
  public R save(@Validated(value = {AddGroup.class}) @RequestBody BrandEntity brand){
		brandService.save(brand);

    return R.ok();
  }
/**
   * 修改 - 使用修改分组校验接口参数对象的字段
   */
  @RequestMapping("/update")
  public R update(@Validated(value = UpdateGroup.class) @RequestBody BrandEntity brand){
		brandService.updateById(brand);

    return R.ok();
  }

此时,不同业务就会校验不同的字段!!!

三、自定义校验注解

1、导入依赖的jar包

<dependency>
  <groupId>javax.validation</groupId>
  <artifactId>validation-api</artifactId>
  <version>2.0.1.Final</version>
</dependency>

2、编写自定义校验注解

/**
 * 自定义校验注解
 * @author mashanghaoyun
 * @date 2020/8/3115:01
 */
@Target({METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER, TYPE_USE})
@Retention(RUNTIME)
@Documented
@Constraint(validatedBy = {})
public @interface ListValue {

  String message() default "{com.mashanghaoyun.common.valid.ListValue.message}";

  Class<?>[] groups() default {};

  Class<? extends Payload>[] payload() default {};

  int[] vals() default { };

}

3、编写自定义校验器

/**
 * 自定义校验器
 * @author mashanghaoyun
 * @date 2020/8/3115:15
 */
public class ListValueConstraintValidator implements ConstraintValidator<ListValue, Integer> {

  private Set<Integer> set = new HashSet<>();

  /**
   * @Description 初始化方法
   * @Author mashanghaoyun
   * @Date 15:17 2020/8/31
   * @Param [constraintAnnotation]
   * @return void
   **/
  @Override
  public void initialize(ListValue constraintAnnotation) {
    int[] vals = constraintAnnotation.vals();
    if (vals.length > 0) {
      for (int val : vals) {
        set.add(val);
      }
    }
  }

  /**
   * @Description 判断是否校验成功
   * @Author mashanghaoyun
   * @Date 15:18 2020/8/31
   * @Param [value(当前提交校验的值), context]
   * @return boolean
   **/
  @Override
  public boolean isValid(Integer value, ConstraintValidatorContext context) {
    if (set.size() > 0) {
      if (set.contains(value)) {
        return true;
      }
    }
    return false;
  }
}

3、关联自定义注解与校验器

4、使用自定义注解

到此这篇关于Java如何使用JSR303校验数据与自定义校验注解的文章就介绍到这了,更多相关Java JSR303校验数据内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 作为Java程序员应该掌握的10项技能

    作为Java程序员应该掌握的10项技能

    这篇文章主要介绍了作为Java程序员应该掌握的10项技能,包括java的知识点与相关的技能,对于java的学习有不错的参考借鉴价值,需要的朋友可以参考下
    2015-05-05
  • 详解Java中static关键字的使用和原理

    详解Java中static关键字的使用和原理

    static可以用来修饰的成员变量和成员方法,被修饰的成员是属于类的,而不是单单是属于某个对象的。本文就来详细说说他的使用和原理,需要的可以参考一下
    2022-10-10
  • Java中进程、协程与线程的区别详解

    Java中进程、协程与线程的区别详解

    这篇文章主要介绍了Java中进程,线程,协程的概念、区别以及使用场景的选择,早期的操作系统每个程序就是一个进程,知道一个程序运行完,才能进行下一个进程,就是"单进程时代",一切的程序只能串行发生,需要的朋友可以参考下
    2023-08-08
  • eclipse/intellij idea 查看java源码和注释方法

    eclipse/intellij idea 查看java源码和注释方法

    下面小编就为大家带来一篇eclipse/intellij idea 查看java源码和注释方法。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-05-05
  • 解决

    解决"XML Parser Error on line 1: 前言中不允许有内容"错误

    解决用windows自带的记事编辑xml文件后出现 "XML Parser Error on line 1: 前言中不允许有内容。"的错误
    2018-02-02
  • IntelliJ IDEA 好用插件之analyze inspect code详解

    IntelliJ IDEA 好用插件之analyze inspect code详解

    这篇文章主要介绍了IntelliJ IDEA 好用插件之analyze inspect code的相关知识,本文通过图文并茂的形式给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧
    2020-12-12
  • Java数据结构之队列的简单定义与使用方法

    Java数据结构之队列的简单定义与使用方法

    这篇文章主要介绍了Java数据结构之队列的简单定义与使用方法,简单描述了队列的功能、特点,并结合java实例形式分析了队列的简单定义与使用方法,需要的朋友可以参考下
    2017-10-10
  • 关于maven打包时的报错: Return code is: 501 , ReasonPhrase:HTTPS Required

    关于maven打包时的报错: Return code is: 501 , ReasonPhrase:HTTPS Requ

    这篇文章主要介绍了关于maven打包时的报错: Return code is: 501 , ReasonPhrase:HTTPS Required,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-09-09
  • RocketMQ4.5.2 修改mqnamesrv 和 mqbroker的日志路径操作

    RocketMQ4.5.2 修改mqnamesrv 和 mqbroker的日志路径操作

    这篇文章主要介绍了RocketMQ 4.5.2 修改mqnamesrv 和 mqbroker的日志路径操作,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-07-07
  • 使用纯java config来配置spring mvc方式

    使用纯java config来配置spring mvc方式

    这篇文章主要介绍了使用纯java config来配置spring mvc方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-11-11

最新评论