사용자 지정 주석 만들고 대상 지정하기
보존 정책이 있는 주석을 정의하고 클래스, 함수 및 프로퍼티에 적용해 보세요.
사용자 지정 주석 만들고 대상 지정하기은(는) CoddyKit의 무료 Kotlin Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Kotlin Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Kotlin Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
사용자 지정 애너테이션을 사용하는 이유
애너테이션은 선언(클래스, 함수, 프로퍼티, 매개변수)에 연결되는 메타데이터입니다. 사용자 지정 애너테이션을 사용하면 프레임워크, 빌드 도구(KSP/KAPT) 또는 자체 런타임 로직에서 처리할 코드를 표시할 수 있습니다.
애너테이션 선언하기
annotation class 키워드를 사용합니다. 애너테이션 클래스에는 생성자 매개변수를 지정할 수 있으며, 매개변수 타입은 기본 타입, String, KClass, 열거형, 다른 애너테이션 또는 이러한 타입의 배열로 제한됩니다:
annotation class Validate(val minLength: Int = 1, val maxLength: Int = 255)메타 애너테이션: @Target
@Target은 애너테이션을 사용할 수 있는 위치를 제한합니다. 일반적인 대상은 다음과 같습니다: CLASS, FUNCTION, PROPERTY, FIELD, VALUE_PARAMETER, CONSTRUCTOR.
@Target(AnnotationTarget.PROPERTY, AnnotationTarget.VALUE_PARAMETER)
annotation class Validate(val minLength: Int = 1, val maxLength: Int = 255)@Retention: 애너테이션은 언제 사용할 수 있나요?
@Retention은 애너테이션의 수명을 제어합니다:
SOURCE— 컴파일 후 폐기됩니다BINARY— .class 파일에 저장되지만 리플렉션으로는 표시되지 않습니다RUNTIME— 저장되며 런타임에 표시됩니다(대부분의 사용 사례에서 기본값)
@Retention(AnnotationRetention.RUNTIME)
@Target(AnnotationTarget.PROPERTY)
annotation class Validate(val minLength: Int = 1)@Repeatable: 동일한 애너테이션 여러 번 적용하기
기본적으로 애너테이션은 선언마다 한 번만 적용할 수 있습니다. 여러 번 적용하려면 @Repeatable을 지정합니다:
@Repeatable
@Target(AnnotationTarget.FUNCTION)
annotation class Role(val name: String)생성자와 매개변수에 애너테이션 적용하기
생성자 매개변수와 주 생성자의 프로퍼티에 애너테이션을 적용할 수 있습니다. 어떤 요소가 애너테이션을 받을지 제어하려면 @field:, @get: 또는 @param: 사용 지점 대상을 사용합니다:
data class User(
@field:Validate(minLength = 2) val name: String,
@field:Validate(minLength = 0, maxLength = 120) val email: String
)사용 지점 대상
Kotlin은 하나의 프로퍼티에서 여러 바이트코드 요소(필드, 게터, 세터, 매개변수)를 생성합니다. 사용 지점 대상은 어느 요소가 애너테이션을 받을지 지정합니다:
@field:백킹 필드@get:게터@set:세터@param:생성자 매개변수
클래스에 애너테이션 적용하기
클래스에 애너테이션을 적용하면 프레임워크 처리 대상으로 표시하는 데 유용합니다(예: 클래스를 직렬화 가능하거나 주입 가능하게 표시하거나 특정 모듈의 일부로 표시하는 경우):
@Target(AnnotationTarget.CLASS)
@Retention(AnnotationRetention.RUNTIME)
annotation class Repository
@Repository
class UserRepository@MustBeDocumented
@MustBeDocumented를 추가하면 생성된 API 문서에 애너테이션이 표시됩니다. 공개 API 계약의 일부를 구성하는 애너테이션에 사용합니다.
@MustBeDocumented
@Target(AnnotationTarget.CLASS)
annotation class PublicApi(val since: String)애너테이션 매개변수: 기본값과 배열
매개변수에는 기본값을 지정할 수 있으며, vararg 키워드나 명시적인 배열 타입을 사용해 배열을 받을 수 있습니다:
annotation class Roles(vararg val value: String)
@Roles("ADMIN", "EDITOR")
class AdminPanel애너테이션의 KClass 매개변수
애너테이션에서 KClass를 통해 클래스 타입을 참조할 수 있습니다:
annotation class Serializer(val using: KClass<out Any>)
@Serializer(using = GsonAdapter::class)
class Event빠른 확인
사용자 지정 애너테이션을 런타임에 Kotlin 리플렉션으로 사용할 수 있게 하는 @Retention 값은 무엇인가요?
요약: 사용자 지정 애너테이션
핵심 내용:
annotation class로 선언하며, 매개변수는 기본 타입, String, KClass, 열거형 및 배열로 제한됩니다@Target— 적용할 수 있는 위치@Retention— 사용할 수 있는 시점(리플렉션에는 RUNTIME 사용)@Repeatable— 하나의 선언에 여러 번 적용할 수 있게 함- 사용 지점 대상(
@field:,@get:등)은 어느 바이트코드 요소가 애너테이션을 받을지 제어합니다
AI 튜터와 함께 Kotlin을(를) 배우세요 — 무료
브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.
- 코스
- 51
- 레슨
- 203
자주 묻는 질문
“사용자 지정 주석 만들고 대상 지정하기” 강의는 무료인가요?
네 — “사용자 지정 주석 만들고 대상 지정하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Kotlin Academy 강의 전체를 잠금 해제할 수 있습니다. Kotlin Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“사용자 지정 주석 만들고 대상 지정하기”에서 뭘 배우나요?
보존 정책이 있는 주석을 정의하고 클래스, 함수 및 프로퍼티에 적용해 보세요. 브라우저에서 직접 실행하는 실습 코드로 Kotlin Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Kotlin Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Kotlin Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.
“사용자 지정 주석 만들고 대상 지정하기” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Kotlin Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Kotlin Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- Kotlin 리플렉션: KClass, KFunction, KProperty
- 사용자 지정 주석 만들고 대상 지정하기
- 실행 중 주석 읽기
- 리플렉션 기반 검증과 매핑