android saripaar

Android Saripaar v2

சரிபார் - sari-paar (tamil para "verificar", "verificar" o "validar")

Android Saripaar es una biblioteca de validación de formularios de UI basada en reglas simple, potente y rica en funciones para Android. Es la biblioteca de validación de UI MÁS SIMPLE disponible para Android.

¿Por qué Android Saripaar?

• Construido sobre Apache Commons Validator, un marco de validación con un historial comprobado en plataformas web, de escritorio y móviles.
• Validación de estilo declarativo mediante Anotaciones .
• Extensible , ahora permite anotaciones personalizadas.
• Validaciones sincrónicas y asincrónicas , no tiene que preocuparse por los subprocesos.
• Admite los modos BURST e INMEDIATO.
• Funciona con los widgets estándar de Android , sin dependencias de vistas personalizadas.
• Aísla la lógica de validación mediante reglas.
• Compatible con otras bibliotecas y marcos basados ​​en anotaciones como ButterKnife, AndroidAnnotations, RoboGuice, etc.

Inicio rápido

Paso 1: anota tus widgets usando Anotaciones de 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 ;

Las anotaciones se explican por sí solas. La anotación @Order SÓLO se requiere cuando se realizan validaciones ordenadas usando Validator.validateTill(View) y Validator.validateBefore(View) o en modo IMMEDIATE .

Paso 2: crear una instancia de un nuevo validador

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

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

    // More code…
}

Necesitará un Validator y un ValidationListener para recibir devoluciones de llamadas en eventos de validación.

Paso 3: implementar un 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() : se llama cuando todas sus vistas pasan todas las validaciones.
• onValidationFailed(List<ValidationError> errors) : se llama cuando hay errores de validación.

Paso 4 - Validar

 registerButton . setOnClickListener ( new OnClickListener () {

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

La llamada Validator.validate() ejecuta las validaciones y devuelve el resultado a través de devoluciones de llamada apropiadas en ValidationListener . Puede ejecutar validaciones en un AsyncTask en segundo plano llamando al método Validator.validate(true) .

Sarapaar X

Si busca anotaciones específicas de un país, consulte el proyecto Saripaar X. El proyecto de ampliación se encuentra en sus primeras etapas y necesita contribuyentes. Siéntete libre de contribuir.

experto

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

Gradle

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

Instantáneas

En su archivo {project_base}/build.gradle , incluya lo siguiente.

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

ProGuard

Excluya las clases de Saripaar de la ofuscación y minificación. Agregue las siguientes reglas a su archivo proguard-rules.pro .

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

Evolución

Para aquellos interesados ​​en descubrir cómo evolucionó la versión 2 a partir de la versión 1, mire este vídeo (~20 segundos).

¿Usando Saripaar?

Envíame un tweet con tu URL de Google Play y agregaré tu aplicación a la lista :)

Icono	Aplicación	Icono	Aplicación	Icono	Aplicación
	Wikipedia		WikipediaBeta		Bastón Mizuno
	Buscar		SaludMinder		mamáyo
	Sentirse tejido		callebarz		Asarme
	Tubo		Enganche		Tatva Moksh Lakshya

wiki

Visite la wiki para obtener una guía completa sobre Android Saripaar.

Licencia

 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.

_{Logotipo de Saripaar © 2013 - 2015, Mobs & Geeks.}