前言
??在日常的Android開發(fā)中们颜，我們在做登錄注冊等帶有提示性輸入校驗的時候。常常會這樣子寫代碼：
??然后你會發(fā)現(xiàn)每一次寫帶有提交信息頁面的時候都不得不去編寫這種千篇一律的代碼屿附，那彰亥。。递宅。。有沒有一種更加優(yōu)雅得實現(xiàn)方式呢苍狰？So,我就是在這種情況下去編寫了一個項目办龄，希望自己能把更多的注意力放在其他地方。（PS:比如偷懶）
一淋昭、如何優(yōu)雅地實現(xiàn)代碼
??說到用優(yōu)雅得方式寫代碼俐填，不得不提AnnotationProcessor,一個用于編譯時掃描和處理注解工具。它能很好得幫我們處理一些具有規(guī)律的翔忽，重復性的代碼勞動英融。So,作為一位矮肥圓盏檐，不得不承認，這東西很適合我驶悟。所以胡野，我使用它結合Butternife寫了一個校驗提交前數據合法性的一個工具，用于即將重構的項目撩银。
二给涕、EasyValidate
- 使用方法，在module的build.gradle中添加
implementation 'com.eiualee:easyvalidate:1.0.3'
annotationProcessor 'com.eiualee:easyvalidate-compiler:1.0.3'
三额获、用法
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 (判斷控件是否選中狀態(tài), 當控件選中的狀態(tài)與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實現(xiàn)
一個接口。這個接口主用于校驗失敗時回調环鲤，畢竟失敗時不一定都是Toast內容是吧纯趋！這樣子便于拓展,嗯，這樣子說可能不太直觀冷离，我們來看一下這個接口的調用時機
??以下為自動化生成的代碼：
/**
* @ 驗證方法
*/
@UiThread
public final boolean isEmptyValidate(int plan) {
if(plan == 0){
if (TextUtils.isEmpty(EasyValidate.getText(target.tv_test != null?target.tv_test:((TextView)sourse.findViewById(2131165318))))){
if(listener == null)return false;
listener.unValidate(2131165318,"文本框不能為空");
return false;
}
if (TextUtils.isEmpty(EasyValidate.getText(target.et_test != null?target.et_test:((EditText)sourse.findViewById(2131165236))))){
if(listener == null)return false;
listener.unValidate(2131165236,"輸入框不能為空");
return false;
}
return true;
}
return true;
}
- 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);需要變化一下
- 釋放資源
@Override
protected void onDestroy() {
super.onDestroy();
IVALIDATE.unBind();
}
現(xiàn)在為注解使用事項
- 注解的使用
@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)
EditText et_input3;
- 調用驗證的方法
if(!IVALIDATE.isValidatePass(Plan.DEFAULT)){
//Todo 驗證不通過
return;
}
以上就是綁定界面、使用注解西剥、開始驗證痹栖、解綁界面一整套的流程了，是不是很簡單瞭空。揪阿。。哦對了咆畏，在上面調用驗證方法是會有一個Plan.DEFAULT這個是干嘛的呢图甜？請接著看。
Plan的使用（注解中默認的Plan為DEFAULT）
- 當我們在開發(fā)的時候鳖眼。假設會有以下這么一種需求：
界面有4個輸入框，分別為手機號碼驗證碼用戶名密碼
①當用戶輸入手機號碼時嚼摩，只要驗證碼不為空就可以請求登錄接口了钦讳。
②當用戶輸入用戶名時,只要密碼不為空就可以請求登錄接口了矿瘦。
那我們要怎么做呢？這下子就會用到Plan這個字段了愿卒，請看代碼
@ValidateNull(id = R.id.et_phoneNo,toast = "手機號碼不能為空",plan = Plan.A)
EditText et_phoneNo;
@ValidateNull(id = R.id.et_checkNo,toast = "手機驗證碼不能為空",plan = Plan.A)
EditText et_checkNo;
@ValidateNull(id = R.id.et_userName,toast = "手機用戶名不能為空",plan = Plan.B)
EditText et_userName;
@ValidateNull(id = R.id.et_pw,toast = "手機密碼不能為空",plan = Plan.B)
EditText et_pw;
在調用時分別傳入Plan即可
if(!IVALIDATE.isValidatePass(Plan.A)){
//Todo 驗證不通過
return;
}
if(!IVALIDATE.isValidatePass(Plan.B)){
//Todo 驗證不通過
return;
}
- 那當我需求中的判斷都需要用到這個控件去判斷可咋辦呢缚去？
@ValidateNull(id = R.id.et_pw,toast = "手機密碼不能為空",plan = {Plan.A, Plan.B})
EditText et_pw;
plan = {Plan.A, Plan.B}就這么簡單，我既參加計劃A的校驗琼开，也參加計劃B的校驗易结，這下可沒毛病了吧！
對于自定義的View
//使用@ValidateNull @ValidateRegular 時柜候，請務必手動實現(xiàn)這個方法
public CharSequence getText(){
//這里面的內容根據自身情況定
return editText.getText();
}
//使用@ValidateCheck時搞动，請務必手動實現(xiàn)這個方法
public boolean isCheck(){
//這里面的內容根據自身情況定
return checkBox.isCheck();
}
使用的注意事項
-
組件化開發(fā)時要配合Butternife使用，我懶得去生成R2文件了渣刷，畢竟重復造輪子沒意義是吧鹦肿。
結言
嗯。辅柴。箩溃。效果圖我就不發(fā)了。就這樣子吧碌嘀。實現(xiàn)的原理大部分來源于Butternife涣旨。
