compact3

javax.tools

Interface FileObject

All Known Subinterfaces:

JavaFileObject

所有已知实现类：

ForwardingFileObject ， ForwardingJavaFileObject ， SimpleJavaFileObject

public interface FileObject

文件抽象的工具。 在这种情况下， 文件意味着抽象普通文件和其他数据源。 例如，文件对象可用于表示数据库中的常规文件，内存缓存或数据。

如果发生安全异常，此接口中的所有方法都可能会抛出SecurityException异常。

除非明确允许，如果给定一个null参数，则该接口中的所有方法都可能会抛出null 。

从以下版本开始：

1.6

方法摘要

Modifier and Type	Method and Description
boolean	delete() 删除此文件对象。
CharSequence	getCharContent(boolean ignoreEncodingErrors) 获取此文件对象的字符内容（如果可用）。
long	getLastModified() 获取上次修改此文件对象的时间。
String	getName() 获取此文件对象的用户友好名称。
InputStream	openInputStream() 获取此文件对象的InputStream。
OutputStream	openOutputStream() 获取此文件对象的OutputStream。
Reader	openReader(boolean ignoreEncodingErrors) 获取此对象的读者。
Writer	openWriter() 获取此文件对象的Writer。
URI	toUri() 返回标识此文件对象的URI。

方法详细信息

toUri

URI toUri()

返回标识此文件对象的URI。

结果

一个URI

getName

String getName()

获取此文件对象的用户友好名称。 没有指定返回的确切值，但实现应该小心保留用户给出的名称。 例如，如果用户在命令行上写入文件名"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

获取此对象的读者。 返回的读取器将替换不能用默认转换字符解码的字节。 此外，读者可以报告诊断，除非ignoreEncodingErrors是真的。

参数

ignoreEncodingErrors - 忽略编码错误，如果为true

结果

一位读者

异常

IllegalStateException - 如果这个文件对象被打开来写入并且不支持读取

UnsupportedOperationException - 如果这种文件对象不支持字符访问

IOException - 如果发生I / O错误

getCharContent

CharSequence getCharContent(boolean ignoreEncodingErrors)
                     throws IOException

获取此文件对象的字符内容（如果可用）。 任何无法解码的字节都将被默认的转换字符替代。 此外，除非ignoreEncodingErrors为真，否则可能会报告ignoreEncodingErrors 。

参数

ignoreEncodingErrors - 如果为true，则忽略编码错误

结果

一个CharSequence（如果有的话） null否则

异常

IllegalStateException - 如果这个文件对象被打开来写入并且不支持读取

UnsupportedOperationException - 如果这种文件对象不支持字符访问

IOException - 如果发生I / O错误

openWriter

Writer openWriter()
           throws IOException

获取此文件对象的Writer。

结果

一个作家

异常

IllegalStateException - 如果此文件对象被打开以供阅读并且不支持写入

UnsupportedOperationException - 如果这种文件对象不支持字符访问

IOException - 如果发生I / O错误

getLastModified

long getLastModified()

获取上次修改此文件对象的时间。 时间是从时代（1970年1月1日00:00:00 GMT）开始测量的。

结果

该文件对象上次修改的时间; 如果文件对象不存在，则发生I / O错误，或者不支持该操作

delete

boolean delete()

删除此文件对象。 如果发生错误，返回false。

结果

当且仅当此文件对象成功删除时为true; 否则为假