javax.tools
클래스 ForwardingJavaFileManager<M extends JavaFileManager >

java.lang.Object 
  javax.tools.ForwardingJavaFileManager<M>

형태 파라미터:

M - 이 객체에 의해 호출을 전송 되는 파일 관리자-의 종류

모든 구현된 인터페이스:

Closeable , Flushable , JavaFileManager , OptionChecker

public class ForwardingJavaFileManager<M extends JavaFileManager >
extends Object 
implements JavaFileManager 

지정된 파일 관리자-에 호출을 전송 합니다. 이 클래스의 서브 클래스는, 이러한 메소드의 일부를 오버라이드(override) 할 가능성이 있습니다. 또, 추가의 필드 및 메소드를 제공할 가능성도 있습니다.

도입된 버젼:

1.6

상자의 클래스의 개요

인터페이스 javax.tools. JavaFileManager 로부터 상속된 상자의 클래스/인터페이스

JavaFileManager.Location

필드의 개요

protected M

fileManager 모든 메소드가 위양 되는, delegate의 파일 관리자-입니다.

생성자 의 개요

protected

ForwardingJavaFileManager (M fileManager) ForwardingJavaFileManager 의 새로운 인스턴스를 생성합니다.

메소드의 개요

void	close () 이 파일 관리자-에 의해 직접적 또는 간접적으로 열린 자원이 있으면, 그것을 해제합니다.
void	flush () 이 파일 관리자-에 의해 직접적 또는 간접적으로 열린 출력용 자원이 있으면, 그것을 플래시 합니다.
ClassLoader	getClassLoader (JavaFileManager.Location location) 지정된 장소로부터 플러그 인을 로드하는 클래스 로더를 가져옵니다.
FileObject	getFileForInput (JavaFileManager.Location location, String packageName, String relativeName) 지정된 장소에 있는, 특정의 패키지내의 특정의상대명을 나타내는 입력용파일 객체를 가져옵니다.
FileObject	getFileForOutput (JavaFileManager.Location location, String packageName, String relativeName, FileObject sibling) 지정된 장소에 있는, 특정의 패키지내의 특정의상대명을 나타내는 출력용파일 객체를 가져옵니다.
JavaFileObject	getJavaFileForInput (JavaFileManager.Location location, String className, JavaFileObject.Kind kind) 지정된 장소에 있는, 특정의 종류의 특정의 클래스를 나타내는 입력용파일 객체를 가져옵니다.
JavaFileObject	getJavaFileForOutput (JavaFileManager.Location location, String className, JavaFileObject.Kind kind, FileObject sibling) 지정된 장소에 있는, 특정의 종류의 특정의 클래스를 나타내는 출력용파일 객체를 가져옵니다.
boolean	handleOption (String current, Iterator <String > remaining) 1 개의 옵션을 처리합니다.
boolean	hasLocation (JavaFileManager.Location location) 이 파일 관리자-에 있어 기존의 장소일지 어떨지를 판단합니다.
String	inferBinaryName (JavaFileManager.Location location, JavaFileObject file) 장소에 근거해 파일 객체의 바이너리명을 추측합니다.
boolean	isSameFile (FileObject a, FileObject b) 2 개의 파일 객체를 비교해, 이것들에 의해 나타내지는 부하의 객체가 같은 경우는 true 를 돌려줍니다.
int	isSupportedOption (String option) 지정된 옵션이 지원되고 있는지 어떤지를 조사해 지원되고 있는 경우는 그 옵션이 취하는 인수의 수를 특정합니다.
Iterable <JavaFileObject >	list (JavaFileManager.Location location, String packageName, Set <JavaFileObject.Kind > kinds, boolean recurse) 지정의 장소의 지정의 기준에 일치하는 모든 파일 객체를 일람표 가리킵니다.

클래스 java.lang. Object 로부터 상속된 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait

필드의 상세

fileManager

protected final M  extends JavaFileManager  fileManager

모든 메소드가 위양 되는, delegate의 파일 관리자-입니다.

생성자 의 상세

ForwardingJavaFileManager

protected ForwardingJavaFileManager(M  fileManager)

ForwardingJavaFileManager 의 새로운 인스턴스를 생성합니다.

파라미터:

fileManager - 이 파일 관리자-에 위양 되는 대상

메소드의 상세

getClassLoader

public ClassLoader  getClassLoader(JavaFileManager.Location  location)

인터페이스 JavaFileManager 의 기술:

지정된 장소로부터 플러그 인을 로드하는 클래스 로더를 가져옵니다. 예를 들어, 주석 프로세서를 로드하는 경우, 컴파일러는 ANNOTATION_PROCESSOR_PATH 의 클래스 로더를 요구합니다.

