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。}