org.apache.jackrabbit.oak.plugins.identifier

Class IdentifierManager

java.lang.Object

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

public class IdentifierManager
extends java.lang.Object

TODO document

Constructor Summary

Constructors

Constructor and Description
IdentifierManager(Root root)

Method Summary

Modifier and Type	Method and Description
static @NotNull java.lang.String	generateUUID() Deprecated. Use UUIDUtils.generateUUID()
static @NotNull java.lang.String	generateUUID(java.lang.String hint) Deprecated. Use UUIDUtils.generateUUID(String)
static @NotNull java.lang.String	getIdentifier(Tree tree) Return the identifier of a tree.
@Nullable java.lang.String	getPath(PropertyState referenceValue) Returns the path of the tree references by the specified (weak) reference PropertyState.
@Nullable java.lang.String	getPath(PropertyValue referenceValue) Returns the path of the tree references by the specified (weak) reference PropertyState.
@Nullable java.lang.String	getPath(java.lang.String identifier) The path of the tree identified by the specified identifier or null.
@NotNull java.lang.Iterable<java.lang.String>	getReferences(boolean weak, @NotNull Tree tree, @Nullable java.lang.String propertyName) Searches all reference properties to the specified tree that match the given name and node type constraints.
@NotNull java.lang.Iterable<java.lang.String>	getReferences(@NotNull Tree tree, @NotNull java.lang.String propertyName, @NotNull java.lang.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).
@Nullable Tree	getTree(java.lang.String identifier) The possibly non existing tree identified by the specified identifier or null.
static boolean	isValidUUID(java.lang.String uuid) Deprecated. Use UUIDUtils.isValidUUID(String) (String)}
@Nullable java.lang.String	resolveUUID(java.lang.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

@NotNull
public static @NotNull java.lang.String generateUUID()

Deprecated. Use UUIDUtils.generateUUID()

generateUUID

@NotNull
public static @NotNull java.lang.String generateUUID(java.lang.String hint)

Deprecated. Use UUIDUtils.generateUUID(String)

isValidUUID

public static boolean isValidUUID(java.lang.String uuid)

Deprecated. Use UUIDUtils.isValidUUID(String) (String)}

getIdentifier

@NotNull
public static @NotNull java.lang.String getIdentifier(Tree tree)

Return the identifier of a tree.

Parameters:

tree - a tree

Returns:

identifier of tree

getTree

@Nullable
public @Nullable Tree getTree(java.lang.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

@Nullable
public @Nullable java.lang.String getPath(java.lang.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

@Nullable
public @Nullable java.lang.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

@Nullable
public @Nullable java.lang.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

@NotNull
public @NotNull java.lang.Iterable<java.lang.String> getReferences(boolean weak,
                                                                            @NotNull
                                                                            @NotNull Tree tree,
                                                                            @Nullable
                                                                            @Nullable java.lang.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

@NotNull
public @NotNull java.lang.Iterable<java.lang.String> getReferences(@NotNull
                                                                            @NotNull Tree tree,
                                                                            @NotNull
                                                                            @NotNull java.lang.String propertyName,
                                                                            @NotNull
                                                                            @NotNull java.lang.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

@Nullable
public @Nullable java.lang.String resolveUUID(java.lang.String uuid)