javax.annotation.processing
인터페이스 ProcessingEnvironment

public interface ProcessingEnvironment

주석 처리 툴 시스템는,주석 프로세서에 이 인터페이스를 구현한 객체를 제공 하는 것으로, 그 프로세서가, 이 시스템가 제공하는 기능을 사용해 신규 파일에의 기입해, 에러 메세지의 보고, 및 다른 유틸리티의 검색을 실시할 수 있도록(듯이) 합니다.

Sun 이외의 회사가, 복수의 프로세서가 협조 동작하면서 단일의 원시 파일을 출력할 수 있도록(듯이) 하는 Filer 확장 등, 이 인터페이스의 기능 객체의 부가가치 래퍼를 제공하고 싶다고 생각할 가능성이 있습니다. 이것을 가능하게 하려면 , API 경유에서의 부작용을 서로 확인할 수 있는 것 같은 문맥내에서 동작하는 복수의 프로세서에 대해, 툴 인프라스트럭쳐(infrastructure)는,. equals 인 대응하는 기능 객체,. equals 인 Filer, 등이라고 한 것을 제공하지 않으면 안됩니다. 게다가 실행중의 주석 프로세서로부터 봐, 적어도 헬퍼 클래스의 선택된 부분집합이 같은 클래스 로더에 의해 로드 된 것처럼 보이도록, 툴 호출을 구성할 수가 없으면 안됩니다. (기능 객체가 공유 상태를 관리하기 위해(때문에), 래퍼 클래스의 구현은, 같은 기저 기능 객체가 이전에 랩 되었는지의 여부를 모르면 안 된다. )

도입된 버젼:

1.6

메소드의 개요

Elements	getElementUtils () 요소로 조작하기 위한 일부의 유틸리티 메소드의 구현을 돌려줍니다.
Filer	getFiler () 새로운 원시 파일, 클래스 파일, 또는 보조 파일의 작성에 사용되는 필터를 돌려줍니다.
Locale	getLocale () 현재의 로케일을 돌려줍니다.
Messager	getMessager () 에러, 경고, 및 다른 통지를 보고하기 위해서(때문에) 사용되는 멧세이쟈를 돌려줍니다.
Map <String ,String >	getOptions () 주석 처리 툴에게 건네진 프로세서 고유의 옵션을 돌려줍니다.
SourceVersion	getSourceVersion () 생성되는 모든 소스 및 클래스 파일이 준거해야 할 소스 버젼을 돌려줍니다.
Types	getTypeUtils () 형태로 조작하기 위한 일부의 유틸리티 메소드의 구현을 돌려줍니다.

메소드의 상세

getOptions

Map <String ,String > getOptions()

주석 처리 툴에게 건네진 프로세서 고유의 옵션을 돌려줍니다. 옵션은, 옵션명 대 옵션치의 맵의 형식에서 돌려주어집니다. 값이 없는 옵션의 경우, 맵내의 대응하는 값은 null 가 됩니다.

프로세서 고유의 옵션을 건네주는 방법의 상세한 것에 대하여는, 사용하는 특정의 툴 인프라스트럭쳐(infrastructure)의 문서를 참조해 주세요. 예를 들어, 어느 커멘드 유키자네장은, 프로세서 고유의 옵션의 선두에 「-A」 와 같은 기존의 캐릭터 라인을 붙이는 것으로 그것들을 구별인가 만약 키 해, 다른 툴 구현은, 그것과는 다른 규약에 따르거나 대체 기구를 제공하거나 할지도 모릅니다. 혹은, 다른 구현은, 프로세서 고유의 옵션에 가세해 툴에게 건네진 옵션을 검색하기 위한 구현 고유의 방법을 제공할지도 모릅니다.

반환값:

툴에게 건네진 프로세서 고유의 옵션

getMessager

Messager  getMessager()

에러, 경고, 및 다른 통지를 보고하기 위해서(때문에) 사용되는 멧세이쟈를 돌려줍니다.

반환값:

멧세이쟈

getFiler

Filer  getFiler()

새로운 원시 파일, 클래스 파일, 또는 보조 파일의 작성에 사용되는 필터를 돌려줍니다.

반환값:

필터

getElementUtils

Elements  getElementUtils()

요소로 조작하기 위한 일부의 유틸리티 메소드의 구현을 돌려줍니다.

반환값:

요소의 유틸리티

getTypeUtils

Types  getTypeUtils()

형태로 조작하기 위한 일부의 유틸리티 메소드의 구현을 돌려줍니다.

반환값:

형 유틸리티

getSourceVersion

SourceVersion  getSourceVersion()

생성되는 모든 소스 및 클래스 파일이 준거해야 할 소스 버젼을 돌려줍니다.

반환값:

생성되는 소스 및 클래스 파일이 준거해야 할 소스 버젼

관련 항목:

Processor.getSupportedSourceVersion()

getLocale

Locale  getLocale()

현재의 로케일을 돌려줍니다. 유효한 로케일이 존재하지 않는 경우는 null 를 돌려줍니다. 이 로케일을 사용하면, 로컬라이즈 된 메세지 를 제공할 수 있습니다.

반환값:

현재의 로케일. 유효한 로케일이 존재하지 않는 경우는 null