Objetos complementarios

Algunos miembros pertenecen a una clase en su conjunto, en lugar de a una sola instancia. Kotlin los coloca en un companion object dentro de la clase, y los llamas mediante el nombre de la clase:

class Temperature(val celsius: Double) {
    companion object {
        fun fromFahrenheit(f: Double) = Temperature((f - 32) * 5 / 9)
    }
}

Dentro de main:

val boiling = Temperature.fromFahrenheit(212.0)
println(boiling.celsius)

Salida:

100.0

fromFahrenheit es una función factoría: una función que crea instancias. A diferencia de un constructor, tiene un nombre descriptivo y puede devolver null en lugar de un objeto. Con un private constructor, la factoría es la única vía de acceso, por lo que puede comprobar y limpiar primero la entrada:

class Username private constructor(val text: String) {
    companion object {
        fun of(raw: String): Username? {
            val clean = raw.trim().lowercase()
            return if (clean.length in 3..12) Username(clean) else null
        }
    }
}

Dentro de main:

println(Username.of("  Ada_L ")?.text)
println(Username.of("x")?.text)
// Username("x")   // error: el constructor es privado

Salida:

ada_l
null

El objeto companion pertenece a la clase, por lo que puede llamar al constructor privado, y el propio código de la clase utiliza los miembros del companion sin un prefijo. Aquí cada ticket toma el número siguiente de un contador que comparten todos los tickets:

class Ticket(val holder: String) {
    val number = nextNumber++

    companion object {
        private var nextNumber = 1
        val issued: Int
            get() = nextNumber - 1
    }
}

Dentro de main:

val a = Ticket("Ada")
val b = Ticket("Bo")
println("${a.holder} #${a.number}, ${b.holder} #${b.number}")
println("issued: ${Ticket.issued}")

Salida:

Ada #1, Bo #2
issued: 2

Kotlin no tiene la palabra clave static. Los miembros del companion cumplen esa función: una sola copia para toda la clase, a la que se accede como ClassName.member. Como cualquier objeto, el companion se crea una vez, cuando la clase se utiliza por primera vez. Coloca en él aquello que no depende de una instancia, como las factorías y los contadores compartidos; todo lo que lea los datos de una instancia debe permanecer como un miembro normal.

class User private constructor(val name: String) {
    fun greet() = "hi $name"             // necesita una instancia: user.greet()

    companion object {
        fun guest() = User("guest")      // pertenece a la clase: User.guest()
    }
}