Java如何優(yōu)雅地實(shí)現(xiàn)接口數(shù)據(jù)校驗(yàn)

@RestController
public?class?OrderController?{

????@Autowired
????private?OrderService?orderServiceImpl;

????@PostMapping("/createOrder")
????public?CreateOrderBO?validationTest(@Validated?CreateOrderDTO?createOrderDTO)?{
????????return?orderServiceImpl.createOrder(createOrderDTO);
????}
}

@Data
public?class?CreateOrderDTO?{

????@NotNull(message?=?"訂單號(hào)不能為空")
????private?String?orderId;
????@NotNull(message?=?"訂單金額不能為空")
????@Min(value?=?1,?message?=?"訂單金額不能小于0")
????private?Integer?amount;
????@Pattern(regexp?=?"^1[3|4|5|7|8][0-9]{9}$",?message?=?"用戶手機(jī)號(hào)不合法")
????private?String?mobileNo;
????private?String?orderType;
????private?String?status;
}

@PostMapping("/createOrder")
public?CreateOrderBO?validationTest(@Validated?CreateOrderDTO?createOrderDTO)?{
????return?orderServiceImpl.createOrder(createOrderDTO);
}

@Target({METHOD,?FIELD,?ANNOTATION_TYPE,?CONSTRUCTOR,?PARAMETER})
@Retention(RUNTIME)
@Documented
@Constraint(validatedBy?=?{EnumValueValidator.class})
public?@interface?EnumValue?{

????//默認(rèn)錯(cuò)誤消息
????String?message()?default?"必須為指定值";

????//支持string數(shù)組驗(yàn)證
????String[]?strValues()?default?{};

????//支持int數(shù)組驗(yàn)證
????int[]?intValues()?default?{};

????//支持枚舉列表驗(yàn)證
????Class[]?enumValues()?default?{};

????//分組
????Class[]?groups()?default?{};

????//負(fù)載
????Class[]?payload()?default?{};

????//指定多個(gè)時(shí)使用
????@Target({FIELD,?METHOD,?PARAMETER,?ANNOTATION_TYPE})
????@Retention(RUNTIME)
????@Documented
????@interface?List?{
????????EnumValue[]?value();
????}

????/**
?????*?校驗(yàn)類邏輯定義
?????*/
????class?EnumValueValidator?implements?ConstraintValidator<EnumValue,?Object>?{

????????//字符串類型數(shù)組
????????private?String[]?strValues;
????????//int類型數(shù)組
????????private?int[]?intValues;
????????//枚舉類
????????private?Class[]?enumValues;

????????/**
?????????*?初始化方法
?????????*
?????????*?@param?constraintAnnotation
?????????*/
????????@Override
????????public?void?initialize(EnumValue?constraintAnnotation)?{
????????????strValues?=?constraintAnnotation.strValues();
????????????intValues?=?constraintAnnotation.intValues();
????????????enumValues?=?constraintAnnotation.enumValues();
????????}

????????/**
?????????*?校驗(yàn)方法
?????????*
?????????*?@param?value
?????????*?@param?context
?????????*?@return
?????????*/
????????@SneakyThrows
????????@Override
????????public?boolean?isValid(Object?value,?ConstraintValidatorContext?context)?{
????????????//針對(duì)字符串?dāng)?shù)組的校驗(yàn)匹配
????????????if?(strValues?!=?null?&&?strValues.length?>?0)?{
????????????????if?(value?instanceof?String)?{
????????????????????for?(String?s?:?strValues)?{//判斷值類型是否為Integer類型
????????????????????????if?(s.equals(value))?{
????????????????????????????return?true;
????????????????????????}
????????????????????}
????????????????}
????????????}
????????????//針對(duì)整型數(shù)組的校驗(yàn)匹配
????????????if?(intValues?!=?null?&&?intValues.length?>?0)?{
????????????????if?(value?instanceof?Integer)?{//判斷值類型是否為Integer類型
????????????????????for?(Integer?s?:?intValues)?{
????????????????????????if?(s?==?value)?{
????????????????????????????return?true;
????????????????????????}
????????????????????}
????????????????}
????????????}
????????????//針對(duì)枚舉類型的校驗(yàn)匹配
????????????if?(enumValues?!=?null?&&?enumValues.length?>?0)?{
????????????????for?(Class?cl?:?enumValues)?{
????????????????????if?(cl.isEnum())?{
????????????????????????//枚舉類驗(yàn)證
????????????????????????Object[]?objs?=?cl.getEnumConstants();
????????????????????????//這里需要注意，定義枚舉時(shí)，枚舉值名稱統(tǒng)一用value表示
????????????????????????Method?method?=?cl.getMethod("getValue");
????????????????????????for?(Object?obj?:?objs)?{
????????????????????????????Object?code?=?method.invoke(obj,?null);
????????????????????????????if?(value.equals(code.toString()))?{
????????????????????????????????return?true;
????????????????????????????}
????????????????????????}
????????????????????}
????????????????}
????????????}
????????????return?false;
????????}
????}
}

/**
?*?定制化注解，支持參數(shù)值與指定類型數(shù)組列表值進(jìn)行匹配(缺點(diǎn)是需要將枚舉值寫(xiě)死在字段定義的注解中)
?*/
@EnumValue(strValues?=?{"pay",?"refund"},?message?=?"訂單類型錯(cuò)誤")
private?String?orderType;
/**
?*?定制化注解，實(shí)現(xiàn)參數(shù)值與枚舉列表的自動(dòng)匹配校驗(yàn)(能更好地與實(shí)際業(yè)務(wù)開(kāi)發(fā)匹配)
?*/
@EnumValue(enumValues?=?Status.class,?message?=?"狀態(tài)值不在指定范圍")
private?String?status;

