Классы

Конструкторы

Класс в Kotlin может иметь первичный конструктор и один или несколько вторичных конструкторов. Первичный конструктор является частью заголовка класса и следует за именем класса и необязательными параметрами типа.

class Person constructor(firstName: String) { /*...*/ }

Если первичный конструктор не имеет анотаций или модификаторов видимости, ключевое слово constructor можно опустить:

class Person(firstName: String) { /*...*/ }

Первичный конструктор не может содержать никакого кода. Код инициализации может быть помещен в блоки инициализации, которые предваряются ключевым словом init.

Во время инициализации экземпляра блоки инициализации выполняются в том же порядке, что и они появляются в теле класса, чередуясь с инициализаторами свойств:

//sampleStart
class InitOrderDemo(name: String) {
    val firstProperty = "First property: $name".also(::println)
    
    init {
        println("First initializer block that prints $name")
    }
    
    val secondProperty = "Second property: ${name.length}".also(::println)
    
    init {
        println("Second initializer block that prints ${name.length}")
    }
}
//sampleEnd

fun main() {
    InitOrderDemo("hello")
}

Параметры первичного конструктора могут использоваться в блоках инициализации. Они также могут использоваться в инициализаторах свойств, объявленных в теле класса:

class Customer(name: String) {
    val customerKey = name.uppercase()
}

Kotlin имеет лаконичную синтаксическую конструкцию для объявления свойств и инициализации их из первичного конструктора:

class Person(val firstName: String, val lastName: String, var age: Int)

Такие объявления также могут включать значения по умолчанию для свойств класса:

class Person(val firstName: String, val lastName: String, var isEmployed: Boolean = true)

Вы можете использовать завершающую запятую при объявлении свойств класса:

class Person(
    val firstName: String,
    val lastName: String,
    var age: Int, // trailing comma
) { /*...*/ }

Подобно обычным свойствам, свойства, объявленные в первичном конструкторе, могут быть изменяемыми (var) или только для чтения (val).

Если конструктор имеет анотации или модификаторы видимости, ключевое слово constructor необходимо, и модификаторы предваряют его:

class Customer public @Inject constructor(name: String) { /*...*/ }

Узнайте больше о модификаторах видимости.

class Person(val pets: MutableList<Pet> = mutableListOf())

class Pet {
    constructor(owner: Person) {
        owner.pets.add(this) // adds this pet to the list of its owner's pets
    }
}

class Person(val name: String) {
    val children: MutableList<Person> = mutableListOf()
    constructor(name: String, parent: Person) : this(name) {
        parent.children.add(this)
    }
}

//sampleStart
class Constructors {
    init {
        println("Init block")
    }

    constructor(i: Int) {
        println("Constructor $i")
    }
}
//sampleEnd

fun main() {
    Constructors(1)
}

class DontCreateMe private constructor() { /*...*/ }

Создание экземпляров классов

Для создания экземпляра класса вызовите конструктор так, как будто это обычная функция:

val invoice = Invoice()

val customer = Customer("Joe Smith")

Процесс создания экземпляров вложенных, внутренних и анонимных внутренних классов описан в Вложенные классы.

Члены класса

Классы могут содержать:

• Конструкторы и блоки инициализации

• Функции

• Свойства

• Вложенные и внутренние классы

• Объявления объектов

Наследование

Классы могут быть получены друг от друга и образовывать иерархии наследования. Узнайте больше о наследовании в Kotlin.

Абстрактные классы

Класс может быть объявлен abstract, вместе с некоторыми или всеми его членами. Абстрактный член не имеет реализации в своём классе. Вам не нужно аннотировать абстрактные классы или функции open.

abstract class Polygon {
    abstract fun draw()
}

class Rectangle : Polygon() {
    override fun draw() {
        // draw the rectangle
    }
}

Вы можете переопределить неабстрактный open член абстрактным.

open class Polygon {
    open fun draw() {
        // some default polygon drawing method
    }
}

abstract class WildShape : Polygon() {
    // Classes that inherit WildShape need to provide their own
    // draw method instead of using the default on Polygon
    abstract override fun draw()
}

Компаньоны

Если вам нужно написать функцию, которая может вызываться без экземпляра класса, но которая нуждается в доступе к внутренностям класса (например, метод фабрики), вы можете написать её как член объявления объекта внутри этого класса.

Более конкретно, если вы объявляете компаньон-объект внутри своего класса, вы можете обращаться к его членам, используя только имя класса в качестве квалификатора.