การอ่านคำอธิบายประกอบขณะรันไทม์

ข้อกำหนดเบื้องต้น

การอ่านคำอธิบายประกอบจาก KClass

@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"

การอ่านคำอธิบายประกอบจากคุณสมบัติ

@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"

การอ่านคำอธิบายประกอบจากฟังก์ชัน

@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

การวนดูคุณสมบัติทั้งหมดเพื่อค้นหาคำอธิบายประกอบ

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

การอ่านคำอธิบายประกอบบนพารามิเตอร์

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 เทียบกับ findAnnotation

การเดินดูโครงสร้างลำดับชั้นของคลาส

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

ประสิทธิภาพ

เป้าหมายตามตำแหน่งใช้งานและฟิลด์ JVM

ตัวอย่างเชิงปฏิบัติ: ตัวแมปออบเจ็กต์กับฐานข้อมูลอย่างง่าย

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

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

ตรวจสอบอย่างรวดเร็ว

สรุปทบทวน: การอ่านคำอธิบายประกอบในขณะทำงาน