androidpropertieskotlinlazy-initialization

Kotlin lazy properties and values reset: a resettable lazy delegate


So I use kotlin for android, and when inflating views, I tend to do the following:

private val recyclerView by lazy { find<RecyclerView>(R.id.recyclerView) }

This method will work. However, there is a case in which it will bug the app. If this is a fragment, and the fragment goes to the backstack, onCreateView will be called again, and the view hierarchy of the fragment will recreated. Which means, the lazy initiated recyclerView will point out to an old view no longer existent.

A solution is like this:

private lateinit var recyclerView: RecyclerView

And initialise all the properties inside onCreateView.

My question is, is there any way to reset lazy properties so they can be initialised again? I like the fact initialisations are all done at the top of a class, helps to keep the code organised. The specific problem is found in this question: kotlin android fragment empty recycler view after back


Solution

  • Here is a quick version of a resettable lazy, it could be more elegant and needs double checked for thread safety, but this is basically the idea. You need something to manage (keep track) of the lazy delegates so you can call for reset, and then things that can be managed and reset. This wraps lazy() in these management classes.

    Here is what your final class will look like, as an example:

    class Something {
        val lazyMgr = resettableManager()
        val prop1: String by resettableLazy(lazyMgr) { ... }
        val prop2: String by resettableLazy(lazyMgr) { ... }
        val prop3: String by resettableLazy(lazyMgr) { ... }
    }
    

    Then to make the lazy's all go back to new values on next time they are accessed:

    lazyMgr.reset() // prop1, prop2, and prop3 all will do new lazy values on next access
    

    The implementation of the resettable lazy:

    class ResettableLazyManager {
        // we synchronize to make sure the timing of a reset() call and new inits do not collide
        val managedDelegates = LinkedList<Resettable>()
    
        fun register(managed: Resettable) {
            synchronized (managedDelegates) {
                managedDelegates.add(managed)
            }
        }
    
        fun reset() {
            synchronized (managedDelegates) {
                managedDelegates.forEach { it.reset() }
                managedDelegates.clear()
            }
        }
    }
    
    interface Resettable {
        fun reset()
    }
    
    class ResettableLazy<PROPTYPE>(val manager: ResettableLazyManager, val init: ()->PROPTYPE): Resettable {
        @Volatile var lazyHolder = makeInitBlock()
    
        operator fun getValue(thisRef: Any?, property: KProperty<*>): PROPTYPE {
            return lazyHolder.value
        }
    
        override fun reset() {
            lazyHolder = makeInitBlock()
        }
    
        fun makeInitBlock(): Lazy<PROPTYPE> {
            return lazy {
                manager.register(this)
                init()
            }
        }
    }
    
    fun <PROPTYPE> resettableLazy(manager: ResettableLazyManager, init: ()->PROPTYPE): ResettableLazy<PROPTYPE> {
        return ResettableLazy(manager, init)
    }
    
    fun resettableManager(): ResettableLazyManager = ResettableLazyManager()
    

    And some unit tests to be sure:

    class Tester {
       @Test fun testResetableLazy() {
           class Something {
               var seed = 1
               val lazyMgr = resettableManager()
               val x: String by resettableLazy(lazyMgr) { "x ${seed}" }
               val y: String by resettableLazy(lazyMgr) { "y ${seed}" }
               val z: String by resettableLazy(lazyMgr) { "z $x $y"}
           }
    
           val s = Something()
           val x1 = s.x
           val y1 = s.y
           val z1 = s.z
    
           assertEquals(x1, s.x)
           assertEquals(y1, s.y)
           assertEquals(z1, s.z)
    
           s.seed++ // without reset nothing should change
    
           assertTrue(x1 === s.x)
           assertTrue(y1 === s.y)
           assertTrue(z1 === s.z)
    
           s.lazyMgr.reset()
    
           s.seed++ // because of reset the values should change
    
           val x2 = s.x
           val y2 = s.y
           val z2 = s.z
    
           assertEquals(x2, s.x)
           assertEquals(y2, s.y)
           assertEquals(z2, s.z)
    
           assertNotEquals(x1, x2)
           assertNotEquals(y1, y2)
           assertNotEquals(z1, z2)
    
           s.seed++ // but without reset, nothing should change
    
           assertTrue(x2 === s.x)
           assertTrue(y2 === s.y)
           assertTrue(z2 === s.z)
       }
    }