Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ragunathjawahar/android-saripaar

UI form validation library for Android
https://github.com/ragunathjawahar/android-saripaar

android java

Last synced: about 1 month ago
JSON representation

UI form validation library for Android

Host: GitHub
URL: https://github.com/ragunathjawahar/android-saripaar
Owner: ragunathjawahar
License: apache-2.0
Created: 2012-09-08T11:52:30.000Z (over 12 years ago)
Default Branch: master
Last Pushed: 2020-12-03T16:41:19.000Z (about 4 years ago)
Last Synced: 2024-08-01T19:38:05.819Z (4 months ago)
Topics: android, java
Language: Java
Homepage:
Size: 2.98 MB
Stars: 3,224
Watchers: 99
Forks: 460
Open Issues: 62
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-list - ragunathjawahar/android-saripaar - UI form validation library for Android (Java)
awesome-github-android-ui - android-saripaar - 基于规则的AndroidUI输入验证库 (表单)

README

        Android Saripaar v2 [![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-Android%20Saripaar-brightgreen.svg?style=flat)](http://android-arsenal.com/details/1/526)

===================

![Logo](logo.png)

**சரிபார்** - sari-paar (Tamil for "to check", "verify" or "validate")

Android Saripaar is a simple, feature-rich and powerful rule-based UI form validation library for Android.

It is the **SIMPLEST** UI validation library available for Android.

Why Android Saripaar?

---------------------

 - Built on top of [Apache Commons Validator], a validation framework with proven track record on the web, desktop and mobile platforms.

 - Declarative style validation using **Annotations**.

 - **Extensible**, now allows Custom Annotations.

 - **Synchronous** and **Asynchronous** validations, you don't have to worry about threading.

 - Supports both BURST and IMMEDIATE modes.

 - Works with **Stock Android Widgets**, no custom view dependencies.

 - Isolates validation logic using rules.

 - Compatible with other annotation-based libraries and frameworks such as [ButterKnife], [AndroidAnnotations], [RoboGuice], etc.,

Quick Start

-----------

**Step 1 - Annotate your widgets using [Saripaar Annotations]**

```java

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

```

The annotations are self-explanatory. The `@Order` annotation is required ONLY when performing ordered validations using

`Validator.validateTill(View)` and `Validator.validateBefore(View)` or in `IMMEDIATE` mode.

**Step 2 - Instantiate a new [Validator]**

```java

@Override

public void onCreate(Bundle savedInstanceState) {

    super.onCreate(savedInstanceState);

    // Code…

    validator = new Validator(this);

    validator.setValidationListener(this);

    // More code…

}

```

You will need a `Validator` and a `ValidationListener` for receiving callbacks on validation events.

**Step 3 - Implement a [ValidationListener]**

```java

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 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()` - Called when all your views pass all validations.

 - `onValidationFailed(List errors)` - Called when there are validation error(s).

**Step 4 - Validate**

```java

registerButton.setOnClickListener(new OnClickListener() {

    @Override

    public void onClick(View v) {

        validator.validate();

    }

});

```

The `Validator.validate()` call runs the validations and returns the result via appropriate callbacks on the `ValidationListener`. You can run validations on a background `AsyncTask` by calling the `Validator.validate(true)` method.

Saripaar X

---------------------

If you are looking for country-specific annotations, checkout the [Saripaar X] project. The extensions project is in its early stages and needs contributors. Feel free to contribute.

Maven

---------------------

    

        com.mobsandgeeks

        android-saripaar

        (latest version)

    

Gradle

---------------------

    dependencies {

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

    }

Snapshots

---------------------

In your `{project_base}/build.gradle` file, include the following.

    allprojects {

        repositories {

            jcenter()

            maven {

                url "https://oss.sonatype.org/content/repositories/snapshots/"

            }

        }

    }

ProGuard

---------------------

Exclude Saripaar classes from obfuscation and minification. Add the following rules to your `proguard-rules.pro` file.

    -keep class com.mobsandgeeks.saripaar.** {*;}

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

Evolution

---------------------

For those interested in finding out how v2 evolved from v1, watch this (~20 second) [video].

Using Saripaar?

---------------------

[Tweet] me with your Google Play URL and I'll add your app to the list :)

Icon         | App           | Icon         | App           | Icon         | App

------------ | ------------- | ------------ | ------------- | ------------ | -------------

 | [Wikipedia] |  | [Wikipedia Beta] |  | [Mizuno Baton]

 | [Fetch] |  | [HealtheMinder] |  | [MomMe]

 | [Feelknit] |  | [StreetBarz] |  | [Roast Me]

 | [Pipe] |  | [Snagajob] |  | [Tatva Moksh Lakshya]

Wiki

---------------------

Please visit the [wiki] for a complete guide on Android Saripaar.

License

---------------------

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

  [jar]: http://search.maven.org/#search%7Cga%7C1%7Candroid%20saripaar

  [Apache Commons Validator]: http://commons.apache.org/proper/commons-validator/

  [ButterKnife]: https://github.com/JakeWharton/butterknife

  [AndroidAnnotations]: https://github.com/excilys/androidannotations

  [RoboGuice]: https://github.com/roboguice/roboguice/

  [Saripaar Annotations]: https://github.com/ragunathjawahar/android-saripaar/tree/master/saripaar/src/main/java/com/mobsandgeeks/saripaar/annotation

  [Validator]: https://github.com/ragunathjawahar/android-saripaar/blob/master/saripaar/src/main/java/com/mobsandgeeks/saripaar/Validator.java

  [ValidationListener]: https://github.com/ragunathjawahar/android-saripaar/blob/master/saripaar/src/main/java/com/mobsandgeeks/saripaar/Validator.java

  [Saripaar X]: https://github.com/ragunathjawahar/saripaar-x

  [video]: https://youtu.be/6Os9RxVK76A?t=23

  [Tweet]: https://twitter.com/ragunathjawahar

  [Wikipedia]: https://play.google.com/store/apps/details?id=org.wikipedia

  [Wikipedia Beta]: https://play.google.com/store/apps/details?id=org.wikipedia.beta

  [Fetch]: https://play.google.com/store/apps/details?id=com.buywithfetch.android

  [Mizuno Baton]: https://play.google.com/store/apps/details?id=com.mizuno.baton

  [MomMe]: https://play.google.com/store/apps/details?id=org.harthosp.momme

  [HealtheMinder]: https://play.google.com/store/apps/details?id=org.hartfordhealthcare.healtheminder

  [Feelknit]: https://play.google.com/store/apps/details?id=com.qubittech.feelknit.app

  [StreetBarz]: https://play.google.com/store/apps/details?id=com.diofeher.StreetBarz

  [Roast Me]: https://play.google.com/store/apps/details?id=com.marsvard.roastcam

  [Pipe]: https://play.google.com/store/apps/details?id=com.pipeapp.pipe

  [Snagajob]: https://play.google.com/store/apps/details?id=com.snagajob.jobseeker

  [Tatva Moksh Lakshya]: https://play.google.com/store/apps/details?id=siesgst.edu.in.tml16

  [wiki]: https://github.com/ragunathjawahar/android-saripaar/wiki