Package adams.core.io

Class PlaceholderDirectory

  • All Implemented Interfaces:
    Serializable, Comparable<File>
    public class PlaceholderDirectory
extends PlaceholderFile
    A specialized File class used for selecting directories with the GOE.
    Version:
    $Revision$
    Author:
    fracpete (fracpete at waikato dot ac dot nz)
    See Also:
    Serialized Form

    • Constructor Detail

      • PlaceholderDirectory

        public PlaceholderDirectory()
        Creates a new PlaceholderFile instance by using the given file.

      • PlaceholderDirectory

        public PlaceholderDirectory​(File file)
        Creates a new PlaceholderDirectory instance by using the given file.
        Parameters:
        file - the file to use

      • PlaceholderDirectory

        public PlaceholderDirectory​(String pathname)
        Creates a new File instance by converting the given pathname string into an abstract pathname. If the given string is the empty string, then the result is the empty abstract pathname.
        Parameters:
        pathname - A pathname string

      • PlaceholderDirectory

        public PlaceholderDirectory​(String parent,
                            String child)
        Creates a new File instance from a parent pathname string and a child pathname string.

        If parent is null then the new File instance is created as if by invoking the single-argument File constructor on the given child pathname string.

        Otherwise the parent pathname string is taken to denote a directory, and the child pathname string is taken to denote either a directory or a file. If the child pathname string is absolute then it is converted into a relative pathname in a system-dependent way. If parent is the empty string then the new File instance is created by converting child into an abstract pathname and resolving the result against a system-dependent default directory. Otherwise each pathname string is converted into an abstract pathname and the child abstract pathname is resolved against the parent.

        Parameters:
        parent - The parent pathname string
        child - The child pathname string

      • PlaceholderDirectory

        public PlaceholderDirectory​(File parent,
                            String child)
        Creates a new File instance from a parent abstract pathname and a child pathname string.

        If parent is null then the new File instance is created as if by invoking the single-argument File constructor on the given child pathname string.

        Otherwise the parent abstract pathname is taken to denote a directory, and the child pathname string is taken to denote either a directory or a file. If the child pathname string is absolute then it is converted into a relative pathname in a system-dependent way. If parent is the empty abstract pathname then the new File instance is created by converting child into an abstract pathname and resolving the result against a system-dependent default directory. Otherwise each pathname string is converted into an abstract pathname and the child abstract pathname is resolved against the parent.

        Parameters:
        parent - The parent abstract pathname
        child - The child pathname string

      • PlaceholderDirectory

        public PlaceholderDirectory​(URI uri)
        Creates a new File instance by converting the given file: URI into an abstract pathname.

        The exact form of a file: URI is system-dependent, hence the transformation performed by this constructor is also system-dependent.

        For a given abstract pathname f it is guaranteed that

        new File( f.toURI()).equals( f.getAbsoluteFile())
        so long as the original abstract pathname, the URI, and the new abstract pathname are all created in (possibly different invocations of) the same Java virtual machine. This relationship typically does not hold, however, when a file: URI that is created in a virtual machine on one operating system is converted into an abstract pathname in a virtual machine on a different operating system.
        Parameters:
        uri - An absolute, hierarchical URI with a scheme equal to "file", a non-empty path component, and undefined authority, query, and fragment components

    • Method Detail

      • createFile

        public PlaceholderFile createFile​(String name)
        Creates a file object using this directory and the specified name.
        Parameters:
        name - the filename (no path)
        Returns:
        the combine dir/filename