Spring Boot Validating 校验请求参数

目录

javax.validation.constraints 介绍 开发环境 基础示例 总结

javax.validation.constraints 介绍

javax.validation.constraints 包含全部 Bean Validation 提供的约束，又称为内置约束。参考最新的 Java(TM) EE 7

一、Specification APIs，共提供 13 个注解类：

二、AssertFalse：被注解的元素必须为 false 或 null

三、AssertTrue：被注解的元素必须为 true 或 null

四、DecimalMax(value)：被注解的元素必须是一个数字，支持类型包括BigDecimal、BigInteger、CharSequence、byte、short、int、long 以及对应的包装器类型，可是因为精度问题并不支持 double 和 float，且值必须小于等于指定的最小值，也接受 null

五、DecimalMin(value)：被注解的元素必须是一个数字，支持类型和 DecimalMax 一致，且值必须大于等于指定的最小值，也接受 nullDigits(fraction, integer)：被注解的元素必须是一个数字，包括BigDecimal、BigInteger、CharSequence、byte、short、int、long 以及对应的包装器类型，且值必须在可接受的范围内

六、Future：被注解的元素必须是一个未来的日期或 null，支持类型包括 java.util.Date 和 java.util.Calendar

七、Max(value)：被注解的元素必须是一个数字，支持类型和 DecimalMax 一致，且值必须小于等于指定的最大值

八、Min(value)：被注解的元素必须是一个数字，支持类型和 DecimalMax 一致，且值必须大于等于指定的最小值

九、NotNull：被注解的元素不能为 null

十、Null：被注解的元素必须为 null

十一、Past：被注解的元素必须是一个过去的日期，支持类型包括 java.util.Date 和 java.util.Calendar

十二、Pattern(value)：被注解的元素必须符合指定的正则表达式，支持类型 CharSequence，也接受 CharSequence. null

1三、Size(max, min)：被注解的元素大小必须在指定的范围内，支持类型包括：CharSequence、Collection、Map、Array

开发环境

Oracle JDK 1.8.0_201

Apache Maven 3.6.0

IntelliJ IDEA (Version 2018.3.3)

基础示例

1/建立 Spring Boot 工程，参考：IntelliJ IDEA 建立 Spring Boot 工程。

2/生成的 pom 文件以下，注意须要添加 spring-boot-starter-web 和 org.hibernate.validator:hibernate-validator 依赖。

< ?xml version="1.0" encoding="UTF-8"?>

< project xmlns="maven.apache.org/POM/4.0.0" xmlns:xsi="www.w3.org/2001/XMLSch…"

xsi:schemaLocation="maven.apache.org/POM/4.0.0 maven.apache.org/xsd/maven-4…">

< modelVersion>4.0.0< /modelVersion>

< parent>

< groupId>org.springframework.boot< /groupId>

< artifactId>spring-boot-starter-parent< /artifactId>

< version>2.1.4.RELEASE< /version>

< relativePath/>

< /parent>

< groupId>tutorial.spring.boot< /groupId>

< artifactId>spring-boot-validating</ artifactId>

< version>0.0.1-SNAPSHOT</ version>

< na me>spring-boot-validating< /name>

< description >Spring Boot Validating< /description>

< properties>

< java.version>1.8< /java.version>

< /properties>

< dependencies>

< dependency>

< groupId>org.springframework.boot</ groupId>

< artifactId>spring-boot-starter-web</ artifactId>

< /dependency>

< dependency>

< groupId>org.hibernate.validator</ groupId>

< artifactId>hibernate-validator</ artifactId>

< version>6.0.16.Final</ version>

< /dependency>

< dependency>

< g roupId>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>

建立实体类（领域模型）。

package tutorial.spring.boot.validating.domain;

import javax.validation.constraints.*;

import java.util.Date;

