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}((0d)|(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
以上就是本文的全部内容,希望对大家的学习有所帮助。
- Sklearn-train_test_split随机划分训练集和测试集
- 使用shell来定制dbms_sqltune(r7笔记第39天)
- 简单易学的机器学习算法——分类回归树CART
- Java设计模式-状态模式
- DBA和开发同事的一些代沟(四) (r7笔记第36天)
- python获取文件所在目录和文件名,以及检索当前文件名的方法
- 数据同步中的误导(r7笔记第34天)
- java读取xml文件
- 优化算法——粒子群算法(PSO)
- Java开发画板
- Python—numpy模块下函数介绍(一)numpy.ones、empty等
- Tomcat用户权限设置
- 优化算法——模拟退火算法
- 绘制动态心形图案::R语言绘制心形图
- JavaScript 教程
- JavaScript 编辑工具
- JavaScript 与HTML
- JavaScript 与Java
- JavaScript 数据结构
- JavaScript 基本数据类型
- JavaScript 特殊数据类型
- JavaScript 运算符
- JavaScript typeof 运算符
- JavaScript 表达式
- JavaScript 类型转换
- JavaScript 基本语法
- JavaScript 注释
- Javascript 基本处理流程
- Javascript 选择结构
- Javascript if 语句
- Javascript if 语句的嵌套
- Javascript switch 语句
- Javascript 循环结构
- Javascript 循环结构实例
- Javascript 跳转语句
- Javascript 控制语句总结
- Javascript 函数介绍
- Javascript 函数的定义
- Javascript 函数调用
- Javascript 几种特殊的函数
- JavaScript 内置函数简介
- Javascript eval() 函数
- Javascript isFinite() 函数
- Javascript isNaN() 函数
- parseInt() 与 parseFloat()
- escape() 与 unescape()
- Javascript 字符串介绍
- Javascript length属性
- javascript 字符串函数
- Javascript 日期对象简介
- Javascript 日期对象用途
- Date 对象属性和方法
- Javascript 数组是什么
- Javascript 创建数组
- Javascript 数组赋值与取值
- Javascript 数组属性和方法
- 在Linux中使用history命令的方法
- Linux服务器部署JavaWeb项目完整教程
- centos 6 安装vsftpd与PAM虚拟用户的方法
- CentOS6.8中/英文环境切换教程图解
- centos7.6 安装Tomcat-8.5.39的方法
- ubuntu14.04安装jdk1.8的教程
- Linux nohup实现后台运行程序及查看(nohup与&)
- 详解Linux 服务管理两种方式service和systemctl
- CentOS6.5安装python3.7详细步骤
- Centos7.5配置IP地址的实现
- linux里daily_routine实例代码详解
- 类Linux环境安装jdk1.8及环境变量配置详解
- CentOS7yum安装PHP7.2的操作方法
- CentOS 7中 Apache Web 服务器安装配置教程
- Win10安装Linux系统的教程图解