Kotlin in Action Chap.10

지금까지 함수와 클래스에 대한 많은 feature를 보았지만, 이들은 전부 클래스나 함수의 이름을 명확하게 명시할 것을 요구한다. 예를 들어 함수를 호출하려면 해당 함수가 정의된 클래스나 이름, 또는 파라미터 타입을 알아야 한다. 그러나 Annotations과 reflection를 사용하면 이러한 제약에서 벗어나 미리 알고있지 않은 임의의 클래스를 다룰 수 있게 해준다.

애노테이션: 라이브러리가 요구하는 의미를 클래스에게 부여할 수 있음
리플렉션: 실행(runtime) 시점에 컴파일러 내부 구조를 분석할 수 있음

#애노테이션 선언과 적용

애노테이션의 핵심 컨셉은 코틀린에서도 비슷하다. 애노테이션은 추가적인 메타데이터를 선언할 때 사용할 수 있게 해준다. 메타데이터는 소스코드나 컴파일된 클래스 파일, 또는 런타임 때 접근가능하다.

#애노테이션 적용

애노테이션을 적용하기 위해서는 선언 시 함수나 클래스 이름 앞에 @ 캐릭터를 넣으면 된다.

import org.junit.*
class MyTest {
	@Test fun testTrue() { //애노테이션 적용
		Assert.assertTrue(true)
	}
}

애노테이션은 다음과 같은 파라미터를 가질 수 있다: 원시 타입의 값, 문자열, enum, 클래스 참조, 다른 애노테이션 클래스, 그리고 지금까지 말한 요소들로 이뤄진 배열이 있다.

애노테이션 인자를 지정하는 문법은 자바와 약간 다르다.

클래스를 애노테이션 인자로 지정할 때: @MyAnnotation(MyClass::class)처럼 ::class를 클래스 이름 뒤에 뒤에 넣어야 한다.
다른 애노테이션을 인자로 지정할 때: 인자로 들어가는 애노테이션의 이름 앞에 @를 넣지 않아야 한다.
배열을 인자로 지정할 때: @RequestMapping(path = arrayOf("/foo", "/bar"))처럼 arrayOf 함수를 사용한다. 하지만 자바에서 선언한 애노테이션 클래스를 사용하는 경우라면 value라는 이름의 파라미터가 자동으로 가변 길이 인자로 변환되게 된다. 따라서 이 경우에는 arrayOf 함수를 쓰지 않아도 된다.

애노테이션 인자는 컴파일 시점에 인지 가능해야 한다. 따라서 임의의 프로퍼티를 인자로 지정할 수는 없다. 프로퍼티를 애노테이션 인자로 사용하려면 그 앞에 const 변경자를 붙여야 한다.

const val TEST_TIMEOUT = 100L
@Test(timeout = TEST_TIMEOUT) fun testMethod() { ... }

만약 일반적인 프로퍼티를 사용하고 애노테이션 인자로 사용한다면, ““Only ‘const val’ can be used in constant expressions.”에러를 얻게 된다.

#애노테이션 타겟

일반적으로, 코틀린에서 하나의 선언은 자바에서 여러 개의 선언과 상응한다. 따라서 이들 중 어떤 요소가 애노테이션이 되어야 하는지 알기 어렵다.

애노테이트 되어야 하는 특정한 요소는 use-site target 선언으로 명시할 수 있다. 이 선언은 @ 캐릭터와 애노테이션 이름 사이에 위치하며, :으로 분리되어 보인다. 다음 그림에서는 get이 use-site target이 된다.

Untitled