SpringMVC-快速入门（五）- 校验数据

JSR是Java Specification Requests的缩写，意思是Java 规范提案。JSR303–Bean Validation 是一个数据验证的规范。常用hibernate-validator实现校验。

1、添加hibernate-validator依赖

pom.xml配置文件，添加依赖。

<!--JSR303 Bean校验-->
<dependency>
  <groupId>org.hibernate</groupId>
  <artifactId>hibernate-validator</artifactId>
  <version>5.3.6.Final</version>
</dependency>
<dependency>
  <groupId>javax.validation</groupId>
  <artifactId>validation-api</artifactId>
  <version>2.0.1.Final</version>
</dependency>

2、注解Bean

类Product的name属性增加 @NotEmpty(message = “用户名不能为空”)

public class Product {

    private int id;
    @NotEmpty(message = "用户名不能为空")
    private String name;
    private float price;

    public int getId() {
        return id;
    }
    public void setId(int id) {
        this.id = id;
    }
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public float getPrice() {
        return price;
    }
    public void setPrice(float price) {
        this.price = price;
    }

    public Product() { }
    public Product(int id, String name, float price) {
        this.id = id;
        this.name = name;
        this.price = price;
    }

    @Override
    public String toString() {
        return "编号(id)：" + this.getId() + "，名称(name)：" + this.getName() + "，价格(price)：" + this.getPrice();
    }
}

• 空值检查
  • @Null：验证对象是否为null
  • @NotNull：验证对象是否不为null, 无法查检长度为0的字符串
  • @NotBlank：检查约束字符串是不是Null还有被Trim的长度是否大于0，只对字符串，且会去掉前后空格。
  • @NotEmpty：检查约束元素是否为NULL或者是EMPTY.
• Booelan检查
  • @AssertTrue：验证 Boolean 对象是否为 true
  • @AssertFalse：验证 Boolean 对象是否为 false
• 长度检查
  • @Size(min=, max=)：验证对象（Array,Collection,Map,String）长度是否在给定的范围之内
  • @Length(min=, max=)：Validates that the annotated string is between min and max included.
• 日期检查
  • @Past：验证 Date 和 Calendar 对象是否在当前时间之前
  • @Future：验证 Date 和 Calendar 对象是否在当前时间之后
  • @DateTimeFormat(pattern=“yyyy-MM-dd”)：验证日期格式
• 正则
  • @Pattern：验证 String 对象是否符合正则表达式的规则
• 数值检查 建议使用在Stirng,Integer类型，不建议使用在int类型上，因为表单值为“”时无法转换为int，但可以转换为String为"",Integer为null
  • @Min：验证 Number 和 String 对象是否大等于指定的值
  • @Max：验证 Number 和 String 对象是否小等于指定的值
  • @DecimalMax：被标注的值必须不大于约束中指定的最大值. 这个约束的参数是一个通过BigDecimal定义的最大值的字符串表示.小数存在精度
  • @DecimalMin：被标注的值必须不小于约束中指定的最小值. 这个约束的参数是一个通过BigDecimal定义的最小值的字符串表示.小数存在精度
  • @Digits：验证 Number 和 String 的构成是否合法
  • @Digits(integer=,fraction=)：验证字符串是否是符合指定格式的数字，interger指定整数精度，fraction指定小数精度。
• 范围
  • @Range(min=, max=)：检查被注解对象的值是否处于min与max之间，闭区间，包含min与max值
  • @Range(min=10000,max=50000,message=“必须介于{2}-{1}之间”)
• 其它注解
  • @Valid：递归的对关联对象进行校验, 如果关联对象是个集合或者数组，那么对其中的元素进行递归校验，如果是一个map，则对其中的值部分进行校验。(是否进行递归验证)，该注解使用在Action的参数上。
  • @CreditCardNumber：信用卡验证
  • @Email：验证是否是邮件地址，如果为null,不进行验证，算通过验证。
  • @ScriptAssert(lang= ,script=, alias=)
  • @URL(protocol=,host=, port=,regexp=, flags=)

3、注解控制器参数

@Controller
@RequestMapping("/param")
public class ParamController {
    @RequestMapping("/action11")
    @ResponseBody
    public Product action11(@RequestBody  Product product){
        System.out.println(product);
        return product;
    }

    @RequestMapping("/action12")
    @ResponseBody
    public Product action12(@RequestBody @Validated Product product){
        System.out.println(product);
        return product;
    }
}

访问 http://localhost:8080/param/action11，结果：

访问 http://localhost:8080/param/action12，结果：

对比结果看出，action12中的 @Validated起作用了，它会校验对象product的属性，而类Product的属性name注解@NotEmpty(message = “用户名不能为空”)，故返回 “Status 400”。

@Valid 和 @Validated

• @Valid是使用hibernate validation的时候使用
• @Validated是使用spring Validator校验机制使用

@RequestMapping("/action12")
@ResponseBody
public Product action12(@RequestBody @Validated Product product){
    System.out.println(product);
    return product;
}

@RequestMapping("/action13")
@ResponseBody
public Product action13(@RequestBody @Valid Product product){
    System.out.println(product);
    return product;
}

访问 http://localhost:8080/param/action13，结果：

上送属性 name ，访问 http://localhost:8080/param/action13，结果：