SpringBoot + Thymeleaf + Validate验证

　　

　　在开发业务时，不可避免的需要处理一些校验， 如果是写 if-else 这种代码去校验， 那会有一大段这样的代码。不过还好有个校验插件： javax.validation.validation-api ，不过一般会引用hibernate的校验组件： org.hibernate.hibernate-validator ， 它已经引用了validation-api组件。

1.基础校验类型

　　JSR303 是一套JavaBean参数校验的标准，它定义了很多常用的校验注解，我们可以直接将这些注解加在我们JavaBean的属性上面，就可以在需要校验的时候进行校验了。注解如下：
创建需要被校验的实体类，使用一些比较常用的校验注解，还是比较浅显易懂的，字段上的注解名称即可推断出校验内容，每一个注解都包含了message字段，用于校验失败时作为提示信息，
特殊的校验注解，如Pattern（正则校验），还可以自己添加正则表达式，在实体类上加上@notnull @size等验证，例如：

 @Entity
 @Table(name = "userinfo", uniqueConstraints = @UniqueConstraint(columnNames = "username"))
  public class User {
     private Integer id;
    @Size(min = 4, max = 15, message = "用户名长度为4-15位")
    private String username;
    @Size(min = 6, max = 18, message = "密码长度为6-18位")
    private String password;
    @Pattern(regexp = "^([a-z0-9A-Z]+[-|\\.]?)+[a-z0-9A-Z]@([a-z0-9A-Z]+(-[a-z0-9A-Z]+)?\\.)+[a-zA-Z]{2,}$", message = "邮箱格式不正确")
    private String email;
     @Pattern(regexp = "^((13[0-9])|(15[^4,\\D])|(18[0,5-9]))\\d{8}$", message = "手机号填写错误")
     private String phone;
     @NotEmpty(message = "性别不能为空")
     private String sex;
     private Date creat_time;
     private Date update_time;
     @Id
     @GeneratedValue
        public Integer getId() {
             return id;
          }
        //省略后面set和get方法

　　说明：

@null  被注释的元素必须为空
 @notnull  被注释的元素必须不为空
 @AssertTrue  被注释的元素必须为true
 @AssertFalse  被注释的元素必须为false
 @Min  被注释的元素必须是一个数字，其值必须大于等于指定的最小数
 @Max  被注释的元素必须是一个数字，其值必须小于等于指定的最大数
 @DecimalMin  被注释的元素必须是一个数字，其值必须大于等于指定的最小数
 @DecimalMax  被注释的元素必须是一个数字，其值必须小于等于指定的最大数
 @Size(min,max)  被注释的元素的大小必须在指定的范围内
 @Digits（integer，fraction） 被注释的元素必须是一个数字，其值必须在可接受的范围内
 @past  被注释的元素必须是一个过去的日期
 @Future  被注释的元素必须是一个将来的日期
 @Pattern(value)  被注释的元素必须符合指定的正则表达式
 @Email  被注释的元素必须是电子邮箱
 @Length  被注释的字符串的大小必须在指定的范围内
 @NotEmpty  被注释的字符串必须非空
 @Range  被注释的元素必须在合适的范围内

　　 @NotNull  和  @NotEmpty   和 @NotBlank  区别：

　　@NotEmpty  用在集合类上面，@NotBlank  用在String上面， @NotNull  用在基本类型上。

我们可以看到我们在username、password和age对应的get方法上都加上了一个注解，这些注解就是JSR-303里面定义的限制，把对应的校验错误信息放到Spring的Errors对象中。

2.在@Controller中校验数据

　　接着我们来定义一个使用User对象作为参数接收者的Controller，其代码如下所示：

 @Controller
  public class FooController {
  @RequestMapping("/foo")
     public String foo(@Validated Foo foo <1>, BindingResult bindingResult <2>) {
         if(bindingResult.hasErrors()){
             for (FieldError fieldError : bindingResult.getFieldErrors()) {
                 //...
             }
             return "fail";
         }
         return "success";
     }
 }

　　<1> 参数Foo前需要加上 @Validated 注解，表明需要spring对其进行校验，而校验的信息会存放到其后的 BindingResult 中。注意，必须相邻，如果有多个参数需要校验，形式可以如下。 foo(@Validated Foo foo, BindingResult fooBindingResult ，@Validated Bar bar, BindingResult barBindingResult){ //*** }  ;即一个校验类对应一个校验结果。
　　<2> 校验结果会被自动填充，在controller中可以根据业务逻辑来决定具体的操作，如跳转到错误页面。

3.页面获取message里的错误信息

　　现、在Form里 th：Object 里添加实体的对象，通过 #fields.hasErrors（'字段名'） 判断该字段是否有错误，如果有错误，通过 th：errors=“*{字段名}” 显示messages里的错误信息提示。例如：

<p th:if="${#fields.hasErrors('username')} " th:errors="*{username}" class="text-danger"></p>

4.分组校验

　　例如：

 Class Foo{
       @Min(value = 18,groups = {Adult.class})
       private Integer age;
       public interface Adult{}
       public interface Minor{}
           }  

　　这个里的age只有在Adult的分组下才会背校验，例如：

 @RequestMapping("/drink")
 public String drink(@Validated({Foo.Adult.class}) Foo foo, BindingResult bindingResult) {
     if(bindingResult.hasErrors()){
         for (FieldError fieldError : bindingResult.getFieldErrors()) {}......

5.自定义校验

　　(1)我们尝试添加一个“字符串不能包含空格”的限制。

 @Target({METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER})
 @Retention(RUNTIME)
 @Documented
 @Constraint(validatedBy = {CannotHaveBlankValidator.class})<1>
 public @interface CannotHaveBlank {
     //默认错误消息
     String message() default "不能包含空格";
     //分组
     Class<?>[] groups() default {};
     //负载
     Class<? extends Payload>[] payload() default {};
     //指定多个时使用
     @Target({FIELD, METHOD, PARAMETER, ANNOTATION_TYPE})
     @Retention(RUNTIME)
     @Documented
     @interface List {
         CannotHaveBlank[] value();
     }
 }

　　我们不需要关注太多东西，使用spring validation的原则便是便捷我们的开发，例如payload，List ，groups，都可以忽略。

<1>自定义注解中指定了这个注解真正的验证者类。

（2）编写真正的校验者类

 public class CannotHaveBlankValidator implements <1> ConstraintValidator<CannotHaveBlank, String> {
     @Override
     public void initialize(CannotHaveBlank constraintAnnotation) {
     }
     @Override
     public boolean isValid(String value, ConstraintValidatorContext context <2>) {
         //null时不进行校验
         if (value != null && value.contains(" ")) {
             <3>
             //获取默认提示信息
             String defaultConstraintMessageTemplate = context.getDefaultConstraintMessageTemplate();
             System.out.println("default message :" + defaultConstraintMessageTemplate);
             //禁用默认提示信息
             context.disableDefaultConstraintViolation();
             //设置提示语
             context.buildConstraintViolationWithTemplate("can not contains blank").addConstraintViolation();
             return false;
         }
         return true;
     }
 }

<1> 所有的验证者都需要实现ConstraintValidator接口，它的接口也很形象，包含一个初始化事件方法，和一个判断是否合法的方法。

 public interface ConstraintValidator<A extends Annotation, T> {

     void initialize(A constraintAnnotation);

     boolean isValid(T value, ConstraintValidatorContext context);
 }

<2>  ConstraintValidatorContext  这个上下文包含了认证中所有的信息，我们可以利用这个上下文实现获取默认错误提示信息，禁用错误提示信息，改写错误提示信息等操作。
<3> 一些典型校验操作，或许可以对你产生启示作用。
值得注意的一点是，自定义注解可以用在METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER之上， ConstraintValidator 的第二个泛型参数T，是需要被校验的类型。