리플렉션 기반 검증과 매핑
주석 기반 리플렉션을 사용해 간단한 검증기 또는 객체 매퍼를 만들어 보세요.
리플렉션 기반 검증과 매핑은(는) CoddyKit의 무료 Kotlin Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Kotlin Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Kotlin Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
이 패턴으로 해결하는 문제
리플렉션 기반 검증은 런타임에 클래스 프로퍼티의 애너테이션을 읽고 검증 규칙을 자동으로 적용하므로 필드마다 수동으로 확인할 필요가 없습니다. 객체와 데이터베이스 행 사이를 변환하는 ORM 매퍼도 같은 기법을 사용합니다.
Validate 애너테이션
런타임에 보존되며 프로퍼티를 대상으로 하는 애너테이션을 정의합니다:
@Retention(AnnotationRetention.RUNTIME)
@Target(AnnotationTarget.PROPERTY)
annotation class Validate(
val minLength: Int = 0,
val maxLength: Int = Int.MAX_VALUE,
val pattern: String = ""
)데이터 클래스에 애너테이션 적용하기
데이터 클래스의 프로퍼티에 @Validate를 적용합니다. 검증기는 런타임에 이러한 프로퍼티를 검색합니다:
data class UserForm(
@Validate(minLength = 2, maxLength = 50) val name: String,
@Validate(pattern = "^[\\w.]+@[\\w]+\\.[a-z]{2,}$") val email: String,
@Validate(minLength = 8) val password: String
)검증 함수
KClass.declaredMemberProperties를 사용해 프로퍼티를 순회하고 애너테이션을 찾은 다음 오류를 수집합니다:
fun validate(obj: Any): List<String> {
val errors = mutableListOf<String>()
for (prop in obj::class.declaredMemberProperties) {
val ann = prop.findAnnotation<Validate>() ?: continue
val value = (prop as KProperty1<Any, *>).get(obj)?.toString() ?: ""
if (value.length < ann.minLength) errors += "${prop.name}: too short"
if (value.length > ann.maxLength) errors += "${prop.name}: too long"
if (ann.pattern.isNotEmpty() && !value.matches(Regex(ann.pattern)))
errors += "${prop.name}: invalid format"
}
return errors
}검증기 실행하기
애너테이션이 적용된 객체라면 무엇이든 validate()를 호출할 수 있습니다. 이 함수는 오류 메시지 목록을 반환하며, 빈 목록이면 유효하다는 뜻입니다:
val form = UserForm("A", "not-an-email", "short")
val errors = validate(form)
errors.forEach(::println)
// name: too short
// email: invalid format
// password: too short@Column을 사용한 객체를 맵으로 매핑하기
또 다른 리플렉션 패턴에서는 열 이름을 제공하는 @Column 애너테이션을 사용해 객체를 Map으로 매핑합니다:
@Retention(AnnotationRetention.RUNTIME)
@Target(AnnotationTarget.PROPERTY)
annotation class Column(val name: String)
fun toMap(obj: Any): Map<String, Any?> =
obj::class.declaredMemberProperties
.mapNotNull { prop ->
val col = prop.findAnnotation<Column>() ?: return@mapNotNull null
col.name to (prop as KProperty1<Any, *>).get(obj)
}.toMap()매핑기 사용하기
데이터 클래스에 애너테이션을 적용하고 toMap()을 호출하면 열을 키로 사용하는 맵을 얻을 수 있으며, 이 맵은 INSERT 문에 바로 사용할 수 있습니다:
data class User(
@Column("user_name") val name: String,
@Column("user_email") val email: String
)
val user = User("Alice", "alice@example.com")
println(toMap(user))
// {user_name=Alice, user_email=alice@example.com}리플렉션 결과 캐싱
리플렉션 검색은 비용이 큽니다. 시작 시 KClass를 키로 하는 ConcurrentHashMap을 사용해 프로퍼티와 애너테이션의 매핑을 캐시합니다:
val cache = ConcurrentHashMap<KClass<*>, List<Pair<KProperty1<Any,*>, Column>>>()
fun columnsOf(klass: KClass<*>) = cache.getOrPut(klass) {
klass.declaredMemberProperties
.mapNotNull { p ->
p.findAnnotation<Column>()?.let { (p as KProperty1<Any,*>) to it }
}
}검증과 매핑 결합하기
하나의 프로퍼티에 여러 애너테이션을 적용하고 각각 독립적으로 처리할 수 있습니다. 먼저 검증한 다음 매핑하거나, 각 애너테이션 유형을 수집해 한 번의 순회에서 두 작업을 모두 수행할 수도 있습니다:
data class Product(
@Validate(minLength = 1) @Column("product_name") val name: String,
@Column("price") val price: Double
)제한 사항
리플렉션 기반 검증은 강력하지만 절충점이 있습니다. 런타임 오버헤드를 추가하고 애너테이션 보존 정책에 의존하며 컴파일 시간에 오류를 잡을 수 없습니다. 성능이 중요한 경로에서 검증의 성능이나 컴파일 시간 안전성이 중요하다면 KSP로 생성한 코드를 고려해 보십시오.
이 패턴을 사용해야 할 때
리플렉션 기반 검증은 임의의 사용자 정의 클래스를 처리해야 하는 프레임워크 코드에서 특히 유용합니다. 객체 관계형 매핑기, 직렬화기, 양식 검증기, 구성 바인더 등이 그 예입니다. 자체 타입을 관리하는 애플리케이션 코드에서는 속도와 명확성을 위해 명시적 검증을 우선하는 것이 좋습니다.
빠른 확인
검증 애너테이션을 런타임에 읽으려면 어떤 애너테이션 보존 정책이 필요한가요?
복습: 리플렉션 기반 검증 및 매핑
핵심 내용:
- 런타임에 보존되며 프로퍼티를 대상으로 하는 애너테이션을 선언합니다
declaredMemberProperties와findAnnotation을 사용해 검증 또는 매핑을 수행합니다- 반복되는 리플렉션 오버헤드를 피하도록
KClass별로 결과를 캐시합니다 - 결합된 동작을 위해 하나의 프로퍼티에 여러 애너테이션을 적용합니다
- 성능이 중요한 경로에서는 컴파일 시간 대안으로 KSP를 고려합니다
자주 묻는 질문
“리플렉션 기반 검증과 매핑” 강의는 무료인가요?
네 — “리플렉션 기반 검증과 매핑” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Kotlin Academy 강의 전체를 잠금 해제할 수 있습니다. Kotlin Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“리플렉션 기반 검증과 매핑”에서 뭘 배우나요?
주석 기반 리플렉션을 사용해 간단한 검증기 또는 객체 매퍼를 만들어 보세요. 브라우저에서 직접 실행하는 실습 코드로 Kotlin Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Kotlin Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Kotlin Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.
“리플렉션 기반 검증과 매핑” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Kotlin Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Kotlin Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.