android saripaar

Android Saripaire v2

சரிபார் - sari-paar (tamoul pour "vérifier", "vérifier" ou "valider")

Android Saripaar est une bibliothèque de validation de formulaires d'interface utilisateur simple, riche en fonctionnalités et puissante basée sur des règles pour Android. Il s'agit de la bibliothèque de validation d'interface utilisateur la plus SIMPLE disponible pour Android.

Pourquoi Android Saripaar ?

• Construit sur Apache Commons Validator, un framework de validation ayant fait ses preuves sur les plateformes Web, de bureau et mobiles.
• Validation du style déclaratif à l'aide d'Annotations .
• Extensible , autorise désormais les annotations personnalisées.
• Validations synchrones et asynchrones , vous n'avez pas à vous soucier du threading.
• Prend en charge les modes BURST et IMMEDIATE.
• Fonctionne avec les widgets Stock Android , aucune dépendance d'affichage personnalisée.
• Isole la logique de validation à l’aide de règles.
• Compatible avec d'autres bibliothèques et frameworks basés sur des annotations tels que ButterKnife, AndroidAnnotations, RoboGuice, etc.,

Démarrage rapide

Étape 1 - Annotez vos widgets à l'aide des annotations 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 ;

Les annotations sont explicites. L'annotation @Order est requise UNIQUEMENT lors de l'exécution de validations ordonnées à l'aide de Validator.validateTill(View) et Validator.validateBefore(View) ou en mode IMMEDIATE .

Étape 2 - Instancier un nouveau validateur

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

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

    // More code…
}

Vous aurez besoin d'un Validator et d'un ValidationListener pour recevoir des rappels sur les événements de validation.

Étape 3 - Implémenter 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() - Appelé lorsque toutes vos vues réussissent toutes les validations.
• onValidationFailed(List<ValidationError> errors) - Appelé en cas d'erreur(s) de validation.

Étape 4 - Valider

 registerButton . setOnClickListener ( new OnClickListener () {

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

L'appel Validator.validate() exécute les validations et renvoie le résultat via des rappels appropriés sur ValidationListener . Vous pouvez exécuter des validations sur une AsyncTask en arrière-plan en appelant la méthode Validator.validate(true) .

Saripaar X

Si vous recherchez des annotations spécifiques à un pays, consultez le projet Saripaar X. Le projet d’extensions en est à ses débuts et a besoin de contributeurs. N'hésitez pas à contribuer.

Maven

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

Graduation

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

Instantanés

Dans votre fichier {project_base}/build.gradle , incluez les éléments suivants.

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

ProGarde

Excluez les classes Saripaar de l’obscurcissement et de la minification. Ajoutez les règles suivantes à votre fichier proguard-rules.pro .

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

Évolution

Pour ceux qui souhaitent découvrir comment la v2 a évolué à partir de la v1, regardez cette vidéo (environ 20 secondes).

Vous utilisez Saripaar ?

Tweetez-moi avec votre URL Google Play et j'ajouterai votre application à la liste :)

Icône	Application	Icône	Application	Icône	Application
	Wikipédia		Wikipédia bêta		Bâton Mizuno
	Aller chercher		SantéMinder		MamanMoi
	Sentir le tricot		RueBarz		Rôti-moi
	Tuyau		Snagajob		Tatva Moksh Lakshya

Wiki

Veuillez visiter le wiki pour un guide complet sur Android Saripaar.

Licence

 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.

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