Spring Boot Validator 學習筆記
阿新 • • 發佈:2018-11-03
Spring Boot Validator 筆記
1 背景
開發過程中,後臺的引數校驗是必不可少的,本文關於 spring-boot-starter-validation
的學習筆記
2 示例
2.1 如何在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.littlefxc</groupId>
<artifactId>personal</artifactId>
<version>1.0-snapshot</version>
<packaging>jar</packaging >
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<java.version>1.8</java.version>
</properties>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>1.5.16.RELEASE</version>
</parent>
<dependencies>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
</dependency>
<!-- 熱部署 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-devtools</artifactId>
</dependency>
<!-- web -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- 校驗框架 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-validation</artifactId>
</dependency>
</dependencies>
<repositories>
<repository>
<id>central</id>
<name>central</name>
<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
<layout>default</layout>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
</repositories>
</project>
2.2 Hibernate Validator 常用註解
2.3 建立自定義校驗器
2.3.1 建立自定義註解
package com.littlefxc.examples.validation;
import javax.validation.Constraint;
import javax.validation.Payload;
import javax.validation.ReportAsSingleViolation;
import javax.validation.constraints.Pattern;
import java.lang.annotation.Documented;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;
import static java.lang.annotation.ElementType.*;
import static java.lang.annotation.ElementType.PARAMETER;
import static java.lang.annotation.RetentionPolicy.RUNTIME;
/**
* @author fengxuechao
*/
@Documented
@Constraint(validatedBy = { })
@Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER })
@Retention(RUNTIME)
@ReportAsSingleViolation@Pattern(regexp = "")
public @interface IsPhone {
/**
* 錯誤提示
* @return
*/
String message() default "{login.phone.invalid}";
Class<?>[] groups() default {};
Class<? extends Payload>[] payload() default {};
}
2.3.2 實現ConstraintValidator
僅僅建立註解是沒有任何意義的,必須與ConstraintValidator這個介面配合,才能使自定義註解生效
package com.littlefxc.examples.validation;
import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;
import java.util.regex.Pattern;
/**
* @author fengxuechao
*/public class IsPhoneConstraintValidator implements ConstraintValidator<IsPhone, String> {
private Pattern pattern = Pattern.compile("^(13[0-9]|14[579]|15[0-3,5-9]|16[6]|17[0135678]|18[0-9]|19[89])\\d{8}$");
@Override
public void initialize(IsPhone constraintAnnotation) {
//啟動時執行
}
/**
* 自定義校驗邏輯
* @param value CharSequence為校驗的型別
* @param context
* @return
*/
@Override
public boolean isValid(String value, ConstraintValidatorContext context) {
if (value == null || value.length() == 0) {
return true;
}
return pattern.matcher(value).matches();
}
}
2.3.3 組合驗證:建立兩個介面表示新增時和編輯時
package com.littlefxc.examples.validation;
/**
* 新增時
* @author fengxuechao
*/public interface ValidatorAdd {
}
package com.littlefxc.examples.validation;
/**
* 編輯時
* @author fengxuechao
*/public interface ValidatorEdit {
}
2.3.4 定義錯誤資訊
Spring Boot Validation約定錯誤資訊放在resources資料夾下的ValidationMessages.properties。
檔案中key代表的是校驗框架註解中的message屬性。
login.id.NotNull=id不能為空
login.username.NotBlank=使用者名稱不能為空
login.username.Email=使用者名稱必須是郵箱賬號
login.password.NotBlank=密碼不能為空
login.password.Length=密碼長度至少為6位
login.phone.invalid="手機號格式不合法"
2.3.5 建立實體類
package com.littlefxc.examples.model;
import com.littlefxc.examples.validation.IsPhone;
import com.littlefxc.examples.validation.ValidatorAdd;
import com.littlefxc.examples.validation.ValidatorEdit;
import lombok.Data;
import org.hibernate.validator.constraints.Email;
import org.hibernate.validator.constraints.Length;
import org.hibernate.validator.constraints.NotBlank;
import javax.validation.constraints.NotNull;
/**
* @author fengxuechao
*/@Datapublic class LoginVo {
/**
* 編輯時:不能為null
*/
@NotNull(message = "{login.id.NotNull}", groups = {ValidatorEdit.class})
private String id;
/**
* 新增時:不能為空,符合郵箱格式
* 編輯時:符合郵箱格式
*/
@NotBlank(message = "{login.username.NotBlank}", groups = {ValidatorAdd.class})
@Email(message = "{login.username.Email}", groups = {ValidatorAdd.class, ValidatorEdit.class})
private String username;
/**
* 新增時:不能為空,密碼長度至少為6位
* 編輯時:密碼長度至少為6位
*/
@NotBlank(message = "{login.password.NotBlank}", groups = {ValidatorAdd.class})
@Length(min = 6, message = "{login.password.Length}", groups = {ValidatorAdd.class, ValidatorEdit.class})
private String password;
/**
* 新增時:符合手機格式
* 編輯時:符合手機格式
*/
@IsPhone(groups = {ValidatorAdd.class, ValidatorEdit.class})
private String phone;
}
2.3.6 定義控制器
package com.littlefxc.examples.controller;
import com.littlefxc.examples.model.LoginVo;
import com.littlefxc.examples.validation.ValidatorAdd;
import com.littlefxc.examples.validation.ValidatorEdit;
import org.springframework.validation.BindException;
import org.springframework.validation.FieldError;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import java.util.HashMap;
import java.util.UUID;
/**
* @author fengxuechao
*/@RestControllerpublic class ValidatorController {
/**
* 持久化
*/
private static final HashMap<String, LoginVo> map = new HashMap<>();
/**
* 新增時
*
* @param loginVo
* @return
*/
@RequestMapping(value = "/save")
public String save(@Validated({ValidatorAdd.class}) LoginVo loginVo) {
loginVo.setId(UUID.randomUUID().toString().replace("-", ""));
map.put(loginVo.getId(), loginVo);
return "新增通過:" + loginVo.toString();
}
/**
* 編輯時
*
* @param loginVo
* @return
*/
@RequestMapping(value = "/edit")
public String edit(@Validated({ValidatorEdit.class}) LoginVo loginVo) {
map.replace(loginVo.getId(), map.get(loginVo.getId()), loginVo);
return "編輯通過:" + loginVo.toString();
}
/**
* 列表
*
* @return
*/
@RequestMapping(value = "/list")
public HashMap<String, LoginVo> edit() {
return map;
}
/**
* 統一異常處理
*
* @param ex
* @return
*/
@ExceptionHandler(BindException.class)
public String handleBindException(BindException ex) {
StringBuilder sb = new StringBuilder();
for (FieldError fieldError : ex.getFieldErrors()) {
sb.append(fieldError.getField())
.append(": ")
.append(fieldError.getDefaultMessage())
.append(";");
}
return "驗證失敗:" + sb.toString();
}
}
2.3.7 結果
驗證成功
驗證失敗