0Pricing
Kotlin Academy · Pelajaran

Membaca Anotasi saat Runtime

Ambil instance anotasi dari deklarasi menggunakan refleksi Kotlin.

Membaca Anotasi saat Runtime adalah pelajaran Kotlin Academy gratis di CoddyKit. Ini adalah pelajaran 3 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar Kotlin Academy, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus Kotlin Academy mencakup 4 pelajaran total.

Prasyarat

Untuk membaca anotasi saat program berjalan, Anda memerlukan: (1) anotasi yang dideklarasikan dengan @Retention(RUNTIME), (2) dependensi kotlin-reflect di jalur kelas, dan (3) referensi KClass, KFunction, atau KProperty ke elemen yang diberi anotasi.

Membaca Anotasi dari KClass

Panggil annotations pada KClass untuk mendapatkan semua anotasi pada kelas tersebut, atau gunakan findAnnotation<T>() untuk tipe tertentu:

@Retention(AnnotationRetention.RUNTIME)
@Target(AnnotationTarget.CLASS)
annotation class Table(val name: String)

@Table(name = "users")
class UserEntity

val ann = UserEntity::class.findAnnotation<Table>()
println(ann?.name)  // "users"

Membaca Anotasi dari Properti

Akses anotasi pada properti melalui KProperty.annotations atau findAnnotation<T>():

@Retention(AnnotationRetention.RUNTIME)
@Target(AnnotationTarget.PROPERTY)
annotation class Column(val name: String)

data class User(@Column("user_name") val name: String)

val prop = User::name
val col = prop.findAnnotation<Column>()
println(col?.name)  // "user_name"

Membaca Anotasi dari Fungsi

Gunakan KFunction.findAnnotation<T>() untuk membaca anotasi pada fungsi:

@Retention(AnnotationRetention.RUNTIME)
@Target(AnnotationTarget.FUNCTION)
annotation class Transactional

class UserService {
    @Transactional
    fun save(user: User) { /*...*/ }
}

val fn = UserService::save
val isTx = fn.hasAnnotation<Transactional>()
println(isTx)  // true

Menelusuri Semua Properti untuk Anotasi

Pola umum adalah memindai semua properti yang dideklarasikan dalam kelas dan mengumpulkan properti yang diberi anotasi tertentu:

fun <A : Annotation> KClass<*>.annotatedProperties(
    annotationClass: KClass<A>
): List<Pair<KProperty1<*, *>, A>> =
    declaredMemberProperties
        .mapNotNull { prop ->
            prop.findAnnotation(annotationClass)?.let { ann -> prop to ann }
        }

Membaca Anotasi pada Parameter

Akses anotasi parameter konstruktor melalui KFunction.parameters:

class Repo(
    @param:Validate(minLength = 3) val name: String
)

val ctor = Repo::class.primaryConstructor!!
val param = ctor.parameters.first()
val ann = param.findAnnotation<Validate>()
println(ann?.minLength)  // 3

hasAnnotation vs findAnnotation

Gunakan hasAnnotation<T>() untuk pemeriksaan nilai benar/salah; gunakan findAnnotation<T>() saat memerlukan nilai properti anotasi. Keduanya adalah fungsi ekstensi dari kotlin.reflect.full.

Menelusuri Hierarki Kelas

Anotasi pada kelas induk atau antarmuka tidak diwariskan secara otomatis (NOT) dalam refleksi Kotlin. Anda harus menelusuri KClass.superclasses atau menggunakan KClass.allSuperclasses jika memerlukan anotasi warisan.

fun KClass<*>.findAnnotationRecursive(ann: KClass<out Annotation>) =
    generateSequence(this) { null } // simplified — real impl walks supers
        .flatMap { it.annotations }
        .firstOrNull { it.annotationClass == ann }

Performa

Panggilan refleksi lambat. Jika memindai anotasi saat startup kerangka kerja, simpan hasilnya dalam peta dengan KClass sebagai kunci. Jangan pernah membaca anotasi pada jalur eksekusi intensif untuk setiap permintaan atau bingkai.

Sasaran Lokasi Penggunaan dan Bidang JVM

Untuk anotasi pada properti dengan sasaran @field:, anotasi berada pada bidang pendukung JVM. Akses melalui refleksi Java (KProperty.javaField?.annotations), bukan melalui daftar annotations Kotlin, yang hanya mencakup lokasi deklarasi Kotlin.

Contoh Praktis: Pemetaan ORM Sederhana

Pemetaan ORM kecil membaca anotasi @Column untuk membuat daftar kolom SQL:

fun columns(klass: KClass<*>): String =
    klass.declaredMemberProperties
        .mapNotNull { it.findAnnotation<Column>()?.name }
        .joinToString(", ")

println(columns(User::class))  // "user_name, email"

Pemeriksaan Singkat

Bagaimana cara membaca anotasi tertentu bertipe MyAnn dari KClass?

Ringkasan: Membaca Anotasi saat Program Berjalan

Hal-hal utama:

  • Anotasi harus memiliki @Retention(RUNTIME)
  • Gunakan findAnnotation<T>() untuk mendapatkan nilai anotasi, dan hasAnnotation<T>() untuk pemeriksaan nilai benar/salah
  • Berlaku pada KClass, KFunction, KProperty, dan KParameter
  • Simpan hasil pemindaian dalam cache saat startup untuk menghindari beban tambahan pada setiap permintaan
  • Untuk anotasi @field:, gunakan KProperty.javaField

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Membaca Anotasi saat Runtime” gratis?

Ya — teks lengkap “Membaca Anotasi saat Runtime” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus Kotlin Academy, upgrade ke CoddyKit PRO. Kursus Kotlin Academy mencakup 4 pelajaran total.

Apa yang akan aku pelajari di “Membaca Anotasi saat Runtime”?

Ambil instance anotasi dari deklarasi menggunakan refleksi Kotlin. Kamu berlatih Kotlin Academy dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.

Apakah aku perlu pengalaman untuk memulai Kotlin Academy?

Tidak diperlukan pengalaman sebelumnya. Kotlin Academy di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 3 dari 4.

Berapa lama pelajaran “Membaca Anotasi saat Runtime” memakan waktu?

Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.

Bisakah aku menulis dan menjalankan kode dalam pelajaran Kotlin Academy ini?

Ya. Setiap pelajaran Kotlin Academy menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.

Semua pelajaran dalam kursus ini

  1. Refleksi Kotlin: KClass, KFunction, KProperty
  2. Membuat dan Menargetkan Anotasi Kustom
  3. Membaca Anotasi saat Runtime
  4. Validasi dan Pemetaan Berbasis Refleksi
← Kembali ke Kotlin Academy