SharedPrefsUtils-ktx:

Save and load objects from SharedPreferences in a faster and simpler way with Kotlin Extensions.

This project is a "Kotlin extensions" version of SharedPrefsUtils

Version 1.x

  • September, 2019 - Kotlin version

Getting started

The first step is to include SharedPrefsUtils-ktx into your project, for example, as a Gradle compile dependency:

implementation 'com.github.guilhe:SharedPrefsUtils-ktx:${LATEST_VERSION}'
Groovy

Maven Central Download

Sample usage

Get a hold of SharedPreferences instance to use the extensions put and get:

lateinit var prefs: SharedPreferences
...
prefs = appContext.getSharedPreferences("test", Context.MODE_PRIVATE)
Java

To save and load primitive types:

prefs.put("key", 1)
val a = prefs.get("key", Int::class.java, 1)
Java

To save and load object types:

val list = mutableListOf<Int>()
prefs.put("key", list)
list = prefs.get("key", object : TypeToken<List<Int>>() {}, mutableListOf()))
Java

When not using primitive types you should use TypeToken instead of T::class.java, for example:

    @Test
    fun getObjectWithType() {
        val list = ArrayList<MyObjectType>()
        list.add(MyObjectType("string", 1, true))
        prefs.put("key", list)

        assertEquals(list, prefs.get("key", object : TypeToken<List<MyObjectType>>() {}, ArrayList()))
        assertNotEquals(list, prefs.get("key", List::class.java, ArrayList<MyObjectType>()))
    }

    @Test
    fun getObjectWithType2() {
        val list = ArrayList<Int>()
        list.add(1)
        prefs.put("key", list)

        assertEquals(list, prefs.get("key", object : TypeToken<List<Int>>() {}, ArrayList()))
        assertNotEquals(list, prefs.get("key", List::class.java, ArrayList<Int>()))
    }

    @Parcelize data class MyObjectType(val fieldA: String, val fieldB: Int, val fieldC: Boolean) : Parcelable
Java

Both tests will ran to completion.

Regarding assertNotEquals(list, prefs.get("key", List::class.java, ArrayList<Int>())) being true, I guess it's related with the fact that public <T> T fromJson(JsonReader reader, Type typeOfT){} method from Gson.java (line 886) is type unsafe:
"Since Type is not parameterized by T, this method is type unsafe and should be used carefully".
That's why I believe I'm getting List<Double> instead of List<Integer>.

Also:

prefs.put(prefs, "key", 1)
prefs.get(prefs, "key", Boolean::class.java, false)
Java

Will throw JsonParseException.

Binaries

Additional binaries and dependency information for can be found at https://search.maven.org.

Dependencies

Bugs and Feedback

For bugs, questions and discussions please use the Github Issues.

GitHub