org.onosproject.store.service

Class DocumentPath

java.lang.Object

org.onosproject.store.service.DocumentPath

All Implemented Interfaces:

Comparable<DocumentPath>

public class DocumentPath
extends Object
implements Comparable<DocumentPath>

Unique key for nodes in the DocumentTree.

Constructor Summary

Constructors

Constructor and Description
DocumentPath(String nodeName, DocumentPath parentPath) Constructs a new document path.

Method Summary

Modifier and Type	Method and Description
DocumentPath	childPath() Returns the relative path to the given node.
int	compareTo(DocumentPath that)
boolean	equals(Object obj)
static DocumentPath	from(String path) Creates a new DocumentPath from a period delimited path string.
int	hashCode()
boolean	isAncestorOf(DocumentPath other) Returns if the specified path belongs to a direct ancestor of the node pointed at by this path.
boolean	isDescendentOf(DocumentPath other) Returns if the specified path is belongs to a subtree rooted this path.
static DocumentPath	leastCommonAncestor(Collection<DocumentPath> paths) Returns the path that points to the least common ancestor of the specified collection of paths.
DocumentPath	parent() Returns a path for the parent of this node.
List<String>	pathElements() Returns the list of path elements representing this path in correct order.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

DocumentPath

public DocumentPath(String nodeName,
                    DocumentPath parentPath)

Constructs a new document path.

New paths must contain at least one name and string names may NOT contain any period characters. If one field is null that field will be ignored.

Parameters:

nodeName - the name of the last level of this path

parentPath - the path representing the parent leading up to this node, in the case of the root this should be null

Throws:

IllegalDocumentNameException - if both parameters are null or name contains an illegal character ('.')

Method Detail

from

public static DocumentPath from(String path)

Creates a new DocumentPath from a period delimited path string.

Parameters:

path - path string

Returns:

DocumentPath instance

childPath

public DocumentPath childPath()

Returns the relative path to the given node.

Returns:

relative path to the given node.

parent

public DocumentPath parent()

Returns a path for the parent of this node.

Returns:

parent node path. If this path is for the root, returns null.

pathElements

public List<String> pathElements()

Returns the list of path elements representing this path in correct order.

Returns:

a list of elements that make up this path

isAncestorOf

public boolean isAncestorOf(DocumentPath other)

Returns if the specified path belongs to a direct ancestor of the node pointed at by this path.

Example: root.a is a direct ancestor of r.a.b.c; while r.a.x is not.

Parameters:

other - other path

Returns:

true is yes; false otherwise.

isDescendentOf

public boolean isDescendentOf(DocumentPath other)

Returns if the specified path is belongs to a subtree rooted this path.

Example: root.a.b and root.a.b.c.d.e are descendants of r.a.b; while r.a.x.c is not.

Parameters:

other - other path

Returns:

true is yes; false otherwise.

leastCommonAncestor

public static DocumentPath leastCommonAncestor(Collection<DocumentPath> paths)

Returns the path that points to the least common ancestor of the specified collection of paths.

Parameters:

paths - collection of path

Returns:

path to least common ancestor

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object

compareTo

public int compareTo(DocumentPath that)

Specified by:

compareTo in interface Comparable<DocumentPath>