This library provides reactive shared preferences interaction with very little code. It is designed specifically to be used with Kotlin.
Inspiration has been taken from other libraries, but it was written from the ground up on its own.
Add this to your module's build.gradle
file:
dependencies {
// ... other dependencies
implementation 'com.afollestad:rxkprefs:1.0.0'
}
The core class of the library is RxkPrefs
. It takes 3 parameters, one of
which is optional (the shared preferences mode).
// First parameter is your Context, like an Activity, the second is a key.
val myPrefs = RxkPrefs(this, "my_prefs")
// The optional third parameter is a mode.
// This is like using Context.getSharedPreferences("my_prefs", MODE_PRIVATE)
val myPrefs = RxkPrefs(this, "my_prefs", MODE_PRIVATE)
With a RxkPrefs
instance, you can retrieve preferences.
val myPrefs: RxkPrefs = // ...
// Getting a string preference is as simple as this:
val myString = myPrefs.string("my_string", "default_value")
// You could omit the second parameter to use the default, default value (empty string)
val myString = myPrefs.string("my_string")
Once you have a reference to a preference, there are a few things you can do with them.
val myPref: Pref<String> = // ...
// The key of the preference - first parameter passed in prefs.string(...)
val key: String = myPref.key()
// The default value of the preference - second parameter passed in prefs.string(...)
// Or the primitive default, such as an empty string, 0, or false.
val defaultValue: String = myPref.defaultValue()
// The current value of the preference, or the default value if none.
val currentValue: String = myPref.get()
// Changes the value of the preference.
myPref.set("new value!")
// True if a value has been set, otherwise false.
val isSet: Boolean = myPref.isSet()
// Deletes any existing value for the preference.
myPref.delete()
// See "The Preference Observable" below
val observable: Observable<String> = myPref.asObservable()
// See "The Preference Consumer" below
val consumer: Consumer<String> = myPref.asConsumer()
You can receive changes to a preference in real-time with its Observable.
val myPref: Pref<String> = // ...
val obs = myPref.asObservable()
val sub = obs.subscribe { newValue ->
// use new value
}
sub.dispose() // when you no longer want to receive values
Further usage of this is more of an RxJava issue and less specific to this library. You should have a basic understanding of what you can do with RxJava and what its use cases are.
You can use the preference consumer to save preference values from the emissions of an Observable.
Say you're using RxBinding to bind Android views to Observables that emit when their value changes, such as a CheckBox:
val myPref: Pref<Boolean> = // ...
val consumer = myPref.asConsumer()
RxCompoundButton.checks(yourCheckboxView)
.subscribe(consumer)
Whenever the checkbox is checked or unchecked, the underlying boolean shared preference is set to true or false automatically.