Android Saripaar 注解詳解

小仙女本仙人 2022-01-03

展開(kāi)全文

寫這篇文章的原因

在移動(dòng)端一般很少使用復(fù)雜的表單，一般針對(duì)于屬性的更改都會(huì)打開(kāi)一個(gè)新的頁(yè)面進(jìn)行更改。雖然不多，但是也會(huì)有。如果一個(gè)頁(yè)面要輸入的內(nèi)容包括姓名、地址、郵箱、手機(jī)號(hào)等，對(duì)各個(gè)屬性的驗(yàn)證會(huì)非常麻煩，并且非常的不優(yōu)雅。

于是，saripaar就出現(xiàn)了，一種基于規(guī)則的Android UI輸入驗(yàn)證庫(kù)，通過(guò)注解即可標(biāo)注驗(yàn)證規(guī)則。

使用過(guò)程中發(fā)現(xiàn)只有四個(gè)字：簡(jiǎn)單好用。但是官方對(duì)注解的使用并沒(méi)有一份完整的文檔，故參考源碼整理了現(xiàn)有的所有注解（基于版本2.0.3）。

如何使用

導(dǎo)入依賴

第一步當(dāng)然是導(dǎo)入依賴?yán)?，可通過(guò)implementation 'com.mobsandgeeks:android-saripaar:(latest version)'導(dǎo)入saripaar，將(latest version)替換為最新版本即可。

使用注解

對(duì)需要進(jìn)行驗(yàn)證的可輸入View加上注解來(lái)標(biāo)注驗(yàn)證規(guī)則，例

@Length(min = 6, max = 9)
private AppCompatEditText et1;

該注解表示et1中的輸入內(nèi)容長(zhǎng)度只能在6到9的閉區(qū)間。

實(shí)例化`Validator`

mValidator = new Validator(this);
mValidator.setValidationListener(this);

Validator負(fù)責(zé)驗(yàn)證給定容器中的View，通常容器為Activity或Fragment。但也可以用包含View的其他類作為容器。

實(shí)現(xiàn)`ValidationListener`

public class MainActivity extends AppCompatActivity implements Validator.ValidationListener {

    // Code…

    @Override
    public void onValidationSucceeded() {
        Toast.makeText(this, "成功了！", Toast.LENGTH_LONG).show();
    }

    @Override
    public void onValidationFailed(List<ValidationError> errors) {
        Toast.makeText(this, "失敗了！", Toast.LENGTH_LONG).show();
    }
}

ValidationListener用戶監(jiān)聽(tīng)回調(diào)結(jié)果，并進(jìn)行相應(yīng)的處理。

調(diào)用驗(yàn)證方法

btn.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View v) {
        mValidator.validate();
    }
});

其余的高級(jí)用法在此不做介紹，該文章主要介紹各個(gè)注解的使用。

注解

`@AssertFalse`

描述

用于判斷輸入內(nèi)容是否為false。

作用范圍

CheckBox
RadioButton
RadioGroup

參數(shù)

sequence：確定規(guī)則的判定順序，當(dāng)單個(gè)View有多個(gè)規(guī)則時(shí)生效
messageResId：錯(cuò)誤提示文字的資源文件ID
message：錯(cuò)誤提示文字
注：所有注解均有這三個(gè)參數(shù)，故之后注解省略不寫

`@AssertTrue`

描述

用于判斷輸入內(nèi)容是否為true。

作用范圍

CheckBox
RadioButton
RadioGroup

`@Checked`

描述

用于判斷輸入內(nèi)容是否為預(yù)設(shè)值，默認(rèn)預(yù)設(shè)值為true。

作用范圍

CheckBox
RadioButton
RadioGroup

參數(shù)

value：用于設(shè)置預(yù)設(shè)值，默認(rèn)為true

`@ConfirmEmail`

描述

判斷當(dāng)前輸入內(nèi)容與被@Email注解的View的內(nèi)容是否一致。
注：當(dāng)前容器所持有的被@Email注解的View必須且只允許有一個(gè)。

作用范圍

TextView

`@ConfirmPassword`

描述

判斷當(dāng)前輸入內(nèi)容與被@Password注解的View的內(nèi)容是否一致。
注：當(dāng)前容器所持有的被@Password注解的View必須且只允許有一個(gè)。

作用范圍

TextView

`@CreditCard`

描述

判斷輸入內(nèi)容是否符合信用卡卡號(hào)規(guī)則。

作用范圍

TextView

參數(shù)

