Como personalizar a anotação de verificação simples com base em JSR303 no SpringBoot

1. Meio Ambiente

• SpringBoot 2.2.2.RELEASE
• Dependência validation-api(aqui está apenas a dependência da introdução da função)

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

2. Escreva uma anotação de inspeção personalizada

• Para escrever uma @interfaceclasse, uso ValidValue como exemplo aqui.
• Os três seguintes são exigidos JSR303pelos regulamentos

	// 校验不通过时返回的错误信息
    String message() default "The specified value must be submitted";
	// 在需要多个校验规则的时候可以指定是哪个组的校验规则
    Class<?>[] groups() default {
    
    };
	//
    Class<? extends Payload>[] payload() default {
    
    };

• As regras definidas são as regras que int[] vals() default {};você deseja usar para verificação. Isso significa que o número inserido deve estar na matriz.
• O exemplo completo é o seguinte ( se você não sabe o que as anotações na aula usam, você pode apenas clicar em uma anotação de verificação e copiá-la )
• O ValidValueConstraintValidatorvalidador interno (descrito abaixo) precisa ser vinculado às suas anotações de validação

/**
 * @Author: llzhyaa 
 * @Date: 2020/4/10 21:05
 * validatedBy = {} 可以指定多个校验器
 */
@Documented
@Constraint(
        validatedBy = {
    
    ValidValueConstraintValidator.class}
)
@Target({
    
    ElementType.METHOD, ElementType.FIELD, ElementType.ANNOTATION_TYPE, ElementType.CONSTRUCTOR, ElementType.PARAMETER, ElementType.TYPE_USE})
@Retention(RetentionPolicy.RUNTIME)
public @interface ValidValue{
    
    
    // 这三个是必须有的
    String message() default "The specified value must be submitted";

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

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

    int[] vals() default  {
    
    };
}

3. Escreva um validador personalizado

• Precisa definir um validador
• A extends Annotation 指定注解 (就是你上面自定义注解的名字)
• T 指定类型 ，就是你需要校验的变量的类型

/**
 * @Author: llzhyaa 
 * @Date: 2020/4/10 21:15
 * 校验器
 * ConstraintValidator<A extends Annotation, T>
 *     A extends Annotation 指定注解 (就是你上面自定义注解的名字)
 *     T 指定类型 
 */
public class ValidValueConstraintValidator implements ConstraintValidator<ValidValue,Integer> {
    
    

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

    @Override
    public void initialize(ValidValue constraintAnnotation) {
    
    
        // 初始化 , 获取到在你注解上的数字，存入一个set中
        int[] vals = constraintAnnotation.vals();
        if(vals  != null){
    
    
          for (int val : vals) {
    
    
            set.add(val);
       		 }
        }	
    }

    // 判断是否校验成功

    /**
     *
     * @param integer 需要校验的值（就是你传入的值）
     * @param constraintValidatorContext
     * @return
     */
    @Override
    public boolean isValid(Integer integer, ConstraintValidatorContext constraintValidatorContext) {
    
    
		// 校验，获取到你输入的数字是否包含在你之前的set中
        return set.contains(integer);
    }
}

• Associar um verificador personalizado a uma anotação de verificação personalizada
• Isso é para @Constraintligar seu validador personalizado em sua anotação de validação personalizada

@Constraint(
      validatedBy = {
    
    ValidValueConstraintValidator.class}
)

4. Adicione um comentário sobre o seu controlador

• @ValidIndica que o valor recebido precisa ser verificado
• BindingResult result, Você pode obter as informações de erro

	@ResponseBody
    @RequestMapping("/test")
    public Map<String,String> test(@Valid String showStatus ,BindingResult result){
    
    
       if (result.hasErrors()){
    
    
            // 获取错误结果
            Map<String,String> map = new HashMap<>();
            result.getFieldErrors().forEach((item)->{
    
    
                // FieldError 获取错误提示
                String message = item.getDefaultMessage();
                String field = item.getField();
                map.put(field,message);
            })
        }
        return map ;
    }

4. Teste

• Basta adicionar suas anotações às variáveis ​​que você precisa verificar
• @ValidValue(vals = {0,1}), O que significa que o número inserido deve ser 0 ou 1. Se for outro número, um erro será relatado

	@ValidValue(vals = {
    
    0,1})
	private Integer showStatus;

• Basta olhar para os detalhes do erro,

 	{
    
    
   		 // 这里就是你自定义的默认返回错误
        "showStatus": "The specified value must be submitted",
    }

5. Como personalizar a mensagem de erro retornada

• Nos comentários fornecidos pelo pacote jar, suas mensagens de erro são todas colocadas no pacote jar, que pode ser visto por ValidationMessages.propertiespesquisa global ValidationMessages.
• Por exemplo

javax.validation.constraints.AssertFalse.message     = must be false
javax.validation.constraints.AssertTrue.message      = must be true
javax.validation.constraints.DecimalMax.message      = must be less than ${
    
    inclusive == true ? 'or equal to ' : ''}{
    
    value}
javax.validation.constraints.DecimalMin.message      = must be greater than ${
    
    inclusive == true ? 'or equal to ' : ''}{
    
    value}
javax.validation.constraints.Digits.message          = numeric value out of bounds (<{
    
    integer} digits>.<{
    
    fraction} digits> expected)
javax.validation.constraints.Email.message           = must be a well-formed email address
javax.validation.constraints.Future.message          = must be a future date
javax.validation.constraints.FutureOrPresent.message = must be a date in the present or in the future
javax.validation.constraints.Max.message             = must be less than or equal to {
    
    value}
javax.validation.constraints.Min.message             = must be greater than or equal to {
    
    value}
javax.validation.constraints.Negative.message        = must be less than 0
javax.validation.constraints.NegativeOrZero.message  = must be less than or equal to 0
javax.validation.constraints.NotBlank.message        = must not be blank
javax.validation.constraints.NotEmpty.message        = must not be empty
javax.validation.constraints.NotNull.message         = must not be null

• Então, nós mesmos escrevemos um ValidationMessages.propertiesarquivo e o colocamos no diretório de recursos
• com.study.common.valid.ValidValue.messageÉ a sua anotação personalizada mais.message

com.study.common.valid.ValidValue.message=输入的数字必须不规范

• Em seguida, as informações de retorno padrão acima de sua anotação personalizada precisam ser modificadas

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