org.apache.jackrabbit.jcr2spi.hierarchy
Interface HierarchyManager

All Known Implementing Classes:

HierarchyManagerImpl

public interface HierarchyManager

HierarchyManager...

Method Summary

void	dispose() Dispose this HierarchyManager
int	getDepth(HierarchyEntry hierarchyEntry) Returns the depth of the specified item.
NodeEntry	getNodeEntry(NodeId nodeId) Resolves a itemId into a HierarchyEntry.
NodeEntry	getNodeEntry(Path qPath) Resolves a path into a NodeEntry.
NodeState	getNodeState(Path qPath) Retrieves the NodeEntry corresponding to the given path and resolves it to the underlying NodeState.
PropertyEntry	getPropertyEntry(Path qPath) Resolves a path into a PropertyEntry.
PropertyEntry	getPropertyEntry(PropertyId propertyId) Resolves a propertyId into a PropertyEntry.
PropertyState	getPropertyState(Path qPath) Retrieves the PropertyEntry corresponding to the given path and resolves it to the underlying PropertyState.
int	getRelativeDepth(NodeEntry ancestor, HierarchyEntry descendant) Returns the depth of the specified descendant relative to the given ancestor.
NodeEntry	getRootEntry()
HierarchyEntry	lookup(ItemId workspaceItemId) Lookup of HierarchyEntry by its workspace Id that may be different if a entry (or any of its ancestors) has been transiently moved or reordered. If the Hierarchy already lists the entry with the given workspaceItemId it is returned otherwise null.
HierarchyEntry	lookup(Path workspacePath) Lookup of HierarchyEntry by its workspace path that may be different if a entry (or any of its ancestors) has been transiently moved or reordered. If the Hierarchy already lists the entry with the given path it is returned otherwise null.

Method Detail

dispose

void dispose()

Dispose this HierarchyManager

getRootEntry

NodeEntry getRootEntry()

Returns:

the root entry.

lookup

HierarchyEntry lookup(ItemId workspaceItemId)

Lookup of HierarchyEntry by its workspace Id that may be different if a entry (or any of its ancestors) has been transiently moved or reordered.

If the Hierarchy already lists the entry with the given workspaceItemId it is returned otherwise null. See getNodeEntry(NodeId) or getPropertyEntry(PropertyId) for methods that resolves the ItemId including lookup in the persistence layer if the entry has not been loaded yet.

Parameters:

workspaceItemId -

Returns:

the HierarchyEntry with the given workspaceItemId.

lookup

HierarchyEntry lookup(Path workspacePath)

Lookup of HierarchyEntry by its workspace path that may be different if a entry (or any of its ancestors) has been transiently moved or reordered.

If the Hierarchy already lists the entry with the given path it is returned otherwise null. See getNodeEntry(Path) or getPropertyEntry(Path) for methods that resolves the path including lookup in the persistence layer if the entry has not been loaded yet.

Parameters:

workspacePath -

Returns:

the HierarchyEntry with the given workspacePath.

getNodeEntry

NodeEntry getNodeEntry(NodeId nodeId)
                       throws javax.jcr.ItemNotFoundException,
                              javax.jcr.RepositoryException

Resolves a itemId into a HierarchyEntry.

Parameters:

nodeId -

Returns:

Throws:

javax.jcr.PathNotFoundException

javax.jcr.RepositoryException

javax.jcr.ItemNotFoundException

getNodeEntry

NodeEntry getNodeEntry(Path qPath)
                       throws javax.jcr.PathNotFoundException,
                              javax.jcr.RepositoryException

Resolves a path into a NodeEntry.

Parameters:

qPath -

Returns:

Throws:

javax.jcr.PathNotFoundException

javax.jcr.RepositoryException

getPropertyEntry

PropertyEntry getPropertyEntry(PropertyId propertyId)
                               throws javax.jcr.ItemNotFoundException,
                                      javax.jcr.RepositoryException

Resolves a propertyId into a PropertyEntry.

Parameters:

propertyId -

Returns:

Throws:

javax.jcr.PathNotFoundException

javax.jcr.RepositoryException

javax.jcr.ItemNotFoundException

getPropertyEntry

PropertyEntry getPropertyEntry(Path qPath)
                               throws javax.jcr.PathNotFoundException,
                                      javax.jcr.RepositoryException

Resolves a path into a PropertyEntry.

Parameters:

qPath -

Returns:

Throws:

javax.jcr.PathNotFoundException

javax.jcr.RepositoryException

getNodeState

NodeState getNodeState(Path qPath)
                       throws javax.jcr.PathNotFoundException,
                              javax.jcr.RepositoryException

Retrieves the NodeEntry corresponding to the given path and resolves it to the underlying NodeState.

Parameters:

qPath -

Returns:

Throws:

javax.jcr.PathNotFoundException

javax.jcr.RepositoryException

getPropertyState

PropertyState getPropertyState(Path qPath)
                               throws javax.jcr.PathNotFoundException,
                                      javax.jcr.RepositoryException

Retrieves the PropertyEntry corresponding to the given path and resolves it to the underlying PropertyState.

Parameters:

qPath -

Returns:

Throws:

javax.jcr.PathNotFoundException

javax.jcr.RepositoryException

getDepth

int getDepth(HierarchyEntry hierarchyEntry)
             throws javax.jcr.ItemNotFoundException,
                    javax.jcr.RepositoryException

Returns the depth of the specified item. The depth reflects the absolute hierarchy level.

Parameters:

hierarchyEntry -

Returns:

the depth of the specified item

Throws:

javax.jcr.RepositoryException - if another error occurs

javax.jcr.ItemNotFoundException

getRelativeDepth

int getRelativeDepth(NodeEntry ancestor,
                     HierarchyEntry descendant)
                     throws javax.jcr.ItemNotFoundException,
                            javax.jcr.RepositoryException

Returns the depth of the specified descendant relative to the given ancestor. If ancestor and descendant denote the same item 0 is returned. If ancestor does not denote an ancestor -1 is returned.

Parameters:

ancestor - NodeEntry that must be an ancestor of the descendant

descendant - HierarchyEntry

Returns:

the relative depth; -1 if ancestor does not denote an ancestor of the item denoted by descendant (or itself).

Throws:

javax.jcr.ItemNotFoundException - If either of the specified id's does not denote an existing item.

javax.jcr.RepositoryException - If another error occurs.