-
- All Known Subinterfaces:
-
JavaFileObject
public interface FileObject
工具的文件抽象。 在此上下文中, file表示常规文件和其他数据源的抽象。 例如,文件对象可用于表示常规文件,内存缓存或数据库中的数据。如果发生安全性异常,此接口中的所有方法都可能抛出SecurityException。
除非明确允许,否则如果给定
null
参数,此接口中的所有方法都可能抛出NullPointerException。- 从以下版本开始:
- 1.6
-
-
方法摘要
所有方法 实例方法 抽象方法 变量和类型 方法 描述 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
- 如果为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)起的毫秒数来衡量。- 结果
- 上次修改此文件对象的时间; 如果文件对象不存在,如果发生I / O错误,或者不支持该操作,则为0或0
-
delete
boolean delete()
删除此文件对象。 如果出现错误,则返回false。- 结果
- 当且仅当此文件对象被成功删除时才返回true; 否则是假的
-
-