導讀

在開發JAVA伺服器端程式碼時，我們會遇到對外部傳來的引數合法性進行驗證，而hibernate-validator提供了一些常用的引數校驗註解，我們可以拿來使用。

引入maven依賴

<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>4.3.1.Final</version> 
</dependency>

在Model中定義要校驗的欄位：

import javax.validation.constraints.Pattern;
import javax.validation.constraints.Size;
import org.hibernate.validator.constraints.NotEmpty;
 
public class PayRequestDto {
     
    /**
     * 支付完成時間
     **/
    @NotEmpty(message="支付完成時間不能空")
    @Size(max=14,message="支付完成時間長度不能超過{max}位")
    private
 
 String payTime;
     
    /**
     * 狀態
     **/
    @Pattern(regexp = "0[0123]", message = "狀態只能為00或01或02或03")
    private String status;
 
    public String getPayTime() {
        return payTime;
    }
 
    public void setPayTime(String payTime) {
        this.payTime = payTime;
    }
 
    public String getStatus() {
        
 
return status;
    }
 
    public void setStatus(String status) {
        this.status = status;
    }
}

定義Validation工具類

import java.util.Set;
import javax.validation.ConstraintViolation;
import javax.validation.Validation;
import javax.validation.Validator;
import org.hibernate.validator.HibernateValidator;
import com.atai.framework.lang.AppException;

public class ValidationUtils {
    
    /**
     * 使用hibernate的註解來進行驗證
     * 
     */
    private static Validator validator = Validation
            .byProvider(HibernateValidator.class).configure().failFast(true).buildValidatorFactory().getValidator();

    /**
     * 功能描述: <br>
     * 〈註解驗證引數〉
     *
     * @param obj
     * @see [相關類/方法](可選)
     * @since [產品/模組版本](可選)
     */
    public static <T> void validate(T obj) {
        Set<ConstraintViolation<T>> constraintViolations = validator.validate(obj);
        // 丟擲檢驗異常
        if (constraintViolations.size() > 0) {
            throw new AppException("0001", String.format("引數校驗失敗:%s", constraintViolations.iterator().next().getMessage()));
        }
    }
}

在程式碼中呼叫工具類進行引數校驗：

    /**
     * 新增
     * @param req
     * @return
     */
    @RequestMapping(value = "add", method= RequestMethod.POST)
    public SecurityRiskLibaryAddRsp add(SecurityRiskLibaryAddReq req){
        ValidationUtils.validate(req);
        return securityRiskLibaryService.add(req);
    }

以下是對hibernate-validator中部分註解進行描述：

驗證