Stateful

Additional

Language
Kotlin
Version
N/A
Created
Oct 15, 2018
Updated
Nov 10, 2018
Owner
PicsArt
Contributor
Artyom Dangizyan (artyomdangizyan)
1
Activity
Badge
Generate
Download
Source code

Advertising

Stateful

Stateful is a Kotlin library which makes Android application development faster and easier. It helps you delete all the boilerplate code for saving instance state and lets you forget about saving and restoring your fragment's/activity's state.

Download

Gradle:

implementation 'com.picsart:stateful:1.0.1'

Using Stateful

The most activities look like the following example.

class MySuperCoolActivity : Activity() {
    private var importantNumber: Int = 3
    private var importantFlag: Boolean = false
    ///and many other super important properties


    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        if (savedInstanceState != null) {
            importantNumber = savedInstanceState.getInt("important property key")
            importantFlag = savedInstanceState.getBoolean("important flag key")
            //....
        }
        //some important logic...
    }

    override fun onSaveInstanceState(outState: Bundle) {
        super.onSaveInstanceState(outState)
        outState.putInt("important property key", importantNumber)
        outState.putBoolean("important flag key", importantFlag)
        //....
    }

    //some more code..
}

What if I say that you can remove all boilerplate code for saving state with the help of stateful?

class MySuperCoolActivity : Activity(), Stateful by state() {
    private var importantNumber: Int by statefulProperty(3)
    private var importantFlag: Boolean by statefulProperty(false)
    ///and many more super important properties


    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        restore(savedInstanceState)
        //some important logic...
    }

    override fun onSaveInstanceState(outState: Bundle) {
        super.onSaveInstanceState(outState)
        save(outState)
    }

    //some more code..
}

The default implementation is using property names as a key to put them in the bundle. If you want to implement your own logic for a key generation you can extend Stateful interface and use your own implementation.