多くの検証アノテーションが javax.validation.constraints パッケージで定義されており、依存関係が導入されています。
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
対応するアノテーションをエンティティ クラスに追加するだけで、
エンティティ クラス:
package com.zhmsky.mallproduct.entity;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import java.io.Serializable;
import java.util.Date;
import lombok.Data;
import javax.validation.constraints.NotBlank;
/**
* 品牌
*
* @author zhmsky
* @email [email protected]
* @date 2022-07-30 16:40:28
*/
@Data
@TableName("pms_brand")
public class BrandEntity implements Serializable {
private static final long serialVersionUID = 1L;
/**
* 品牌名
*/
@NotBlank(message = "品牌名不能为空")
private String name;
}
1. コントローラー インターフェイスでの検証例外の処理
message can specify the validation description,
and then use the @Valid annotation in the対応する controller interface method to specify the interface parameter validation, followed by BindingResult to receive the validation result. 検証が失敗すると、検証失敗情報をカプセル化して返します。 、検証に合格した場合、関連するロジックが実行されます
@RequestMapping(value = "/save",method = RequestMethod.POST)
public R save(@Valid @RequestBody BrandEntity brand, BindingResult result){
if(result.hasErrors()){
Map<String, String> map = new HashMap<>();
//获取校验结果
for (FieldError fieldError : result.getFieldErrors()) {
//获取错误提示
String message = fieldError.getDefaultMessage();
//校验错误的字段
String field = fieldError.getField();
//封装错误
map.put(field,message);
}
return R.error(20001,"参数校验失败").put("errorMap",map);
}
brandService.save(brand);
return R.ok();
}
2. 例外処理の統一
パラメーター検証の例外処理をインターフェースごとに行うと、ワークロードが比較的大きくコードが煩雑になるため、グローバルな例外処理、つまり
@RestControllerAdvice+@ExceptionHandler アノテーションの使用が導入されます。
package com.zhmsky.mallproduct.exception;
import com.zhmsky.common.utils.R;
import lombok.extern.slf4j.Slf4j;
import org.springframework.validation.BindingResult;
import org.springframework.validation.FieldError;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import java.util.HashMap;
import java.util.Map;
/**
* 同意异常处理类
* @author zhmsky
* @date 2022/8/1 21:36
*/
@Slf4j
@RestControllerAdvice(basePackages = {
"com.zhmsky.mallproduct.controller"})
public class MallProductControllerAdvice {
//具体的某个异常类型处理
@ExceptionHandler(MethodArgumentNotValidException.class)
public R handleValidException(MethodArgumentNotValidException e){
log.error("数据异常:{},异常类型:{}",e.getMessage(),e.getClass());
BindingResult result = e.getBindingResult();
Map<String, String> map = new HashMap<>();
for (FieldError fieldError : result.getFieldErrors()) {
map.put(fieldError.getDefaultMessage(),fieldError.getField());
}
return R.error().put("errorMap",map);
}
//抛出的所有异常类型处理
@ExceptionHandler(Throwable.class)
public R handleException(Throwable e){
//TODO 处理逻辑
return R.error();
}
}
3. エラーコード列挙クラス
package com.zhmsky.common.exception;
/**
* @author zhmsky
* @date 2022/8/1 21:56
*/
public enum ErrorCodeEnum {
UNKNOWN_EXCEPTION(10000, "系统未知错误"),
VALID_EXCEPTION(10001, "参数格式校验失败");
/**
* 错误码
*/
private Integer code;
/**
* 错误提示
*/
private String msg;
ErrorCodeEnum(Integer code, String msg) {
this.code = code;
this.msg = msg;
}
public Integer getCode(){
return this.code;
}
public String getMsg(){
return this.msg;
}
}
4. カスタム パラメータ検証アノテーション
1. カスタム検証アノテーションを書く
javax.validation.constraints の @NotBlank アノテーションを参照し、
@Documented
@Constraint(validatedBy = {
})
@Target({
METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER, TYPE_USE })
@Retention(RUNTIME)
@Repeatable(List.class)
public @interface NotBlank {
//校验规则提示信息
String message() default "{javax.validation.constraints.NotBlank.message}";
//分组校验
Class<?>[] groups() default {
};
//负载
Class<? extends Payload>[] payload() default {
};
/**
* Defines several {@code @NotBlank} constraints on the same element.
*
* @see NotBlank
*/
@Target({
METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER, TYPE_USE })
@Retention(RUNTIME)
@Documented
public @interface List {
NotBlank[] value();
}
}
上記を真似て、カスタム アノテーションをすばやく記述します。
@Documented
@Constraint(validatedBy = {
StatusValueConstraintValidator.class})
@Target({
METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER, TYPE_USE})
@Retention(RUNTIME)
public @interface statusValue {
//校验规则提示信息(在配置文件中配置)
String message() default "{com.zhmsky.common.validator.statusValue.message}";
Class<?>[] groups() default {
};
Class<? extends Payload>[] payload() default {
};
//注解参数
int[] values() default {
};
}
ValidationMessages.properties ファイルを作成し、構成ファイルでカスタム検証ルール プロンプトを構成します。
com.zhmsky.common.validator.statusValue.message=error.......xxxx
2. カスタムバリデータを書く
//statusValue就是自定义的注解,Integer就是自定义注解标注的字段类型
public class StatusValueConstraintValidator implements ConstraintValidator<statusValue, Integer> {
private Set<Integer> set = new HashSet<>();
//初始化方法
@Override
public void initialize(statusValue constraintAnnotation) {
//字段标注的注解里面设定的值(校验规则)
int[] values = constraintAnnotation.values();
for (int value : values) {
set.add(value);
}
}
//判断是否校验成功
@Override
public boolean isValid(Integer value, ConstraintValidatorContext context) {
//value就是字段字段实际接收到的值
return set.contains(value);
}
}
3. カスタム アノテーションとカスタム バリデータを関連付ける
つまり、カスタムアノテーションの @Constraint アノテーションにカスタムバリデーターを指定し、
4. カスタム アノテーション @statusValue をテストする
@Data
@TableName("pms_brand")
public class BrandEntity implements Serializable {
private static final long serialVersionUID = 1L;
/**
* 品牌名
*/
@NotBlank(message = "品牌名不能为空")
private String name;
/**
* 显示状态[0-不显示;1-显示],指定字段值只能为 0 或 1
*/
@statusValue(values={
0,1})
private Integer showStatus;
}
対応するコントローラ インターフェイスで @Validated アノテーションを使用して確認すると、showStatus フィールドが値 3 を渡します。
テスト結果を次の図に示します。