org.apache.hadoop.fs
Class Path

java.lang.Object
  org.apache.hadoop.fs.Path

All Implemented Interfaces:

Comparable

public class Path
extends Object
implements Comparable

Names a file or directory in a FileSystem. Path strings use slash as the directory separator. A path string is absolute if it begins with a slash.

Field Summary

static String	CUR_DIR
static String	SEPARATOR The directory separator, a slash.
static char	SEPARATOR_CHAR

Constructor Summary

Path(Path parent, Path child)
Resolve a child path against a parent path.

Path(Path parent, String child)
Resolve a child path against a parent path.

Path(String pathString)
Construct a path from a String.

Path(String parent, Path child)
Resolve a child path against a parent path.

Path(String parent, String child)
Resolve a child path against a parent path.

Path(String scheme, String authority, String path)
Construct a Path from components.

Path(URI aUri)
Construct a path from a URI

Method Summary

int	compareTo(Object o)
int	depth() Return the number of elements in this path.
boolean	equals(Object o)
FileSystem	getFileSystem(Configuration conf) Return the FileSystem that owns this Path.
String	getName() Returns the final component of this path.
Path	getParent() Returns the parent of a path or null if at root.
int	hashCode()
boolean	isAbsolute() True if the directory of this path is absolute.
Path	makeQualified(FileSystem fs) Returns a qualified path object.
Path	makeQualified(URI defaultUri, Path workingDir) Returns a qualified path object.
Path	suffix(String suffix) Adds a suffix to the final name in the path.
String	toString()
URI	toUri() Convert this to a URI.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

SEPARATOR

public static final String SEPARATOR

The directory separator, a slash.

See Also:

Constant Field Values

SEPARATOR_CHAR

public static final char SEPARATOR_CHAR

See Also:

Constant Field Values

CUR_DIR

public static final String CUR_DIR

See Also:

Constant Field Values

Constructor Detail

Path

public Path(String parent,
            String child)

Resolve a child path against a parent path.

Path

public Path(Path parent,
            String child)

Resolve a child path against a parent path.

Path

public Path(String parent,
            Path child)

Resolve a child path against a parent path.

Path

public Path(Path parent,
            Path child)

Resolve a child path against a parent path.

Path

public Path(String pathString)

Construct a path from a String. Path strings are URIs, but with unescaped elements and some additional normalization.

Path

public Path(String scheme,
            String authority,
            String path)

Construct a Path from components.

Path

public Path(URI aUri)

Construct a path from a URI

Method Detail

toUri

public URI toUri()

Convert this to a URI.

getFileSystem

public FileSystem getFileSystem(Configuration conf)
                         throws IOException

Return the FileSystem that owns this Path.

Throws:

IOException

isAbsolute

public boolean isAbsolute()

True if the directory of this path is absolute.

getName

public String getName()

Returns the final component of this path.

getParent

public Path getParent()

Returns the parent of a path or null if at root.

suffix

public Path suffix(String suffix)

Adds a suffix to the final name in the path.

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

compareTo

public int compareTo(Object o)

Specified by:

compareTo in interface Comparable

depth

public int depth()

Return the number of elements in this path.

makeQualified

public Path makeQualified(FileSystem fs)

Returns a qualified path object.

makeQualified

public Path makeQualified(URI defaultUri,
                          Path workingDir)

Returns a qualified path object.