0Pricing
Kotlin Academy · 강의

주석 정의하기

사용자 지정 주석을 만듭니다

주석 정의하기은(는) CoddyKit의 무료 Kotlin Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Kotlin Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Kotlin Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

주석 선언하기

annotation class 키워드로 주석을 정의합니다. 가장 간단한 주석은 데이터를 전달하지 않고 표시 역할을 합니다.

annotation class Beta

@Beta
fun newFeature() = "experimental"

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

주석 매개변수

주석은 생성자 매개변수를 통해 데이터를 담을 수 있습니다. 허용되는 유형은 제한되어 있으며 기본 유형, String, 열거형, 다른 주석, KClass, 그리고 이러한 유형의 배열만 사용할 수 있습니다.

annotation class ApiVersion(val value: Int)

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

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

@Target

@Target은 주석을 적용할 수 있는 위치를 제한합니다. CLASS, FUNCTION, PROPERTY와 같은 하나 이상의 AnnotationTarget 값을 전달합니다.

@Target(AnnotationTarget.FUNCTION)
annotation class Loggable

@Loggable
fun process() = "processing"

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

@Retention

@Retention은 주석이 얼마나 오래 유지되는지 제어합니다.

  • SOURCE — 컴파일러가 제거함
  • BINARY — 클래스 파일에 유지되지만 리플렉션으로 볼 수 없음
  • RUNTIME — 유지되며 리플렉션으로 볼 수 있음(기본값)
@Retention(AnnotationRetention.RUNTIME)
annotation class Important

@Important
class Order

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

여러 대상

여러 대상을 나열하면 주석을 둘 이상의 위치에 적용할 수 있습니다. 여기서는 주석을 클래스와 함수 모두에 사용할 수 있습니다.

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

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

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

기본 매개변수 값

주석 매개변수에는 기본값을 지정할 수 있으므로 호출자가 생략할 수 있습니다. 따라서 일반적인 경우를 간결하게 작성할 수 있습니다.

annotation class Cache(val seconds: Int = 60)

@Cache
fun cheap() = 1

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

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

배열 매개변수

배열 유형을 사용할 수 있습니다. 주석을 사용할 때 [ ... ] 배열 리터럴 구문으로 값을 전달합니다.

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

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

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

@Repeatable

기본적으로 하나의 요소에는 주석을 한 번만 적용할 수 있습니다. @Repeatable을 표시하면 여러 번 적용할 수 있습니다.

@Repeatable
annotation class Tag(val value: String)

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

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

중첩 주석 매개변수

주석 매개변수 자체가 다른 주석일 수 있으므로 구조화된 메타데이터를 만들 수 있습니다.

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

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

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

좋은 주석 설계하기

잘 설계된 주석은 다음과 같은 특징이 있습니다.

  • 명확하고 단일한 목적을 가짐
  • @Target을 설정하여 잘못된 사용을 컴파일 오류로 만듦
  • 리플렉션이 필요할 때만 RUNTIME 유지 정책을 사용함
  • 합리적인 기본값을 제공함

정의에서 사용까지

주석을 정의하는 것은 전체 과정의 절반에 불과합니다. 주석은 그 자체로는 아무 동작도 하지 않는 메타데이터입니다. 누군가 주석을 읽어야 하며, 일반적으로 실행 시점의 리플렉션이나 컴파일 시점의 주석 처리기가 이 역할을 담당합니다. 곧 리플렉션을 사용해 보겠습니다.

빠른 확인

주석 정의에 대한 이해도를 확인해 보세요.

복습

다음과 같이 주석을 정의하는 방법을 배웠습니다.

  • 매개변수가 있는 annotation class
  • 적용 위치를 제한하는 @Target
  • 유지 기간을 제어하는 @Retention
  • @Repeatable과 기본값

다음 주제: 리플렉션으로 유형 검사하기

자주 묻는 질문

“주석 정의하기” 강의는 무료인가요?

네 — “주석 정의하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 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 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. 주석 사용하기
  2. 주석 정의하기
  3. 리플렉션 기초
  4. 실전 리플렉션
← Kotlin Academy(으)로 돌아가기