Kotlin Academy · Les

Annotaties definiëren

Maak aangepaste annotaties

Les 2 van 413 stappen

Annotaties definiëren is een gratis Kotlin Academy-les op CoddyKit. Dit is les 2 van 4. Je kunt 3 lessen uit dit leerpad gratis volledig lezen — daarna ontgrendelt CoddyKit PRO alle lessen, plus praktische oefeningen met een ingebouwde code-editor en een AI-tutor die 24/7 beschikbaar is. Deze les maakt deel uit van het leertraject Kotlin Academy. Je voortgang wordt gesynchroniseerd op het web en in de CoddyKit-app. De cursus Kotlin Academy bevat in totaal 4 lessen.

Een annotatie declareren

Je definieert een annotatie met de sleutelwoorden annotation class. De eenvoudigste annotatie bevat geen gegevens en dient als markering.

annotation class Beta

@Beta
fun newFeature() = "experimental"

fun main() {
    println(newFeature())
}

Annotatieparameters

Annotaties kunnen gegevens bevatten via constructorparameters. De toegestane typen zijn beperkt: primitieve typen, String, enumeraties, andere annotaties, KClass en arrays daarvan.

annotation class ApiVersion(val value: Int)

@ApiVersion(2)
fun endpoint() = "v2"

fun main() {
    println(endpoint())
}

@Target

@Target beperkt waar je annotatie mag worden toegepast. Je geeft een of meer waarden van AnnotationTarget door, zoals CLASS, FUNCTION of PROPERTY.

@Target(AnnotationTarget.FUNCTION)
annotation class Loggable

@Loggable
fun process() = "processing"

fun main() {
    println(process())
}

@Retention

@Retention bepaalt hoelang de annotatie behouden blijft:

SOURCE — wordt door de compiler verwijderd
BINARY — blijft in het klassenbestand staan, maar is niet zichtbaar voor reflectie
RUNTIME — blijft behouden en is zichtbaar voor reflectie (de standaardwaarde)

@Retention(AnnotationRetention.RUNTIME)
annotation class Important

@Important
class Order

fun main() {
    println("Important is readable at runtime")
}

Meerdere doelen

Geef meerdere doelen op om een annotatie op meer dan één plaats toe te staan. Hier werkt de annotatie zowel voor klassen als voor functies.

@Target(AnnotationTarget.CLASS, AnnotationTarget.FUNCTION)
annotation class Audited

@Audited
class Account {
    @Audited
    fun withdraw() = "ok"
}

fun main() {
    println(Account().withdraw())
}

Standaardwaarden voor parameters

Annotatieparameters kunnen standaardwaarden hebben, zodat aanroepers ze mogen weglaten. Zo blijven veelvoorkomende gevallen beknopt.

annotation class Cache(val seconds: Int = 60)

@Cache
fun cheap() = 1

@Cache(seconds = 300)
fun expensive() = 2

fun main() {
    println("" + cheap() + " " + expensive())
}

Arrayparameters

Je kunt arraytypen gebruiken. Geef waarden op met de syntaxis voor arrayliteralen [ ... ] in het gebruik van de annotatie.

annotation class Roles(val names: Array<String>)

@Roles(["admin", "editor"])
fun restricted() = "secret"

fun main() {
    println(restricted())
}

@Repeatable

Standaard kan een annotatie maar één keer per element voorkomen. Markeer de annotatie met @Repeatable om haar meerdere keren toe te passen.

@Repeatable
annotation class Tag(val value: String)

@Tag("db")
@Tag("cache")
fun layered() = "ok"

fun main() {
    println(layered())
}

Geneste annotatieparameters

Een annotatieparameter kan zelf een andere annotatie zijn, zodat je gestructureerde metadata kunt opbouwen.

annotation class Author(val name: String)
annotation class Module(val owner: Author)

@Module(Author("Grace"))
class Payments

fun main() {
    println("Nested annotation metadata defined")
}

Goede annotaties ontwerpen

Een goed ontworpen annotatie:

Heeft één duidelijk doel
Stelt @Target in, zodat verkeerd gebruik een compilatiefout is
Gebruikt RUNTIME-retentie alleen wanneer reflectie die nodig heeft
Biedt zinvolle standaardwaarden

Van definitie naar gebruik

Een annotatie definiëren is maar de helft van het verhaal. Op zichzelf is het inerte metadata. Iets moet de annotatie lezen — meestal reflectie tijdens de uitvoering of een annotatieverwerker tijdens de compilatie. Binnenkort gebruik je reflectie.

Korte controle

Toets je begrip van het definiëren van annotaties.

Beantwoord dit in de interactieve les

Samenvatting

Je hebt geleerd annotaties te definiëren:

annotation class met parameters
@Target om de plaatsing te beperken
@Retention om de levensduur te bepalen
@Repeatable en standaardwaarden

Vervolgens inspecteer je typen met reflectie.

Gratis beginnen

Leer Kotlin met een AI-tutor — gratis

Schrijf echte code en voer die uit in je browser, krijg direct hulp van een AI-tutor die 24/7 beschikbaar is en ga verder waar je gebleven bent op het web of in de app.

Cursussen: 51
Lessen: 203

Gratis beginnen met leren Bekijk de volledige cursus

Veelgestelde vragen

Is de les “Annotaties definiëren” gratis?

Ja — je kunt hier op het web alle 3 lessen van het leerpad Kotlin Academy, waaronder “Annotaties definiëren”, gratis volledig lezen. Daarna ontgrendelt CoddyKit PRO alle lessen, plus interactieve oefeningen met een ingebouwde code-editor en een AI-tutor die 24/7 beschikbaar is. De cursus Kotlin Academy bevat in totaal 4 lessen.

Wat leer ik in “Annotaties definiëren”?

Maak aangepaste annotaties Je oefent met Kotlin Academy door code rechtstreeks in de browser uit te voeren. Een AI-begeleider die 24/7 beschikbaar is beantwoordt je vragen terwijl je de les doorwerkt.

Heb ik ervaring nodig om met Kotlin Academy te beginnen?

Ervaring vooraf is niet nodig. Kotlin Academy op CoddyKit is opgebouwd voor beginners tot gevorderden, zodat je hier of bij het begin kunt starten en in je eigen tempo kunt leren. Dit is les 2 van 4.

Hoe lang duurt de les “Annotaties definiëren”?

De meeste lessen van CoddyKit duren ongeveer 5–10 minuten. Elke les is kort en interactief, zodat je gestaag vooruitgaat en op het web en in de app precies verdergaat waar je was gebleven.

Kan ik code schrijven en uitvoeren in deze les over Kotlin Academy?

Ja. Elke les over Kotlin Academy bevat een ingebouwde code-editor, zodat je rechtstreeks in je browser echte code kunt schrijven en uitvoeren en direct feedback van AI krijgt — lokale installatie is niet nodig.

Alle lessen in deze cursus

← Terug naar Kotlin Academy