Kotlin Academy · Pelajaran

Mendefinisikan Anotasi

Buat anotasi kustom

Mendefinisikan Anotasi adalah pelajaran Kotlin Academy gratis di CoddyKit. Ini adalah pelajaran 2 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.

Mendeklarasikan Anotasi

Anda mendefinisikan anotasi dengan kata kunci annotation class. Anotasi paling sederhana tidak membawa data dan berfungsi sebagai penanda.

annotation class Beta

@Beta
fun newFeature() = "experimental"

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

Parameter Anotasi

Anotasi dapat menyimpan data melalui parameter konstruktor. Jenis yang diizinkan terbatas: jenis primitif, String, enumerasi, anotasi lain, KClass, dan larik dari jenis-jenis tersebut.

annotation class ApiVersion(val value: Int)

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

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

@Target

@Target membatasi tempat anotasi Anda dapat diterapkan. Anda memberikan satu atau beberapa nilai AnnotationTarget, seperti CLASS, FUNCTION, atau PROPERTY.

@Target(AnnotationTarget.FUNCTION)
annotation class Loggable

@Loggable
fun process() = "processing"

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

@Retention

@Retention mengatur berapa lama anotasi bertahan:

SOURCE — dibuang oleh kompiler
BINARY — disimpan dalam berkas kelas, tetapi tidak terlihat oleh refleksi
RUNTIME — disimpan dan terlihat oleh refleksi (bawaan)

@Retention(AnnotationRetention.RUNTIME)
annotation class Important

@Important
class Order

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

Beberapa Target

Cantumkan beberapa target agar anotasi dapat digunakan di lebih dari satu tempat. Di sini, anotasi berfungsi baik pada kelas maupun fungsi.

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

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

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

Nilai Parameter Bawaan

Parameter anotasi dapat memiliki nilai bawaan, sehingga pemanggil dapat mengabaikannya. Dengan begitu, kasus umum tetap ringkas.

annotation class Cache(val seconds: Int = 60)

@Cache
fun cheap() = 1

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

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

Parameter Larik

Anda dapat menggunakan jenis larik. Berikan nilai menggunakan sintaksis literal larik [ ... ] saat menggunakan anotasi.

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

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

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

@Repeatable

Secara bawaan, sebuah anotasi hanya dapat muncul sekali pada setiap elemen. Tandai dengan @Repeatable agar dapat diterapkan beberapa kali.

@Repeatable
annotation class Tag(val value: String)

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

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

Parameter Anotasi Bertingkat

Parameter anotasi dapat berupa anotasi lain, sehingga Anda dapat membangun metadata terstruktur.

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

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

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

Merancang Anotasi yang Baik

Anotasi yang dirancang dengan baik:

Memiliki tujuan tunggal yang jelas
Menetapkan @Target agar penyalahgunaan menjadi kesalahan kompilasi
Menggunakan retensi RUNTIME hanya ketika refleksi membutuhkannya
Menyediakan nilai bawaan yang masuk akal

Dari Definisi ke Penggunaan

Mendefinisikan anotasi hanyalah separuh dari keseluruhan proses. Anotasi itu sendiri hanyalah metadata pasif. Sesuatu harus membacanya — biasanya refleksi saat program berjalan atau pemroses anotasi saat kompilasi. Anda akan segera menggunakan refleksi.

Pemeriksaan Singkat

Uji pemahaman Anda tentang pendefinisian anotasi.

Ringkasan

Anda mempelajari cara mendefinisikan anotasi:

annotation class dengan parameter
@Target untuk membatasi penempatan
@Retention untuk mengatur masa berlaku
@Repeatable dan nilai bawaan

Selanjutnya: memeriksa tipe dengan refleksi.

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Mendefinisikan Anotasi” gratis?

Ya — teks lengkap “Mendefinisikan Anotasi” 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 “Mendefinisikan Anotasi”?

Buat anotasi kustom 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 2 dari 4.

Berapa lama pelajaran “Mendefinisikan Anotasi” 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

← Kembali ke Kotlin Academy