javax.tools
介面 FileObject

所有已知子介面：

JavaFileObject

所有已知實作類別：

ForwardingFileObject, ForwardingJavaFileObject, SimpleJavaFileObject

public interface FileObject

工具的檔案抽象。在這裡，檔案 是指常規檔案和其他資料源的抽象。例如，檔案對象可用於表示常規檔案、記憶體快取記憶體或資料庫中的資料。

如果發生安全異常，則此介面中的所有方法都將拋出 SecurityException。

除非明確允許，否則只要給定 null 參數，此介面中的所有方法都將拋出 NullPointerException。

從以下版本開始：

1.6

方法摘要

boolean	delete() 刪除此檔案物件。
CharSequence	getCharContent(boolean ignoreEncodingErrors) 返回此檔案物件的字元內容（如果有）。
long	getLastModified() 獲取最後一次修改此檔案物件的時間。
String	getName() 獲取此檔案物件的使用者友好 (user-friendly) 的名稱。
InputStream	openInputStream() 獲取此檔案物件的 InputStream。
OutputStream	openOutputStream() 獲取此檔案物件的 OutputStream。
Reader	openReader(boolean ignoreEncodingErrors) 獲取此物件的 reader。
Writer	openWriter() 獲取此檔案物件的 Writer。
URI	toUri() 返回標識此檔案物件的 URI。

方法詳細資訊

toUri

URI toUri()

返回標識此檔案物件的 URI。

返回：

URI

getName

String getName()

獲取此檔案物件的使用者友好 (user-friendly) 的名稱。沒有指定返回的準確值，但是實作應該負責保存使用者給定的名稱。例如，如果使用者在命令行中寫入檔案名 "BobsApp\Test.java"，則此方法應該返回 "BobsApp\Test.java"，而 toUri 方法可能返回 file:///C:/Documents%20and%20Settings/UncleBob/BobsApp/Test.java。

返回：

使用者友好的名稱

openInputStream

InputStream openInputStream()
                            throws IOException

獲取此檔案物件的 InputStream。

返回：

InputStream

拋出：

IllegalStateException - 如果此檔案物件是為寫入而打開的，不支持讀取操作

UnsupportedOperationException - 如果這種檔案物件不支持位元組存取

IOException - 如果發生 I/O 錯誤

openOutputStream

OutputStream openOutputStream()
                              throws IOException

獲取此檔案物件的 OutputStream。

返回：

OutputStream

拋出：

IllegalStateException - 如果此檔案物件是為讀取而打開的，不支持寫入操作

UnsupportedOperationException - 如果這種物件不支持位元組存取

IOException - 如果發生 I/O 錯誤

openReader

Reader openReader(boolean ignoreEncodingErrors)
                  throws IOException

獲取此物件的 reader。返回的 reader 將代替不能用預設轉換字元解碼的位元組。此外，除非 ignoreEncodingErrors 為 true，否則 reader 可能報告一個診斷。

參數：

ignoreEncodingErrors - 如果為 true，則忽略編碼錯誤

返回：

Reader

拋出：

IllegalStateException - 如果此檔案物件是為寫入而打開的，不支持讀取操作

UnsupportedOperationException - 如果這種檔案物件不支持字元存取

IOException - 如果發生 I/O 錯誤

getCharContent

CharSequence getCharContent(boolean ignoreEncodingErrors)
                            throws IOException

返回此檔案物件的字元內容（如果有）。預設的轉換字元將代替任何不能被解碼的位元組。此外，除非 ignoreEncodingErrors 為 true，否則可能報告一個診斷。

參數：

ignoreEncodingErrors - 如果為 true，則忽略編碼錯誤

返回：

CharSequence（如果有）；否則返回 null

拋出：

IllegalStateException - 如果此檔案物件是為寫入而打開的，不支持讀取操作

UnsupportedOperationException - 如果這種檔案物件不支持字元存取

IOException - 如果發生 I/O 錯誤

openWriter

Writer openWriter()
                  throws IOException

獲取此檔案物件的 Writer。

返回：

Writer

拋出：

IllegalStateException - 如果此檔案物件是為讀取而打開的，不支持寫入操作

UnsupportedOperationException - 如果這種檔案物件不支持字元存取

IOException - 如果發生 I/O 錯誤

getLastModified

long getLastModified()

獲取最後一次修改此檔案物件的時間。該時間用距歷元（1970 年 1 月 1 日 00:00:00，格林威治時間）的毫秒數計算。

返回：

最後一次修改此檔案物件的時間；如果該檔案物件不存在，發生 I/O 錯誤或者不支持該操作，則返回 0

delete

boolean delete()

刪除此檔案物件。如果發生錯誤，則返回 false。

返回：

當且僅當成功刪除此檔案物件時，返回 true；否則返回 false