JavaTM Platform
Standard Ed. 6

javax.tools
类 ForwardingFileObject<F extends FileObject>

java.lang.Object
  继承者 javax.tools.ForwardingFileObject<F>
类型参数:
F - 此对象将转发到的文件对象的类型
所有已实现的接口:
FileObject
直接已知子类:
ForwardingJavaFileObject

public class ForwardingFileObject<F extends FileObject>
     
extends Object
implements FileObject

将调用转发到给定的文件对象。此类的子类可以重写其中某些方法,还可以提供附加字段和方法。

从以下版本开始:
1.6

字段摘要
protected  F fileObject
          一个文件对象,所有方法都将委托给它。
 
构造方法摘要
protected ForwardingFileObject(F fileObject)
          创建一个新的 ForwardingFileObject 实例。
 
方法摘要
 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。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

字段详细信息

fileObject

protected final F extends FileObject fileObject
一个文件对象,所有方法都将委托给它。

构造方法详细信息

ForwardingFileObject

protected ForwardingFileObject(F fileObject)
创建一个新的 ForwardingFileObject 实例。

参数:
fileObject - 委托给此文件对象
方法详细信息

toUri

public URI toUri()
从接口 FileObject 复制的描述
返回标识此文件对象的 URI。

指定者:
接口 FileObject 中的 toUri
返回:
URI

getName

public String getName()
从接口 FileObject 复制的描述
获取此文件对象的用户友好 (user-friendly) 的名称。没有指定返回的准确值,但是实现应该负责保存用户给定的名称。例如,如果用户在命令行中写入文件名 &quot;BobsApp\Test.java&quot;,则此方法应该返回 &quot;BobsApp\Test.java&quot;,而 toUri 方法可能返回 file:///C:/Documents%20and%20Settings/UncleBob/BobsApp/Test.java

指定者:
接口 FileObject 中的 getName
返回:
用户友好的名称

openInputStream

public InputStream openInputStream()
                            throws IOException
从接口 FileObject 复制的描述
获取此文件对象的 InputStream。

指定者:
接口 FileObject 中的 openInputStream
返回:
InputStream
抛出:
IllegalStateException - 如果此文件对象是为写入而打开的,不支持读取操作
UnsupportedOperationException - 如果这种文件对象不支持字节访问
IOException - 如果发生 I/O 错误

openOutputStream

public OutputStream openOutputStream()
                              throws IOException
从接口 FileObject 复制的描述
获取此文件对象的 OutputStream。

指定者:
接口 FileObject 中的 openOutputStream
返回:
OutputStream
抛出:
IllegalStateException - 如果此文件对象是为读取而打开的,不支持写入操作
UnsupportedOperationException - 如果这种对象不支持字节访问
IOException - 如果发生 I/O 错误

openReader

public Reader openReader(boolean ignoreEncodingErrors)
                  throws IOException
从接口 FileObject 复制的描述
获取此对象的 reader。返回的 reader 将代替不能用默认转换字符解码的字节。此外,除非 ignoreEncodingErrors 为 true,否则 reader 可能报告一个诊断。

指定者:
接口 FileObject 中的 openReader
参数:
ignoreEncodingErrors - 如果为 true,则忽略编码错误
返回:
Reader
抛出:
IllegalStateException - 如果此文件对象是为写入而打开的,不支持读取操作
UnsupportedOperationException - 如果这种文件对象不支持字符访问
IOException - 如果发生 I/O 错误

getCharContent

public CharSequence getCharContent(boolean ignoreEncodingErrors)
                            throws IOException
从接口 FileObject 复制的描述
返回此文件对象的字符内容(如果有)。默认的转换字符将代替任何不能被解码的字节。此外,除非 ignoreEncodingErrors 为 true,否则可能报告一个诊断。

指定者:
接口 FileObject 中的 getCharContent
参数:
ignoreEncodingErrors - 如果为 true,则忽略编码错误
返回:
CharSequence(如果有);否则返回 null
抛出:
IllegalStateException - 如果此文件对象是为写入而打开的,不支持读取操作
UnsupportedOperationException - 如果这种文件对象不支持字符访问
IOException - 如果发生 I/O 错误

openWriter

public Writer openWriter()
                  throws IOException
从接口 FileObject 复制的描述
获取此文件对象的 Writer。

指定者:
接口 FileObject 中的 openWriter
返回:
Writer
抛出:
IllegalStateException - 如果此文件对象是为读取而打开的,不支持写入操作
UnsupportedOperationException - 如果这种文件对象不支持字符访问
IOException - 如果发生 I/O 错误

getLastModified

public long getLastModified()
从接口 FileObject 复制的描述
获取最后一次修改此文件对象的时间。该时间用距历元(1970 年 1 月 1 日 00:00:00,格林威治时间)的毫秒数计算。

指定者:
接口 FileObject 中的 getLastModified
返回:
最后一次修改此文件对象的时间;如果该文件对象不存在,发生 I/O 错误或者不支持该操作,则返回 0

delete

public boolean delete()
从接口 FileObject 复制的描述
删除此文件对象。如果发生错误,则返回 false。

指定者:
接口 FileObject 中的 delete
返回:
当且仅当成功删除此文件对象时,返回 true;否则返回 false

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策