org.apache.jackrabbit.oak.plugins.identifier

Class IdentifierManager

java.lang.Object

org.apache.jackrabbit.oak.plugins.identifier.IdentifierManager

public class IdentifierManager
extends Object

TODO document

Constructor Summary

Constructors

Constructor and Description
IdentifierManager(Root root)

Method Summary

Modifier and Type	Method and Description
static String	generateUUID()
static String	generateUUID(String hint)
static String	getIdentifier(Tree tree) Return the identifier of a tree.
String	getPath(PropertyState referenceValue) Returns the path of the tree references by the specified (weak) reference PropertyState.
String	getPath(PropertyValue referenceValue) Returns the path of the tree references by the specified (weak) reference PropertyState.
String	getPath(String identifier) The path of the tree identified by the specified identifier or null.
Iterable<String>	getReferences(boolean weak, Tree tree, String propertyName) Searches all reference properties to the specified tree that match the given name and node type constraints.
Iterable<String>	getReferences(Tree tree, String propertyName, String ntName, boolean weak) Searches all reference properties to the specified tree that match the given propertyName and the specified, mandatory node type constraint (ntName).
Tree	getTree(String identifier) The possibly non existing tree identified by the specified identifier or null.
static boolean	isValidUUID(String uuid)
String	resolveUUID(String uuid)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

IdentifierManager

public IdentifierManager(Root root)

Method Detail

generateUUID

public static String generateUUID()

generateUUID

public static String generateUUID(String hint)

isValidUUID

public static boolean isValidUUID(String uuid)

getIdentifier

public static String getIdentifier(Tree tree)

Return the identifier of a tree.

Parameters:

tree - a tree

Returns:

identifier of tree

getTree

public Tree getTree(String identifier)

The possibly non existing tree identified by the specified identifier or null.

Parameters:

identifier - The identifier of the tree such as exposed by getIdentifier(Tree)

Returns:

The tree with the given identifier or null if no such tree exists.

getPath

public String getPath(String identifier)

The path of the tree identified by the specified identifier or null.

Parameters:

identifier - The identifier of the tree such as exposed by getIdentifier(Tree)

Returns:

The path of the tree with the given identifier or null if no such tree exists or if the tree is not accessible.

getPath

public String getPath(PropertyState referenceValue)

Returns the path of the tree references by the specified (weak) reference PropertyState.

Parameters:

referenceValue - A (weak) reference value.

Returns:

The tree with the given identifier or null if no such tree exists or isn't accessible to the content session.

getPath

public String getPath(PropertyValue referenceValue)

Returns the path of the tree references by the specified (weak) reference PropertyState.

Parameters:

referenceValue - A (weak) reference value.

Returns:

The tree with the given identifier or null if no such tree exists or isn't accessible to the content session.

getReferences

public Iterable<String> getReferences(boolean weak,
                                      Tree tree,
                                      String propertyName)

Searches all reference properties to the specified tree that match the given name and node type constraints.

Parameters:

weak - if true only weak references are returned. Otherwise only hard references are returned.

tree - The tree for which references should be searched.

propertyName - A name constraint for the reference properties; null if no constraint should be enforced.

Returns:

A set of oak paths of those reference properties referring to the specified tree and matching the constraints.

getReferences

public Iterable<String> getReferences(Tree tree,
                                      String propertyName,
                                      String ntName,
                                      boolean weak)

Searches all reference properties to the specified tree that match the given propertyName and the specified, mandatory node type constraint (ntName). In contrast to getReferences(boolean, org.apache.jackrabbit.oak.api.Tree, java.lang.String) this method requires all parameters to be specified, which eases the handling of the result set and doesn't require the trees associated with the result set to be resolved.

Parameters:

tree - The tree for which references should be searched.

propertyName - The name of the reference properties.

ntName - The node type name to be used for the query.

weak - if true only weak references are returned. Otherwise on hard references are returned.

Returns:

A set of oak paths of those reference properties referring to the specified tree and matching the constraints.

resolveUUID

public String resolveUUID(String uuid)