android saripaar

Android Сарипаар v2

சரிபார் - сари-паар (по-тамильски «проверять», «проверять» или «подтверждать»)

Android Saripaar — это простая, многофункциональная и мощная библиотека проверки форм пользовательского интерфейса на основе правил для Android. Это САМАЯ ПРОСТАЯ библиотека проверки пользовательского интерфейса, доступная для Android.

Почему Android Сарипаар?

• Создан на основе Apache Commons Validator, среды проверки с проверенной репутацией на веб-платформах, настольных и мобильных платформах.
• Декларативная проверка стиля с использованием аннотаций .
• Расширяемый , теперь позволяет использовать пользовательские аннотации.
• Синхронная и асинхронная проверки: вам не нужно беспокоиться о многопоточности.
• Поддерживает режимы BURST и IMMEDIATE.
• Работает со стандартными виджетами Android , без пользовательских зависимостей представления.
• Изолирует логику проверки с помощью правил.
• Совместимость с другими библиотеками и платформами на основе аннотаций, такими как ButterKnife, AndroidAnnotations, RoboGuice и т. д.

Быстрый старт

Шаг 1. Аннотируйте свои виджеты с помощью аннотаций Saripaar.

 @ 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 ;

Аннотации говорят сами за себя. Аннотация @Order требуется ТОЛЬКО при выполнении упорядоченных проверок с использованием Validator.validateTill(View) и Validator.validateBefore(View) или в режиме IMMEDIATE .

Шаг 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 . Вы можете запустить проверку фоновой AsyncTask , вызвав метод Validator.validate(true) .

Сарипаар 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 * {*;}

Эволюция

Для тех, кто хочет узнать, как версия 2 развилась из версии 1, посмотрите это (~ 20 секунд) видео.

Используете Сарипаар?

Напишите мне в Твиттере URL-адрес Google Play, и я добавлю ваше приложение в список :)

Икона	Приложение	Икона	Приложение	Икона	Приложение
	Википедия		Википедия бета		Мизуно Батон
	Принести		HealtheMinder		MomMe
	Фелкнит		УлицаБарз		Поджарь меня
	Трубка		Снагаджоб		Татва Мокш Лакшья

Вики

Пожалуйста, посетите вики для получения полного руководства по 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.

_{Логотип Сарипаар © 2013–2015, Mobs & Geeks.}