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

 更新时间:2018年12月29日 09:21:41   作者:夏季凉茶  
这篇文章主要介绍了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;
}

以上就是绑定界面、使用注解、开始验证、解绑界面一整套的流程了,是不是很简单。。。哦对了,在上面调用验证方法是会有一个 Plan.DEFAULT 这个是干嘛的呢?请接着看。

Plan的使用(注解中默认的Plan为DEFAULT)

当我们在开发的时候。假设会有以下这么一种需求:

手机号码 验证码 用户名 密码
手机号码 验证码

①当用户输入 手机号码 时,只要 验证码 不为空就可以请求登录接口了。

用户名 密码

②当用户输入 用户名 时,只要 密码 不为空就可以请求登录接口了。

那我们要怎么做呢?这下子就会用到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的校验,这下可没毛病了吧!

使用的注意事项

组件化 开发时要配合Butternife使用,我懒得去生成R2文件了,毕竟重复造轮子没意义是吧。 结言

嗯。。。效果图我就不发了。就这样子吧。实现的原理大部分来源于Butternife,啊哈哈哈。以上,这是我的第一篇博客,算是对自己辛苦成果的奖励吧。。。。拜!

GitHub地址: https://github.com/EiuaLee/EasyValidate

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持脚本之家。

相关文章

  • 详解Android端与JavaWeb传输加密(DES+RSA)

    详解Android端与JavaWeb传输加密(DES+RSA)

    这篇文章主要介绍了详解Android端与JavaWeb传输加密(DES+RSA),小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-11-11
  • ExpandListView实现下拉列表案例

    ExpandListView实现下拉列表案例

    这篇文章主要为大家详细介绍了ExpandListView实现下拉列表案例,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-08-08
  • Android Studio中使用SQLite的操作方法

    Android Studio中使用SQLite的操作方法

    这篇文章主要介绍了Android Studio中使用SQLite的操作方法的相关资料,需要的朋友可以参考下
    2023-06-06
  • Android简单使用PopupWindow的方法

    Android简单使用PopupWindow的方法

    这篇文章主要为大家详细介绍了Android简单使用PopupWindow的方法,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-03-03
  • Kotlin操作符重载实例详解

    Kotlin操作符重载实例详解

    Kotlin允许我们为自己的类型提供预定义的一组操作符的实现,下面这篇文章主要给大家介绍了关于Kotlin操作符重载的相关资料,文中通过示例代码介绍的非常详细,需要的朋友可以参考下
    2022-04-04
  • Android控件PullRefreshViewGroup实现下拉刷新和上拉加载

    Android控件PullRefreshViewGroup实现下拉刷新和上拉加载

    这篇文章主要为大家详细介绍了Android控件PullRefreshViewGroup实现下拉刷新和上拉加载效果,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-03-03
  • Android FFmpeg音视频解码播放示例详解

    Android FFmpeg音视频解码播放示例详解

    这篇文章主要为大家介绍了Android FFmpeg音视频解码播放示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-10-10
  • android 网络请求库volley方法详解

    android 网络请求库volley方法详解

    这篇文章主要介绍了android 网络请求库volley方法详解的相关资料,需要的朋友可以参考下
    2016-09-09
  • 详解如何在Android中实现悬浮Activity

    详解如何在Android中实现悬浮Activity

    本篇文章主要介绍详解如何在Android中实现悬浮Activity,通过修改Activity的实现来适配平板设备,已达到代码的最大利用率。有兴趣的可以了解一下。
    2017-01-01
  • android Retrofit2网络请求封装介绍

    android Retrofit2网络请求封装介绍

    大家好,本篇文章主要讲的是android Retrofit2网络请求封装介绍,感兴趣的同学赶快来看一看吧,对你有帮助的话记得收藏一下,方便下次浏览
    2021-12-12

最新评论