Kotlin Academy · Pelajaran

Menggunakan Anotasi

Beri anotasi pada kode

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

Apa Itu Anotasi

Anotasi melampirkan metadata pada kode. Anotasi tidak mengubah perilaku dengan sendirinya, tetapi alat, kompilator, dan pustaka membacanya untuk mengambil keputusan.

Anda menulis anotasi dengan @ diikuti namanya, lalu menempatkannya tepat sebelum elemen yang dikenainya.

Anotasi Pertama

Pustaka standar menyediakan beberapa anotasi yang berguna. @Deprecated menandai kode yang sebaiknya tidak lagi digunakan dan menampilkan peringatan di lokasi pemanggilan.

@Deprecated("Use newGreet() instead")
fun greet() = "Hi"

fun newGreet() = "Hello"

fun main() {
    println(newGreet())
}

Anotasi dengan Argumen

Anotasi dapat menerima argumen yang ditulis seperti parameter konstruktor. @Deprecated menerima pesan dan, secara opsional, petunjuk ReplaceWith.

@Deprecated(
    message = "Renamed for clarity",
    replaceWith = ReplaceWith("sum(a, b)")
)
fun add(a: Int, b: Int) = a + b

fun sum(a: Int, b: Int) = a + b

fun main() {
    println(sum(2, 3))
}

Menonaktifkan Peringatan

@Suppress memberi tahu kompilator untuk membungkam peringatan tertentu pada elemen yang diberi anotasi. Anda meneruskan nama peringatan sebagai string.

@Suppress("UNUSED_VARIABLE")
fun main() {
    val unused = 42
    println("Runs without the unused-variable warning")
}

JvmStatic dan Rekan-rekannya

Beberapa anotasi memengaruhi cara Kotlin dikompilasi ke JVM. @JvmStatic, @JvmField, dan @JvmName mengendalikan kode byte agar pemanggil Java melihat API yang lebih mudah digunakan.

Anotasi ini tidak melakukan apa-apa pada kode Kotlin murni, tetapi penting untuk interoperabilitas.

class Math {
    companion object {
        @JvmStatic
        fun square(x: Int) = x * x
    }
}

fun main() {
    println(Math.square(5))
}

Target Lokasi Penggunaan Anotasi

Sebuah properti dapat menghasilkan beberapa elemen JVM: bidang, pengambil, penyetel, dan parameter konstruktor. Target lokasi penggunaan menentukan tempat anotasi diterapkan.

Sintaksis: @get:, @set:, @field:, @param:.

class User(@get:JvmName("fetchName") val name: String)

fun main() {
    val u = User("Ada")
    println(u.name)
}

Throws untuk Interoperabilitas Java

Kotlin tidak memiliki pengecualian yang diperiksa, sehingga pemanggil Java tidak pernah melihat klausa throws kecuali Anda menambahkan @Throws. Anotasi ini mencatat jenis pengecualian ke dalam tanda tangan kode byte.

import java.io.IOException

@Throws(IOException::class)
fun readData(): String {
    return "data"
}

fun main() {
    println(readData())
}

Beberapa Anotasi

Anda dapat menumpuk beberapa anotasi pada satu elemen. Masing-masing ditulis pada barisnya sendiri (atau dipisahkan dengan spasi). Urutannya tidak penting.

@Deprecated("old")
@Suppress("DEPRECATION")
fun legacy() = "still here"

fun main() {
    println(legacy())
}

Anotasi pada Ekspresi

Anotasi juga dapat diterapkan pada ekspresi dan deklarasi lokal, bukan hanya fungsi atau kelas tingkat teratas. Ini umum dilakukan dengan @Suppress di dalam isi fungsi.

fun main() {
    @Suppress("UNUSED_VARIABLE")
    val temp = computeOnce()
    println("Done")
}

fun computeOnce() = 99

OptIn dan API Eksperimental

Pustaka menandai API yang tidak stabil dengan anotasi opt-in khusus. Untuk menggunakannya, Anda mengakui risikonya dengan @OptIn(SomeApi::class) atau dengan meneruskan anotasi tersebut.

Dengan begitu, fitur eksperimental tetap digunakan secara eksplisit, bukan secara tidak sengaja.

fun main() {
    // @OptIn would appear here when calling an experimental function
    println("Opt-in keeps unstable APIs visible")
}

Mengapa Menggunakan Anotasi?

Anotasi memungkinkan Anda menyampaikan maksud kepada alat: kompiler memperingatkan pemanggilan yang sudah tidak digunakan, pustaka serialisasi memetakan bidang, kerangka kerja pengujian menemukan metode pengujian, dan kerangka kerja DI menghubungkan dependensi.

Metadata, bukan logika
Dibaca saat kompilasi atau saat program berjalan
Menjaga konfigurasi tetap dekat dengan kode

Pemeriksaan Singkat

Uji pemahaman Anda tentang penggunaan anotasi.

Ringkasan

Anda mempelajari cara menggunakan anotasi bawaan:

@Deprecated, @Suppress, @Throws
Interoperabilitas JVM: @JvmStatic, @JvmName
Target lokasi penggunaan seperti @get: dan @field:
Opt-in untuk API eksperimental

Selanjutnya, Anda akan mendefinisikan anotasi Anda sendiri.

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Menggunakan Anotasi” gratis?

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

Beri anotasi pada kode 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 1 dari 4.

Berapa lama pelajaran “Menggunakan 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