public interface FileObject
工具的文件抽象。在这里,文件 是指常规文件和其他数据源的抽象。例如,文件对象可用于表示常规文件、内存缓存或数据库中的数据。
如果发生安全异常,则此接口中的所有方法都将抛出 SecurityException。
除非明确允许,否则只要给定 null
参数,此接口中的所有方法都将抛出 NullPointerException。
方法摘要 | |
---|---|
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。 |
方法详细信息 |
---|
URI toUri()
String getName()
"BobsApp\Test.java"
,则此方法应该返回
"BobsApp\Test.java"
,而
toUri 方法可能返回
file:///C:/Documents%20and%20Settings/UncleBob/BobsApp/Test.java
。
InputStream openInputStream() throws IOException
IllegalStateException
- 如果此文件对象是为写入而打开的,不支持读取操作
UnsupportedOperationException
- 如果这种文件对象不支持字节访问
IOException
- 如果发生 I/O 错误
OutputStream openOutputStream() throws IOException
IllegalStateException
- 如果此文件对象是为读取而打开的,不支持写入操作
UnsupportedOperationException
- 如果这种对象不支持字节访问
IOException
- 如果发生 I/O 错误
Reader openReader(boolean ignoreEncodingErrors) throws IOException
ignoreEncodingErrors
为 true,否则 reader 可能报告一个诊断。
ignoreEncodingErrors
- 如果为 true,则忽略编码错误
IllegalStateException
- 如果此文件对象是为写入而打开的,不支持读取操作
UnsupportedOperationException
- 如果这种文件对象不支持字符访问
IOException
- 如果发生 I/O 错误
CharSequence getCharContent(boolean ignoreEncodingErrors) throws IOException
ignoreEncodingErrors
为 true,否则可能报告一个诊断。
ignoreEncodingErrors
- 如果为 true,则忽略编码错误
null
IllegalStateException
- 如果此文件对象是为写入而打开的,不支持读取操作
UnsupportedOperationException
- 如果这种文件对象不支持字符访问
IOException
- 如果发生 I/O 错误
Writer openWriter() throws IOException
IllegalStateException
- 如果此文件对象是为读取而打开的,不支持写入操作
UnsupportedOperationException
- 如果这种文件对象不支持字符访问
IOException
- 如果发生 I/O 错误
long getLastModified()
boolean delete()