public class User {

@NotNull(message = "姓名不能为空")

@Size(min = 2, max = 20, message = "不知足姓名长度要求：2~20")

private String name;

@NotNull(message = "年龄不能为空")

@Max(value = 16, message = "不知足最大年龄16岁")

private Integer age;

@Min(value = 150, message = "不知足最小身高1米5")

private Double height;

@Pattern(regexp = "^[1]+@[a-zA-Z0-9-]+(.[a-zA-Z0-9-]+)*.[a-zA-Z0-9]{2,6}$", message =

"不知足邮箱正则表达式")

private String email;

@Past(message = "出生日期非法")

private Date birth;

@AssertTrue(message = "不知足会员要求")

private Boolean member;

public String getName() {

return name;

} public void setName(String name) {

this.name = name;

} public Integer getAge() {

return age;

}

public void setAge(Integer age) {

this.age = age;

} public Double getHeight() {

return height;

} public void setHeight(Double height) {

this.height = height;

} public String getEmail() {

return email; } public void setEmail(String email) {

this.email = email;

} public Date getBirth() {

return birth;

} public void setBirth(Date birth) {

this.birth = birth;

} public Boolean getMember() {

return member;

} public void setMember(Boolean member) {

this.member = member;

} @Override

public String toString() {

return "User{" +

"name='" + name + ''' +

", age=" + age +

", height=" + height +

", email='" + email + ''' +

", birth=" + birth +

", member=" + member +

'}';

}

}

编写校验请求的接口。

package tutorial.spring.boot.validating.controller;

import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

import org.springframework.beans.propertyeditors.CustomDateEditor;

import org.springframework.validation.BindingResult;

import org.springframework.web.bind.ServletRequestDataBinder;

import org.springframework.web.bind.annotation.InitBinder;

import org.springframework.web.bind.annotation.PostMapping;

import org.springframework.web.bind.annotation.RequestMapping;

import org.springframework.web.bind.annotation.RestController;

import tutorial.spring.boot.validating.domain.User;

import javax.servlet.http.HttpServletRequest;

import javax.validation.Valid;

import java.text.SimpleDateFormat;

import java.util.Date;

@RestController

@RequestMapping("/")

public class UserController {

private static final Logger LOGGER = LoggerFactory.getLogger(UserController.class);

@InitBinder

protected void init(HttpServletRequest request, ServletRequestDataBinder binder) {

SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd");

format.setLenient(false);

binder.registerCustomEditor(Date.class, new CustomDateEditor(format, false));

}

@PostMapping

public String validateUser(@Valid User user, BindingResult bindingResult) {

if (bindingResult.hasErrors()) {

bindingResult.getAllErrors().forEach(error -> LOGGER.error(error.getDefaultMessage()));

return "User is invalid: " + user;

}

return "User is valid: " + user;

}

} 注意：@InitBinder 注解的 init 方法是用来处理 java.util.Date 类型转换的（String 转 Date）。

启动后使用 Postman 测试。

控制台打印日志以下：

2019-04-23 21:09:20.362 ERROR 13380 --- [nio-8080-exec-2] t.s.b.v.controller.UserController : 出生日期非法

2019-04-23 21:09:20.362 ERROR 13380 --- [nio-8080-exec-2] t.s.b.v.controller.UserController : 不知足邮箱正则表达式

2019-04-23 21:09:20.362 ERROR 13380 --- [nio-8080-exec-2] t.s.b.v.controller.UserController : 不知足最大年龄16岁

2019-04-23 21:09:20.362 ERROR 13380 --- [nio-8080-exec-2] t.s.b.v.controller.UserController : 不知足会员要求

2019-04-23 21:09:20.362 ERROR 13380 --- [nio-8080-exec-2] t.s.b.v.controller.UserController : 不知足最小身高1米5

2019-04-23 21:09:20.362 ERROR 13380 --- [nio-8080-exec-2] t.s.b.v.controller.UserController : 不知足姓名长度要求：2~20

总结 源码：gitee.com/jyl16269386…

---

1. a-zA-Z0-9_.- ↩︎