cardTypes：是一個(gè)數(shù)組，用于確定信用卡的類型，每種類型對(duì)應(yīng)著不同的正則表達(dá)式
- Type.AMEX，美國(guó)運(yùn)通卡，對(duì)應(yīng)著^(3[47]\d{13})$
- Type.DINERS，大萊信用卡，對(duì)應(yīng)著^(30[0-5]\d{11}|3095\d{10}|36\d{12}|3[8-9]\d{12})$
- Type.DISCOVER，發(fā)現(xiàn)卡，對(duì)應(yīng)著^(6011\d{12})$、^(64[4-9]\d{13})$和^(65\d{14})$
- Type.MASTERCARD，萬(wàn)事達(dá)卡，對(duì)應(yīng)著^(5[1-5]\d{14})$
- Type.VISA，簽證卡，對(duì)應(yīng)著^(4)(\d{12}|\d{15})$
- Type.NONE，不允許任何內(nèi)置的信用卡，適用于自定義信用卡類型

`@DecimalMax`

描述

限制輸入內(nèi)容的最大值，輸入內(nèi)容會(huì)被強(qiáng)轉(zhuǎn)為Double類型，若輸入文字不符合Double類型，會(huì)報(bào)ConversionException異常。

作用范圍

TextView

參數(shù)

value：double類型，最大值。

`@DecimalMin`

描述

限制輸入內(nèi)容的最小值，輸入內(nèi)容會(huì)被強(qiáng)轉(zhuǎn)為Double類型，若輸入文字不符合Double類型，會(huì)報(bào)ConversionException異常。

作用范圍

TextView

參數(shù)

value：double類型，最小值。

`@Digits`

描述

判斷輸入內(nèi)容是否為數(shù)字，可定義整數(shù)部分以及小數(shù)部分的最大位數(shù)。

作用范圍

TextView

參數(shù)

integer：整數(shù)部分最大位數(shù)
fraction：小數(shù)部分最大位數(shù)
注：輸入內(nèi)容需滿足正則
String.format("(\\d{0,%d})(\\.\\d{1,%d})?", integer, fraction);

`@Domain`

描述

判斷輸入內(nèi)容是否是一個(gè)有效的域名。

作用范圍

TextView

參數(shù)

allowLocal：本地地址是否有效，默認(rèn)為false

`@Email`

描述

判斷輸入內(nèi)容是否是一個(gè)有效的郵箱地址。

作用范圍

TextView

參數(shù)

allowLocal：本地地址是否有效，默認(rèn)為false

`@Future`

描述

判斷輸入的時(shí)間是否是未來(lái)時(shí)間（與當(dāng)前時(shí)間相比）。輸入的時(shí)間必須滿足相應(yīng)的格式。

作用范圍

TextView

參數(shù)

dateFormat：時(shí)間的格式，默認(rèn)為dd-MM-yyyy，以下為saripaar提供的格式（可自定義）
- DateFormats.DMY：dd-MM-yyyy
- DateFormats.YMD：yyyy-MM-dd
- DateFormats.MDY：MM-dd-yyyy
- DateFormats.DMY_TIME_12_HOURS：dd-MM-yyyy hh:mm aa
- DateFormats.YMD_TIME_12_HOURS：yyyy-MM-dd hh:mm aa
- DateFormats.MDY_TIME_12_HOURS：MM-dd-yyyy hh:mm aa
- DateFormats.DMY_TIME_24_HOURS：dd-MM-yyyy kk:mm
- DateFormats.YMD_TIME_24_HOURS：yyyy-MM-dd kk:mm
- DateFormats.MDY_TIME_24_HOURS：MM-dd-yyyy kk:mm
dateFormatResId：時(shí)間格式的資源ID

`@IpAddress`

描述

判斷輸入的內(nèi)容是否是一個(gè)IP，IPv4或IPv6

作用范圍

TextView

`@Isbn`

描述

判斷輸入的內(nèi)容是否是一個(gè)Isbn，即國(guó)際標(biāo)準(zhǔn)書(shū)號(hào)。

作用范圍

TextView

`@Length`

描述

限制輸入內(nèi)容的文本長(zhǎng)度，可自定義最大長(zhǎng)度和最小長(zhǎng)度。

作用范圍

TextView

參數(shù)

min：文本的最小長(zhǎng)度，默認(rèn)為Integer.MIN_VALUE
max：文本的最大長(zhǎng)度，默認(rèn)為Integer.MAX_VALUE
trim：是否需要先做trim操作，默認(rèn)為false

