摘要：介紹出發點在日常開發中經常需要對方法的入參做校驗，特別是在遠程調用的方法中。類字段無參方法方法參數為或數組或集合類型提供長度或大小校驗。類非靜態方法方法參數指定參數校驗失敗時拋出異常。方法方法參數禁用校驗邏輯。

在日常開發中經常需要對方法的入參做校驗，特別是在遠程調用的方法中。

我基于這個需求便開發了這款工具，可以節省在這方面所花費的精力，通過配置的注解，在編譯期對語法樹進行修改，就能為方法加入參數的校驗邏輯。

知道Lombok的同學肯定不少吧，其實原理都是一樣的。

現在所支持的校驗有數字、字符串、數組、集合和Map，并且能夠在校驗失敗時選擇是拋出異常或返回數據。

下面讓我們直接先看下使用效果吧。

public class MyApp {

    @Throw
    public Info run(Args args,
                    @Nullable Info info,
                    @Return({"test", "0"}) @NotBlank String name,
                    @Return("null") @NumberRule(min = "1") int num) {
        // process
        System.out.println("run");
        return new Info();
    }
}

如上代碼，經過編譯后將會是這樣的 :

public class MyApp {
    public MyApp() {
    }
    public MyApp.Info run(MyApp.Args args, MyApp.Info info, String name, int num) {
        if (args == null) {
            throw new IllegalArgumentException("Invalid input parameter, cause args is null");
        } else {
            String mvar_0 = args.invalid0();
            if (mvar_0 != null) {
                throw new IllegalArgumentException("Invalid input parameter, cause " + mvar_0);
            } else {
                if (info != null) {
                    mvar_0 = info.invalid0();
                    if (mvar_0 != null) {
                        throw new IllegalArgumentException("Invalid input parameter, cause " + mvar_0);
                    }
                }

                if (name == null) {
                    return new MyApp.Info("test", (Double)null);
                } else if (Util.isBlank(name)) {
                    return new MyApp.Info("test", (Double)null);
                } else if (num < 1) {
                    return null;
                } else {
                    System.out.println("run");
                    return new MyApp.Info();
                }
            }
        }
    }
}

原始的邏輯 System.out.println("run"); new Info(); 被放置在了最后，當調用時參數校驗都通過后才會執行。
其實例子中的代碼省略了對參數定義校驗注解的部分，這些類在經過編譯器后將會生成參數的校驗方法。。。完整的代碼如下

public class MyApp {

    @Throw
    public Info run(Args args,
                    @Nullable Info info,
                    @Return({"test", "null"}) @NotBlank String name,
                    @Return("null") @NumberRule(min = "1") int num) {
        // process
        System.out.println("run");
        return new Info();
    }

    class Args {

        @NumberRule(max = "1000") int id;

        @NotNull HashMap param;

        @Nullable @SizeRule(min = 5) boolean[] value;
    }

    static class Info {

        @SizeRule(min = 50) String name;

        @Nullable @NumberRule(min = "-25.02", max = "200") Double price;

        @SizeRule(min = 10, max = 10) List extra;

        public Info() {
        }

        Info(String name, Double price) {
            this.name = name;
            this.price = price;
        }
    }
}

其中的 Args 和 Info 在經過編譯后將會根據定義的注解生成校驗方法。

   static class Info {
       String name;
       Double price;
       List extra;

       public Info() {
       }

       Info(String name, Double price) {
           this.name = name;
           this.price = price;
       }

       public String invalid0() {
           if (this.name == null) {
               return "name is null";
           } else if (this.name.length() < 50) {
               return "name.length() less than 50";
           } else if (this.price != null && this.price > 200.0D) {
               return "price great than 200.0";
           } else if (this.extra == null) {
               return "extra is null";
           } else {
               return this.extra.size() != 10 ? "extra cannot equals 10" : null;
           }
       }
   }

   class Args {
       int id;
       HashMap param;
       boolean[] value;

       Args() {
       }

       public String invalid0() {
           if (this.value != null && this.value.length < 5) {
               return "value.length less than 5";
           } else if (this.id > 1000) {
               return "id great than 1000";
           } else {
               return this.param == null ? "param is null" : null;
           }
       }
   }

看到這兒，你應該對這個工具的基本功能有了大概的了解，下面我會介紹如果使用這個工具。

Maven

    
        io.github.moyada
        medivh
        1.2.0
        provided
    

Gradle

dependencies {
  compileOnly "io.github.moyada:medivh:1.2.0"
}

如果沒有使用構建工具也沒問題，可以從網上下載jar包，一樣配置，在后面用 javac -cp 編譯就好了。

現在可供使用的注解有這幾種，支持以類、枚舉、接口作為參數添加校驗規則。

例如我需要提供一個判斷String是否為null或空白字符串的方法。

@Return("true")
public boolean isEmpty(@NotBlank String str) {
    return false;
}

使用構建工具的編譯命令, 如 mvn compile 或 gradle build。

或者使用 Java 命令進行編譯，如 javac -cp medivh.jar MyApp.java

如上述代碼，經過編譯期后，即可生成方法邏輯，并且創建一個 io.moyada.medivh.support.Util 類提供檢驗是否為空白字符串的方法，當然也支持自己指定方法。

public boolean isEmpty(String str) {
    if (str == null) {
        return true;
    } else {
        return Util.isBlank(str);
    }
}

看完這份介紹，如果有興趣的同學還可以前往 github 查看，會有更詳細的文檔和示例，歡迎大家進行使用和提出意見。

github.com/moyada/medivh