Module datarush.commons
Package com.pervasive.datarush.io

Interface Path

  • All Superinterfaces:
    Serializable
    All Known Implementing Classes:
    AzureFilePath, FTPPath, GcpFilePath, HadoopFilePath
    public interface Path
extends Serializable
    An abstract identifier for a resource. A Path represents a location in a FileSystem. Paths are normally constructed via the methods available in Paths.

    Paths present a hierarchical structure for locating resources, identifying a resource based on a sequential traversal of elements, typically starting from some root. The methods of this interface deal only with the structural aspects of paths, not with the data which they identified. To actually access the data represented by a path, use the methods found in FileClient.

    Paths are identified using a URI-like syntax, using a scheme prefix of : to identify the type of file system. The remainder identifies the specific instance of the file system and the path to the element. The local file system is a special exception. While the file scheme is recognized, a scheme is not required; path strings with no scheme are assumed to be local files. Some examples of path strings are: 

     file:/home/myuser/myfile
 C:\temp\myfile
 ../siblingfile
 hdfs://namenode:9000/path/to/file

    It is only necessary to implement a Path if writing a new file system scheme, in which case it is necessary to also implement a FileSystemProvider and FileSystem as well.

    • Method Detail

      • getFileSystemProvider

        FileSystemProvider getFileSystemProvider()
        Gets the file system provider for this path.
        Returns:
        the file system provider associated with the path

      • isAbsolute

        boolean isAbsolute()
        Indicates whether the path is absolute or relative. That is, does the path start from the root of the associated file system.

        For most file systems, all paths are absolute.

        Returns:
        true if the path starts from the file system root, false otherwise.

      • toAbsolutePath

        Path toAbsolutePath()
        Converts a relative path into an absolute path.
        Returns:
        the absolute path pointing to the same location. If the path is already absolute, it is returned.

      • getParent

        Path getParent()
        Gets the path referring to the location containing the path.
        Returns:
        the path to the container of this path, null if this path is the root.

      • getName

        String getName()
        Gets the last element of the path.
        Returns:
        the last element of the path.

      • resolve

        Path resolve​(String childPath)
        Adds additional elements to the path. The provided string is interpreted as a relative path starting from the path's location.
        Parameters:
        childPath - the
        Returns:
        the resulting path

      • toFile

        File toFile()
        Gets the local file corresponding to the path. This only makes sense when the path refers to the local file system. For other paths, it always returns null.
        Returns:
        the file which this path identifies or null if it does not identify a file on the local file system.

      • toURL

        String toURL()
        Returns the URL string corresponding to this path.
        Returns:
        The URL string for this path, or null if this path cannot be mapped to a URL.

      • toString

        String toString()
        Gets the string representation of the path. It must be true that Paths.asPath(path.toString()) refers to the same location as path. However, it may not the case that pathString.equals(Paths.asPath(pathString).toString()).
        Overrides:
        toString in class Object
        Returns:
        the string representation of the path