Annotation Type
이 문서에서는 Java Annotation Type을 만들고 사용하는 방법에 대해서 살펴본다. 이 내용은 오라클 튜토리얼 문서를 참고하였으며, 하단에 링크를 첨부한다.
Annotation Type 생성
Annotation Type은 다음의 형태를 가진다.
public @interface 이름 {
}
직접 해당 코드를 작성하거나 생성 메뉴에서 Annotation을 선택하여 생성할 수 있다.
예제 - 사용할 Annotation 클래스
이 문서에서 사용할 예시 Annotation 코드는 다음과 같다.
package com.hacademy.annotation;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface TestEntity {
String author() default "";
String date() default "N/A";
String comment() default "";
}
생성한 Annotation Type에 다음 두 가지 Annotation을 설정하여 적용 방식을 지정한다.
Retention - 생성한 Annotation이 어느 시점까지 지속되어야 하는지에 대해서 설정할 수 있다
Target - 생성한 Annotation을 적용할 수 있는 대상을 배열 형태로 지정한다.
TestEntity에 대한 설정은 다음과 같다.
//class, interface, enum에 설정 가능하다
@Target(ElementType.TYPE)
//런타임 시점까지 유지되어 Reflection 등의 코드에서 불러올 수 있다
@Retention(RetentionPolicy.RUNTIME)
또한 Annotation Type은 옵션으로 지정할 수 있는 데이터들을 내부에 선언할 수 있다. 기본값을 부여하지 않을 경우 반드시 설정해야 하며, default 키워드로 기본값을 부여하면 선택적으로 설정하고 미설정 시 기본값이 적용된다.
TestEntity는 3개의 옵션을 지정할 수 있다.
String author() default "";
String date() default "N/A";
String comment() default "";
예제 - 생성한 Annotation type의 적용
이전 예제에서 생성한 TestEntity를 적용한 클래스 코드는 다음과 같다.
package com.hacademy.annotation;
@TestEntity(author = "hacademy", date = "2022-03-03", comment = "테스트를 위한 Annotation")
public class Item {
private String name;
private int price;
public void setName(String name) {
this.name = name;
}
public void setPrice(int price) {
this.price = price;
}
public String getName() {
return name;
}
public int getPrice() {
return price;
}
@Override
public String toString() {
return "Item [name=" + name + ", price=" + price + "]";
}
}
적용은 @TestEntity의 형태로 하며, 옵션의 경우 default값을 설정해두었으므로 필요시 생략 가능하다.
Annotation 내부의 데이터 중 변수명이 value인 항목은 하나만 작성할 경우 옵션명을 작성하지 않아도 된다.
다음 두 코드는 같은 코드이다.
