【java】实现自定义注解校验—

自定义注解校验的实现步骤：

1.创建注解类，编写校验注解，即类似@NotEmpty注解
2.编写自定义校验的逻辑实体类，编写具体的校验逻辑。(这个类可以实现ConstraintValidator这个接口，让注解用来校验)
3.开启使用自定义注解进行校验。

第一种实现自定义注解的方式：https://blog.csdn.net/m0_46459413/article/details/134257302?spm=1001.2014.3001.5502

第二种实现自定义注解的方式：

一、创建注解类：

1、创建类时，选择Annotation类型

在这里插入图片描述

2、编写注解类

在这里插入图片描述

如图是我们自定义的一个年龄注解，message是该注解校验失败时的提示信息，default是默认值，我们可以重写该提示信息。下面两行代码是自定义注解需要加上的，这里不作研究。

二、自定义注解校验逻辑的实现：

这里有两种实现方式，
一种是当注解仅仅作用在字段(属性)上生效时：可以在工具类中编写方法进行逻辑校验；
另一种：使用@Constraint注解，指明了校验类，进行校验，这里只实现第二种。

第二种：使用@Constraint注解，指明校验类，进行校验

EX：自定的Age注解上面有一个@Constraint注解，该注解指明了校验类，我们点进MyAnnoationValidator类看一下
在这里插入图片描述

可以看到校验类都必须要实现ConstraintValidator接口，并且重写接口中的两个方法。

接口上是有泛型的，第一个泛型代表了我们这个校验类是哪个注解的校验类，第二个泛型代表该注解校验的参数是什么类型，第二个注解默认是Object类型，我们改成了Integer类型，
initialize方法 是该校验类的初始化方法，在这个方法里，我们可以对传进来的参数作一些处理。
isValid方法 就是注解类型的核心校验方法，校验通过与否就是看该方法的返回值是true还是false，true就代表校验通过，false就代表校验失败

三、使用自定义注解：

自定义校验注解在代码中的应用

1、在dto中使用：

定义一个实体类User
在这里插入图片描述

2、在代码中使用：

定义一个Controller，使用@Valid注解我们的User类，@Valid注解没有实际的注解体，这个注解的作用就是使我们的@Age注解起作用。
后面的BindingResult类的作用是当注解校验失败时，我们可以手动去处理。如果不加这个类的话，注解校验失败，会直接返回http的400错误码。加上这个类，我们可以自己自定义错误信息，然后返回，此时的http状态码为200
在这里插入图片描述

3、@valid注解

1、@valid注解作用

@valid注解主要用于数据校验，在接口的入参实体类前添加@Valid注解，这时实体类会开启一个校验的功能；然后在入参实体类中的属性上，添加不同的注解（例如@NotBlank注解）来完成不同的校验规则。

2、@valid注解的使用

a、在实体类中添加@valid相关注解

使用@Valid相关注解非常简单，只需要在参数的实体类属性上添加如@NotBlank,@Max,@Min等注解对字段进行限制。如下：

public class User{
    @NotBlank(message = "姓名不为空")
    private String username;
    @NotBlank(message = "密码不为空")
    private String password;
}

如果嵌套了实体对象，则需要在最外层属性上添加@Valid注解，否则嵌套实体对象中的验证不生效

public class User{
    @NotBlank(message = "姓名不为空")
    private String username;
    @NotBlank(message = "密码不为空")
    private String password;
    //嵌套必须加@Valid，否则嵌套中的验证不生效
    @Valid
    @NotNull(message = "用户信息不能为空")
    private UserInfo userInfo;
}
public class UserInfo {
    @NotBlank(message = "年龄不为空")
    @Max(value = 18,message = "不超过18岁")
    private String age;
    @NotBlank(message = "性别不为空")
    private String gender;
}

b、在接口中添加@valid注解

在controller类中添加接口，POST方法中接收设置了@Valid相关注解的实体对象，然后再参数中添加@Valid注解来开启效验功能，需要注意的是，@Valid对Get请求中接收的平面参数请求无效。

@RestController
public class TestController {
    @PostMapping("/user")
    public String addUserInfo(@Valid @RequestBody User user){
        return "调用成功";
    }
}

参考链接：https://blog.csdn.net/weixin_43400432/article/details/126159450

四、观察仿照 @NotEmpty注解，编写自定义校验注解

1、观察下@NotEmpty 注解:

//
// Source code recreated from a .class file by IntelliJ IDEA
// (powered by Fernflower decompiler)
//
package org.hibernate.validator.constraints;
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
import javax.validation.Constraint;
import javax.validation.Payload;
import javax.validation.ReportAsSingleViolation;
import javax.validation.constraints.NotNull;
import javax.validation.constraints.Size;
import javax.validation.constraintvalidation.SupportedValidationTarget;
import javax.validation.constraintvalidation.ValidationTarget;
@Documented
@Constraint(
    validatedBy = {
    }
)
@SupportedValidationTarget({
    ValidationTarget.ANNOTATED_ELEMENT})
