Preference-Rhythm

Additional

Language
Java
Version
1.0.1 (Mar 10, 2017)
Created
Feb 3, 2017
Updated
Nov 29, 2017 (Retired)
Owner
Anas Alaa (anasanasanas)
Contributors
Anas Aladdin (anasanasanas123)
Anas Alaa (anasanasanas)
anasanasanas1
3
Activity
Badge
Generate
Download
Source code

Preference Rhythm

Android library makes using Shared Preference easier.

Features

  • Support RxJava 2
  • Encrypt Data
  • Support Iterable
  • Build on top of repository design pattern

Installation

Add this to your module build.gradle file:

dependencies {
    ...
     compile "com.github.anasanasanas:Preference-Rhythm:1.0.0"
}

Add this to your root build.gradle file:

allprojects {
    repositories {
        ...
        maven { url "https://jitpack.io" }
    }
}

How to use Preference Rhythm ?

just extend PreferenceRepoImpl with the Object you want to save.

public class CountryPreferenceRepo extends PreferenceRepoImpl<Country> {
    public CountryPreferenceRepo(Context context, Class<Country> clazz) {
        super(context, clazz);
    }

    @Override
    public boolean encryptData() {
        return false;
    }

    @Override
    public String encryptionKey() {
        return null;
    }
}

OR

public class UserTokenPreferenceRepo extends PreferenceRepoImpl<String> {
    public UserTokenPreferenceRepo(Context context, Class<String> clazz) {
        super(context, clazz);
    }

    @Override
    public boolean encryptData() {
        return true;
    }

    @Override
    public String encryptionKey() {
        return "8N5zx1CUFyoE7Z3WuUq5SX14ziWKBJti";
    }
}

Then

        //check if the shared preference is empty and return boolean value
        userTokenPreferenceRepo.isEmpty();

        //clear the shared preference data
        userTokenPreferenceRepo.clear();

        //save the object in the shared preference
        userTokenPreferenceRepo.saveObject("Token");

        //get the object in the shared preference, if nothing saved return null
        userTokenPreferenceRepo.getObject();

        //save list of objects in the shared preference
        userTokenPreferenceRepo.saveList(new ArrayList<String>());

        //get the list saved in the shared preference, if nothing saved return null
        userTokenPreferenceRepo.getList();

        //return Observable that emits the Object
        userTokenPreferenceRepo.getObjectObservable();

        //return Observable that emits List of the objects
        userTokenPreferenceRepo.getListObservable();

Notes

  • Every class extend PreferenceRepoImpl has his own shared preference file.
  • If the Encryption key changed all the data in the shared preference will be cleared.