摘要：在接口服務(wù)開(kāi)發(fā)中，難免會(huì)校驗(yàn)傳入方的參數(shù)校驗(yàn)，尤其在請(qǐng)求時(shí)，驗(yàn)證字符長(zhǎng)度，字符類型是否滿足數(shù)據(jù)庫(kù)中字段的最大長(zhǎng)度及類型，如果不符合條件應(yīng)及時(shí)攔截并返回，避免后續(xù)的流程。

公司轉(zhuǎn)java開(kāi)發(fā)也有一段時(shí)間了，在實(shí)際開(kāi)發(fā)過(guò)程中還是會(huì)遇到一些問(wèn)題的，本篇主要記錄下接口服務(wù)中參數(shù)驗(yàn)證相關(guān)的開(kāi)發(fā)過(guò)程和一些知識(shí)點(diǎn)。

在接口服務(wù)開(kāi)發(fā)中，難免會(huì)校驗(yàn)傳入方的參數(shù)校驗(yàn)，尤其在post請(qǐng)求時(shí)，驗(yàn)證字符長(zhǎng)度，字符類型是否滿足數(shù)據(jù)庫(kù)中字段的最大長(zhǎng)度及類型，如果不符合條件應(yīng)及時(shí)攔截并返回，避免后續(xù)的流程。

先了解下提供的注解，基本上常用的都提供了，在代碼編寫(xiě)時(shí)還是比較方便的，一個(gè)注解解決了驗(yàn)證邏輯。

/**Bean Validation 中內(nèi)置的 constraint**/
@Null   //被注釋的元素必須為 null    
@NotNull    //被注釋的元素必須不為 null    
@AssertTrue     //被注釋的元素必須為 true    
@AssertFalse    //被注釋的元素必須為 false    
@Min(value)     //被注釋的元素必須是一個(gè)數(shù)字，其值必須大于等于指定的最小值    
@Max(value)     //被注釋的元素必須是一個(gè)數(shù)字，其值必須小于等于指定的最大值    
@DecimalMin(value)  //被注釋的元素必須是一個(gè)數(shù)字，其值必須大于等于指定的最小值    
@DecimalMax(value)  //被注釋的元素必須是一個(gè)數(shù)字，其值必須小于等于指定的最大值    
@Size(max=, min=)   //被注釋的元素的大小必須在指定的范圍內(nèi)    
@Digits (integer, fraction)     //被注釋的元素必須是一個(gè)數(shù)字，其值必須在可接受的范圍內(nèi)    
@Past   //被注釋的元素必須是一個(gè)過(guò)去的日期    
@Future     //被注釋的元素必須是一個(gè)將來(lái)的日期    
@Pattern(regex=,flag=)  //被注釋的元素必須符合指定的正則表達(dá)式    
    
/**Hibernate Validator 附加的 constraint**//    
@NotBlank(message =)   //驗(yàn)證字符串非null，且長(zhǎng)度必須大于0    
@Email  //被注釋的元素必須是電子郵箱地址    
@Length(min=,max=)  //被注釋的字符串的大小必須在指定的范圍內(nèi)    
@NotEmpty   //被注釋的字符串的必須非空    
@Range(min=,max=,message=)  //被注釋的元素必須在合適的范圍內(nèi)

    /**
     * 訂單號(hào)
     */
    @Range(min=1,message = "不是正確的訂單號(hào)")
    private Long e_order_id;
    /**
     * 產(chǎn)品code
     */
    @NotBlank(message = "不是正確的產(chǎn)品code")
    private String product_code;

在controller中，我們通過(guò)BindingResult來(lái)接收對(duì)應(yīng)的驗(yàn)證信息

    @ApiOperation(value = "修改訂單狀態(tài)", notes = "若找不到結(jié)果則返回 null。")
    @RequestMapping(value = "/status", method = RequestMethod.PUT)
    @ResponseBody
    public String PutOrderStatus(@RequestBody @Validated @NotNull OrderStatusReq req, BindingResult bindingResult) {
        String validResult = assertParameterValid(bindingResult);
        if (validResult != null) {
            return validResult;
        }
        return iOrderStatusService.putOrderStatus(req).toString();
    }

protected String assertParameterValid(BindingResult bindingResult) {
        if (bindingResult.hasErrors()) {
            FieldError error = bindingResult.getFieldError();
            return new Response<>(BusinessReturnCode.VALIDATION_FAILURE, String.format("[%s] %s.", error.getField(), error.getDefaultMessage()), null).toString();
        }
        return null;
    }

可惜的是，Hibernate validation中沒(méi)有提供枚舉相關(guān)的校驗(yàn)，而實(shí)際業(yè)務(wù)場(chǎng)景中會(huì)有很多校驗(yàn)類型、狀態(tài)等，這里我們只能自定義了。

首先我們需要自定義一個(gè)annotation來(lái)標(biāo)記你的驗(yàn)證字段，因?yàn)閂alidator框架里面的基礎(chǔ)annotation已經(jīng)不夠用。

然后自定義一個(gè)Validator（繼承ConstraintValidator），并將annotation類型給到ConstraintValidator的泛型列表，相當(dāng)于做了一個(gè)綁定。然后implement ConstraintValidator的兩個(gè)方法，在isValid方法里面用要驗(yàn)證的枚舉驗(yàn)證參數(shù)。

可以看下一個(gè)簡(jiǎn)單的demo：

@Target({ElementType.FIELD, ElementType.METHOD, ElementType.ANNOTATION_TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = {EnumValidAnnotation.EnumValidtor.class})
@Documented
public @interface EnumValidAnnotation {
    String message() default "枚舉不在范圍內(nèi)";

    Class[] groups() default {};

    Class[] payload() default {};

    Class[] target() default {};

    public class EnumValidtor implements ConstraintValidator {

        Class[] cls; //枚舉類

        @Override
        public void initialize(EnumValidAnnotation constraintAnnotation) {
            cls = constraintAnnotation.target();
        }

        @Override
        public boolean isValid(Integer value, ConstraintValidatorContext context) {
            System.out.println("枚舉值" + value);
            if (cls.length > 0) {
                for (Class cl : cls) {
                    try {
                        if (cl.isEnum()) {
                            //枚舉類驗(yàn)證
                            Object[] objs = cl.getEnumConstants();
                            Method method = cl.getMethod("getCode");
                            for (Object obj : objs) {
                                Object code = method.invoke(obj);
                                if (value.equals(code)) {
                                    return true;
                                }
                            }
                        }
                    } catch (NoSuchMethodException e) {
                        e.printStackTrace();
                    } catch (IllegalAccessException e) {
                        e.printStackTrace();
                    } catch (InvocationTargetException e) {
                        e.printStackTrace();
                    }
                }
            }
            return false;
        }
    }

這樣的話在你要驗(yàn)證的字段上加上對(duì)應(yīng)的注解即可：

    /**
     * 更新類型 
     */
    @EnumValidAnnotation(target = OrderStatusEnum.class)
    private int stype;

java中注解還是挺有意思的，類似c#中的attribute,但java中各種框架、方法的注解真的很多，不一直使用或做對(duì)應(yīng)的筆記真的很容易忘記，還是需要多多積累和記錄的。