public?enum?Status?{
????PROCESSING(1,?"處理中"),
????SUCCESS(2,?"訂單已完成");
????Integer?value;
????String?desc;

????Status(Integer?value,?String?desc)?{
????????this.value?=?value;
????????this.desc?=?desc;
????}

????public?Integer?getValue()?{
????????return?value;
????}

????public?String?getDesc()?{
????????return?desc;
????}
}

public?class?ValidatorUtils?{

????private?static?Validator?validator?=?Validation.buildDefaultValidatorFactory().getValidator();

????/**
?????*?bean整體校驗(yàn)，有不合規(guī)范，拋出第1個(gè)違規(guī)異常
?????*/
????public?static?void?validate(Object?obj,?Class...?groups)?{
????????Set>?resultSet?=?validator.validate(obj,?groups);
????????if?(resultSet.size()?>?0)?{
????????????//如果存在錯(cuò)誤結(jié)果，則將其解析并進(jìn)行拼湊后異常拋出
????????????List?errorMessageList?=?resultSet.stream().map(o?->?o.getMessage()).collect(Collectors.toList());
????????????StringBuilder?errorMessage?=?new?StringBuilder();
????????????errorMessageList.stream().forEach(o?->?errorMessage.append(o?+?";"));
????????????throw?new?IllegalArgumentException(errorMessage.toString());
????????}
????}
}

public?boolean?orderCheck(OrderCheckBO?orderCheckBO)?{
????//對(duì)參數(shù)對(duì)象進(jìn)行數(shù)據(jù)校驗(yàn)
????ValidatorUtils.validate(orderCheckBO);
????return?true;
}

@Data
@Builder
public?class?OrderCheckBO?{

????@NotNull(message?=?"訂單號(hào)不能為空")
????private?String?orderId;
????@Min(value?=?1,?message?=?"訂單金額不能小于0")
????private?Integer?orderAmount;
????@NotNull(message?=?"創(chuàng)建人不能為空")
????private?String?operator;
????@NotNull(message?=?"操作時(shí)間不能為空")
????private?String?operatorTime;
}

@Slf4j
@ControllerAdvice
public?class?GlobalExceptionHandler?{
????/**
?????*?統(tǒng)一處理參數(shù)校驗(yàn)錯(cuò)誤異常(非Spring接口數(shù)據(jù)綁定驗(yàn)證)
?????*
?????*?@param?response
?????*?@param?e
?????*?@return
?????*/
????@ExceptionHandler(BindException.class)
????@ResponseBody
????public?ResponseResult?processValidException(HttpServletResponse?response,?BindException?e)?{
????????response.setStatus(HttpStatus.INTERNAL_SERVER_ERROR.value());
????????//獲取校驗(yàn)錯(cuò)誤結(jié)果信息，并將信息組裝
????????List?errorStringList?=?e.getBindingResult().getAllErrors()
????????????????.stream().map(ObjectError::getDefaultMessage).collect(Collectors.toList());
????????String?errorMessage?=?String.join(";?",?errorStringList);
????????response.setContentType("application/json;charset=UTF-8");
????????log.error(e.toString()?+?"_"?+?e.getMessage(),?e);
????????return?ResponseResult.systemException(GlobalCodeEnum.GL_FAIL_9998.getCode(),
????????????????errorMessage);
????}

????/**
?????*?統(tǒng)一處理參數(shù)校驗(yàn)錯(cuò)誤異常
?????*
?????*?@param?response
?????*?@param?e
?????*?@return
?????*/
????@ExceptionHandler(IllegalArgumentException.class)
????@ResponseBody
????public?ResponseResult?processValidException(HttpServletResponse?response,?IllegalArgumentException?e)?{
????????response.setStatus(HttpStatus.INTERNAL_SERVER_ERROR.value());
????????String?errorMessage?=?String.join(";?",?e.getMessage());
????????response.setContentType("application/json;charset=UTF-8");
????????log.error(e.toString()?+?"_"?+?e.getMessage(),?e);
????????return?ResponseResult.systemException(GlobalCodeEnum.GL_FAIL_9998.getCode(),
????????????????errorMessage);
????}

????...
}

@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
@JsonPropertyOrder({"code",?"message",?"data"})
public?class?ResponseResult<T>?implements?Serializable?{

????private?static?final?long?serialVersionUID?=?1L;

????/**
?????*?返回的對(duì)象
?????*/
????@JsonInclude(JsonInclude.Include.NON_NULL)
????private?T?data;
????/**
?????*?返回的編碼
?????*/
????private?Integer?code;
????/**
?????*?返回的信息
?????*/
????private?String?message;

????/**
?????*?@param?data?返回的數(shù)據(jù)
?????*?@param???返回的數(shù)據(jù)類型
?????*?@return?響應(yīng)結(jié)果
?????*/
????public?static??ResponseResult?OK(T?data)?{
????????return?packageObject(data,?GlobalCodeEnum.GL_SUCC_0);
????}

????/**
?????*?自定義系統(tǒng)異常信息
?????*
?????*?@param?code
?????*?@param?message?自定義消息
?????*?@param?
?????*?@return
?????*/
????public?static??ResponseResult?systemException(Integer?code,?String?message)?{
????????return?packageObject(null,?code,?message);
????}
}