Spring进行表单验证

转自：https://www.tianmaying.com/tutorial/spring-form-validation

开发环境

IDE+Java环境（JDK 1.7或以上版本）
Maven 3.0+（Eclipse和Idea IntelliJ内置，如果使用IDE并且不使用命令行工具可以不安装）

POM文件如下：

pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>com.tianmaying</groupId>
  <artifactId>springboot-form-validation-demo</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <packaging>jar</packaging>

  <name>springboot-form-validation-demo</name>
  <description>Springboot form validation demo</description>

  <parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>1.2.5.RELEASE</version>
    <relativePath/>
  </parent>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <java.version>1.8</java.version>
  </properties>

  <dependencies>
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-thymeleaf</artifactId>
    </dependency> 
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-test</artifactId>
      <scope>test</scope>
    </dependency>
  </dependencies>

  <build>
    <plugins>
      <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
      </plugin>
    </plugins>
  </build>

</project>

通过标注设置验证规则

我们需要验证的是提交上来的HelloMessage信息，因此我们给这个类增加标注。我们希望打招呼的对象（name属性）的长度是2到30之间，打招呼的内容（message属性）的长度是10到300之间。让我们来看看如何进行标注：

HelloMessage.java

package com.tianmaying.springboot.formvalidation;

import javax.validation.constraints.Size;

public class HelloMessage {

    @Size(min=2, max=30) // 1
    private String name;

    @Size(min=10, max=300)// 2
    private String message;

    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public String getMessage() {
        return message;
    }
    public void setMessage(String message) {
        this.message = message;
    }

}

1和2两处通过简单的标注设定了验证规则，@Size(min=2, max=30)表示对应属性的字符串长度必须在2到30之间。当然，用于描述验证的规则的标注还有很多，大家可以去异步这里了解。

在Controller中进行验证

Controller中的代码相比无表单验证时，有了几处小的修改：

SayHelloController.java

    @RequestMapping(value="/sayhello", method=RequestMethod.POST)
    public String sayHello(@Valid HelloMessage helloMessage, BindingResult bindingResult, Model model) {

        if (bindingResult.hasErrors()) {
            return "sayhello";
        }

        model.addAttribute("helloMessage", helloMessage);
        return "message";
    }

在sayHello方法中包含了三个参数，HelloMessage参数是表单绑定的待验证的对象，BindingResult包含了验证结果信息，可以通过bindingResult.hasErrors()来判断验证是否通过，Model参数则是用来保存所有用于渲染View的数据。这里的逻辑时如果验证包含错误则返回原页面（这是页面中会显示出错误信息），验证通过则显示message.html页面。

注意

BindingResult参数必须紧跟着HelloMessage参数，否则可能无法得到正确的验证结果。

错误信息的显示

为了让提交表单的页面能够在验证有错误时显示错误信息，我们需要增加一些显示错误信息的HTML代码。

sayhello.html

<!DOCTYPE HTML>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>天码营经验: Spring表单验证</title>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
</head>
<body>
    <h1>表单处理演示</h1>
    <form action="#" th:action="@{/sayhello}" th:object="${helloMessage}" method="post">
        <p>friend: <input type="text" th:field="*{name}" /></p>
        <p th:if="${#fields.hasErrors('name')}" th:errors="*{name}">Name Error</p>
        <p>message: <input type="text" th:field="*{message}" /></p>
        <p th:if="${#fields.hasErrors('message')}" th:errors="*{message}">message Error</p>
        <p><input type="submit" value="Submit" /> <input type="reset" value="Reset" /></p>
    </form>
</body>
</html>

th:object="{helloMessage}"表示这是一个bean-backed的表单，在每个表单域的后面，都跟随着一个<P>元素来显示错误验证错误信息，比如<p th:if="${#fields.hasErrors('name')}" th:errors="*{name}">Name Error</p>。

Run起来

不解释，看这里

package com.tianmaying.springboot.formvalidation;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class App {

    public static void main(String[] args) {
        SpringApplication.run(App.class, args);
    }

}

这样表单验证就圆满成功啦！再来总结一下，基于Spring进行表单验证你只需要这三步：

通过标注设置验证规则，注意你还可以使用一些扩展实现提供的规则，比如验证是否为合法的email
在Controller中通过@Valid标注和BindingResult进行规则验证
在页面中展现规则，如果是返回JSON的REST服务，则不需要在页面中显示，在Controller中要根据BindingResult的结果生成对应的JSON数据