Kotlin Academy · Lektion

Inline-Value-Klassen

Verpacken Sie Werte ohne zusätzlichen Aufwand

Inline-Value-Klassen ist eine kostenlose Kotlin Academy-Lektion auf CoddyKit. Dies ist Lektion 2 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des Kotlin Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der Kotlin Academy-Kurs umfasst insgesamt 4 Lektionen.

Das Wrapping-Problem

Das Verpacken eines primitiven Typs in eine Klasse erhöht die Typsicherheit, verursacht aber normalerweise eine Heap-Allokation. Value-Klassen bieten diese Sicherheit, während der Compiler den Wrapper nach Möglichkeit entfernt.

Deklarieren einer Wertklasse

Kennzeichnen Sie eine Klasse mit @JvmInline value class und genau einer Eigenschaft im primären Konstruktor. Sie verhält sich wie ein eigener Typ.

@JvmInline
value class Password(val value: String)

fun main() {
    val p = Password("secret")
    println(p.value)
}

Ein eigener Typ

Im Gegensatz zu einem Typalias ist eine Wertklasse ein eigenständiger Typ. Sie können nicht versehentlich einen einfachen String übergeben, wenn ein Password erwartet wird.

@JvmInline
value class Password(val value: String)

fun login(p: Password) = println("login with " + p.value)

fun main() {
    login(Password("hunter2"))
}

Kein zusätzlicher Aufwand

Zur Laufzeit inlined der Compiler normalerweise den zugrunde liegenden Wert, sodass kein zusätzliches Objekt angelegt wird. Ein Password wird in den meisten Codepfaden als einfacher String dargestellt.

@JvmInline
value class Meters(val amount: Double)

fun main() {
    val d = Meters(5.0)
    println(d.amount) // stored inline as a Double
}

Methoden und Eigenschaften

Wertklassen können genau wie normale Klassen Funktionen und berechnete Eigenschaften enthalten.

@JvmInline
value class Celsius(val degrees: Double) {
    fun toFahrenheit() = degrees * 9 / 5 + 32
}

fun main() {
    println(Celsius(100.0).toFahrenheit())
}

Init-Blöcke zur Validierung

Mit einem init-Block können Sie den verpackten Wert bei der Erstellung validieren und so garantieren, dass jede Instanz gültig ist.

@JvmInline
value class Percentage(val value: Int) {
    init {
        require(value in 0..100) { "out of range" }
    }
}

fun main() {
    println(Percentage(75).value)
}

Berechnete Eigenschaften

Sie können berechnete Eigenschaften hinzufügen, die aus dem einzigen gespeicherten Wert abgeleitet werden, sodass die Logik nahe am Typ bleibt.

@JvmInline
value class Seconds(val value: Int) {
    val asMinutes: Double get() = value / 60.0
}

fun main() {
    println(Seconds(120).asMinutes)
}

Implementieren von Schnittstellen

Wertklassen können Schnittstellen implementieren und dadurch polymorph verwendet werden. Hinweis: Bei einer Verwendung als Schnittstellentyp kann dadurch Boxing erzwungen werden.

interface Describable {
    fun describe(): String
}

@JvmInline
value class Money(val cents: Int) : Describable {
    override fun describe() = "$" + cents / 100.0
}

fun main() {
    println(Money(1599).describe())
}

Wann Boxing auftritt

Der Wrapper wird wiederhergestellt (Boxing), wenn der Wert als nullable Typ, als Schnittstelle oder in einer generischen Sammlung verwendet wird. In diesen Fällen erstellt der Compiler ein echtes Objekt – das ist weiterhin korrekt, aber weniger effizient.

@JvmInline
value class Id(val raw: Int)

fun main() {
    val direct = Id(1)        // inlined
    val boxed: Id? = Id(2)    // boxed because nullable
    println("" + direct.raw + " " + boxed?.raw)
}

value class und data class

Eine data class legt immer ein Objekt an und kann mehrere Eigenschaften enthalten. Eine value class enthält genau eine Eigenschaft und zielt auf keinen zusätzlichen Aufwand ab. Verwenden Sie Wertklassen für schlanke, typsichere Wrapper um einen einzelnen Wert.

Warum das wichtig ist

Mit Wertklassen können Sie:

Verwechslungen zwischen Parametern desselben Typs verhindern
Validierung an einen primitiven Typ binden
(Normalerweise) keine Laufzeitkosten verursachen

Sie sind die typsichere Lösung für Fälle, in denen Typaliase nicht ausreichen.

Kurzer Test

Testen Sie Ihr Verständnis von Inline-Wertklassen.

Zusammenfassung

Sie haben Inline-Wertklassen kennengelernt:

Sie werden mit @JvmInline value class und einer Eigenschaft deklariert
Sie sind ein eigener Typ mit (normalerweise) keinem zusätzlichen Aufwand
Sie unterstützen Methoden, berechnete Eigenschaften und die Validierung mit init
Boxing tritt bei nullable, generischer oder als Schnittstelle erfolgender Verwendung auf

Als Nächstes: Anwendungsfälle aus der Praxis.

Häufig gestellte Fragen

Ist die Lektion „Inline-Value-Klassen“ kostenlos?

Ja — der vollständige Text von „Inline-Value-Klassen“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des Kotlin Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der Kotlin Academy-Kurs umfasst insgesamt 4 Lektionen.

Was lerne ich in „Inline-Value-Klassen“?

Verpacken Sie Werte ohne zusätzlichen Aufwand Du übst Kotlin Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.

Brauche ich Erfahrung, um Kotlin Academy zu starten?

Keine Vorkenntnisse erforderlich. Kotlin Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 2 von 4.

Wie lange dauert die Lektion „Inline-Value-Klassen“?

Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.

Kann ich in dieser Kotlin Academy-Lektion Code schreiben und ausführen?

Ja. Jede Kotlin Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.

Alle Lektionen in diesem Kurs

← Zurück zu Kotlin Academy