lateinit — отложенная инициализация

Свойство класса в Kotlin должно получить значение сразу — в конструкторе или при объявлении. Иначе компилятор сообщит, что свойство должно быть инициализировано (Property must be initialized), то есть получить первое значение. Но бывает, что значение появится позже: после загрузки данных, в методе настройки, в onCreate экрана Android. Для таких случаев есть lateinit:

class Profile {
    lateinit var name: String

    fun load() {
        name = "Anna"
    }

    fun show() {
        if (::name.isInitialized) {
            println("Name: $name")
        } else {
            println("not loaded")
        }
    }
}

fun main() {
    val p = Profile()
    p.show()
    p.load()
    p.show()
}

not loaded
Name: Anna

lateinit var name: String — обещание компилятору: «значение будет присвоено до первого чтения». Тип остаётся обычным, без вопроса, и проверять на null не нужно.

::name.isInitialized проверяет, присвоено ли значение. Такая проверка работает внутри класса, где объявлено свойство.

Если прочитать раньше времени

kotlin.UninitializedPropertyAccessException: lateinit property name has not been initialized

Программа обратилась к свойству до того, как ему присвоили значение. Найдите в стеке вызовов строку своего файла (строки at … под сообщением) и проверьте порядок: присваивание должно выполниться раньше. В Android так бывает, если свойство, которое заполняется в onCreate, прочитать раньше, чем onCreate выполнился.

Ограничения

• только var, не val;
• тип не может быть со знаком ?;
• нельзя для Int, Double, Boolean, Char и других простых типов — только для классов вроде String, List или своих;
• у свойства не должно быть своих get() и set();
• нельзя в основном конструкторе.

Чем заменить

Что взять вместо lateinit, зависит от случая — выберите свой.

class Session {
    var user: String? = null
}

class Report {
    val text: String by lazy {
        println("building report")
        "Report ready"
    }
}

fun main() {
    val r = Report()
    println("created")
    println(r.text)
    println(r.text)
}

created
building report
Report ready
Report ready

Все три способа рядом: