javax.tools
인터페이스 StandardJavaFileManager

모든 슈퍼 인터페이스:

Closeable , Flushable , JavaFileManager , OptionChecker

public interface StandardJavaFileManager
extends JavaFileManager 

java.io.File 에 근거한 파일 관리자-입니다. 이 클래스의 인스턴스를 가져오려면 , 일반적으로,getStandardFileManager 를 사용합니다. 다음에 예를 나타냅니다.

   JavaCompiler compiler = ToolProvider.getSystemJavaCompiler();
   DiagnosticCollector<JavaFileObject> diagnostics =
       new DiagnosticCollector<JavaFileObject>();
   StandardJavaFileManager fm = compiler.getStandardFileManager(diagnostics, null, null);
 

이 파일 관리자-는, 일반적으로 파일,zip 파일 엔트리, 또는 같은 파일 시스템에 근거하는 컨테이너내의 엔트리를 나타내는 파일 객체를 작성합니다. 이 인터페이스를 구현하고 있는 파일 관리자-로부터 반환되는 파일 객체는, 다음의 동작에 따를 필요가 있습니다.

• 파일명은 정규의 것일 필요는 없습니다.
• 일반적으로의 파일을 나타내는 파일 객체의 경우는 다음과 같이 됩니다.
  • FileObject.delete() 메소드는 File.delete() 와 동일하다.
  • FileObject.getLastModified() 메소드는 File.lastModified() 와 동일하다.
  • FileObject.getCharContent(boolean) ,FileObject.openInputStream() , 및 FileObject.openReader(boolean) 의 각 메소드는, 다음에 나타내는 것이 성공했을 경우에 성공할 필요가 있다 (인코딩의 문제는 무시).

    new FileInputStream (new File (fileObject . toUri ()))

  • FileObject.openOutputStream() 및 FileObject.openWriter() 의 각 메소드는, 다음에 나타내는 것이 성공했을 경우에 성공할 필요가 있다 (인코딩의 문제는 무시).

    new FileOutputStream (new File (fileObject . toUri ()))

• FileObject.toUri() 로부터 반환되는 URI 는 다음과 같이 될 필요가 있습니다.
  • 절대적 이다 (schema를 가진다).
  • 처리 고유의 문맥 (현재의 디렉토리 등) 없음으로 해결할 수 있는 표준화 된 패스 컴포넌트 를 가진다 (파일명은 절대적인 필요가 있다).

이러한 규칙에 따르면(자), 예를 들어 다음과 같이 됩니다.

• file:///C:/Documents%20and%20Settings/UncleBob/BobsApp/Test.java
• jar:///C:/Documents%20and%20Settings/UncleBob/lib/vendorA.jar! com/vendora/LibraryClass.class

다음과 같이는 되지 않습니다 (괄호내는 이유).

• file:BobsApp/Test.java (파일명이 상대적으로, 현재의 디렉토리에 의존하고 있다)
• jar:lib/vendorA.jar! com/vendora/LibraryClass.class (! 의 나머지의 원가요소는 올바르지만, 패스의 전반이 현재의 디렉토리에 의존하고 있다)
• Test.java (이 URI 는 현재의 디렉토리에 의존하고 있어, schema를 가지지 않는다)
• jar:///C:/Documents%20and%20Settings/UncleBob/BobsApp/../lib/vendorA.jar! com/vendora/LibraryClass.class (패스가 표준화되어 있지 않다)

도입된 버젼:

1.6

상자의 클래스의 개요

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

JavaFileManager.Location

메소드의 개요

Iterable <? extends JavaFileObject >	getJavaFileObjects (File ... files) 지정된 파일을 나타내는 파일 객체를 가져옵니다.
Iterable <? extends JavaFileObject >	getJavaFileObjects (String ... names) 지정된 파일명을 나타내는 파일 객체를 가져옵니다.
Iterable <? extends JavaFileObject >	getJavaFileObjectsFromFiles (Iterable <? extends File > files) 지정된 파일을 나타내는 파일 객체를 가져옵니다.
Iterable <? extends JavaFileObject >	getJavaFileObjectsFromStrings (Iterable <String > names) 지정된 파일명을 나타내는 파일 객체를 가져옵니다.
Iterable <? extends File >	getLocation (JavaFileManager.Location location) 지정된 장소에 관련지을 수 있었던 패스를 가져옵니다.
boolean	isSameFile (FileObject a, FileObject b) 2 개의 파일 객체를 비교해, 그것들이 동일한 정규의 파일, zip 파일 엔트리, 또는 파일 시스템에 근거하는 컨테이너내의 엔트리를 나타내고 있는 경우는 true 를 돌려줍니다.
void	setLocation (JavaFileManager.Location location, Iterable <? extends File > path) 지정된 패스와 지정된 장소를 관련짓습니다.

