Annotation

💡 어노테이션이란 본래 주석이란 뜻으로, 인터페이스를 기반으로 한 문법이다. 주석과는 그 역할이 다르지만 주석처럼 코드에 달아 클래스에 특별한 의미를 부여하거나 기능을 주입할 수 있다.

어노테이션은 컴파일 타임 또는 런타임에 해석될 수 있다.

✔️ 어노테이션의 장점
어노테이션을 사용하면 데이터에 대한 유효성 검사조건을 어노테이션을 사용하여 직접 명시함으로써 유효조건을 쉽게 파악할 수 있게 되며 코드가 깔끔해진다.
단순히 부가적인 표현 뿐만 아니라 reflection을 이용하면 어노테이션 지정만으로 원하는 클래스 주입도 가능

✔️ 어노테이션의 역할
크게 문서화, 컴파일러 체크, 코드 분석을 위한 용도로 사용됨
문서화는 JavaDoc이 있어서 많이 사용되지는 않고 본질적인 목적은 소스 코드에 메타데이터를 표현하는 것

1. Built-in annotation

이미 자바에 내장되어 있는 어노테이션
주로 컴파일러를 위한 것으로 컴파일러에게 유용한 정보를 제공한다.

1) @Override

메소드 앞에만 붙일 수 있으며 현재 메소드가 수퍼클래스의 메소드를 오버라이드한 메소드임을 컴파일러에게 명시한다.
오버라이딩 할 때 메소드 명에서 오타가 발생할 수 있는데 컴파일러 입장에서는 새로운 메소드를 생성하는 것인지 오버라이딩 하는 것인지 모른다. 이런 경우 어노테이션을 이용해서 오타가 발생할 수 있는 부분을 잡아줄 수 있음.

2) @Deprecated

차후 버전에 지원되지 않을 수 있기 때문에 더 이상 사용되지 말아야 할 메소드를 나타냄

3) @SupressWarnings

프로그래머의 의도를 컴파일러에게 전달하여 경고를 제거한다.

4) @FunctionalInterface

컴파일러에게 다음의 인터페이스는 함수형 인터페이스라는 것을 말함. 오버라이딩 어노테이션과 같은 이유로 실수를 미연에 방지하기 위해 사용함

2. Meta annotation

어노테이션에 사용되는 어노테이션으로 해당 어노테이션의 동작대상을 결정한다.
주로 새로운 어노테이션을 정의할 때 사용함

1) @Target

어노테이션이 적용가능한 대상을 지정하는데 사용함.
여러 개의 값을 지정할 때는 배열에서처럼 괄호 {}를 사용해야 함

2) @Retention

어노테이션이 유지되는 기간을 지정하는데 사용한다.
세가지 유지 정책을 사용할 수 있음
1. SOURCE : 소스 파일에만 존재하며, 클래스 파일에는 존재하지 않는다.
@Override나 @SupressWarnings 같은 컴파일러에 의해 사용되는 어노테이션 유지 정책이 SOURCE임. 컴파일러를 직접 작성할 것이 아니면 이 유지 정책은 사용할 일 ❌
2. CLASS : 클래스 파일에는 존재하지만 런타임 시에 사용이 불가능하다.
Retention 어노테이션의 default 값이지만 런타임 시에 사용이 불가능하여 잘 사용되지 않는다.
3. RUNTIME : 클래스 파일에 존재하며 런타임 시에도 사용 가능하다. 런타임 시에 리플렉션을 통해 클래스 파일에 저장된 어노테이션 정보를 읽어서 처리할 수 있게 됨.
@FunctionalInterface는 컴파일러가 체크하는 어노테이션이지만 런타임 시에도 사용되므로 RUNTIME의 유지정책을 갖는다.

3) @Documented

어노테이션에 대한 정보가 javadoc으로 작성된 문서에 포함되도록 할 때 사용하는 어노테이션이다.
built-in-annotation 중 @Override 와 @SupressWarnings를 제외하고는 모두 이 어노테이션이 붙어있다.

4) @Native

✔️네이티브 메소드 : JVM이 설치된 OS의 메소드를 말함
네이티브 메소드에 의해 참조되는 상수필드에 붙이는 어노테이션임. 네이티브 메소드는 보통 C언어로 작성되어 있고 자바에서는 메소드의 선언부만 정의하고 구현은 하지 않는다.
Object 클래스의 메소드들은 대부분 네이티브 메소드이다. 즉, 자바라는 언어를 통해 OS의 메소도를 호출하는 것
네이티브 메소드와 자바에 정의된 메소드를 연결하는 것 : JNI

3. Custom Annotation

public @interface MyAnnotation {}

어노테이션 타입 선언은 특별한 종류의 인터페이스이다

• 어노테이션 타입 선언을 일반적인 인터페이스 선언과 구분하기 위해 예약어 interface 앞에 @를 붙임
• 어노테이션 타입은 암묵적으로 java.lang.annotation.Annotation을 확장하기 때문에 extends 절을 가질 수 없음.
• 어노테이션은 메타데이터 저장을 위해 클래스처럼 멤버를 가질 수 있다.

✔️ 어노테이션 내에 선언된 메소드 : 어노테이션의 요소(element)라고 함
이 요소의 개수에 따라 Marker, Single-value, Full 어노테이션으로 분류 가능

Marker 어노테이션

요소가 한 개도 없으며, 단순히 표식으로서 사용되는 어노테이션임
이 어노테이션은 컴파일러에게 어떤 의미를 전달하는데 사용됨

Single-value 어노테이션

요소로 단일 변수만을 갖는 어노테이션임. 단일변수 밖에 없기 때문에 값만을 명시하여 데이터를 전달할 수 있다.

@interface TestInfo {
	String value();
}
@TestInfo("passed") //@TestInfo(value="passed")와 동일
class NewClass { ... }

Full 어노테이션

요소로 둘 이상의 변수를 갖는 어노테이션으로 데이터를 배열 안에 key-value의 형태로 전달

이 요소에는 일정한 규칙이 존재한다.

1. 요소의 타입은 기본형, String, enum, Annotation, Class만 허용된다.
2. 요소의 ()안에 매개변수를 선언할 수 없다.
3. 예외를 선언할 수 없다.
4. 요소를 타입 매개변수로 정의할 수 없다.
   +) 어노테이션의 각 요소는 기본값을 가질 수 있다.

@interface TestInfo {
	int count() default 1;
}
@TestInfo("passed") //@TestInfo(count=1)와 동일
class NewClass { ... }

출처 : https://asfirstalways.tistory.com/309