Class DocFile


  • @Deprecated
    public abstract class DocFile
    extends Object
    Deprecated.
    Abstraction for handling files, which may be specified directly (e.g. via a path on the command line) or relative to a Location.

    This is NOT part of any supported API. If you write code that depends on this, you do so at your own risk. This code and its internal interfaces are subject to change or deletion without notice.

    Since:
    8
    • Field Detail

      • location

        protected final JavaFileManager.Location location
        Deprecated.
        The location for this file. Maybe null if the file was created without a location or path.
      • path

        protected final DocPath path
        Deprecated.
        The path relative to the (output) location. Maybe null if the file was created without a location or path.
    • Constructor Detail

      • DocFile

        protected DocFile​(Configuration configuration)
        Deprecated.
        Create a DocFile without a location or path
    • Method Detail

      • createFileForDirectory

        public static DocFile createFileForDirectory​(Configuration configuration,
                                                     String file)
        Deprecated.
        Create a DocFile for a directory.
      • createFileForInput

        public static DocFile createFileForInput​(Configuration configuration,
                                                 String file)
        Deprecated.
        Create a DocFile for a file that will be opened for reading.
      • createFileForOutput

        public static DocFile createFileForOutput​(Configuration configuration,
                                                  DocPath path)
        Deprecated.
        Create a DocFile for a file that will be opened for writing.
      • list

        public static Iterable<DocFile> list​(Configuration configuration,
                                             JavaFileManager.Location location,
                                             DocPath path)
        Deprecated.
        List the directories and files found in subdirectories along the elements of the given location.
        Parameters:
        configuration - the doclet configuration
        location - currently, only StandardLocation.SOURCE_PATH is supported.
        path - the subdirectory of the directories of the location for which to list files
      • copyFile

        public void copyFile​(DocFile fromFile)
                      throws IOException
        Deprecated.
        Copy the contents of another file directly to this file.
        Throws:
        IOException
      • copyResource

        public void copyResource​(DocPath resource,
                                 boolean overwrite,
                                 boolean replaceNewLine)
        Deprecated.
        Copy the contents of a resource file to this file.
        Parameters:
        resource - the path of the resource, relative to the package of this class
        overwrite - whether or not to overwrite the file if it already exists
        replaceNewLine - if false, the file is copied as a binary file; if true, the file is written line by line, using the platform line separator
      • canRead

        public abstract boolean canRead()
        Deprecated.
        Return true if the file can be read.
      • canWrite

        public abstract boolean canWrite()
        Deprecated.
        Return true if the file can be written.
      • exists

        public abstract boolean exists()
        Deprecated.
        Return true if the file exists.
      • getName

        public abstract String getName()
        Deprecated.
        Return the base name (last component) of the file name.
      • getPath

        public abstract String getPath()
        Deprecated.
        Return the file system path for this file.
      • isAbsolute

        public abstract boolean isAbsolute()
        Deprecated.
        Return true if file has an absolute path name.
      • isDirectory

        public abstract boolean isDirectory()
        Deprecated.
        Return true if file identifies a directory.
      • isFile

        public abstract boolean isFile()
        Deprecated.
        Return true if file identifies a file.
      • isSameFile

        public abstract boolean isSameFile​(DocFile other)
        Deprecated.
        Return true if this file is the same as another.
      • mkdirs

        public abstract boolean mkdirs()
        Deprecated.
        Create the file as a directory, including any parent directories.
      • resolve

        public abstract DocFile resolve​(DocPath p)
        Deprecated.
        Derive a new file by resolving a relative path against this file. The new file will inherit the configuration and location of this file If this file has a path set, the new file will have a corresponding new path.
      • resolve

        public abstract DocFile resolve​(String p)
        Deprecated.
        Derive a new file by resolving a relative path against this file. The new file will inherit the configuration and location of this file If this file has a path set, the new file will have a corresponding new path.
      • resolveAgainst

        public abstract DocFile resolveAgainst​(JavaFileManager.Location locn)
        Deprecated.
        Resolve a relative file against the given output location.
        Parameters:
        locn - Currently, only DocumentationTool.Location#DOCUMENTATION_OUTPUT is supported.