annotation 주석?

annotation 한글로 읽으면 어노테이션 사전적 의미로는 "주석" 이다.

주석은 이미 있지않은가?

이게 java5 에 왜 추가가되었을까?

뭐..좀더 확장된 개념의 주석이라고 보면되겠다.

기존의 주석과 달라진점은 프로그램상에서 처리가 가능하다는것이다.

주석을 프로그램상에서 처리할일이 뭐가있지? 라고 생각은 했는데..

아래예제와같이 테스트프로그램 같은데서 쓰일수 있다.

먼저 어노테이션 사용법을 알아보자

1. 먼저 어노테이션 인터페이스를 선언하자

- maker.java

---

package cranix.test;
import java.lang.annotation.*;
@Retention(RetentionPolicy.RUNTIME)
public @interface maker {
int num();
String name();
String id();
String date() default "unsigned";
}

---

- 위에서 주석이라고 했지만 class 형태로 만들어진다.

- 어노테이션은 인터페이스에만 선언이 가능하다.

- @Retention(RetentionPolicy.RUNTIME) : 이 어노테이션을 쓰게되면 정보를 CLASS 파일에 저장하도록 한다. (이래야지만 파싱할수 있다.)

- 어노테이션의 선언은 @interface 로 하면된다.

- 메소드들의 내용은 올수없고 형태만 올수있다.

- default 가 찍히지 않은 메소드는 필수로 입력해야 한다.

2. 자 이제 위에서 만든 어노테이션을 사용해 보자

AnnotationCopyright.java

---

package cranix.test;
import java.lang.annotation.*;

@maker(
num=1,
name="정의돈",
id="cranix"
)
public class AnnotationCopyright {
public static void main(String args[]) {
for (Annotation a: AnnotationCopyright.class.getAnnotations()) {
  System.out.println("Annotation : " + a);
}
}
}

---

- class.getAnnotations() 와 같이 어노테이션을 파싱할수 있다.

- 물론 어노테이션 인터페이스에서 @Retention(RetentionPolicy.RUNTIME) 를 선언해 줘야지만 가능하다

3. 이제 위엣걸 실행시켜 보자

---

Annotation : @cranix.test.maker(date=unsigned, num=1, name=정의돈, id=cranix)

---

- @ 하나는 하나의 어노테이션이니까 루프를 한번만 도는거다.

이제 annotation을 이용해서 jUnit 과 비스무리한 초간단 테스트 프로그램을 만들어 보겠다.

1. 어노테이션 인터페이스를 만들어준다.

- Test.java

---

package cranix.test.annotation;
import java.lang.annotation.*;
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface Test {}

---

2. 테스트할 프로그램을 만든다.

- TestClass.java

---

package cranix.test;
import cranix.test.annotation.*;

public class TestClass {
@Test public static void m1() {}
public static void m2() {}
@Test public static void m3() {
throw new RuntimeException("런타임 익셉션");
}
public static void m4() {}
@Test public static void m5() {}
@Test public static void m6() throws Exception {
throw new Exception("엑셉션");
}
public static void m7() {}


public static void main(String args[]) throws Exception {
AnnotationTest.test(TestClass.class);
}
}

---

- 어노테이션이 들어간것이 보이는가?

- 테스트를 원하는 메소드 앞에 @Test 라는 어노테이션을 선언해 주자.

3. 이제 어노테이션이 들어간 클래스를 파싱해서 테스트 해보도록 하자

- AnnotationTest.java

---

package cranix.test.annotation;
import java.lang.reflect.*;

public class AnnotationTest {
public static void test(Class clazz) throws Exception {
int passed = 0;
int faild = 0;
for (Method m: clazz.getMethods()) {
  if (m.isAnnotationPresent(Test.class)) {
   try {
    m.invoke(null);
    passed++;
   }
   catch(Throwable e) {
    System.out.printf("%s 메소드에서 테스트실패 - 이유 : %s\n",m,e.getCause());
    faild++;
   }
  }
}
System.out.printf("테스트 종료 - 성공 : %d, 실패 : %d\n",passed,faild);  
}
}

---

- m.isAnnotationPresent(Test.class) 라는것은 메소드가 Test.class 어노테이션을 받고있는것인가 검사하는 것이다.

- 이렇게 하면 @Test 어노테이션을 받고있는 메소드만 테스트를 수행하게 되는것이다.

4. 실행을 하면 아래와같이 나온다.

---

public static void cranix.test.TestClass.m3() 메소드에서 테스트실패 - 이유 : java.lang.RuntimeException: 런타임 익셉션
public static void cranix.test.TestClass.m6() throws java.lang.Exception 메소드에서 테스트실패 - 이유 : java.lang.Exception: 엑셉션
테스트 종료 - 성공 : 2, 실패 : 2

---

- 이런 멍청한 테스트 프로그램을 쓰지는 않겠지만 충분히 응용가능하다고 본다.

자 이제까지 간단하게 어노테이션을 알아봤다.

jUnit,EJB3 에서도 어노테이션을 쓴다고 한다.

EJB3 는 안써봐서 모르겠고 jUnit 은 충분히 이해할만 하다.

자바 프로그래밍의 개념이 조금 확장된것이 느껴지지 않는가?