EasyValidate优雅地校验提交数据完整性

前言

在日常的Android开发中，我们在做登录注册等带有提示性输入校验的时候。常常会写样子写代码：

然后你会发现每一次写带有提交信息页面的时候都不得不去编写这种千篇一律的代码，那。。。。有没有一种更加优雅得实现方式呢？So,我就是在这种情况下去编写了一个项目，希望自己能把更多的注意力放在其他地方。（PS:比如偷懒）

一、如何优雅地实现代码

说到用优雅得方式写代码，不得不提AnnotationProcessor,一个用于编译时扫描和处理注解工具。它能很好得帮我们处理一些具有规律的，重复性的代码劳动。So,作为一位矮肥圆，不得不承认，这东西很适合我。所以，我使用它结合Butternife写了一个校验提交前数据合法性的一个工具，用于即将重构的项目。

二、EasyValidate

使用方法，在Project下的build.gradle文件下面的allprojects中添加以下代码片段

allprojects {
 repositories {
   google()
   jcenter()
   maven {url "https://dl.bintray.com/liweihua/maven/"}
 }
}

然后，在module的build.gradle中添加

implementation 'com.eiualee:easyvalidate:1.0.0'
 annotationProcessor 'com.eiualee:easyvalidate-compiler:1.0.0'

三、用法

EasyValidate 提供了3种注解验证，注：Plan字段等下再说

① ValidateNull (控件空判断，当控件为空时，提示toast中填写的内容)

@Retention(RetentionPolicy.CLASS)
@Target(ElementType.FIELD)
public @interface ValidateNull {

int id();//控件ID

String toast();//不合法时提示的内容

int[] plan() default {Plan.DEFAULT};//校验计划
}

② ValidateCheck (判断控件是否选中状态, 当控件选中的状态与validateState字段的值相同时会提示toast中的内容)

@Retention(RetentionPolicy.CLASS)
@Target(ElementType.FIELD)
public @interface ValidateCheck {

int id();//控件ID

String toast();//不合法时提示的内容

int[] plan() default {Plan.DEFAULT};//校验计划

boolean validateState() default false;//勾选的值不能与此相同,相同的话提示错误
}

③ ValidateRegular(判断控件内容是否符合正则表达式)

@Retention(RetentionPolicy.CLASS)
@Target(ElementType.FIELD)
public @interface ValidateRegular {

int id();//控件ID

String toast();//不合法时提示的内容

int[] plan() default {Plan.DEFAULT};//校验计划

String regular();

}

当了解完上面3中注解后，我们就可以开始愉快的编程了。试着在控件上面这样子使用，噢不，先得调用一个方法，使用与 Butternife 一致，毕竟是基于它写出来的。以下为初始化时调用的代码：

Activity：

IValidate IVALIDATE = EasyValidate.bind(this);
IVALIDATE.setUnValidateListener(new IValidate.OnViewUnValidateListener() {
   //失败时的回调（viewid：验证失败View的id,toast：注解上的内容）
   @Override
   public void unValidate(int viewId, String toast) {    
      ToastUtils.showLongToast(toast);
   }
});

调用 EasyVlidate.bind(); 方法并返回一个 IValidate ,用 IValidate 实现

一个接口。这个接口主用于校验失败时回调，毕竟失败时不一定都是 Toast 内容是吧！这样子便于拓展。

Fragment

IValidate IVALIDATE = EasyValidate.bind(this, fragmentView);
IVALIDATE.setUnValidateListener(new IValidate.OnViewUnValidateListener() {
   //失败时的回调（viewid：验证失败View的id,toast：注解上的内容）
   @Override
   public void unValidate(int viewId, String toast) {
     ToastUtils.showLongToast(toast);
   }
});

与Activity的使用方法差不多，只是 EasyValidate.bind(this, fragmentView); 需要变化一下

释放资源

IVALIDATE.unBind();

现在为注解使用事项

注解的使用

@ValidateNull(id = R.id.et_input1, toast = "输入框1为空")
EditText et_input1;
@ValidateCheck(id = R.id.cb_check. toast = "请勾选xxxx注意事项后重新提交")
CheckBox cb_check;
//18位身份证号码
public static final String REGEX_ID_CARD = "^[1-9]\\d{5}[1-9]\\d{3}((0\\d)|(1[0-2]))(([0|1|2]\\d)|3[0-1])\\d{3}([0-9Xx])$";
@ValidateRegular(id = R.id.et_input3, toast = "输入框3内容不符合18位身份证", regular = REGEX_ID_CARD, plan = Plan.B)
EditText et_input3;

调用验证的方法

if(!IVALIDATE.isValidatePass(Plan.DEFAULT)){
  //Todo 验证不通过
  return;
}

来源：https://www.jianshu.com/p/311ab5be9e2e