패키지 javax.lang.model.element

Java 프로그램 언어의 요소를 모델화하기 위해서(때문에) 사용되는 인터페이스입니다.

참조처:
설명

인터페이스의 개요

AnnotationMirror	주석을 나타냅니다.
AnnotationValue	주석형의 요소의 값을 나타냅니다.
AnnotationValueVisitor<R, P>	주석형 요소의 값의 방문객입니다.
Element	패키지, 클래스, 또는 메소드 등, 프로그램 요소를 나타냅니다.
ElementVisitor<R, P>	방문객 디자인 패턴의 스타일에 의한 프로그램 요소의 방문객입니다.
ExecutableElement	클래스 또는 인터페이스의 메소드, 생성자 , 또는 초기화자 (정적 또는 인스턴스)를 나타냅니다 (주석형 요소를 포함한다).
Name	문자의 불변 순서입니다.
PackageElement	패키지의 프로그램 요소를 나타냅니다.
TypeElement	클래스 또는 인터페이스의 프로그램 요소를 나타냅니다.
TypeParameterElement	총칭적인 클래스, 인터페이스, 메소드, 또는 생성자 의 요소의 가형 파라미터를 나타냅니다.
VariableElement	필드,enum 정수, 메소드 또는 생성자 의 파라미터, 로컬 변수, 또는 예외 파라미터를 나타냅니다.

열거형의 개요

ElementKind	요소의 kind 입니다.
Modifier	클래스, 메소드, 필드 등, 프로그램 요소의 수식자를 나타냅니다.
NestingKind	형태 요소의 「상자의 종류」입니다.

예외의 개요

UnknownAnnotationValueException	미지의 종류의 주석치가 검출된 것을 나타냅니다.
UnknownElementException	미지의 종류의 요소가 검출된 것을 나타냅니다.

패키지 javax.lang.model.element 의 설명

Java 프로그램 언어의 요소를 모델화하기 위해서(때문에) 사용되는 인터페이스입니다.

주석 처리의 문맥으로 사용할 때는, 나타내지는 요소의 정확한 모델을 돌려줄 필요가 있습니다. 이것은 언어 모델이기 (위해)때문에, 원시 코드는 클래스 파일등의 실행 가능한 출력안의 표현은 아니고, 그 구조 구문의 기준이 되는 표현 (참조 표현)을 제공합니다. 실행 가능한 출력은, 모델화 요소를 작성하기 위한 기초로서 기능할 수가 있습니다. 다만, 원시 코드를 실행 가능한 출력으로 변환하는 처리에서는, 원시 코드 표현의 일부의 특성을 복원하는 것이 허가되지 않는 경우가 있습니다. 예를 들어,source retention 를 가지는 주석을 클래스 파일로부터 복원할 수 없습니다. 또, 클래스 파일이 소스의 위치 정보를 제공할 수 없는 경우도 있습니다. 다음과 같은 경우에, 요소상수식자가 다를 가능성이 있습니다.

• 클래스 또는 인터페이스에 strictfp 가 있다
• 파라미터에 final 가 있다
• 클래스 및 인터페이스에 protected,private, 및 static 가 있다

또, 상자로 된 클래스의 구현으로 사용되는 액세스용 메소드나, 공변반환값의 구현에 사용되는 브릿지 메소드 등, 클래스 파일의 합성 구조 구문은, 이 모델의 외부의 변환 아티팩트입니다.

주석 처리중은, 불완전한 프로그램이나 에러가 있는 프로그램에서의 조작이 필요합니다만, 결과적으로 얻을 수 있는 모델의 품질이 저하합니다. 원시 코드가 구문적으로 정형식이 아닌 경우, 모델이 구현의 질의 문제가 되는 일도, 안 되는 것도 있습니다. 프로그램이 구문적으로 올발라도, 그 외의 부분에서 에러가 있는 경우, 반환되는 모델에게는, 프로그램내의 메소드 본체가 모두 "throw new RuntimeException();" 로 옮겨놓을 수 있었을 경우와 동일한 정도의 정보가 포함될 필요가 있습니다. 발견되지 않는 형태 XYZ 를 프로그램이 참조하는 경우, 반환되는 모델에게는, 형태 XYZ 의 선언이 "class XYZ {}","interface XYZ {}","enum XYZ {}", 또는 "@interface XYZ {}" 이다고 보였을 경우와 동일한 정도의 정보가 포함될 필요가 있습니다. 발견되지 않는 형태 XYZ<K1, ... , Kn> 를 프로그램이 참조하는 경우, 반환되는 모델에게는, XYZ 의 선언이 "class XYZ<T1, ... , Tn> {}" 또는 "interface XYZ<T1, ... , Tn> {}" 이다고 보였을 경우와 동일한 정도의 정보가 포함될 필요가 있습니다.

특정의 구현으로 특히 지정되지 않는 한, 이 패키지의 메소드가 돌려주는 컬렉션은, 호출측으로부터는 변경 불가능하고, 병행 액세스에 대해서는 안전하지 않으면 상정하도록 해 주세요.

특히 지정되지 않는 한, 이 패키지의 메소드는 null 인수가 건네받으면(자) NullPointerException 를 throw 합니다.

도입된 버젼:

1.6