SpringBoot入门 (十一) 数据校验

本文记录学习在SpringBoot中做数据校验。

一什么是数据校验

　　数据校验就是在应用程序中，对输入进来得数据做语义分析判断，阻挡不符合规则得数据，放行符合规则得数据，以确保被保存得数据符合我们得数据存储规则。

　　在SpringMvc中做数据校验有2中方式：一种是 Spring 自带的验证框架，另外一种是利用 JSR 实现。JSR 是一个规范，提供了完整得一套 API，通过标注给对象属性添加约束。Hibernate Validator 就是对JSR 规范所有注解的具体实现，以及一些附加的约束注解。用户还可以自定义约束注解。Hibernate Validator提供得注解如下：

二使用示例

　　SpringBoot对数据校验也做了支持，默认提供的参数校验依赖于 hibernate-validator来实现。使用 Hibernate Validator校验数据，需要定义一个接收的数据模型，使用注解的形式描述字段校验的规则。通过前台页面提交form表单保存数据，后台做校验。

　　在pom.xml文件中引入依赖

<dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-thymeleaf</artifactId>
        </dependency>
        <dependency>
            <groupId>org.hibernate.validator</groupId>
            <artifactId>hibernate-validator</artifactId>
        </dependency>

　　写一个实体类，对相关属性字段通过注解添加校验规则

public class Person {

    @NotBlank(message = "不能为空")
    @Length(min = 2, max = 20, message = "长度要在2到20之间")
    private String name;

    @NotNull
    @Min(value = 17, message = "最小值为17")
    private Integer age;

    @NotEmpty
    @Email(message="邮件格式不正确")
    private String email;

  // 此处省略getter和setter

}

　　每个注解中得属性message是数据校验不通过时我们要给出得提示信息，如 @Email(message="邮件格式不正确") 当邮件格式校验不通过时，提示邮件格式不正确。

　　控制器

@Controller
public class TestController {

    @GetMapping("/info")
    public String info(Model model){
        Person person = new Person();
        model.addAttribute("person", person);
        return "person_info.html";
    }

    @PostMapping("/save")
    public String save(@Valid Person person, BindingResult result, Model model){
        if (result.hasErrors()) {
            model.addAttribute("person", person);
            return "person_info.html";
        }
　　　　//数据保存。。。
        model.addAttribute("success","校验通过，数据已保存");
        return "success.html";
    }

}

　　我们通过访问info方法，跳转到信息输入页面，提交数据时访问save方法，Person前得注解@Valid 说明当前对象要做数据校验，BindingResult 中会存储数据校验得结果，@Valid和BindingResult必须成对出现。如果校验不通过时即有错误信息，会进入if略记判断中，返回信息输入页面，展示错误提示信息。

　　信息输入页面

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <form th:action="@{/save}" th:method="post" th:object="${person}">
        <table>
            <tr>
                <td>name:</td>
                <td><input type="text" th:field="*{name}" th:value="${person.name}"/></td>
                <td th:if="${#fields.hasErrors('name')}" th:errors="*{name}" th:style="'color:red'">Name Error</td>
            </tr>
            <tr>
                <td>age:</td>
                <td><input type="text" th:field="*{age}" th:value="${person.age}"/></td>
                <td th:if="${#fields.hasErrors('age')}" th:errors="*{age}" th:style="'color:red'">Age Error</td>
            </tr>
            <tr>
                <td>email:</td>
                <td><input type="text" th:field="*{email}" th:value="${person.email}"/></td>
                <td th:if="${#fields.hasErrors('email')}" th:errors="*{email}" th:style="'color:red'">Email Error</td>
            </tr>
            <tr>
                <td th:colspan="2"><button th:type="submit">Submit</button></td>
            </tr>
        </table>
    </form>
</body>
</html>

　　th:object 要与后台接收校验得对象保持一致。访问info方法在页面随便输入一些信息，在提交数据，会看到校验结果

SpringBoot入门 (十一) 数据校验-LMLPHP

　　如果各项数据都符合规则，则校验通过，跳转至success页面

SpringBoot入门 (十一) 数据校验-LMLPHP

梓&艺