Package org.apache.flink.core.fs

Class Path

java.lang.Object

org.apache.flink.core.fs.Path

All Implemented Interfaces:

Serializable, IOReadableWritable

@Public
public class Path
extends Object
implements IOReadableWritable, Serializable

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.

Tailing slashes are removed from the path.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static String	CUR_DIR	Character denoting the current directory.
static String	SEPARATOR	The directory separator, a slash.
static char	SEPARATOR_CHAR	The directory separator, a slash (character).

Constructor Summary

Constructors

Constructor	Description
Path()	Constructs a new (empty) path object (used to reconstruct path object after RPC call).
Path(String pathString)	Construct a path from a String.
Path(String parent, String child)	Resolve a child path against a parent path.
Path(String scheme, String authority, String path)	Construct a Path from a scheme, an authority and a path string.
Path(String parent, Path child)	Resolve a child path against a parent path.
Path(URI uri)	Constructs a path object from a given URI.
Path(Path parent, String child)	Resolve a child path against a parent path.
Path(Path parent, Path child)	Resolve a child path against a parent path.

Method Summary

Modifier and Type	Method	Description
int	compareTo(Object o)
int	depth()	Returns the number of elements in this path.
boolean	equals(Object o)
static Path	fromLocalFile(File file)	Creates a path for the given local file.
FileSystem	getFileSystem()	Returns the FileSystem that owns this Path.
String	getName()	Returns the final component of this path, i.e., everything that follows the last separator.
Path	getParent()	Returns the parent of a path, i.e., everything that precedes the last separator or null if at root.
String	getPath()	Return full path.
int	hashCode()
boolean	hasWindowsDrive()	Checks if the provided path string contains a windows drive letter.
boolean	isAbsolute()	Checks if the directory of this path is absolute.
Path	makeQualified(FileSystem fs)	Returns a qualified path object.
void	read(DataInputView in)	Reads the object's internal data from the given data input view.
Path	suffix(String suffix)	Adds a suffix to the final name in the path.
String	toString()
URI	toUri()	Converts the path object to a URI.
void	write(DataOutputView out)	Writes the object's internal data to the given data output view.

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

The directory separator, a slash (character).

See Also:

Constant Field Values

CUR_DIR

public static final String CUR_DIR

Character denoting the current directory.

See Also:

Constant Field Values

Constructor Detail

Path

public Path()

Constructs a new (empty) path object (used to reconstruct path object after RPC call).

Path

public Path(URI uri)

Constructs a path object from a given URI.

Parameters:

uri - the URI to construct the path object from

Path

public Path(String parent,
            String child)

Resolve a child path against a parent path.

Parameters:

parent - the parent path

child - the child path

Path

public Path(Path parent,
            String child)

Resolve a child path against a parent path.

Parameters:

parent - the parent path

child - the child path

Path

public Path(String parent,
            Path child)

Resolve a child path against a parent path.

Parameters:

parent - the parent path

child - the child path

Path

public Path(Path parent,
            Path child)

Resolve a child path against a parent path.

Parameters:

parent - the parent path

child - the child path

Path

public Path(String pathString)

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

Parameters:

pathString - the string to construct a path from

Path

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

Construct a Path from a scheme, an authority and a path string.

Parameters:

scheme - the scheme string

authority - the authority string

path - the path string

Method Detail

toUri

public URI toUri()

Converts the path object to a URI.

Returns:

the URI object converted from the path object

getFileSystem

public FileSystem getFileSystem()
                         throws IOException

Returns the FileSystem that owns this Path.

Returns:

the FileSystem that owns this Path

Throws:

IOException - thrown if the file system could not be retrieved

isAbsolute

public boolean isAbsolute()

Checks if the directory of this path is absolute.

Returns:

true if the directory of this path is absolute, false otherwise

getName

public String getName()

Returns the final component of this path, i.e., everything that follows the last separator.

Returns:

the final component of the path

getPath

public String getPath()

Return full path.

Returns:

full path

getParent

public Path getParent()

Returns the parent of a path, i.e., everything that precedes the last separator or null if at root.

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.

Parameters:

suffix - The suffix to be added

Returns:

the new path including the suffix

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)

depth

public int depth()

Returns the number of elements in this path.

Returns:

the number of elements in this path

makeQualified

public Path makeQualified(FileSystem fs)

Returns a qualified path object.

Parameters:

fs - the FileSystem that should be used to obtain the current working directory

Returns:

the qualified path object

read

public void read(DataInputView in)
          throws IOException

Description copied from interface: IOReadableWritable

Reads the object's internal data from the given data input view.

Specified by:

read in interface IOReadableWritable

Parameters:

in - the input view to read the data from

Throws:

IOException - thrown if any error occurs while reading from the input stream

write

public void write(DataOutputView out)
           throws IOException

Description copied from interface: IOReadableWritable

Writes the object's internal data to the given data output view.

Specified by:

write in interface IOReadableWritable

Parameters:

out - the output view to receive the data.

Throws:

IOException - thrown if any error occurs while writing to the output stream

hasWindowsDrive

public boolean hasWindowsDrive()

Checks if the provided path string contains a windows drive letter.

Returns:

True, if the path string contains a windows drive letter, false otherwise.

fromLocalFile

public static Path fromLocalFile(File file)

Creates a path for the given local file.

This method is useful to make sure the path creation for local files works seamlessly across different operating systems. Especially Windows has slightly different rules for slashes between schema and a local file path, making it sometimes tricky to produce cross-platform URIs for local files.

Parameters:

file - The file that the path should represent.

Returns:

A path representing the local file URI of the given file.