android saripaar

Android 薩裡帕爾 v2

சரிபார் - sari-paar（泰米爾語「檢查」、「驗證」或「驗證」）

Android Saripaar 是一個簡單、功能豐富且功能強大的基於規則的 Android UI 表單驗證庫。它是適用於 Android 的最簡單的UI 驗證庫。

為什麼選擇 Android 薩裡帕爾？

• 建構在 Apache Commons Validator 之上，這是一個在 Web、桌面和行動平台上擁有良好記錄的驗證框架。
• 使用註解進行聲明式樣式驗證。
• 可擴展，現在允許自訂註釋。
• 同步和非同步驗證，您不必擔心線程。
• 支援突發和立即模式。
• 適用於Stock Android Widgets ，無自訂視圖相依性。
• 使用規則隔離驗證邏輯。
• 相容於其他基於註解的庫和框架，如ButterKnife、AndroidAnnotations、RoboGuice等，

快速入門

步驟 1 - 使用 Saripaar Annotations 對您的小部件進行註釋

 @ NotEmpty
@ Email
private EditText emailEditText ;

@ Password ( min = 6 , scheme = Password . Scheme . ALPHA_NUMERIC_MIXED_CASE_SYMBOLS )
private EditText passwordEditText ;

@ ConfirmPassword
private EditText confirmPasswordEditText ;

@ Checked ( message = "You must agree to the terms." )
private CheckBox iAgreeCheckBox ;

註釋是不言自明的。只有在使用Validator.validateTill(View)和Validator.validateBefore(View)或在IMMEDIATE模式下執行有序驗證時，才需要@Order註解。

第 2 步 - 實例化一個新的驗證器

 @ Override
public void onCreate ( Bundle savedInstanceState ) {
    super . onCreate ( savedInstanceState );
    // Code…

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

    // More code…
}

您將需要一個Validator和ValidationListener來接收驗證事件的回呼。

第 3 步 - 實現 ValidationListener

 public class RegistrationActivity extends Activity implements ValidationListener {

    // Code…

    @ Override
    public void onValidationSucceeded () {
        Toast . makeText ( this , "Yay! we got it right!" , Toast . LENGTH_SHORT ). show ();
    }

    @ Override
    public void onValidationFailed ( List < ValidationError > errors ) {
        for ( ValidationError error : errors ) {
            View view = error . getView ();
            String message = error . getCollatedErrorMessage ( this );

            // Display error messages ;)
            if ( view instanceof EditText ) {
                (( EditText ) view ). setError ( message );
            } else {
                Toast . makeText ( this , message , Toast . LENGTH_LONG ). show ();
            }
        }
    }
}

• onValidationSucceeded() - 當所有視圖都通過所有驗證時呼叫。
• onValidationFailed(List<ValidationError> errors) - 當有驗證錯誤時呼叫。

第 4 步 - 驗證

 registerButton . setOnClickListener ( new OnClickListener () {

    @ Override
    public void onClick ( View v ) {
        validator . validate ();
    }
});

Validator.validate()運行驗證並透過ValidationListener上的適當回呼傳回結果。您可以透過呼叫Validator.validate(true)方法在後台AsyncTask上執行驗證。

薩裡帕爾 X

如果您正在尋找特定於國家/地區的註釋，請查看 Saripaar X 專案。該擴展項目正處於早期階段，需要貢獻者。請隨意貢獻。

梅文

 <dependency>
    <groupId>com.mobsandgeeks</groupId>
    <artifactId>android-saripaar</artifactId>
    <version>(latest version)</version>
</dependency>

搖籃

 dependencies {
    compile 'com.mobsandgeeks:android-saripaar:(latest version)'
}

快照

在您的{project_base}/build.gradle檔案中，包含以下內容。

 allprojects {
    repositories {
        jcenter()
        maven {
            url "https://oss.sonatype.org/content/repositories/snapshots/"
        }
    }
}

混淆者

從混淆和縮小中排除 Saripaar 類別。將以下規則加入您的proguard-rules.pro檔案中。

 -keep class com.mobsandgeeks.saripaar.** {*;}
-keep @com.mobsandgeeks.saripaar.annotation.ValidateUsing class * {*;}

演化

對於有興趣了解 v2 如何從 v1 演變而來的人，請觀看此影片（約 20 秒）。

使用薩裡帕爾？

在 Twitter 上告訴我您的 Google Play 網址，我會將您的應用程式加入清單:)

圖示	應用程式	圖示	應用程式	圖示	應用程式
	維基百科		維基百科測試版		美津濃接力棒
	拿來		健康守護者		媽媽我
	感覺針織		街巴茲		烤我
	管道		斯納加工作		塔特瓦·莫克什·拉克夏

維基百科

請造訪 wiki，以取得有關 Android Saripaar 的完整指南。

執照

 Copyright 2012 - 2015 Mobs & Geeks

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

_{Saripaar 標誌 © 2013 - 2015，Mobs & Geeks。}