@Target({
    ElementType.METHOD, ElementType.FIELD, ElementType.ANNOTATION_TYPE, ElementType.CONSTRUCTOR, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
@ReportAsSingleViolation
@NotNull
@Size(
    min = 1
)
public @interface NotEmpty {
    String message() default "{org.hibernate.validator.constraints.NotEmpty.message}";
    Class<?>[] groups() default {
    };
    Class<? extends Payload>[] payload() default {
    };
    @Target({
    ElementType.METHOD, ElementType.FIELD, ElementType.ANNOTATION_TYPE, ElementType.CONSTRUCTOR, ElementType.PARAMETER})
    @Retention(RetentionPolicy.RUNTIME)
    @Documented
    public @interface List {
        NotEmpty[] value();
    }
}

2、编写身份证校验自定义注解类，也必须有message、groups、payload.

package com.zzidc.web.validator;
import javax.validation.Constraint;
import javax.validation.Payload;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
/*
 * @Description //TODO
 * @Date 2019/3/29 17:22
 * @Param
 * @return
 **/
//注解是指定当前自定义注解可以使用在哪些地方，这里仅仅让他可以使用在方法上和属性上；
@Target({
    ElementType.METHOD,ElementType.FIELD})
//指定当前注解保留到运行时；
@Retention(RetentionPolicy.RUNTIME)
//指定了当前注解使用哪个类来进行校验。
@Constraint(validatedBy = IdCardValidator.class) //
public @interface IsIdCard {
    String message();
    // default 关键字 接口中被default修饰的方法，在类实现这个接口时不必必须实现这个方法
    Class<?>[] groups() default {
     };
    // Class<?> 表示不确定的java类型
    // Class<T> 表示java类型
    // Class<K,V> 分别代表java键值中的key value
    // Class<E> 代表Element
    Class<? extends Payload>[] payload() default {
    };
}

3. 编写校验注解的逻辑类：IdCardValidator.class，该类必须实现ConstraintValidator

package com.zzidc.web.validator;
import com.zzidc.web.service.IdCardValidatorService;
import org.springframework.beans.factory.annotation.Autowired;
import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;
/**
 * @ClassName IdCardValidator
 * @Description  校验注解的校验逻辑
 * @Date 2019/3/29 17:23
 **/
public class IdCardValidator implements ConstraintValidator<IsIdCard,String>{
    @Autowired
    private IdCardValidatorService idCardValidatorService;
    /*
     * @Description 校验前的初始化工作
     * @Date 2019/3/29 17:27
     * @Param [isIdCard]
     * @return void
     **/
    @Override
    public void initialize(IsIdCard isIdCard) {
        String message = isIdCard.message();
        System.out.println("自定义的message信息是:".concat(message));
    }
    /*
     * @Description 具体的校验逻辑
     * @Date 2019/3/29 17:29
     * @Param [s, constraintValidatorContext]
     * @return boolean
     **/
    @Override
    public boolean isValid(String s, ConstraintValidatorContext constraintValidatorContext) {
        return idCardValidatorService.volid(s);
    }
}

我们将具体校验逻辑抽出来，抽成一个service：

package com.zzidc.web.service;
/**
 * @ClassName IdCardValidatorService
 * @Description TODO
 * @Date 2019/3/29 17:34
 **/
public interface IdCardValidatorService {
    boolean volid(String value);
}

service实现类：

package com.zzidc.web.service.impl;
import com.zzidc.web.service.IdCardValidatorService;
import com.zzidc.web.utils.IdCardUtils;
import org.springframework.stereotype.Service;
/**
 * @ClassName IdCardValidatorServiceImpl
 * @Description TODO
 * @Date 2019/3/29 17:35
 **/
@Service
public class IdCardValidatorServiceImpl implements IdCardValidatorService {
    @Override
    public boolean volid(String value) {
        return IdCardUtils.isValidIdCard(value);
    }
}

身份证工具校验类:

package com.zzidc.web.utils;
import org.apache.commons.lang3.StringUtils;
/**
 * @ClassName IdCardUtils
 * @Description TODO
 * @Date 2019/3/29 17:37
 **/
public class IdCardUtils {
    public static boolean isValidIdCard(String value){
        String regex = "^(0|86|17951)?(13[0-9]|15[012356789]|17[678]|18[0-9]|14[57])[0-9]{8}$";
        if (StringUtils.isBlank(value)) {
            return false;
        }
        return value.matches(regex);
    }
}