Android 输入校验库简介及使用教程 - Next-Inputs

最新推荐文章于 2024-05-07 11:14:58 发布

weixin_33779515

最新推荐文章于 2024-05-07 11:14:58 发布

阅读量340

点赞数 1

文章标签：移动开发 python java

原文链接：https://my.oschina.net/chenyoca/blog/656520

版权

2019独角兽企业重金招聘Python工程师标准>>>

NextInputs项目地址：https://github.com/yoojia/NextInputs

Android扩展项目地址：https://github.com/yoojia/NextInputs-Android

NextInputs 特点

轻量级，纯JDK实现，无第三方依赖；
小巧，Jar文件仅30K+;
内置20+个常用校验模式;
支持自定义校验模式扩展;
支持自定义校验目标扩展;
支持自定义错误消息提示;

NextInputs 内建了两种校验模式分类：静态校验模式、数值校验模式。使用NextInputs能够极大地提升开发效率，内置的多个校验模式已能应付开发常用的校验需求，如有特殊校验需求，通过扩展接口也能快速解决。

使用示例

NextInputs inputs = new NextInputs();
inputs.add(Inputs.fromString(mUsername),
        StaticPattern.Required(),
        StaticPattern.Email()
);
boolean passed = inputs.test();

配置 Gradle 依赖

dependencies {
    compile 'com.github.yoojia:next-inputs:1.3.3'
}

StaticPattern - 静态校验模式

静态校验模式也可以称为数据格式匹配模式。在校验时不需要其它辅助参数，而是直接校验输入数据的格式是否符合要求。 NextInputs目前内置包含以下几种静态校验模式，在未来版本也会加入其它使用频率较高的模式：

Required - 必填模式
NotBlank - 非空模式
Digits - 数字模式
Email - 邮件地址模式
IPv4 - IP地址模式
Host - 域名模式
URL - URL地址模式
Numeric - 数值模式
BlankCard - 银行卡/信用卡号码模式
ChineseIDCard 身份证号码模式
ChineseMobile 手机号码模式（国内手机号）
IsTrue - 结果为True模式
IsFalse - 结果为False模式

Required - 必填模式

设置Required模式后，输入内容不能为空，也是NextInputs不允许空值的两条校验规则之一

在设置Required模式后，Required模式在校验时会优先于其它模式。其它校验模式在默认情况下将按代码添加顺序依次执行。

注意：

Required的校验优先级默认为 StaticPattern/ValuePattern.PRIORITY_REQUIRED(-1024)，其它优先级为 StaticPattern/ValuePattern.PRIORITY_GENERAL(0)。
如果输入条目没有添加Required校验模式（或者NotBlank模式），在输入内容为空的情况下，校验结果是通过（Passed）的。

NotBlank - 非空数据模式

设置Required模式后，输入内容不能是任何空值，也是NextInputs不允许空值的两条校验规则之一

StaticPattern.Required()，输入内容不能为任何空数据，除空数据外，还包括任意数量的纯空格、制表符等。

Digits - 数字模式

StaticPattern.Digits()，输入内容只能是纯数字。

Email - 邮件地址模式

StaticPattern.Email()，输入内容必须是有效的电子邮件地址。

IPv4 - IP地址模式

StaticPattern.IPv4()，输入内容必须是有效的IPv4地址。

Host - 主机地址模式

StaticPattern.Host()，输入内容必须是有效的主机地址。这个模块包含了IPv4的校验。

URL - URL地址模式

StaticPattern.URL()，输入内容必须是有效的URL地址。

Numeric - 数值模式

StaticPattern.Numeric()，输入内容必须是有效的数值。

BlankCard - 银行卡/信用卡号码模式

StaticPattern.BlankCard()，输入内容必须是有效的银行卡号或者信用卡号。这个模式在实现上，使用银行卡号校验算法（Luhn）来校验，可以支持13位到19位长度的有效卡号。

ChineseIDCard 身份证号码模式

StaticPattern.ChineseIDCard()，输入内容必须是有效的中国居民身份证号码。这个模式支持15位和18位身份证号。

ChineseMobile 手机号码模式（国内手机号）

StaticPattern.ChineseMobile()，输入内容必须是有效的手机号。这个手机号必须是11位国内手机号，其它国家或者地区的手机号暂不支持。

IsTrue - 结果为True模式

StaticPattern.IsTrue()，输入内容必须是True值。通常用于校验RadioBotton或者CheckBox等。

IsFalse - 结果为False模式

StaticPattern.IsFalse()，输入内容必须是False值。通常用于校验RadioBotton或者CheckBox等。

ValuePattern - 数值校验模式

数值校验模式需要指定校验参数来完成校验。 NextInputs目前内置包含以下几种数值校验模式，在未来版本也会加入其它使用频率较高的模式：

Required - 必填模式，与静态校验模式的必填模式相同。
MinLength - 最小内容长度
MaxLength - 最多内容长度
RangeLength - 内容长度在指定范围内
MinValue - 最小值
MaxValue - 最大值
RangeValue - 数值范围
Equals - 与指定内容相同
NotEquals - 与指定内容不相同

Required - 必填项目

ValuePattern.Required()，与StaticPattern.Required相同。

MinLength - 最小内容长度

ValuePattern.MinLength(minLength)，输入内容的长度至少（包括）为指定长度。

MaxLength - 最多内容长度

ValuePattern.MaxLength(maxLength)，输入内容的长度最大（包括）为指定长度。

RangeLength - 内容长度在指定范围内

ValuePattern.RangeLength(minLength, maxLength)，输入内容的长度在指定范围内。

MinValue - 最小值

ValuePattern.MinValue(minValue)，输入数值最小（包括）为指定数值。支持的数值类型：Int、Long、Float、Double；

MaxValue - 最大值

ValuePattern.MaxValue(minValue)，输入数值最大（包括）为指定数值。支持的数值类型：Int、Long、Float、Double；

RangeValue - 数值范围

ValuePattern.RangeValue(minValue, maxValue)，输入数值在（包括）指定数值范围内。支持的数值类型：Int、Long、Float、Double；

Equals - 与指定内容相同

ValuePattern.Equals(...)，输入内容与指定内容相同。Equals有两个实现方式，一个是Equals(Loader<String>)，另一个是Equals(fixedString)；

Equals(Loader<String>)，延迟加载参数形式。当开始校验时，Loader的getValue方法才会被执行，并要求返回一个用于匹配输入内容的字符串；
Equals(fixedString)，与指定固定字符串相同；

NotEquals - 与指定内容不相同

方式与ValuePattern.Equals相同，判断方式取反。

设置校验失败提示消息

NextInputs内置的所有校验模式都自带提示消息，这些提示消息描述也比较“抽象”，很可能不符合你的业务需要。使用 .msgOnFail(String) 接口或者 .msg(String) 接口可以设置校验失败提示消息。当校验失败时，提示消息将通过MessageDisplay接口的具体实现类处理并显示出来。

这两个接口的作用是相同的，如果你觉得.msg(String)会导致你突然忘记这方法是干哈的，你可以使用.msgOnFail(String)方法来提醒自己。

使用 NextInputs.setMessageDisplay(MessageDisplay) 方法可以覆盖默认实现，使用你想要的校验失败提示方式。