Annotation

Annotation
이정훈
http://github.com/sjh836

1. 어노테이션이란
• @를 이용한 주석, 자바코드에 주석을 달아 특별한 의미를 부여
한 것
• 컴파일러가 특정 오류를 억제하도록 지시하는 것과 같이 프로
그램 코드의 일부가 아닌 프로그램에 관한 데이터를 제공, 코드
에 정보를 추가하는 정형화된 방법.

2. 어노테이션의 용도
1. @Override 어노테이션처럼 컴파일러를 위한 정보를 제공하기 위
한 용도
2. 스프링 프레임워크의 @Controller 어노테이션처럼 런타임에 리플
렉션을 이용해서 특수 기능을 추가하기 위한 용도
3. 컴파일 과정에 어노테이션 정보로부터 코드를 생성하기 위한 용도
※ 자바 리플렉션: 다른언어에는 존재하지 않는 특별한 기능, 컴파일 시간이 아닌 실행시간에 동적으
로 특정 클래스의 정보를 객체를 통해 분석 및 추출해내는 프로그래밍 기법

3. 기본 어노테이션(JDK에서 제공)
• @Override: 해당 메소드가 부모 클래스에 있는 메소드를 재정
의했다는 것을 명시적으로 선언
• @Deprecated: 더이상 사용되지 않는 클래스나 메소드 앞에 추
가
• @SuppressWarnings: 프로그램에는 문제가 없는데 간혹 컴파일
러가 경고를 뿜을 때가 있는데, 이를 무시하라고 프로그래머에
게 알려줌

@Deprecated 예제
@Deprecated를 커스텀 어노테이션
(@Test)에 사용
@Test와 관련 엘리먼트에 전부 취소선
이 그어지고, 경고 발생
메소드위에 @Deprecated
를 사용하면 메소드에 취
소선이 그어진다.

@SuppressWarnings 예제
클래스의 타입을 확실하게 하기
위해 제네릭을 사용하라고 경고
이 경고를 무시하기위해 @SuppressWarnings 사용
※제네릭: 타입의 안정성, 개발자의 실수를 방지하기 위해 사용하는 기법으로 안써도 되지만, 경고가 발생된다.
* 인자의 종류

4. 메타 어노테이션
• 어노테이션을 선언할때 사용한다. 프로그래머가 어노테이션을
만들때 사용하는 것이다.
1. @Target
2. @Retention
3. @Documented: 해당 어노테이션 정보가 JavaDocs(API) 문서
에 포함
4. @Inherited: 모든 자식 클래스가 부모 클래스의 어노테이션을
사용할 수 있다는 것을 선언
5. @interface: 어노테이션 선언할 때 사용

4-1. @Target
• 어노테이션이 적용할 위치를 결정
import java.lang.annotation.Target;
• 적용 가능 대상(디폴트는 전 범위)
import java.lang.annotation.ElementType;
ElmentType.TYPE : 클래스, 인터페이스, 열거 타입
ElmentType.ANNOTATION_TYPE : 어노테이션 타입
ElmentType.FIELD : 필드
ElmentType.CONSTRUCTOR : 생성자
ElmentType.METHOD : 메서드
ElmentType.PARAMETER : 파라미터
ElmentType.LOCAL_VARIABLE : 로컬 변수
ElmentType.PACKAGE : 패키지

@Target 예제(main.java 소스)

@Target 예제(Test.java 소스)
@Target을 메소드로 설정했을 경우 @Target을 클래스,인터페이스로 설정했을 경우
Main.java에서 @Test를 메소드에 주었기 때문에 정상 작동 Main.java에서 @Test를 메소드에 주었기 때문에 에러 발생

4-2. @Retention
• 어떤 시점까지 어노테이션이 영향을 미치는지 결정
import java.lang.annotation.Retention;
• 적용 가능 시점
import java.lang.annotation.RetentionPolicy;
RetentionPolicy.SOURCE: 어노테이션 정보가 컴파일 시 사라짐
RetentionPolicy.CLASS: 클래스 파일에 있는 어노테이션정보가 컴파일
러에 의해 참조 가능, 가상머신에서는 사라짐(리플렉션 불가, 디폴트)
RetentionPolicy.RUNTIME: 실행 시 어노테이션 정보가 가상머신에 의
해서 참조 가능

@Retention 예제(main.java 소스)

@Retention 예제(source)
@Retention를 source로 설정했을 경우
실행결과 역시, @Test의 정보가 사라져있다.
Main.class에서 @Test정보가 사라져있다.

@Retention 예제(class)
@Retention를 class로 설정했을 경우
실행시간에는 @Test의 정보가 사라진다.
Main.class에서 @Test정보가 존재한다.

@Retention 예제(runtime)
@Retention를 runtime로 설정했을 경우
컴파일 이후, 실행시각까지 @Test의 정보가 유지된다.
Main.class에서 @Test정보가 존재한다.

@Documented 예제(사용X)
@Documented를 사용하지 않은 경우
JavaDoc에 @Test 어노테이션 정보가 남아있지 않는다.
※ JavaDoc란 자바 소스 코드에 대한 HTML 형식
의 API 문서이다.

@Documented 예제(사용O)
@Documented를 사용한 경우
JavaDoc에 @Test 어노테이션 정보가 있다.

5. 사용자어노테이션 선언법
public @interface 어노테이션이름
{
// 엘리먼트들
/*
String value();
String[] author();
int revision() default 0; //엘리먼트에 디폴트값 주는법
*/
}
어노테이션은 암묵적으로 어노테이션 인터페이스를 상속받으므로 상속받을수 없
다.

6. 어노테이션 사용
@어노테이션(엘리먼트=값, 엘리2=＂값＂)
public class 클래스
{}
@어노테이션2(값) //엘리먼트가 1개일 경우
Public class 클래스2
{}
메소드, 필드 등 어디에서나 사용할 수 있다.

Annotation

Recommended

Recommended

More Related Content

What's hot

What's hot (9)

Viewers also liked

Viewers also liked (13)

Similar to Annotation

Similar to Annotation (20)

More from JungHoon Lee

More from JungHoon Lee (7)

Annotation

Editor's Notes