快捷導(dǎo)航

Java實現(xiàn)優(yōu)雅的參數(shù)校驗方法詳解

更新時間：2022年06月27日 11:27:17 作者：WX7251

這篇文章主要為大家詳細(xì)介紹了Java語言如何實現(xiàn)優(yōu)雅的參數(shù)校驗，文中的示例代碼講解詳細(xì)，對我們學(xué)習(xí)Java有一定是幫助，需要的可以參考一下

一、引子

要對方法的參數(shù)進行校驗，最簡單暴力的寫法是這個樣子：

    public static void utilA(String a,BigDecimal b){
        if (StringUtils.isEmpty(a)){
            System.out.println("a不可為空");
            return;
        }
        if (b == null){
            System.out.println("b不可為空");
            return;
        }
        if (b.compareTo(BigDecimal.ZERO) != 1){
            System.out.println("b的取值范圍不正確");
            return;
        }
        System.out.println("do something");
    }

這樣做從功能角度來說一點問題也沒有。

但是從代碼的長期維護性上來說，代碼復(fù)用率低，校驗規(guī)則一旦多起來很難維護，而且怎么看怎么顯得笨拙，對于有一點追求的工程師來說，這么一大坨還是挺難接受的。

雖然有一些諸如 Preconditions(com.google) 的解決方案，但很難適應(yīng)所有的場景，用起來也沒到非常得心應(yīng)有的地步。

二、如何優(yōu)雅地校驗參數(shù)

Spring官方推薦的，語義清晰的優(yōu)雅的方法級別校驗（入?yún)⑿ｒ?、返回值校驗?/p>

2.1 官方指導(dǎo)意見

Spring官方在SpringBoot文檔中，關(guān)于參數(shù)校驗（Validation）給出的解決方案是這樣的：

@Service
@Validated
public class MyBean {
 
    public Archive findByCodeAndAuthor(@Size(min = 8, max = 10) String code,
            Author author) {
        ...
    }
 
}

Spring Boot 官網(wǎng)文檔《37. Validation》

也就是說，使用 JSR-303 規(guī)范，直接利用注解進行參數(shù)校驗。

（JSR-303 是 JAVA EE 6 中的一項子規(guī)范，叫做 Bean Validation，官方參考實現(xiàn)是 Hibernate Validator）

2.2 注解用法說明

2.2.1.注解簡介

對于簡單類型參數(shù)（非Bean），直接在參數(shù)前，使用注解添加約束規(guī)則。注解如下所示：

@AssertTrue / @AssertFalse

驗證適用字段：boolean

注解說明：驗證值是否為true / false

@DecimalMax / @DecimalMin

驗證適用字段：BigDecimal,BigInteger,String,byte,short,int,long

注解說明：驗證值是否小于或者等于指定的小數(shù)值，要注意小數(shù)存在精度問題

@Digits

驗證適用字段：BigDecimal,BigInteger,String,byte,short,int,long

注解說明：驗證值的數(shù)字構(gòu)成是否合法

屬性說明：integer:指定整數(shù)部分的數(shù)字的位數(shù)。fraction: 指定小數(shù)部分的數(shù)字的位數(shù)。

@Future / @Past

驗證適用字段：Date,Calendar

注解說明：驗證值是否在當(dāng)前時間之后 / 之前

屬性說明：公共

@Max / @Min

驗證適用字段：BigDecimal,BigInteger,String,byte,short,int,long

注解說明：驗證值是否小于或者等于指定的整數(shù)值

屬性說明：公共

注意事項：建議使用在Stirng,Integer類型，不建議使用在int類型上，因為表單提交的值為“”時無法轉(zhuǎn)換為int

@NotNull / @Null

驗證適用字段：引用數(shù)據(jù)類型

注解說明：驗證值是否為非空 / 空

屬性說明：公共

@NotBlank 檢查約束字符串是不是Null還有被Trim的長度是否大于0,只對字符串,且會去掉前后空格.

