首页 > 编程笔记 > Spring MVC笔记 阅读：11454

Spring MVC数据校验

通义灵码
一般情况下，用户的输入是随意的，为了保证数据的合法性，数据验证是所有 Web 应用必须处理的问题。

Spring MVC 有以下两种方法可以验证输入：
数据验证分为客户端验证和服务器端验证，客户端验证主要是过滤正常用户的误操作，通过 JavaScript 代码完成。服务器端验证是整个应用阻止非法数据的最后防线，通过在应用中编程实现。

本节使用 JSR 303 实现服务器端的数据验证。

JSR 303 是 Java 为 Bean 数据合法性校验所提供的标准框架。JSR 303 通过在 Bean 属性上标注类似于 @NotNull、@Max 等标准的注解指定校验规则，并通过标准的验证接口对 Bean 进行验证。可以通过 https://jcp.org/en/jsr/detail?id=303 查看详细内容并下载 JSR 303 Bean Validation。

JSR 303 不需要编写验证器，它定义了一套可标注在成员变量、属性方法上的校验注解，如下表所示。

名称 说明
@Null 被标注的元素必须为 null
@NotNull 被标注的元素必须不为 null
@AssertTrue 被标注的元素必须为 true
@AssertFalse 被标注的元素必须为 false
@Min(value) 被标注的元素必须是一个数字，其值必须大于等于指定的最小值
@Max(value) 被标注的元素必须是一个数字，其值必须小于等于指定的最大值
@DecimalMax(value) 被标注的元素必须是一个数字，其值必须大于等于指定的最大值
@DecimalMin(value) 被标注的元素必须是一个数字，其值必须小于等于指定的最小值
@size 被标注的元素的大小必须在指定的范围内
@Digits（integer，fraction） 被标注的元素必须是一个数字，其值必须在可接受的范围内；integer 指定整数精度，fraction 指定小数精度
@Past 被标注的元素必须是一个过去的日期
@Future 被标注的元素必须是一个将来的日期
@Pattern(value) 被标注的元素必须符合指定的正则表达式
Spring MVC 支持 JSR 303 标准的校验框架，Spring 的 DataBinder 在进行数据绑定时，可同时调用校验框架来完成数据校验工作，非常简单方便。在 Spring MVC 中，可以直接通过注解驱动的方式来进行数据校验。

Spring 本身没有提供 JSR 303 的实现，Hibernate Validator 实现了 JSR 303，所以必须在项目中加入来自 Hibernate Validator 库的 jar 文件，下载地址为 http://hibernate.org/validator/。本节使用版本为 hibernate-validator-5.1.0.Final-dist.zip，复制其中的 3 个 jar 文件即可，Spring 将会自动加载并装配。

示例

本节示例基于《@Controller和@RequestMapping注解》一节中的 springmvcDemo2 实现。

1. 导入依赖

pom.xml 文件中添加以下代码。 
  1. <!-- 数据校验 -->
  2. <dependency>
  3.     <groupId>javax.validation</groupId>
  4.     <artifactId>validation-api</artifactId>
  5.     <version>1.1.0.Final</version>
  6. </dependency>
  7. <dependency>
  8.     <groupId>org.jboss.logging</groupId>
  9.     <artifactId>jboss-logging</artifactId>
  10.     <version>3.1.0.CR2</version>
  11. </dependency>
  12. <dependency>
  13.     <groupId>org.hibernate</groupId>
  14.     <artifactId>hibernate-validator</artifactId>
  15.     <version>5.1.0.Final</version>
  16. </dependency>

2. 创建实体类

创建 User 实体类，代码如下。 
  1. package net.biancheng.po;
  2.  
  3. import javax.validation.constraints.NotNull;
  4.  
  5. import org.hibernate.validator.constraints.Email;
  6. import org.hibernate.validator.constraints.Length;
  7.  
  8. public class User {
  9.     @NotNull(message = "用户id不能为空")
  10.     private Integer id;
  11.     @NotNull
  12.     @Length(min = 2, max = 8, message = "用户名不能少于2位大于8位")
  13.     private String name;
  14.     @Email(regexp = "[a-zA-Z0-9]+@[a-zA-Z0-9]+\\.[a-zA-Z0-9]", message = "邮箱格式不正确")
  15.     private String email;
  16.  
  17.     /** 省略setter和getter方法*/
  18. }

3. 创建JSP页面

创建 addUser.jsp，代码如下。 
  1. <%@ page language="java" contentType="text/html; charset=UTF-8"
  2.     pageEncoding="UTF-8"%>
  3. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  4. <html>
  5. <head>
  6. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  7. <title>添加用户</title>
  8. </head>
  9. <body>
  10.     <form action="${pageContext.request.contextPath}/validate" method="post">
  11.         用户id：<input type="text" name="id" />
  12.         <br>
  13.         用户名：<input type="text" name="name" />
  14.         <br>
  15.         邮箱：<input type="text" name="email" />
  16.         <br>
  17.         <input type="submit" value="提交" />
  18.     </form>
  19. </body>
  20. </html>

4. 创建控制器

创建 UserController 控制器类，代码如下。 
  1. package net.biancheng.controller;
  2.  
  3. import java.util.List;
  4.  
  5. import javax.servlet.http.HttpServletRequest;
  6. import javax.servlet.http.HttpSession;
  7. import javax.validation.Valid;
  8.  
  9. import org.springframework.stereotype.Controller;
  10. import org.springframework.validation.BindingResult;
  11. import org.springframework.validation.ObjectError;
  12. import org.springframework.web.bind.annotation.PathVariable;
  13. import org.springframework.web.bind.annotation.RequestMapping;
  14. import org.springframework.web.bind.annotation.RequestMethod;
  15.  
  16. import net.biancheng.po.User;
  17.  
  18. @Controller
  19. public class UserController {
  20.  
  21.     @RequestMapping("/validate")
  22.     public String validate(@Valid User user, BindingResult result) {
  23.         // 如果有异常信息
  24.         if (result.hasErrors()) {
  25.             // 获取异常信息对象
  26.             List<ObjectError> errors = result.getAllErrors();
  27.             // 将异常信息输出
  28.             for (ObjectError error : errors) {
  29.                 System.out.println(error.getDefaultMessage());
  30.             }
  31.         }
  32.         return "index";
  33.     }
  34.  
  35.     @RequestMapping(value = "/addUser")
  36.     public String add() {
  37.  
  38.         return "addUser";
  39.     }
  40. }

5. 运行测试

访问地址：http://localhost:8080/springmvcDemo2/addUser，运行结果如下。

Eclipse 控制台输出结果如下。

邮箱格式不正确
用户id不能为空
用户名不能少于2位大于8位

相关文章