인터페이스 javax.tools. JavaFileManager 로부터 상속된 메소드

close , flush , getClassLoader , getFileForInput , getFileForOutput , getJavaFileForInput , getJavaFileForOutput , handleOption , hasLocation , inferBinaryName , list

인터페이스 javax.tools. OptionChecker 로부터 상속된 메소드

isSupportedOption

메소드의 상세

isSameFile

boolean isSameFile(FileObject  a,
                   FileObject  b)

2 개의 파일 객체를 비교해, 그것들이 동일한 정규의 파일, zip 파일 엔트리, 또는 파일 시스템에 근거하는 컨테이너내의 엔트리를 나타내고 있는 경우는 true 를 돌려줍니다.

정의:

인터페이스 JavaFileManager 내의 isSameFile

파라미터:

a - 파일 객체

b - 파일 객체

반환값:

지정된 파일 객체가 동일한 정규의 파일 또는 zip 파일 엔트리를 나타내는 경우는 true, 그렇지 않은 경우는 false

예외:

IllegalArgumentException - 한편의 인수가 다른 파일 관리자-구현으로 작성되었을 경우

getJavaFileObjectsFromFiles

Iterable <?  extends JavaFileObject > getJavaFileObjectsFromFiles(Iterable <?  extends File > files)

지정된 파일을 나타내는 파일 객체를 가져옵니다.

파라미터:

files - 파일의 리스트

반환값:

파일 객체의 리스트

예외:

IllegalArgumentException - 파일의 리스트에 디렉토리가 포함되는 경우

getJavaFileObjects

Iterable <?  extends JavaFileObject > getJavaFileObjects(File ... files)

지정된 파일을 나타내는 파일 객체를 가져옵니다. 동등의 편리한 메소드는, 다음과 같습니다.

getJavaFileObjectsFromFiles(Arrays.asList (files))
 

파라미터:

files - 파일의 배열

반환값:

파일 객체의 리스트

예외:

IllegalArgumentException - 파일의 배열에 디렉토리가 포함되는 경우

NullPointerException - 지정된 배열에 null 요소가 포함되는 경우

getJavaFileObjectsFromStrings

Iterable <?  extends JavaFileObject > getJavaFileObjectsFromStrings(Iterable <String > names)

지정된 파일명을 나타내는 파일 객체를 가져옵니다.

파라미터:

names - 파일명의 리스트

반환값:

파일 객체의 리스트

예외:

IllegalArgumentException - 파일명의 리스트에 디렉토리가 포함되는 경우

getJavaFileObjects

Iterable <?  extends JavaFileObject > getJavaFileObjects(String ... names)

지정된 파일명을 나타내는 파일 객체를 가져옵니다. 동등의 편리한 메소드는, 다음과 같습니다.

getJavaFileObjectsFromStrings(Arrays.asList (names))
 

파라미터:

names - 파일명의 리스트

반환값:

파일 객체의 리스트

예외:

IllegalArgumentException - 파일명의 배열에 디렉토리가 포함되는 경우

NullPointerException - 지정된 배열에 null 요소가 포함되는 경우

setLocation

void setLocation(JavaFileManager.Location  location,
                 Iterable <?  extends File > path)
                 throws IOException 

지정된 패스와 지정된 장소를 관련짓습니다. 이전의 값은 모두 파기됩니다.

파라미터:

location - 장소

path - 파일의 리스트. null 의 경우, 이 장소의 디폴트의 패스를 사용

예외:

IllegalArgumentException - 장소가 출력 장소이며, 패스에 포함되는 요소가 엄밀하게 1 개가 아닌 경우

IOException - 장소가 출력 장소이며, 패스가 기존의 디렉토리를 나타내지 않은 경우

관련 항목:

getLocation(javax.tools.JavaFileManager.Location)

getLocation

Iterable <?  extends File > getLocation(JavaFileManager.Location  location)

지정된 장소에 관련지을 수 있었던 패스를 가져옵니다.

파라미터:

location - 장소

반환값:

파일의 리스트. 이 장소에 패스를 관련지을 수 있지 않은 경우는 null

관련 항목:

setLocation(javax.tools.JavaFileManager.Location, java.lang.Iterable)