`@Max`

描述

限制輸入內(nèi)容的最大值，輸入內(nèi)容會(huì)被強(qiáng)轉(zhuǎn)為Integer類型，若輸入文字不符合Integer類型，會(huì)報(bào)ConversionException異常。

作用范圍

TextView

參數(shù)

value：int類型，最大值。

`@Min`

描述

限制輸入內(nèi)容的最小值，輸入內(nèi)容會(huì)被強(qiáng)轉(zhuǎn)為Integer類型，若輸入文字不符合Integer類型，會(huì)報(bào)ConversionException異常。

作用范圍

TextView

參數(shù)

value：int類型，最小值。

`@NotEmpty`

描述

判斷輸入內(nèi)容是否非空。

作用范圍

TextView

參數(shù)

trim：判斷之前是否要先trim，默認(rèn)為false
emptyText：設(shè)置“空字符串”，可自定義一段文本，當(dāng)輸入此文本是則為空
emptyTextResId：設(shè)置“空字符串”的資源文件

`@Order`

描述

確定校驗(yàn)字段的順序。當(dāng)一個(gè)容器有多個(gè)View需要檢驗(yàn)時(shí)，可通過(guò)該注解確定校驗(yàn)順序。

作用范圍

TextView
CheckBox
RadioButton
RadioGroup
Spinner

參數(shù)

value：int類型，用于確定順序

`@Password`

描述

用于校驗(yàn)文本是否符合密碼的規(guī)則。

作用范圍

TextView

參數(shù)

min：最小字符數(shù)，默認(rèn)為6
scheme：Scheme類型，利用正則確定密碼的輸入格式，只能為Scheme類型，不可自定義，默認(rèn)為Password.Scheme.ANY
- Password.Scheme.ANY：.+
- Password.Scheme.ALPHA：\w+
- Password.Scheme.ALPHA_MIXED_CASE：(?=.*[a-z])(?=.*[A-Z]).+
- Password.Scheme.NUMERIC：\d+
- Password.Scheme.ALPHA_NUMERIC：(?=.*[a-zA-Z])(?=.*[\d]).+
- Password.Scheme.ALPHA_NUMERIC_MIXED_CASE：(?=.*[a-z])(?=.*[A-Z])(?=.*[\d]).+
- Password.Scheme.ALPHA_NUMERIC_SYMBOLS：(?=.*[a-zA-Z])(?=.*[\d])(?=.*([^\w])).+
- Password.Scheme.ALPHA_NUMERIC_MIXED_CASE_SYMBOLS：(?=.*[a-z])(?=.*[A-Z])(?=.*[\d])(?=.*([^\w])).+

`@Past`

描述

判斷輸入的時(shí)間是否是過(guò)去時(shí)間（與當(dāng)前時(shí)間相比）。輸入的時(shí)間必須滿足相應(yīng)的格式。

作用范圍

TextView

參數(shù)

dateFormat：時(shí)間的格式，默認(rèn)為dd-MM-yyyy，以下為saripaar提供的格式（可自定義）
- DateFormats.DMY：dd-MM-yyyy
- DateFormats.YMD：yyyy-MM-dd
- DateFormats.MDY：MM-dd-yyyy
- DateFormats.DMY_TIME_12_HOURS：dd-MM-yyyy hh:mm aa
- DateFormats.YMD_TIME_12_HOURS：yyyy-MM-dd hh:mm aa
- DateFormats.MDY_TIME_12_HOURS：MM-dd-yyyy hh:mm aa
- DateFormats.DMY_TIME_24_HOURS：dd-MM-yyyy kk:mm
- DateFormats.YMD_TIME_24_HOURS：yyyy-MM-dd kk:mm
- DateFormats.MDY_TIME_24_HOURS：MM-dd-yyyy kk:mm
dateFormatResId：時(shí)間格式的資源ID

`@Pattern`

描述

判斷輸入的內(nèi)容是否滿足正則表達(dá)式。

作用范圍

TextView

參數(shù)

regex：正則表達(dá)式
caseSensitive：是否區(qū)分大小寫

`@Select`

描述

判斷選擇的索引是否等于默認(rèn)值，如果不等于則通過(guò)，默認(rèn)值為0。

作用范圍

Spinner

參數(shù)

defaultSelection：設(shè)置默認(rèn)值

`@Url`

描述

判斷輸入的內(nèi)容是否是一個(gè)url。

作用范圍

TextView

參數(shù)

