org.apache.jackrabbit.oak.util

Class TreeUtil

java.lang.Object

org.apache.jackrabbit.oak.util.TreeUtil

public final class TreeUtil
extends Object

Utility providing common operations for the Tree that are not provided by the API.

Method Summary

Modifier and Type	Method and Description
static Tree	addChild(Tree parent, String name, String typeName, Tree typeRoot, String userID)
static void	addMixin(Tree tree, String mixinName, Tree typeRoot, String userID)
static void	autoCreateItems(Tree tree, Tree type, Tree typeRoot, String userID)
static PropertyState	autoCreateProperty(String name, Tree definition, String userID)
static String	findDefaultPrimaryType(Tree definitions, boolean sns)
static boolean	getBoolean(Tree tree, String propertyName) Returns the boolean representation of the property with the specified propertyName.
static String	getDefaultChildType(Tree typeRoot, Tree parent, String childName) Finds the default primary type for a new child node with the given name.
static List<Tree>	getEffectiveType(Tree tree, Tree typeRoot) Returns the effective node types of the given node.
static String	getName(Tree tree, String name)
static Iterable<String>	getNames(Tree tree, String name)
static String	getPrimaryTypeName(Tree tree)
static String	getString(Tree tree, String propertyName)
static Iterable<String>	getStrings(Tree tree, String propertyName)
static Tree	getTree(Tree tree, String path) Return the possibly non existing tree located at the passed path from the location of the start tree or null if path results in a parent of the root.
static boolean	isNodeType(Tree tree, String typeName, Tree typeRoot)
static boolean	isReadOnlyTree(Tree tree) Returns true if the specified tree is a read-only tree such as obtained through TreeFactory or a read-only Root.

Methods inherited from class java.lang.Object

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

Method Detail

getPrimaryTypeName

public static String getPrimaryTypeName(Tree tree)

getStrings

public static Iterable<String> getStrings(Tree tree,
                                          String propertyName)

getString

public static String getString(Tree tree,
                               String propertyName)

getBoolean

public static boolean getBoolean(Tree tree,
                                 String propertyName)

Returns the boolean representation of the property with the specified propertyName. If the property does not exist or is an array this method returns false.

Parameters:

tree - The target tree.

propertyName - The name of the property.

Returns:

the boolean representation of the property state with the given name. This utility returns false if the property does not exist or is an multivalued property.

getName

public static String getName(Tree tree,
                             String name)

getNames

public static Iterable<String> getNames(Tree tree,
                                        String name)

getTree

public static Tree getTree(Tree tree,
                           String path)

Return the possibly non existing tree located at the passed path from the location of the start tree or null if path results in a parent of the root.

Parameters:

tree - start tree

path - path from the start tree

Returns:

tree located at path from start or null

addChild

public static Tree addChild(Tree parent,
                            String name,
                            String typeName,
                            Tree typeRoot,
                            String userID)
                     throws RepositoryException

Throws:

RepositoryException

addMixin

public static void addMixin(Tree tree,
                            String mixinName,
                            Tree typeRoot,
                            String userID)
                     throws RepositoryException

Throws:

RepositoryException

autoCreateItems

public static void autoCreateItems(Tree tree,
                                   Tree type,
                                   Tree typeRoot,
                                   String userID)
                            throws RepositoryException

Throws:

RepositoryException

autoCreateProperty

public static PropertyState autoCreateProperty(String name,
                                               Tree definition,
                                               String userID)

getDefaultChildType

public static String getDefaultChildType(Tree typeRoot,
                                         Tree parent,
                                         String childName)

Finds the default primary type for a new child node with the given name.

Parameters:

typeRoot - root of the /jcr:system/jcr:nodeTypes tree

parent - parent node

childName - name of the new child node

Returns:

name of the default type, or null if not available

getEffectiveType

public static List<Tree> getEffectiveType(Tree tree,
                                          Tree typeRoot)

Returns the effective node types of the given node.

findDefaultPrimaryType

public static String findDefaultPrimaryType(Tree definitions,
                                            boolean sns)

isNodeType

public static boolean isNodeType(Tree tree,
                                 String typeName,
                                 Tree typeRoot)

isReadOnlyTree

public static boolean isReadOnlyTree(Tree tree)

Returns true if the specified tree is a read-only tree such as obtained through TreeFactory or a read-only Root.

Parameters:

tree - The tree object to be tested.

Returns:

true if the specified tree is an immutable read-only tree.

See Also:

TreeFactory.createReadOnlyTree(org.apache.jackrabbit.oak.spi.state.NodeState), RootFactory.createReadOnlyRoot(org.apache.jackrabbit.oak.spi.state.NodeState)