javax.tools
類別 SimpleJavaFileObject

java.lang.Object
  javax.tools.SimpleJavaFileObject

所有已實作的介面：

FileObject, JavaFileObject

public class SimpleJavaFileObject
extends Object
implements JavaFileObject

為 JavaFileObject 中的大多數方法提供簡單實作。應子類別化此類別並用作 JavaFileObject 實作的基礎。子類別可以覆寫此類別任意方法的實作和規範，只要不違背 JavaFileObject 的常規協定。

從以下版本開始：

1.6

巢狀類別摘要

從介面 javax.tools.JavaFileObject 繼承的巢狀類別/介面

JavaFileObject.Kind

欄位摘要

protected JavaFileObject.Kind	kind 此檔案物件的種類別。
protected URI	uri 此檔案物件的 URI。

建構子摘要

protected

SimpleJavaFileObject(URI uri, JavaFileObject.Kind kind) 使用給定 URI 建構給定種類別的 SimpleJavaFileObject。

方法摘要

boolean	delete() 此實作不執行任何操作。
Modifier	getAccessLevel() 此實作返回 null。
CharSequence	getCharContent(boolean ignoreEncodingErrors) 此實作總是拋出 UnsupportedOperationException。
JavaFileObject.Kind	getKind() 獲取此檔案物件的種類別。
long	getLastModified() 此實作返回 0L。
String	getName() 獲取此檔案物件的使用者友好 (user-friendly) 的名稱。
NestingKind	getNestingKind() 此實作返回 null。
boolean	isNameCompatible(String simpleName, JavaFileObject.Kind kind) 此實作對其 URI 路徑和給定簡單名稱進行比較。
InputStream	openInputStream() 此實作總是拋出 UnsupportedOperationException。
OutputStream	openOutputStream() 此實作總是拋出 UnsupportedOperationException。
Reader	openReader(boolean ignoreEncodingErrors) 在 Reader 中包裹 getCharContent(boolean) 的結果。
Writer	openWriter() 在 Writer 中包裹 openOutputStream 的結果。
String	toString() 返回該物件的字元串表示。
URI	toUri() 返回標識此檔案物件的 URI。

從類別 java.lang.Object 繼承的方法

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

欄位詳細資訊

uri

protected final URI uri

此檔案物件的 URI。

kind

protected final JavaFileObject.Kind kind

此檔案物件的種類別。

建構子詳細資訊

SimpleJavaFileObject

protected SimpleJavaFileObject(URI uri,
                               JavaFileObject.Kind kind)

使用給定 URI 建構給定種類別的 SimpleJavaFileObject。

參數：

uri - 此檔案物件的 URI

kind - 此檔案物件的種類別

方法詳細資訊

toUri

public URI toUri()

從介面 FileObject 複製的描述

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

指定者：

介面 FileObject 中的 toUri

返回：

URI

getName

public String getName()

從介面 FileObject 複製的描述

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

指定者：

介面 FileObject 中的 getName

返回：

使用者友好的名稱

openInputStream

public InputStream openInputStream()
                            throws IOException

此實作總是拋出 UnsupportedOperationException。子類別可以更改此行為，只要不違背 FileObject 的協定。

指定者：

介面 FileObject 中的 openInputStream

返回：

InputStream

拋出：

IOException - 如果發生 I/O 錯誤

openOutputStream

public OutputStream openOutputStream()
                              throws IOException

此實作總是拋出 UnsupportedOperationException。子類別可以更改此行為，只要不違背 FileObject 的協定。

指定者：

介面 FileObject 中的 openOutputStream

返回：

OutputStream

拋出：

IOException - 如果發生 I/O 錯誤

openReader

public Reader openReader(boolean ignoreEncodingErrors)
                  throws IOException

在 Reader 中包裹 getCharContent(boolean) 的結果。子類別可以更改此行為，只要不違背 FileObject 的協定。

指定者：

介面 FileObject 中的 openReader

參數：

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

返回：

包裹 getCharContent 結果的 Reader

拋出：

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

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

IOException - 如果發生 I/O 錯誤

getCharContent

public CharSequence getCharContent(boolean ignoreEncodingErrors)
                            throws IOException

此實作總是拋出 UnsupportedOperationException。子類別可以更改此行為，只要不違背 FileObject 的協定。

指定者：

介面 FileObject 中的 getCharContent

參數：

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

返回：

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

拋出：

IOException - 如果發生 I/O 錯誤

openWriter

public Writer openWriter()
                  throws IOException

在 Writer 中包裹 openOutputStream 的結果。子類別可以更改此行為，只要不違背 FileObject 的協定。

指定者：

介面 FileObject 中的 openWriter

返回：

包裹 openOutputStream 結果的 Writer

拋出：

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

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

IOException - 如果發生 I/O 錯誤

getLastModified

public long getLastModified()

此實作返回 0L。子類別可以更改此行為，只要不違背 FileObject 的協定。

指定者：

介面 FileObject 中的 getLastModified

返回：

0L

delete

public boolean delete()

此實作不執行任何操作。子類別可以更改此行為，只要不違背 FileObject 的協定。

指定者：

介面 FileObject 中的 delete

返回：

false

getKind

public JavaFileObject.Kind getKind()

從介面 JavaFileObject 複製的描述

獲取此檔案物件的種類別。

指定者：

介面 JavaFileObject 中的 getKind

返回：

this.kind

isNameCompatible

public boolean isNameCompatible(String simpleName,
                                JavaFileObject.Kind kind)

此實作對其 URI 路徑和給定簡單名稱進行比較。如果給定種類別等於此物件的種類別，並且路徑等於 simpleName + kind.extension 或者路徑以 "/" + simpleName + kind.extension 結尾，則此方法返回 true。

此方法調用 getKind() 和 toUri() 並且不直接存取 uri 和 kind 欄位。

子類別可以更改此行為，只要不違背 JavaFileObject 的協定。

指定者：

介面 JavaFileObject 中的 isNameCompatible

參數：

simpleName - 類別的簡單名稱

kind - 種類別

返回：

如果此檔案物件相容，則返回 true；否則返回 false

getNestingKind

public NestingKind getNestingKind()

此實作返回 null。子類別可以更改此行為，只要不違背 JavaFileObject 的協定。

指定者：

介面 JavaFileObject 中的 getNestingKind

返回：

巢狀種類別；如果巢狀種類別未知，則返回 null

getAccessLevel

public Modifier getAccessLevel()

此實作返回 null。子類別可以更改此行為，只要不違背 JavaFileObject 的協定。

指定者：

介面 JavaFileObject 中的 getAccessLevel

返回：

存取級別

toString

public String toString()

從類別 Object 複製的描述

返回該物件的字元串表示。通常，toString 方法會返回一個「以文本方式表示」此物件的字元串。結果應是一個簡明但易於讀懂的資訊表達式。建議所有子類別都覆寫此方法。

Object 類別的 toString 方法返回一個字元串，該字元串由類別名（物件是該類別的一個實例）、at 標記符“@”和此物件雜湊碼的無符號十六進製表示組成。換句話說，該方法返回一個字元串，它的值等於：

getClass().getName() + '@' + Integer.toHexString(hashCode())
 

覆寫：

類別 Object 中的 toString

返回：

該物件的字元串表示形式。