@NotEmpty 檢查約束元素是否為Null或者是EMPTY.

@NotBlank 與 @NotEmpty 的區(qū)別：空格（" "）對于 NotEmpty 是合法的，而 NotBlank 會拋出校驗異常

@Pattern

驗證適用字段：String

注解說明：驗證值是否配備正則表達(dá)式

屬性說明：regexp:正則表達(dá)式flags: 指定Pattern.Flag 的數(shù)組，表示正則表達(dá)式的相關(guān)選項。

@Size

驗證適用字段：String,Collection,Map,數(shù)組

注解說明：驗證值是否滿足長度要求

屬性說明：max:指定最大長度，min:指定最小長度。

@Length(min=, max=)：專門應(yīng)用于String類型

@Valid

驗證適用字段：遞歸的對關(guān)聯(lián)對象進行校驗

注解說明：如果關(guān)聯(lián)對象是個集合或者數(shù)組,那么對其中的元素進行遞歸校驗,如果是一個map,則對其中的值部分進行校驗(是否進行遞歸驗證)

屬性說明：無

@Range(min=, max=) 被指定的元素必須在合適的范圍內(nèi)

@CreditCardNumber信用卡驗證

@Email 驗證是否是郵件地址，如果為null,不進行驗證，算通過驗證。

@URL(protocol=,host=, port=,regexp=, flags=)

2.2.2使用

1.引入依賴

 <!-- https://mvnrepository.com/artifact/org.hibernate.validator/hibernate-validator -->
        <dependency>
            <groupId>org.hibernate.validator</groupId>
            <artifactId>hibernate-validator</artifactId>
            <version>6.1.5.Final</version>
        </dependency>

2.在對應(yīng)字段上添加注解,方法被調(diào)用時，如果傳入的實際參數(shù)與約束規(guī)則不符，會直接拋出 ConstraintViolationException ，表明參數(shù)校驗失敗。

import javax.validation.constraints.Max;
import javax.validation.constraints.Min;
import javax.validation.constraints.NotEmpty;
 
/**
 * @Author: wangxia
 * @Date: 2021/10/20 16:30
 */
public class TestPerson {
 
    @NotEmpty(message = "用戶名不能為空")
    private String username;
 
    @Min(value = 0,message = "年齡不能小于0歲")
    @Max(value =150,message = "年齡不能大于150歲")
    private int age;
 
    public String getUsername() {
        return username;
    }
 
    public void setUsername(String username) {
        this.username = username;
    }
 
    public int getAge() {
        return age;
    }
 
    public void setAge(int age) {
        this.age = age;
    }
}

3..對于Bean類型的參數(shù)，在Bean內(nèi)部的各個字段上面追加約束注解，然后在方法的參數(shù)前面添加 @Validated或@Valid注解即可。示例：

@RequestMapping("/")
@RestController
public class TestValidatController {
 
    @PostMapping("/testValid")
    public String testValid(@Validated @RequestBody TestPerson testPerson){
        return "測試成功";
    }
 
}

4.優(yōu)雅捕獲異常，這一步可以省略，但是請求時會直接返回,400的異常提示，不太優(yōu)雅。

@ControllerAdvice
@ResponseBody 
public class MethodArgumentNotValidHandel {
 
 
    @ExceptionHandler(value=MethodArgumentNotValidException.class)
    public JSONObject MethodArgumentNotValidHandler(HttpServletRequest request,
                                                    MethodArgumentNotValidException exception) throws Exception
    {
        JSONObject result=new JSONObject();
        result.put("code","fail");
        JSONObject errorMsg=new JSONObject();
        for (FieldError error : exception.getBindingResult().getFieldErrors()) {
            errorMsg.put(error.getField(),error.getDefaultMessage());
        }
        result.put("msg",errorMsg);
        return result;
    }
 
}

添加優(yōu)雅捕獲的異常提示: