Android Saripaar 註解詳解

来源:https://www.cnblogs.com/lanxingren/archive/2019/12/02/11973882.html

寫這篇文章的原因 在移動端一般很少使用複雜的表單,一般針對於屬性的更改都會打開一個新的頁面進行更改。雖然不多,但是也會有。如果一個頁面要輸入的內容包括姓名、地址、郵箱、手機號等,對各個屬性的驗證會非常麻煩,並且非常的不優雅。 於是, 就出現了,一種基於規則的 輸入驗證庫,通過註解即可標註驗證規則。 ...


寫這篇文章的原因

在移動端一般很少使用複雜的表單,一般針對於屬性的更改都會打開一個新的頁面進行更改。雖然不多,但是也會有。如果一個頁面要輸入的內容包括姓名、地址、郵箱、手機號等,對各個屬性的驗證會非常麻煩,並且非常的不優雅。

於是,saripaar就出現了,一種基於規則的Android UI輸入驗證庫,通過註解即可標註驗證規則。

使用過程中發現只有四個字:簡單好用。但是官方對註解的使用並沒有一份完整的文檔,故參考源碼整理了現有的所有註解(基於版本2.0.3)。

如何使用

導入依賴

第一步當然是導入依賴啦,可通過implementation 'com.mobsandgeeks:android-saripaar:(latest version)'導入saripaar,將(latest version)替換為最新版本即可。

使用註解

對需要進行驗證的可輸入View加上註解來標註驗證規則,例

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

該註解表示et1中的輸入內容長度只能在6到9的閉區間。

實例化Validator

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

Validator負責驗證給定容器中的View,通常容器為ActivityFragment。但也可以用包含View的其他類作為容器。

實現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用戶監聽回調結果,併進行相應的處理。

調用驗證方法

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

其餘的高級用法在此不做介紹,該文章主要介紹各個註解的使用。

註解

@AssertFalse

描述

用於判斷輸入內容是否為false

作用範圍

  • CheckBox
  • RadioButton
  • RadioGroup

參數

  • sequence:確定規則的判定順序,當單個View有多個規則時生效
  • messageResId:錯誤提示文字的資源文件ID
  • message:錯誤提示文字
    註:所有註解均有這三個參數,故之後註解省略不寫

@AssertTrue

描述

用於判斷輸入內容是否為true

作用範圍

  • CheckBox
  • RadioButton
  • RadioGroup

@Checked

描述

用於判斷輸入內容是否為預設值,預設預設值為true

作用範圍

  • CheckBox
  • RadioButton
  • RadioGroup

參數

  • value:用於設置預設值,預設為true

@ConfirmEmail

描述

判斷當前輸入內容與被@Email註解的View的內容是否一致。
註:當前容器所持有的被@Email註解的View必須且只允許有一個。

作用範圍

  • TextView

@ConfirmPassword

描述

判斷當前輸入內容與被@Password註解的View的內容是否一致。
註:當前容器所持有的被@Password註解的View必須且只允許有一個。

作用範圍

  • TextView

@CreditCard

描述

判斷輸入內容是否符合信用卡卡號規則。

作用範圍

  • TextView

參數

  • cardTypes:是一個數組,用於確定信用卡的類型,每種類型對應著不同的正則表達式
    • Type.AMEX,美國運通卡,對應著^(3[47]\d{13})$
    • Type.DINERS,大萊信用卡,對應著^(30[0-5]\d{11}|3095\d{10}|36\d{12}|3[8-9]\d{12})$
    • Type.DISCOVER,發現卡,對應著^(6011\d{12})$^(64[4-9]\d{13})$^(65\d{14})$
    • Type.MASTERCARD,萬事達卡,對應著^(5[1-5]\d{14})$
    • Type.VISA,簽證卡,對應著^(4)(\d{12}|\d{15})$
    • Type.NONE,不允許任何內置的信用卡,適用於自定義信用卡類型

@DecimalMax

描述

限制輸入內容的最大值,輸入內容會被強轉為Double類型,若輸入文字不符合Double類型,會報ConversionException異常。

作用範圍

  • TextView

參數

  • valuedouble類型,最大值。

@DecimalMin

描述

限制輸入內容的最小值,輸入內容會被強轉為Double類型,若輸入文字不符合Double類型,會報ConversionException異常。

作用範圍

  • TextView

參數

  • valuedouble類型,最小值。

@Digits

描述

判斷輸入內容是否為數字,可定義整數部分以及小數部分的最大位數。

作用範圍

  • TextView

參數

  • integer:整數部分最大位數
  • fraction:小數部分最大位數
    註:輸入內容需滿足正則
    String.format("(\\d{0,%d})(\\.\\d{1,%d})?", integer, fraction);

@Domain

描述

判斷輸入內容是否是一個有效的功能變數名稱。

作用範圍

  • TextView

參數

  • allowLocal:本地地址是否有效,預設為false

@Email

描述

判斷輸入內容是否是一個有效的郵箱地址。

作用範圍

  • TextView

參數

  • allowLocal:本地地址是否有效,預設為false

@Future

描述

判斷輸入的時間是否是未來時間(與當前時間相比)。輸入的時間必須滿足相應的格式。

作用範圍

  • TextView

參數

  • dateFormat:時間的格式,預設為dd-MM-yyyy,以下為saripaar提供的格式(可自定義)
    • DateFormats.DMYdd-MM-yyyy
    • DateFormats.YMDyyyy-MM-dd
    • DateFormats.MDYMM-dd-yyyy
    • DateFormats.DMY_TIME_12_HOURSdd-MM-yyyy hh:mm aa
    • DateFormats.YMD_TIME_12_HOURSyyyy-MM-dd hh:mm aa
    • DateFormats.MDY_TIME_12_HOURSMM-dd-yyyy hh:mm aa
    • DateFormats.DMY_TIME_24_HOURSdd-MM-yyyy kk:mm
    • DateFormats.YMD_TIME_24_HOURSyyyy-MM-dd kk:mm
    • DateFormats.MDY_TIME_24_HOURSMM-dd-yyyy kk:mm
  • dateFormatResId:時間格式的資源ID

@IpAddress

描述

判斷輸入的內容是否是一個IPIPv4IPv6

作用範圍

  • TextView

@Isbn

描述

判斷輸入的內容是否是一個Isbn,即國際標準書號

作用範圍

  • TextView

@Length

描述

限制輸入內容的文本長度,可自定義最大長度和最小長度。

作用範圍

  • TextView

參數

  • min:文本的最小長度,預設為Integer.MIN_VALUE
  • max:文本的最大長度,預設為Integer.MAX_VALUE
  • trim:是否需要先做trim操作,預設為false

@Max

描述

限制輸入內容的最大值,輸入內容會被強轉為Integer類型,若輸入文字不符合Integer類型,會報ConversionException異常。

作用範圍

  • TextView

參數

  • valueint類型,最大值。

@Min

描述

限制輸入內容的最小值,輸入內容會被強轉為Integer類型,若輸入文字不符合Integer類型,會報ConversionException異常。

作用範圍

  • TextView

參數

  • valueint類型,最小值。

@NotEmpty

描述

判斷輸入內容是否非空。

作用範圍

  • TextView

參數

  • trim:判斷之前是否要先trim,預設為false
  • emptyText:設置“空字元串”,可自定義一段文本,當輸入此文本是則為空
  • emptyTextResId:設置“空字元串”的資源文件

@Order

描述

確定校驗欄位的順序。當一個容器有多個View需要檢驗時,可通過該註解確定校驗順序。

作用範圍

  • TextView
  • CheckBox
  • RadioButton
  • RadioGroup
  • Spinner

參數

  • valueint類型,用於確定順序

@Password

描述

用於校驗文本是否符合密碼的規則。

作用範圍

  • TextView

參數

  • min:最小字元數,預設為6
  • schemeScheme類型,利用正則確定密碼的輸入格式,只能為Scheme類型,不可自定義,預設為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

描述

判斷輸入的時間是否是過去時間(與當前時間相比)。輸入的時間必須滿足相應的格式。

作用範圍

  • TextView

參數

  • dateFormat:時間的格式,預設為dd-MM-yyyy,以下為saripaar提供的格式(可自定義)
    • DateFormats.DMYdd-MM-yyyy
    • DateFormats.YMDyyyy-MM-dd
    • DateFormats.MDYMM-dd-yyyy
    • DateFormats.DMY_TIME_12_HOURSdd-MM-yyyy hh:mm aa
    • DateFormats.YMD_TIME_12_HOURSyyyy-MM-dd hh:mm aa
    • DateFormats.MDY_TIME_12_HOURSMM-dd-yyyy hh:mm aa
    • DateFormats.DMY_TIME_24_HOURSdd-MM-yyyy kk:mm
    • DateFormats.YMD_TIME_24_HOURSyyyy-MM-dd kk:mm
    • DateFormats.MDY_TIME_24_HOURSMM-dd-yyyy kk:mm
  • dateFormatResId:時間格式的資源ID

@Pattern

描述

判斷輸入的內容是否滿足正則表達式。

作用範圍

  • TextView

參數

  • regex:正則表達式
  • caseSensitive:是否區分大小寫

@Select

描述

判斷選擇的索引是否等於預設值,如果不等於則通過,預設值為0。

作用範圍

  • Spinner

參數

  • defaultSelection:設置預設值

@Url

描述

判斷輸入的內容是否是一個url

作用範圍

  • TextView

參數

  • schemes:是一個數組,url的協議數組,可自定義,預設為{"http", "https", "ftp"}
  • allowFragmentsurl片段是否允許通過,預設為true

對於@Optional@Or

雖然該版本已經有了這兩個註解,但是並不能使用,參考作者在stackoverflow上的回覆,註解將會在2.1.0版本上線

總結

本篇文章簡單介紹了Android Saripaar的用法,並著重列舉了各個註解的作用以及各個參數的意思,方便以後的查詢。

通過閱讀源碼對saripaar有了更深的認識,並對基於註解的框架有了一個完備的認知。

以後如果有時間的話總結一下Android Saripaar實現的細節。


您的分享是我們最大的動力!

更多相關文章
  • 索引的優點 1.加快數據的檢索速度,這是創建索引的最主要的原因; 2.通過創建唯一性索引,可以保證資料庫表中每一行數據的唯一性; 3.加速表和表之間的連接; 4.在使用分組和排序子句進行數據檢索時,可以顯著減少查詢中分組和排序的時間。 索引的缺點 1.創建索引和維護索引要耗費時間,這種時間隨著數據量 ...
  • 環境 CentOS Linux release 7.7.1908 (Core) 拉取redis 5.0.7 鏡像 創建掛載目錄 下載redis.conf "redis.conf 地址" 進入目錄並下載redis.conf 修改redis.conf 創建啟動容器 參數解釋 ...
  • 一、官網地址 https://studio3t.com/ 二、下載和安裝 點擊DOWNLOAD即可下載 按照自己電腦系統進行選擇,然後填寫郵箱和選擇行業,第一次登錄如果不提交不會下載,下載完成是一個zip壓縮包(我的電腦是windows系統),解壓縮安裝即可,安裝途中可以自行選擇安裝路徑 安裝完成選 ...
  • 使用SQL語句修改Mysql資料庫字元集的方法 修改庫: alter database [$database] character set [$character_set] collate [$collation_name] 註:[$database]為資料庫的庫名。[$character_set] ...
  • 2019年8月5日18:39:06 10.20.100.21rootbayaim 01-Docker介紹 docker -- go 語言編寫一次運算,到處運行只能 運行在linux 64位系統 docker 組成: (後臺進程) 1.鏡像(image) 2.容器(container) 3.倉庫(re ...
  • mysqladmin是一個執行管理操作的客戶端程式。它可以用來檢查伺服器的配置和當前狀態、創建和刪除資料庫等。 mysqladmin工具的使用格式:mysqladmin [option] command [command option] command ...... 1.查看mysql的安裝目錄,進 ...
  • #菜鳥教程地址https://www.runoob.com/docker/docker-tutorial.html#docker官方地址倉庫https://hub.docker.com/ docker 安裝 1.更新內核yum update2.下載安裝腳本curl -fsSL https://get ...
  • 項目是一個即時聊天的社交軟體,聊天流採用的是UICollectionView,隨著進度的完善,發現一個特別的bug,UICollectionviewCell的復用,並沒有直接insert進去,而是出現了莫名奇妙的插入方式, 這不是我的圖,這是我在網上找到的,跟我的效果一樣一樣的。link the i ...
一周排行
  • HttpReports 簡單介紹 HttpReports 是 .Net Core下的一個Web組件,適用於 WebAPI 項目和 API 網關項目,通過中間件的形式集成到您的項目中, 通過HttpReports,可以讓開發人員快速的搭建出一個 API 性能分析的基礎報表網站。 主要包含 HttpRe ...
  • 大家好,這幾天試著從Github上拉取AspNetCore的源碼,嘗試著通過Visual Studio 打開,但是並不盡人意。我們需要去構建我們拉去的源代碼,這樣才可以通過VisualStudio可還原的項目。畢竟AspNetCore是一個巨型的項目集。 先決條件 在Windows中構建AspNet ...
  • 知識需要不斷積累、總結和沉澱,思考和寫作是成長的催化劑 梯子 一、鎖1、lock2、Interlocked3、Monitor4、SpinLock5、Mutex6、Semaphore7、Events1、AutoResetEvent2、ManualResetEvent3、ManualResetEvent ...
  • 安裝Docker CentOS 7 安裝 Docker 編寫Dockerfile 右鍵項目-》添加-》Docker 支持 選擇Linux 修改為如下: FROM mcr.microsoft.com/dotnet/core/aspnet:2.2-stretch-slim AS base WORKDIR ...
  • 原文:https://blogs.msdn.microsoft.com/mazhou/2017/06/06/c-7-series-part-3-default-literals/ C#的default關鍵字有兩種用法:一種是標記switch…case結構的預設分支(會匹配任意不被所有case條件匹配 ...
  • 相關模塊 1. AbpAspNetCoreModule 2. AbpAspNetCoreMvcModule 3. AbpAspNetCoreMvcContractsModule abp通過這三個模塊載入並配置了 asp.net core。,最主要的就是AbpAspNetCoreMvcModule模塊 ...
  • 安裝 參考文檔:https://docs.docker.com/install/linux/docker-ce/centos/#install-using-the-repository 前提條件 Docker 要求 CentOS 系統的內核版本高於 3.10,在終端輸入以下命令: uname -r ...
  • 目前遇到的問題: 1.路徑區分大小寫及路徑用“/”,而不是常用的"\\"。 windows下路徑為:"xxxx\\yyyy",Linux路徑下為:"xxxx/yyyy" 使用 Path.Combine("xxxx","yyyy") 進行合併即可。 2.有時候就需要在 docker 容器里訪問宿主機提 ...
  • 《.Net 最佳實踐》 [作者] (美) Stephen Ritchie[譯者] (中) 黃燈橋 黃浩宇 李永[出版] 機械工業出版社[版次] 2014年01月 第1版[印次] 2018年01月 第1次 印刷[定價] 69.00元 (P001) 開發人員應該對任何稱之為“最佳實踐”的實踐保持一種懷疑 ...
  • 本文介紹了C#中的屬性,以及C#6和C#7中與屬性相關的新特性。 ...
x