Kotlin Academy · Lektion

Oprettelse og målretning af tilpassede annotationer

Definér annotationer med retention-politikker, og anvend dem på klasser, funktioner og egenskaber.

Lektion 2 af 413 trin

Oprettelse og målretning af tilpassede annotationer er en gratis Kotlin Academy-lektion på CoddyKit. Dette er lektion 2 af 4. Du kan læse alle 3 lektioner i dette læringsspor gratis i deres fulde længde — derefter låser CoddyKit PRO alle lektioner op samt praktiske øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. Den er en del af læringsforløbet i Kotlin Academy, og dine fremskridt synkroniseres på tværs af nettet og CoddyKit-appen. Kotlin Academy-kurset indeholder 4 lektioner i alt.

Hvorfor brugerdefinerede annotationer?

Annotationer er metadata, der er knyttet til deklarationer (klasser, funktioner, egenskaber og parametre). Brugerdefinerede annotationer gør det muligt at markere kode til behandling af rammeværk, byggeværktøjer (KSP/KAPT) eller din egen logik ved kørsel.

Deklaration af en annotation

Brug nøgleordet annotation class. Annotation-klasser kan have konstruktørparametre (kun primitive typer, String, KClass, enumereringer, andre annotationer eller arrays af disse):

annotation class Validate(val minLength: Int = 1, val maxLength: Int = 255)

Meta-annotationer: @Target

@Target begrænser, hvor annotationen kan bruges. Almindelige mål er: CLASS, FUNCTION, PROPERTY, FIELD, VALUE_PARAMETER, CONSTRUCTOR.

@Target(AnnotationTarget.PROPERTY, AnnotationTarget.VALUE_PARAMETER)
annotation class Validate(val minLength: Int = 1, val maxLength: Int = 255)

@Retention: Hvornår er annotationen tilgængelig?

@Retention styrer annotationens levetid:

SOURCE – kasseres efter kompilering
BINARY – gemmes i .class-filen, men er ikke synlig via refleksion
RUNTIME – gemmes og er synlig ved kørsel (standard i de fleste anvendelser)

@Retention(AnnotationRetention.RUNTIME)
@Target(AnnotationTarget.PROPERTY)
annotation class Validate(val minLength: Int = 1)

@Repeatable: Anvendelse af den samme annotation flere gange

Som standard kan en annotation kun anvendes én gang pr. deklaration. Markér den med @Repeatable for at tillade flere anvendelser:

@Repeatable
@Target(AnnotationTarget.FUNCTION)
annotation class Role(val name: String)

Annotering af konstruktører og parametre

Du kan annotere konstruktørparametre og egenskaber i den primære konstruktør. Brug use-site-målene @field:, @get: eller @param: til at styre, hvilket element der modtager annotationen:

data class User(
    @field:Validate(minLength = 2) val name: String,
    @field:Validate(minLength = 0, maxLength = 120) val email: String
)

Mål for annoteringens anvendelsessted

Kotlin genererer flere bytecode-elementer fra én egenskab (felt, getter, setter, parameter). Mål for anvendelsessted angiver, hvilket element der modtager annotationen:

@field: det underliggende felt
@get: getteren
@set: setteren
@param: konstruktørparameteren

Annotering af klasser

Annotationer på en klasse er nyttige til at markere den til behandling i et rammeværk (f.eks. for at markere en klasse som serialiserbar, injicerbar eller som en del af et bestemt modul):

@Target(AnnotationTarget.CLASS)
@Retention(AnnotationRetention.RUNTIME)
annotation class Repository

@Repository
class UserRepository

@MustBeDocumented

Ved at tilføje @MustBeDocumented sikrer du, at annotationen vises i den genererede API-dokumentation. Brug den til annotationer, der udgør en del af kontrakten for din offentlige API.

@MustBeDocumented
@Target(AnnotationTarget.CLASS)
annotation class PublicApi(val since: String)

Annotationparametre: Standardværdier og arrays

Parametre kan have standardværdier og kan acceptere arrays ved hjælp af nøgleordet vararg eller eksplicitte array-typer:

annotation class Roles(vararg val value: String)

@Roles("ADMIN", "EDITOR")
class AdminPanel

KClass-parametre i annotationer

Annotationer kan referere til klasser via KClass:

annotation class Serializer(val using: KClass<out Any>)

@Serializer(using = GsonAdapter::class)
class Event

Hurtigt tjek

Hvilken værdi for @Retention gør en brugerdefineret annotation tilgængelig via Kotlin-refleksion ved kørsel?

Besvar den i den interaktive lektion

Opsummering: Brugerdefinerede annotationer

Vigtigste pointer:

Deklarér med annotation class; parametre er begrænset til primitive typer, String, KClass, enumereringer og arrays
@Target – hvor annotationen kan anvendes
@Retention – hvornår den er tilgængelig (brug RUNTIME til refleksion)
@Repeatable – tillad flere anvendelser på én deklaration
Mål for anvendelsessted (f.eks. @field: og @get:) styrer, hvilket bytecode-element der modtager annotationen

Gratis at komme i gang

Lær Kotlin med en AI-underviser — gratis

Skriv og kør rigtig kode i din browser, få øjeblikkelig hjælp fra en AI-underviser døgnet rundt, og fortsæt, hvor du slap, på web eller i appen.

Kurser: 51
Lektioner: 203

Start gratis Se hele kurset

Ofte stillede spørgsmål

Er lektionen “Oprettelse og målretning af tilpassede annotationer” gratis?

Ja — alle 3 lektioner i læringssporet Kotlin Academy, inklusive “Oprettelse og målretning af tilpassede annotationer”, kan læses gratis i deres fulde længde her på webstedet. Derefter låser CoddyKit PRO alle lektioner op samt interaktive øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. Kotlin Academy-kurset indeholder 4 lektioner i alt.

Hvad lærer jeg i “Oprettelse og målretning af tilpassede annotationer”?

Definér annotationer med retention-politikker, og anvend dem på klasser, funktioner og egenskaber. Du øver dig i Kotlin Academy med praktisk kode, som du kører direkte i browseren, og en AI-vejleder døgnet rundt besvarer dine spørgsmål, mens du arbejder dig gennem lektionen.

Skal jeg have erfaring for at begynde på Kotlin Academy?

Der kræves ingen tidligere erfaring. Kotlin Academy på CoddyKit er tilrettelagt for både begyndere og øvede, så du kan starte her eller fra begyndelsen og lære i dit eget tempo. Dette er lektion 2 af 4.

Hvor lang tid tager lektionen “Oprettelse og målretning af tilpassede annotationer”?

De fleste CoddyKit-lektioner tager cirka 5–10 minutter. Hver lektion er kort og interaktiv, så du gør løbende fremskridt og kan fortsætte, hvor du slap – på både web og app.

Kan jeg skrive og køre kode i denne Kotlin Academy-lektion?

Ja. Alle Kotlin Academy-lektioner har en indbygget kodeeditor, så du kan skrive og køre rigtig kode direkte i din browser og få øjeblikkelig feedback fra AI – uden lokal opsætning.

Alle lektioner i dette kursus

Kotlin Reflection: KClass, KFunction, KProperty
Oprettelse og målretning af tilpassede annotationer
Læsning af annotationer under kørsel
Reflection-baseret validering og mapping

← Tilbage til Kotlin Academy