schemes：是一個(gè)數(shù)組，url的協(xié)議數(shù)組，可自定義，默認(rèn)為{"http", "https", "ftp"}
allowFragments：url片段是否允許通過(guò)，默認(rèn)為true

對(duì)于`@Optional`和`@Or`

雖然該版本已經(jīng)有了這兩個(gè)注解，但是并不能使用，參考作者在stackoverflow上的回復(fù)，注解將會(huì)在2.1.0版本上線

總結(jié)

本篇文章簡(jiǎn)單介紹了Android Saripaar的用法，并著重列舉了各個(gè)注解的作用以及各個(gè)參數(shù)的意思，方便以后的查詢。

通過(guò)閱讀源碼對(duì)saripaar有了更深的認(rèn)識(shí)，并對(duì)基于注解的框架有了一個(gè)完備的認(rèn)知。

以后如果有時(shí)間的話總結(jié)一下Android Saripaar實(shí)現(xiàn)的細(xì)節(jié)。

本站是提供個(gè)人知識(shí)管理的網(wǎng)絡(luò)存儲(chǔ)空間，所有內(nèi)容均由用戶發(fā)布，不代表本站觀點(diǎn)。請(qǐng)注意甄別內(nèi)容中的聯(lián)系方式、誘導(dǎo)購(gòu)買等信息，謹(jǐn)防詐騙。如發(fā)現(xiàn)有害或侵權(quán)內(nèi)容，請(qǐng)點(diǎn)擊一鍵舉報(bào)。

轉(zhuǎn)藏 分享

QQ空間 QQ好友新浪微博微信

獻(xiàn)花（0） +1

來(lái)自：小仙女本仙人 > 《待分類》

舉報(bào)/認(rèn)領(lǐng)

0條評(píng)論

發(fā)表

請(qǐng)遵守用戶評(píng)論公約

類似文章 更多

小仙女本仙人

關(guān)注對(duì)話

TA的最新館藏

就在明晚，3月10日19:30，#HMS Core Insights#直播來(lái)了！
SmartSVN 最新版
SpringMVC-05 Json交互處理
jQuery2021.3.9日【懵逼了啥也不是】【emmet語(yǔ)法】
locust工具使用詳解
圖片轉(zhuǎn)換成Base64后獲取圖片信息(長(zhǎng)寬)

喜歡該文的人也喜歡更多

熱門閱讀換一換

日韩黑丝制服一区视频播放|日韩欧美人妻丝袜视频在线观看|九九影院一级蜜桃|亚洲中文在线导航|青草草视频在线观看|婷婷五月色伊人网站|日本一区二区在线|国产AV一二三四区毛片|正在播放久草视频|亚洲色图精品一区

Android Saripaar 注解詳解

寫這篇文章的原因

如何使用

導(dǎo)入依賴

使用注解

實(shí)例化Validator

實(shí)現(xiàn)ValidationListener

調(diào)用驗(yàn)證方法

注解

@AssertFalse

描述

作用范圍

參數(shù)

@AssertTrue

描述

作用范圍

@Checked

描述

作用范圍

參數(shù)

@ConfirmEmail

描述

作用范圍

@ConfirmPassword

描述

作用范圍

@CreditCard

描述

作用范圍

參數(shù)

@DecimalMax

描述

作用范圍

參數(shù)

@DecimalMin

描述

作用范圍

參數(shù)

@Digits

描述

作用范圍

參數(shù)

@Domain

描述

作用范圍

參數(shù)

@Email

描述

作用范圍

參數(shù)

@Future

描述

作用范圍

參數(shù)

@IpAddress

描述

作用范圍

@Isbn

描述

作用范圍

@Length

描述

作用范圍

參數(shù)

@Max

描述

作用范圍

參數(shù)

@Min

描述

作用范圍

參數(shù)

@NotEmpty

描述

作用范圍

參數(shù)

@Order

描述

作用范圍

實(shí)例化`Validator`

實(shí)現(xiàn)`ValidationListener`

`@AssertFalse`

`@AssertTrue`

`@Checked`

`@ConfirmEmail`

`@ConfirmPassword`

`@CreditCard`

`@DecimalMax`

`@DecimalMin`

`@Digits`

`@Domain`

`@Email`

`@Future`

`@IpAddress`

`@Isbn`

`@Length`

`@Max`

`@Min`

`@NotEmpty`

`@Order`

`@Password`

`@Past`

`@Pattern`

`@Select`

`@Url`

對(duì)于`@Optional`和`@Or`