摘要：前言最近在開發某個模塊的功能時，里面包含大量對請求參數判空和驗證的步驟且參數繁多，存在大量的重復判斷，驗證影響代碼的美觀遂決定優化這部分代碼。

最近在開發某個模塊的功能時，里面包含大量對請求參數判空和驗證的步驟且參數繁多，存在大量的重復判斷，驗證影響代碼的美觀遂決定優化這部分代碼。SpringBoot自帶了參數驗證框Hibernate Validator，下面是自己的學習筆記。

若使用SptingBoot，在spring-boot-starter-web包中包含此框架依賴，其他框架加入依賴即可

    
      org.hibernate.validator
      hibernate-validator
      6.0.17.Final
    

個人認為官方文檔是最好的資料，如有需要請瀏覽:https://docs.jboss.org/hibern...

新建類User

package com.longhc.uublog;

import com.alibaba.fastjson.JSON;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;
import javax.validation.constraints.Email;
import javax.validation.constraints.NotBlank;
import javax.validation.constraints.NotNull;
import javax.validation.constraints.Pattern;
import java.io.Serializable;

@Getter
@Setter
@NoArgsConstructor
public class User implements Serializable {
    private static final long serialVersionUID = -2164567260938543876L;

    private String userId;
    
    // 字段userName不可為null，且length>0
    @NotBlank
    private String userName;
    
    // 密碼需要匹配正則表達式
    @Pattern(regexp = "^[A-Z]{0,3}[0-9]{5,10}")
    private String password;

    // 驗證是否是正確的電子郵件格式
    @Email
    private String email;

    // 家庭住址不為空
    @NotNull
    private String address;

    @Override
    public String toString() {
        return JSON.toJSONString(this);
    }
}

使用Validator校驗傳入參數是否符合規則

package com.longhc.uublog;

import lombok.extern.slf4j.Slf4j;
import org.junit.Test;

import javax.validation.ConstraintViolation;
import javax.validation.Validation;
import javax.validation.Validator;
import java.util.Set;

@Slf4j
public class VaildatorTest {

    @Test
    public void test() {
        // 獲得默認的Validator
        Validator validator = Validation.buildDefaultValidatorFactory().getValidator();

        Consumer consumer = new Consumer();
        consumer.setUserName("longhaicheng");
        consumer.setAddress(null);
        consumer.setEmail("123456789");
        // 驗證consumer是否符合要求，并返回set集合，若set集合size()返回>0，說明存在違規的參數，通過日志打印
        Set> constraintViolations = validator.validate(consumer);
        if (constraintViolations.size() > 0) {
            for (ConstraintViolation constraintViolation : constraintViolations) {
                String message = constraintViolation.getMessage();
                log.error("message:{}", message);
            }
        }
    }
}

日志返回：

參數校驗失敗返回錯誤消息，也可以定制錯誤消息，通過注解中的message屬性配置

@NotBlank(message = "字段[userName]不可為空")
@Pattern(regexp = "^[A-Z]{0,3}[0-9]{5,10}",message = "字段[password]需匹配表達式[{regexp}]")
@Email(message = "錯誤的電子郵箱格式")
@NotNull(message = "家庭住址不為空")

要在Spring中使用此框架

package com.longhc.uublog;

import lombok.extern.slf4j.Slf4j;
import org.hibernate.validator.HibernateValidator;
import org.springframework.stereotype.Component;
import javax.validation.ConstraintViolation;
import javax.validation.Validation;
import javax.validation.Validator;
import java.util.Set;



@Component
@Slf4j
public class ValidatorUtil {

    public static Validator getValidator() {
        // 使用HibernateValidator
        Validator validator = Validation.byProvider(HibernateValidator.class)
                .configure()
                // 快速失敗（即：第一個參數校驗失敗就返回錯誤信息，而不是校驗所有的參數，并一次性返回所有的錯誤信息）
                .failFast(true)
                .buildValidatorFactory()
                .getValidator();
        return validator;
    }

    /**
     * @param object object
     * @param groups groups
     */
    public void validateObject(Object object, Class... groups) {
        Set> constraintViolations = getValidator().validate(object, groups);
        if (constraintViolations.size() > 0) {
            for (ConstraintViolation