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
  • 必須是絕對的（有網要），並且
  • 必須具有標準化的路徑元件，它能夠在沒有任何特定於進程的上下文（比如當前目錄）的情況下被解析（檔案名稱必須是絕對的）。

根據這些規則，以下 URI 是允許的：

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

而以下 URI 不允許（原因在括號中註明）：

• file:BobsApp/Test.java （檔案名稱是相對的並且依賴於當前目錄）
• jar:lib/vendorA.jar!com/vendora/LibraryClass.class （路徑的前半部分依賴於當前路徑，而 ! 後面的部分合法）
• Test.java （此 URI 依賴於當前目錄並且沒有網要）
• 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) 比較兩個檔案物件，如果它們表示相同的規範檔案、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)

比較兩個檔案物件，如果它們表示相同的規範檔案、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 - 如果位置為一個輸出位置並且路徑不完全包含一個元素

IOException - 如果位置是一個輸出位置並且路徑不表示現有目錄

另請參見：

getLocation(javax.tools.JavaFileManager.Location)

getLocation

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

獲取與給定位置關聯的路徑。

參數：

location - 位置

返回：

檔案列表，如果此位置沒有關聯路徑，則返回 null

另請參見：

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