android saripaar

AndroidSaripaar v2

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

Android Saripaar é uma biblioteca de validação de formulário de UI simples, rica em recursos e poderosa baseada em regras para Android. É a biblioteca de validação de UI MAIS SIMPLES disponível para Android.

Por que Android Saripaar?

• Construído com base no Apache Commons Validator, uma estrutura de validação com histórico comprovado na web, desktop e plataformas móveis.
• Validação de estilo declarativo usando Annotations .
• Extensível , agora permite anotações personalizadas.
• Validações síncronas e assíncronas , você não precisa se preocupar com threading.
• Suporta os modos BURST e IMMEDIATE.
• Funciona com Stock Android Widgets , sem dependências de visualização personalizada.
• Isola a lógica de validação usando regras.
• Compatível com outras bibliotecas e estruturas baseadas em anotações, como ButterKnife, AndroidAnnotations, RoboGuice, etc.,

Início rápido

Passo 1 - Anote seus widgets usando anotações 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 ;

As anotações são autoexplicativas. A anotação @Order é necessária SOMENTE ao realizar validações ordenadas usando Validator.validateTill(View) e Validator.validateBefore(View) ou no modo IMMEDIATE .

Passo 2 – Instanciar um novo Validador

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

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

    // More code…
}

Você precisará de um Validator e de um ValidationListener para receber retornos de chamada em eventos de validação.

Etapa 3 – Implementar um 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() – Chamado quando todas as suas visualizações passam em todas as validações.
• onValidationFailed(List<ValidationError> errors) - Chamado quando há erro(s) de validação.

Passo 4 – Validar

 registerButton . setOnClickListener ( new OnClickListener () {

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

A chamada Validator.validate() executa as validações e retorna o resultado por meio de retornos de chamada apropriados no ValidationListener . Você pode executar validações em um AsyncTask em segundo plano chamando o método Validator.validate(true) .

Saripar X

Se você estiver procurando anotações específicas de cada país, confira o projeto Saripaar X. O projeto de extensões está em fase inicial e precisa de colaboradores. Sinta-se à vontade para contribuir.

Maven

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

Gradle

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

Instantâneos

Em seu arquivo {project_base}/build.gradle , inclua o seguinte.

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

ProGuard

Exclua as classes Saripaar da ofuscação e minificação. Adicione as seguintes regras ao seu arquivo proguard-rules.pro .

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

Evolução

Para aqueles interessados ​​em descobrir como a v2 evoluiu da v1, assista a este vídeo (cerca de 20 segundos).

Usando Saripaar?

Envie-me um tweet com seu URL do Google Play e adicionarei seu aplicativo à lista :)

Ícone	Aplicativo	Ícone	Aplicativo	Ícone	Aplicativo
	Wikipédia		Wikipédia Beta		Bastão Mizuno
	Buscar		SaúdeMinder		Mamãe eu
	Sinta-se tricotado		StreetBarz		Asse-me
	Cano		Snagajob		Tatva Moksh Lakshya

Wikipédia

Visite o wiki para obter um guia completo sobre Android Saripaar.

Licença

 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 Saripaar © 2013 - 2015, Mobs & Geeks.}