어노테이션 (Annotation)

1) 어노테이션 (Annotation)

 

(1) 어노테이션이란

• 코드에서 “@”으로 작성되는 요소를 어노테이션이라고 하며, 어노테이션은 클래스 또는 인터페이스를 컴파일하거나 실행할 때 어떻게 처리해야 할 것인지를 알려주는 설정 정보이다.

 

• 어노테이션은 주로 세 가지 용도로 사용되어진다.

① 컴파일 시 사용하는 정보 전달

② 빌드 툴이 코드를 자동으로 생성할 때 사용하는 정보 전달

③ 실행 시 특정 기능을 처리할 때 사용하는 정보 전달

 

• 컴파일 시, 사용되는 정보 전달의 대표적인 예는 @Override 어노테이션이다.

 

• @Override는 컴파일러가 메소드 재정의 검사를 하도록 설정하며 정확히 재정의되지 않았다면 컴파일러는 에러를 발생시킨다.

 

• 어노테이션은 자바 프로그램을 개발할 때 필수적인 요소로 특히, 웹 개발에 많이 사용되는 Spring 프레임 워크 또는 Spring Boot에서 다양한 어노테이션을 사용하여 웹 어플리케이션을 설정한다.

 

(2) 어노테이션 타입 정의와 적용

• 어노테이션도 하나의 타입이므로 어노테이션을 사용하기 위해서는 먼저 정의부터 해야 하며, 어노테이션을 정의하는 방법은 인터페이스 정의하는 방법과 유사하다.

[예시]
public @interface AnnotationName { }        

→ @interface 뒤에 사용할 어노테이션 이름이 온다.


@AnnotationName
public class AnnoExample {}        

→ 정의한 어노테이션은 코드에서 다음과 같이 사용!

• 또한, 어노테이션은 속성을 가질 수 있으며 속성은 타입과 이름으로 구성되며 이름 뒤에 괄호를 붙인다.

 

• 속성의 기본값은 default 키워드로 지정할 수 있다.

[예시]
public @interface AnnotationName {
    String prop1();                
    int prop2() default 1;
}

@AnnotationName(prop1 = “값”)            
→ prop1은 기본값이 없기 때문에 반드시 값을 기술해야 하고

@AnnotationName(prop1 = “값”, prop2 = 3)    
→ prop2는 기본값이 있기 때문에 생략 가능하다.


[예시]
public @interface AnnotationName {
    String value();                
    int prop2() default 1;        
}

→ value는 어노테이션의 기본 속성으로 value 속성을 가진 어노테이션을 코드에서
   사용할 때는 아래와 같이 값만 기술할 수 있다.

@AnnotationName(“값”);                
→ 이 값은 value 속성에 자동으로 대입된다.

@AnnotationName(value=“값”, prop2=3);        
→ 하지만 value 속성과 다른 속성의 값을 동시에 주고 싶다면 value 속성명을 적어줘야 함

(3) 어노테이션 적용 대상

• 자바에서 어노테이션은 설정 정보이며 어떤 대상에 설정 정보를 적용할 것인지, 즉 클래스에 적용할 것인지, 메소드에 적용할 것인지를 명시해주어야 한다.

 

• 적용할 수 있는 대상의 종류는 ElementType 열거 상수로 정의되어 있다.

Element.TYPE : 클래스, 인터페이스, 열거 타입
Element.ANNOTATION_TYPE : 어노테이션
Element.FIELD : 필드
Element.CONSTRUCTOR : 생성자
Element.METHOD : 메소드
Element.LOCAL_VARIABLE : 로컬 변수
Element.PACKAGE : 패키지

 

@Target( { Element.TYPE, Element.FIELD, Element.METHOD } )
public @interface AnnotationName { }

• 적용 대상을 지정할 때에는 “@Target” 어노테이션을 사용하며 @Target의 기본 속성인 value는 ElementType 배열을 값으로 가진다.

 

• 이것은 적용 대상을 복수 개로 지정하기 위함이며 위의 어노테이션은 클래스, 필드, 메소드에 해당 어노테이션을 적용할 수 있고 그 외에 생성자, 패키지 등에는 적용할 수 없다.

 

(4) 어노테이션 유지 정책

• 어노테이션을 정의할 때, 한 가지 더 중요한 것은 @AnnotationName을 언제까지 유지할 것인지를 지정하는 것이다.

 

• 어노테이션 유지 정책은 RetentionPolicy 열거 상수로 다음과 같이 정의되어 있다.

@Target( { Element.TYPE, Element.FIELD, Element.METHOD } )
@Retention( RetentionPolicy.RUNTIME )
public @interface AnnotationName { }

• 유지 정책을 지정할 때에는 “@Retention” 어노테이션을 사용하며 @Retention의 기본 속성인 value는 RetentionPolicy 열거 상수 값을 가진다.

 

[Reference]

• 이것이 자바다 개정판