java.lang.reflect
인터페이스 AnnotatedElement

알려진 구현 클래스 목록:

AccessibleObject, Class, Constructor, Field, Method, Package

public interface AnnotatedElement

이 VM 로 현재 실행되고 있는 프로그램의 주석 첨부 요소를 나타냅니다. 이 인터페이스를 사용하면, 주석을 리플렉트 적으로 호출할 수 있습니다 . 이 인터페이스의 메서드에 의해 리턴된 모든 주석은 불변으로 유지되어 직렬화 가능합니다. 호출원래는 배열치를 가지는 열거 멤버의 액세스용 메서드에 의해 리턴된 배열을 변경할 수 있습니다. 이 변경은 다른 호출 바탕으로 리턴된 배열에 영향을 미치지 않습니다.

이 인터페이스의 메서드에 의해 리턴된 주석이, 이 VM 로 액세스 할 수 없는 클래스를 참조하고 있는 Class 값을 가지는 멤버를 (직접 또는 간접에) 포함한 경우, 관련된 클래스를 돌려주는 메서드를 리턴된 주석으로 호출해 클래스를 읽어내려고 하면, TypeNotPresentException을 발생시킵니다.

같이 주석의 열거 정수가 열거형에도는이나 존재하지 않는 경우에 열거치를 가지는 멤버를 읽어내려고 하면, EnumConstantNotPresentException을 발생시킵니다.

마지막으로 호환성 없게 개발된 정의를 가지는 멤버를 읽어내려고 하면, AnnotationTypeMismatchException 또는 IncompleteAnnotationException을 발생시킵니다.

도입된 버전 :

1.5

메서드 개요

<T extends Annotation > T	getAnnotation (Class <T> annotationType) 지정된 형태의 주석이 존재하는 경우는 지정된 형태의 요소의 주석을 리턴합니다.
Annotation []	getAnnotations () 이 요소에 존재하는 모든 주석을 리턴합니다 (이 요소에 주석이 없는 경우는 길이 제로의 배열을 리턴합니다).
Annotation []	getDeclaredAnnotations () 이 요소에 직접 존재하는 모든 주석을 리턴합니다.
boolean	isAnnotationPresent (Class <? extends Annotation > annotationType) 지정된 형태의 주석이 이 요소에 존재하는 경우는 true를 돌려주고, 그렇지 않은 경우는 false를 리턴합니다.

메서드의 상세

isAnnotationPresent

boolean isAnnotationPresent(Class <?  extends Annotation > annotationType)

지정된 형태의 주석이 이 요소에 존재하는 경우는 true를 돌려주고, 그렇지 않은 경우는 false를 리턴합니다. 이 메서드는 주로 마커 주석에의 간이 액세스를 목적으로 설계되고 있습니다.

파라미터:

annotationType - 어노테이션에 대응하는 Class 객체

반환값:

지정된 어노테이션의 주석이 이 요소에 존재하는 경우는 true, 그렇지 않은 경우는 false

예외:

NullPointerException - annotationType가 null인 경우

도입된 버전 :

1.5

getAnnotation

<T extends Annotation > T getAnnotation(Class <T> annotationType)

지정된 형태의 주석이 존재하는 경우는 지정된 형태의 요소의 주석을 리턴합니다. 그렇지 않은 경우는 null을 리턴합니다.

파라미터:

annotationType - 어노테이션에 대응하는 Class 객체

반환값:

존재하는 경우는 지정된 어노테이션의 요소의 주석. 그렇지 않은 경우는 null

예외:

NullPointerException - annotationType가 null인 경우

도입된 버전 :

1.5

getAnnotations

Annotation [] getAnnotations()

이 요소에 존재하는 모든 주석을 리턴합니다 (이 요소에 주석이 없는 경우는 길이 제로의 배열을 리턴합니다). 이 메서드의 호출원래는 리턴된 배열을 자유롭게 변경할 수 있습니다. 이 변경은 다른 호출 바탕으로 리턴된 배열에 영향을 미치지 않습니다.

반환값:

이 요소에 존재하는 모든 주석

도입된 버전 :

1.5

getDeclaredAnnotations

Annotation [] getDeclaredAnnotations()

이 요소에 직접 존재하는 모든 주석을 리턴합니다. 이 인터페이스에 있는 다른 메서드와는 달라, 이 메서드는 상속된 주석을 무시합니다 (이 요소에 주석이 직접 존재하지 않는 경우는 길이 제로의 배열을 돌려준다). 이 메서드의 호출원래는 리턴된 배열을 자유롭게 변경할 수 있습니다. 이 변경은 다른 호출 바탕으로 리턴된 배열에 영향을 미치지 않습니다.

반환값:

이 요소에 직접 존재하는 모든 주석

도입된 버전 :

1.5