org.apache.hadoop.fs.swift.util

Class SwiftObjectPath

java.lang.Object

org.apache.hadoop.fs.swift.util.SwiftObjectPath

public final class SwiftObjectPath
extends Object

Swift hierarchy mapping of (container, path)

Constructor Summary

Constructors

Constructor and Description
SwiftObjectPath(String container, String object) Build an instance from a (host, object) pair

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object o)
static SwiftObjectPath	fromPath(URI uri, Path path) Create a path tuple of (container, path), where the container is chosen from the host of the URI.
static SwiftObjectPath	fromPath(URI uri, Path path, boolean addTrailingSlash) Create a path tuple of (container, path), where the container is chosen from the host of the URI.
String	getContainer()
String	getObject()
int	hashCode()
boolean	isEqualToOrParentOf(SwiftObjectPath possibleChild) Query to see if the possibleChild object is a child path of this.
boolean	objectMatches(String path) Test for the object matching a path, ignoring the container value.
String	toString()
String	toUriPath()

Methods inherited from class java.lang.Object

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

Constructor Detail

SwiftObjectPath

public SwiftObjectPath(String container,
                       String object)

Build an instance from a (host, object) pair

Parameters:

container - container name

object - object ref underneath the container

Method Detail

getContainer

public String getContainer()

getObject

public String getObject()

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toUriPath

public String toUriPath()

toString

public String toString()

Overrides:

toString in class Object

objectMatches

public boolean objectMatches(String path)

Test for the object matching a path, ignoring the container value.

Parameters:

path - path string

Returns:

true iff the object's name matches the path

isEqualToOrParentOf

public boolean isEqualToOrParentOf(SwiftObjectPath possibleChild)

Query to see if the possibleChild object is a child path of this. object. The test is done by probing for the path of the this object being at the start of the second -with a trailing slash, and both containers being equal

Parameters:

possibleChild - possible child dir

Returns:

true iff the possibleChild is under this object

fromPath

public static SwiftObjectPath fromPath(URI uri,
                                       Path path)
                                throws SwiftConfigurationException

Create a path tuple of (container, path), where the container is chosen from the host of the URI.

Parameters:

uri - uri to start from

path - path underneath

Returns:

a new instance.

Throws:

SwiftConfigurationException - if the URI host doesn't parse into container.service

fromPath

public static SwiftObjectPath fromPath(URI uri,
                                       Path path,
                                       boolean addTrailingSlash)
                                throws SwiftConfigurationException

Create a path tuple of (container, path), where the container is chosen from the host of the URI. A trailing slash can be added to the path. This is the point where these /-es need to be appended, because when you construct a Path instance, Path.normalizePath(String, String) is called -which strips off any trailing slash.

Parameters:

uri - uri to start from

path - path underneath

addTrailingSlash - should a trailing slash be added if there isn't one.

Returns:

a new instance.

Throws:

SwiftConfigurationException - if the URI host doesn't parse into container.service