신기한 연구소

[Oracle의 Java Tutorial을 읽고 순서에 의해 정리한 후 본인의 경험과 이해를 바탕으로 작성된 글임을 밝힌다.]

[Java Tutorial, 자바 프로그래밍 기초 배우기, Java Programming, 자바 튜토리얼]

Annotation

메타데이터의 형식인 어노테이션(주석)은 프로그램 자체의 부분이 아닌 프로그램에 대한 데이터를 제공한다. 어노테이션은 어노테이션이 달려있는 코드의 작동에 직접적인 영향이 없다.

주석 기초 (Annotations Basics)

주석의 형태 (The Format of an Annotation)

최고로 간단한 형태 내에 어노테이션은 아래와 같이 보인다.

@Entity

@ 사인 글자는 다음으로 어노테이션임을 컴파일러에게 알린다. 아래 예제에서 어노테이션 이름은 override 이다.

@Override

 void mySuperMethod() {…}

어노테이션은 아래와 같은 요소들의 값에 이름이 있거나 없거나 할 수 있는 요소를 포함할 수 있다.

@Author(

    Name = “Benjamin”,

    Date = “3/27/2009”

)

 class MyClass() {…}

또는

@SuppressWarnings(value = “unchecked”)

  void myMethjod() {…}

만약 vaule로 이름 지어진 하나의 원소만 있다면 그 이름은 생략될 수 있다.

@SuppressWarnings(“unchecked”)

  void myMethod(){…}

만약 어노테이션이 원소가 없다면 괄호도 생략될 수 있다.

@Override example.

같은 선언에서 멀티 어노테이션을 사용 가능하다.

@Author(name = “Jane one”)

@EBook

  class MyClass{…}

만약 어노테이션이 같은 타입을 가지고 있다면 반복 어노테이션이라고 불린다.

@Author(name = “Jane”)

@Author(name = “John”)

  class MyClass{…}

반복 어노테이션은 Java 8 버전에서 지원된다.

어노테이션 타입은 Java SE API의 java.lang 또는 java.lang.annotation 패키지에 정의된 타입 중 하나일 수 있다.

이 전 예제에서 Override 와 SuppressWarniongs는 미리 정의 된 Java 어노테이션이다. 물론 자제로 만든 어노테이션 타입 정의도 가능하다.

어디서 어노테이션을 사용하는가? (Where Annotations Can Be Used)

어노테이션은 선언에 적용될 수 있다. 클래스, 필드, 메서드 그리고 다른 프로그램 원소들의 선언.

선언에서 사용할 때 각 어노테이션은 관례에 따라 그 자신의 라인에 종종 나타난다.

자바 8에서 어노테이션은 타입의 사용에 적용될 수 있다.

클래스 인스턴스 생생 표현식 : new @Interned MyObject();

타입 캐스트 : myString = (@NonNull String) str;

절 구현 : class UnmodifiableList implements

@Readonly List<@Readnoly T> {…}

예외 처리 선언 : void monitorTemperature() throws @Critical TemperatureException {…}