Path (Alfresco 5.1.4.1 Public Java API)

org.alfresco.service.cmr.repository

org.alfresco.service.cmr.repository.Path

All Implemented Interfaces:

@org.alfresco.api.AlfrescoPublicApi
public final class Path

Representation of a simple path e.g. /x/y/z
In the above example, there will be 4 elements, the first being a reference to the root node, followed by qname elements for x, y and z.

Methods and constructors are available to construct a Path instance from a path string or by building the path incrementally, including the ability to append and prepend path elements.

Path elements supported:

/{namespace}name fully qualified element
/name element using default namespace
/{namespace}name[n] nth sibling
/name[n] nth sibling using default namespace
/descendant-or-self::node() descendent or self
/. self
/.. parent

Nested Class Summary
static class	Path.AttributeElement Represents a qualified path to an attribute, including the sibling for repeated properties/attributes to retrieve e.g.
static class	Path.ChildAssocElement Represents a qualified path between a parent and a child node, including the sibling to retrieve e.g.
static class	Path.DescendentOrSelfElement Represents the // or /descendant-or-self::node() xpath element
abstract static class	Path.Element Represents a path element.
static class	Path.ParentElement Represents the /.. xpath element
static class	Path.SelfElement Represents the /. xpath element

Constructor Summary
Path()

Method Summary
Path	append(Path path) Append the given path of this path.
Path	append(Path.Element pathElement) Appends a path element to the end of the path
boolean	equals(Object o) Override equals to check equality of Path instances
Path.Element	first()
Path.Element	get(int n)
Path	getBaseNamePath(TenantService tenantService)
int	hashCode() Override hashCode to check hash equality of Path instances
Iterator<Path.Element>	iterator()
Path.Element	last()
Path	prepend(Path path) Merge the given path into the beginning of this path.
Path	prepend(Path.Element pathElement) Add a path element to the beginning of the path.
int	size()
Path	subPath(int depth) Return a new Path representing this path to the specified depth
Path	subPath(int start, int end) Return a new Path representing this path to the specified depth For example, subPath(2, 4) would return the third and forth elements in the Path.
String	toDisplayPath(NodeService nodeService, PermissionService permissionService) Return the human readable form of the specified node Path.
String	toPrefixString(NamespacePrefixResolver resolver)
String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

public Iterator<Path.Element> iterator()

iterator in interface Iterable<T>

Returns a typed iterator over the path elements

public Path prepend(Path.Element pathElement)

Add a path element to the beginning of the path. This operation is useful in cases where a path is built by traversing up a hierarchy.

pathElement - Path.Element

Returns this instance of the path

public Path prepend(Path path)

Merge the given path into the beginning of this path.

Returns this instance of the path

public Path append(Path.Element pathElement)

Appends a path element to the end of the path

pathElement - Path.Element

Returns this instance of the path

public Path append(Path path)

Append the given path of this path.

Returns this instance of the path

public Path.Element first()

Returns the first element in the path or null if the path is empty

public Path.Element last()

Returns the last element in the path or null if the path is empty

public Path.Element get(int n)

public String toString()

toString in class Object

Returns a string path made up of the component elements of this instance

public String toPrefixString(NamespacePrefixResolver resolver)

Returns a string path made up of the component elements of this instance (prefixed where appropriate)

public String toDisplayPath(NodeService nodeService,
PermissionService permissionService)

Return the human readable form of the specified node Path. Slow version of the method that extracts the name of each node in the Path from the supplied NodeService.

human readable form of the Path excluding the final element

public Path subPath(int depth)

Return a new Path representing this path to the specified depth

depth - the path depth (0 based)

public Path subPath(int start,
int end)

Return a new Path representing this path to the specified depth For example, subPath(2, 4) would return the third and forth elements in the Path.

start - position (0 based)

end - position (0 based)

public boolean equals(Object o)

Override equals to check equality of Path instances

equals in class Object

public int hashCode()

Override hashCode to check hash equality of Path instances

hashCode in class Object

public Path getBaseNamePath(TenantService tenantService)

Java API documentation generated with DocFlex/Javadoc 1.6.1 using JavadocPro template set.