정의:

인터페이스 JavaFileManager 내의 getClassLoader

파라미터:

location - 장소

반환값:

지정의 장소의 클래스 로더. 지정의 장소로부터 플러그 인을 로드할 수 없는 경우, 또는 미지의 장소가 지정되었을 경우는 null

예외:

SecurityException - 현재의 시큐리티 문맥으로 클래스 로더를 작성할 수 없는 경우

IllegalStateException - JavaFileManager.close() 가 불려 가 이 파일 관리자-를 재차 열 수가 없는 경우

list

public Iterable <JavaFileObject > list(JavaFileManager.Location  location,
                                     String  packageName,
                                     Set <JavaFileObject.Kind > kinds,
                                     boolean recurse)
                              throws IOException 

인터페이스 JavaFileManager 의 기술:

지정의 장소의 지정의 기준에 일치하는 모든 파일 객체를 일람표 가리킵니다. 재귀 처리가 유효하게 되어 있는 경우, 「서브 패키지」내의 파일 객체도 일람표 나타납니다.

주:이 파일 관리자-에 있어 미지의 장소가 지정되었을 경우도,null 가 돌려주어질 것은 없습니다. 또, 예외가 생성되는 일도 없습니다.

정의:

인터페이스 JavaFileManager 내의 list

파라미터:

location - 장소

packageName - 패키지명

kinds - 이러한 종류의 객체만 돌려주는

recurse - true 의 경우, 「서브 패키지」도 포함된다

반환값:

지정된 기준에 일치하는 파일 객체의 Iterable

예외:

IOException - 입출력 에러가 발생했을 경우, 또는 JavaFileManager.close() 가 불려 가 이 파일 관리자-를 재차 열 수가 없는 경우

IllegalStateException - JavaFileManager.close() 가 불려 가 이 파일 관리자-를 재차 열 수가 없는 경우

inferBinaryName

public String  inferBinaryName(JavaFileManager.Location  location,
                              JavaFileObject  file)

인터페이스 JavaFileManager 의 기술:

장소에 근거해 파일 객체의 바이너리명을 추측합니다. 유효한 JLS 바이너리명이 아닌 바이너리명이 반환되는 경우도 있습니다.

정의:

인터페이스 JavaFileManager 내의 inferBinaryName

파라미터:

location - 장소

file - 파일 객체

반환값:

바이너리명. 지정된 장소에 파일 객체가 발견되지 않는 경우는 null

예외:

IllegalStateException - JavaFileManager.close() 가 불려 가 이 파일 관리자-를 재차 열 수가 없는 경우

isSameFile

public boolean isSameFile(FileObject  a,
                          FileObject  b)

인터페이스 JavaFileManager 의 기술:

2 개의 파일 객체를 비교해, 이것들에 의해 나타내지는 부하의 객체가 같은 경우는 true 를 돌려줍니다.

정의:

인터페이스 JavaFileManager 내의 isSameFile

파라미터:

a - 파일 객체

b - 파일 객체

반환값:

지정된 파일 객체에 의해 나타내지는 부하의 객체가 같은 경우는 true

예외:

IllegalArgumentException - 어느 쪽인가의 인수가 다른 파일 관리자-로 작성된 인수이며, 이 파일 관리자-가 외부 파일 객체를 지원하고 있지 않는 경우

handleOption

public boolean handleOption(String  current,
                            Iterator <String > remaining)

인터페이스 JavaFileManager 의 기술:

1 개의 옵션을 처리합니다. current 가 이 파일 관리자-의 옵션인 경우는,remaining 로부터 그 옵션에 대한 모든 인수를 사용해, true 를 돌려줍니다. 그렇지 않은 경우는 false 를 돌려줍니다.

정의:

인터페이스 JavaFileManager 내의 handleOption

파라미터:

current - 현재의 옵션

remaining - 나머지의 옵션

반환값:

이 옵션이 이 파일 관리자-로 처리되었을 경우는 true, 그렇지 않은 경우는 false

예외:

IllegalArgumentException - 이 파일 관리자-에 대한 이 옵션이 부정하게 사용되었을 경우

IllegalStateException - JavaFileManager.close() 가 불려 가 이 파일 관리자-를 재차 열 수가 없는 경우

hasLocation

public boolean hasLocation(JavaFileManager.Location  location)

인터페이스 JavaFileManager 의 기술:

이 파일 관리자-에 있어 기존의 장소일지 어떨지를 판단합니다.

정의:

인터페이스 JavaFileManager 내의 hasLocation

파라미터:

location - 장소

반환값:

기존의 장소인 경우는 true

isSupportedOption

public int isSupportedOption(String  option)

인터페이스 OptionChecker 의 기술:

지정된 옵션이 지원되고 있는지 어떤지를 조사해 지원되고 있는 경우는 그 옵션이 취하는 인수의 수를 특정합니다.

정의:

인터페이스 OptionChecker 내의 isSupportedOption

파라미터:

option - 옵션

반환값:

지정된 옵션이 취하는 인수의 수. 그 옵션이 지원되어 있지 않은 경우는 -1

getJavaFileForInput

public JavaFileObject  getJavaFileForInput(JavaFileManager.Location  location,
                                          String  className,
                                          JavaFileObject.Kind  kind)
                                   throws IOException 

인터페이스 JavaFileManager 의 기술:

지정된 장소에 있는, 특정의 종류의 특정의 클래스를 나타내는 입력용파일 객체를 가져옵니다.

정의:

인터페이스 JavaFileManager 내의 getJavaFileForInput

파라미터:

location - 장소

className - 클래스의 이름

kind - 파일의 종류. SOURCE 또는 CLASS

반환값:

파일 객체. 파일이 존재하지 않는 경우는 null 가 돌려주어질 가능성이 있다

예외:

IllegalArgumentException - 이 파일 관리자-에 있어 미지의 장소가 지정되어 파일 관리자-가 미지의 장소를 지원하고 있지 않는 경우, 또는 파일의 종류가 유효하지 않은 경우

IllegalStateException - JavaFileManager.close() 가 불려 가 이 파일 관리자-를 재차 열 수가 없는 경우

IOException - 입출력 에러가 발생했을 경우, 또는 JavaFileManager.close() 가 불려 가 이 파일 관리자-를 재차 열 수가 없는 경우

getJavaFileForOutput

public JavaFileObject  getJavaFileForOutput(JavaFileManager.Location  location,
                                           String  className,
                                           JavaFileObject.Kind  kind,
                                           FileObject  sibling)
                                    throws IOException 

인터페이스 JavaFileManager 의 기술:

지정된 장소에 있는, 특정의 종류의 특정의 클래스를 나타내는 출력용파일 객체를 가져옵니다.

이 파일 관리자-는, 옵션으로서 형제 위젯를 출력처의 힌트로서 사용할 가능성이 있습니다. 이 힌트의 엄밀한 시멘틱스는 지정되지 않습니다. 예를 들어 Sun 의 컴파일러 javac 는, 클래스 파일의 출력 디렉토리가 지정되어 있지 않은 경우, 원시 파일과 같은 디렉토리에 클래스 파일을 배치합니다. 이 처리를 간편화하기 (위해)때문에, javac 는, 이 메소드를 호출할 때, 원시 파일을 형제 위젯로서 지정하는 일이 있습니다.

정의:

인터페이스 JavaFileManager 내의 getJavaFileForOutput

파라미터:

location - 장소

className - 클래스의 이름

kind - 파일의 종류. SOURCE 또는 CLASS

sibling - 배치의 힌트로서 사용되는 파일 객체. null 도 가능

반환값:

출력용 파일 객체

예외:

IllegalArgumentException - 이 파일 관리자-에 있어 미지의 형제 위젯가 지정되었을 경우, 이 파일 관리자-에 있어 미지의 장소가 지정되어 파일 관리자-가 미지의 장소를 지원하고 있지 않는 경우, 또는 파일의 종류가 유효하지 않은 경우

IllegalStateException - JavaFileManager.close() 가 불려 가 이 파일 관리자-를 재차 열 수가 없는 경우

IOException - 입출력 에러가 발생했을 경우, 또는 JavaFileManager.close() 가 불려 가 이 파일 관리자-를 재차 열 수가 없는 경우

getFileForInput

public FileObject  getFileForInput(JavaFileManager.Location  location,
                                  String  packageName,
                                  String  relativeName)
                           throws IOException 

인터페이스 JavaFileManager 의 기술:

지정된 장소에 있는, 특정의 패키지내의 특정의상대명을 나타내는 입력용파일 객체를 가져옵니다.

반환된 객체가원시 파일 또는클래스 파일을 나타내는 경우,JavaFileObject 의 인스턴스일 필요가 있습니다.

비공식에는, 이 메소드로 반환되는 파일 객체는, 장소, 패키지명, 및 상대명을 연결한 장소에 있습니다. 예를 들어,SOURCE_PATH 에 있는 com.sun.tools.javac 패키지내의 프로퍼티 파일 resources/compiler.properties 를 찾고 있는 경우, 다음과 같이 해 이 메소드를 호출할 수가 있습니다.

getFileForInput(SOURCE_PATH, "com.sun.tools.javac", "resources/compiler.properties");

