org.apache.jackrabbit.oak.plugins.tree

Class TreeLocation

java.lang.Object

org.apache.jackrabbit.oak.plugins.tree.TreeLocation

public abstract class TreeLocation
extends Object

A TreeLocation denotes a location inside a tree.

It can either refer to a inner node (that is a Tree), to a leaf (that is a PropertyState) or to an invalid location which refers to neither of the former. TreeLocation instances provide methods for navigating trees such that navigation always results in new TreeLocation instances. Navigation never fails. Errors are deferred until the underlying item itself is accessed. That is, if a TreeLocation points to an item which does not exist or is unavailable otherwise (i.e. due to access control restrictions) accessing the tree will return null at this point.

Constructor Summary

Constructors

Constructor and Description
TreeLocation()

Method Summary

Modifier and Type	Method and Description
static TreeLocation	create(Root root) Equivalent to create(root, "/")
static TreeLocation	create(Root root, String path) Create a new TreeLocation instance for the item at the given path in root.
static TreeLocation	create(Tree tree) Create a new TreeLocation instance for a tree
abstract boolean	exists() Determine whether the underlying Tree or PropertyState for this TreeLocation is available.
TreeLocation	getChild(String name) Navigate to a child of the given name.
abstract String	getName() The name of this location
abstract TreeLocation	getParent() Navigate to the parent or an invalid location for the root of the hierarchy.
abstract String	getPath() The path of this location
PropertyState	getProperty() Get the underlying PropertyState for this TreeLocation.
Tree	getTree() Get the underlying Tree for this TreeLocation.
abstract boolean	remove() Remove the underlying item.
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

TreeLocation

public TreeLocation()

Method Detail

create

public static TreeLocation create(@Nonnull
                                  Tree tree)

Create a new TreeLocation instance for a tree

create

public static TreeLocation create(Root root,
                                  String path)

Create a new TreeLocation instance for the item at the given path in root.

create

public static TreeLocation create(Root root)

Equivalent to create(root, "/")

getParent

@Nonnull
public abstract TreeLocation getParent()

Navigate to the parent or an invalid location for the root of the hierarchy.

Returns:

a TreeLocation for the parent of this location.

exists

public abstract boolean exists()

Determine whether the underlying Tree or PropertyState for this TreeLocation is available.

Returns:

true if the underlying item is available and has not been disconnected.

See Also:

Tree.exists()

getName

@Nonnull
public abstract String getName()

The name of this location

Returns:

name

getPath

@Nonnull
public abstract String getPath()

The path of this location

Returns:

path

remove

public abstract boolean remove()

Remove the underlying item.

Returns:

true if the item was removed, false otherwise.

getChild

@Nonnull
public TreeLocation getChild(String name)

Navigate to a child of the given name.

Parameters:

name - name of the child

Returns:

this default implementation return a non existing location

getTree

@CheckForNull
public Tree getTree()

Get the underlying Tree for this TreeLocation.

Returns:

this default implementation return null.

getProperty

@CheckForNull
public PropertyState getProperty()

Get the underlying PropertyState for this TreeLocation.

Returns:

this default implementation return null.

toString

public String toString()

Overrides:

toString in class Object