Module java.compiler
Package javax.tools

Interface FileObject

所有已知的子接口:
JavaFileObject
所有已知的实现类:
ForwardingFileObject, ForwardingJavaFileObject, SimpleJavaFileObject
public interface FileObject
工具的文件抽象。在这个上下文中，文件 意味着常规文件和其他数据源的抽象。例如，文件对象可以用来表示常规文件、内存缓存或数据库中的数据。

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

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

自版本:
1.6

  • Method Details

    • 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
      返回此对象的Reader。返回的Reader将用默认转换字符替换无法解码的字节。此外，除非ignoreEncodingErrors为true，否则Reader可能会报告诊断。
      参数:
      ignoreEncodingErrors - 如果为true，则忽略编码错误
      返回:
      一个Reader
      抛出:
      IllegalStateException - 如果此文件对象已打开以进行写入且不支持读取
      UnsupportedOperationException - 如果此类文件对象不支持字符访问
      IOException - 如果发生I/O错误

    • getCharContent

      CharSequence getCharContent(boolean ignoreEncodingErrors) throws IOException
      返回此文件对象的字符内容（如果可用）。任何无法解码的字节将被默认转换字符替换。此外，除非ignoreEncodingErrors为true，否则可能会报告诊断。
      参数:
      ignoreEncodingErrors - 如果为true，则忽略编码错误
      返回:
      如果可用，则返回一个CharSequence；否则返回null
      抛出:
      IllegalStateException - 如果此文件对象已打开以进行写入且不支持读取
      UnsupportedOperationException - 如果此类文件对象不支持字符访问
      IOException - 如果发生I/O错误

    • openWriter

      Writer openWriter() throws IOException
      返回此文件对象的Writer。
      返回:
      一个Writer
      抛出:
      IllegalStateException - 如果此文件对象已打开以进行读取且不支持写入
      UnsupportedOperationException - 如果此类文件对象不支持字符访问
      IOException - 如果发生I/O错误

    • getLastModified

      long getLastModified()
      返回此文件对象上次修改的时间。时间以自1970年1月1日格林尼治时间00:00:00起的毫秒数表示。
      返回:
      此文件对象上次修改的时间；如果文件对象不存在、发生I/O错误或不支持该操作，则返回0

    • delete

      boolean delete()
      删除此文件对象。如果发生错误，则返回false。
      返回:
      如果成功删除此文件对象，则返回true；否则返回false