이 호출이 Windows 상에서 실행되어 SOURCE_PATH 가 "C:\Documents and Settings\UncleBob\src\share\classes" 로 설정되어 있었을 경우, 유효한 결과는, 파일 "C:\Documents and Settings\UncleBob\src\share\classes\com\sun\tools\javac\resources\compiler.properties" 를 나타내는 파일 객체가 됩니다.

정의:

인터페이스 JavaFileManager 내의 getFileForInput

파라미터:

location - 장소

packageName - 패키지명

relativeName - 상대명

반환값:

파일 객체. 파일이 존재하지 않는 경우는 null 가 돌려주어질 가능성이 있다

예외:

IllegalArgumentException - 이 파일 관리자-에 있어 미지의 장소가 지정되어 파일 관리자-가 미지의 장소를 지원하고 있지 않는 경우, 또는 relativeName 가 유효하지 않은 경우

IllegalStateException - JavaFileManager.close() 가 불려 가 이 파일 관리자-를 재차 열 수가 없는 경우

IOException - 입출력 에러가 발생했을 경우, 또는 JavaFileManager.close() 가 불려 가 이 파일 관리자-를 재차 열 수가 없는 경우

getFileForOutput

public FileObject  getFileForOutput(JavaFileManager.Location  location,
                                   String  packageName,
                                   String  relativeName,
                                   FileObject  sibling)
                            throws IOException 

인터페이스 JavaFileManager 의 기술:

지정된 장소에 있는, 특정의 패키지내의 특정의상대명을 나타내는 출력용파일 객체를 가져옵니다.

이 파일 관리자-는, 옵션으로서 형제 위젯를 출력처의 힌트로서 사용할 가능성이 있습니다. 이 힌트의 엄밀한 시멘틱스는 지정되지 않습니다. 예를 들어 Sun 의 컴파일러 javac 는, 클래스 파일의 출력 디렉토리가 지정되어 있지 않은 경우, 원시 파일과 같은 디렉토리에 클래스 파일을 배치합니다. 이 처리를 간편화하기 (위해)때문에, javac 는, 이 메소드를 호출할 때, 원시 파일을 형제 위젯로서 지정하는 일이 있습니다.

반환된 객체가원시 파일 또는클래스 파일을 나타내는 경우,JavaFileObject 의 인스턴스일 필요가 있습니다.

비공식에는, 이 메소드로 반환되는 파일 객체는, 장소, 패키지명, 및 상대명을 연결한 장소인가, 형제 인수의 다음에 있습니다. 예는,getFileForInput 를 참조해 주세요.

정의:

인터페이스 JavaFileManager 내의 getFileForOutput

파라미터:

location - 장소

packageName - 패키지명

relativeName - 상대명

sibling - 배치의 힌트로서 사용되는 파일 객체. null 도 가능

반환값:

파일 객체

예외:

IllegalArgumentException - 이 파일 관리자-에 있어 미지의 형제 위젯가 지정되었을 경우, 이 파일 관리자-에 있어 미지의 장소가 지정되어 파일 관리자-가 미지의 장소를 지원하고 있지 않는 경우, 또는 relativeName 가 유효하지 않은 경우

IllegalStateException - JavaFileManager.close() 가 불려 가 이 파일 관리자-를 재차 열 수가 없는 경우

IOException - 입출력 에러가 발생했을 경우, 또는 JavaFileManager.close() 가 불려 가 이 파일 관리자-를 재차 열 수가 없는 경우

flush

public void flush()
           throws IOException 

인터페이스 JavaFileManager 의 기술:

이 파일 관리자-에 의해 직접적 또는 간접적으로 열린 출력용 자원이 있으면, 그것을 플래시 합니다. 닫혀진 파일 관리자-를 플래시 해도, 효과는 없습니다.

정의:

인터페이스 Flushable 내의 flush

정의:

인터페이스 JavaFileManager 내의 flush

예외:

IOException - 입출력 에러가 발생했을 경우

관련 항목:

JavaFileManager.close()

close

public void close()
           throws IOException 

인터페이스 JavaFileManager 의 기술:

이 파일 관리자-에 의해 직접적 또는 간접적으로 열린 자원이 있으면, 그것을 해제합니다. 그러자(면), 이 파일 관리자-가 무효가 되어, 그 후 이 객체상에서 행해지는 메소드 호출이나, 이 객체를 통해 취득되는 객체는, 명시적으로 허가되어 있지 않은 한 미정도리가 됩니다. 다만, 벌써 닫혀진 파일 관리자-를 닫아도, 효과는 없습니다.

정의:

인터페이스 Closeable 내의 close

정의:

인터페이스 JavaFileManager 내의 close

예외:

IOException - 입출력 에러가 발생했을 경우

관련 항목:

JavaFileManager.flush()