org.apache.jackrabbit.jcr2spi
Interface ItemManager

All Superinterfaces:

ItemLifeCycleListener

All Known Implementing Classes:

ItemManagerImpl

public interface ItemManager
extends ItemLifeCycleListener

There's one ItemManager instance per Session instance. It is the factory for Node and Property instances.

The ItemManager's responsabilities are:

• providing access to Item instances by ItemState whereas Node and Item are only providing relative access.
• returning the instance of an existing Node or Property, given its absolute path.
• creating the per-session instance of a Node or Property that doesn't exist yet and needs to be created first.
• guaranteeing that there aren't multiple instances representing the same Node or Property associated with the same Session instance.
• maintaining a cache of the item instances it created.

If the parent Session is an XASession, there is one ItemManager instance per started global transaction.

Method Summary

void	dispose() Disposes this ItemManager and frees resources.
NodeIterator	getChildNodes(NodeEntry parentEntry)
PropertyIterator	getChildProperties(NodeEntry parentEntry)
Item	getItem(HierarchyEntry hierarchyEntry)
Item	getItem(Path path)
boolean	hasChildNodes(NodeEntry parentEntry)
boolean	hasChildProperties(NodeEntry parentEntry)
boolean	itemExists(HierarchyEntry hierarchyEntry) Checks if the item for given HierarchyEntry exists.
boolean	itemExists(Path path) Checks if the item with the given path exists.

Methods inherited from interface org.apache.jackrabbit.jcr2spi.ItemLifeCycleListener

itemCreated, itemDestroyed, itemInvalidated

Method Detail

dispose

void dispose()

Disposes this ItemManager and frees resources.

itemExists

boolean itemExists(Path path)

Checks if the item with the given path exists.

Parameters:

path - path to the item to be checked

Returns:

true if the specified item exists

itemExists

boolean itemExists(HierarchyEntry hierarchyEntry)

Checks if the item for given HierarchyEntry exists.

Parameters:

hierarchyEntry -

Returns:

true if the specified item exists

getItem

Item getItem(Path path)
             throws PathNotFoundException,
                    AccessDeniedException,
                    RepositoryException

Parameters:

path -

Returns:

The item for the given path.

Throws:

PathNotFoundException

AccessDeniedException

RepositoryException

getItem

Item getItem(HierarchyEntry hierarchyEntry)
             throws ItemNotFoundException,
                    AccessDeniedException,
                    RepositoryException

Parameters:

hierarchyEntry -

Returns:

Throws:

ItemNotFoundException

AccessDeniedException

RepositoryException

hasChildNodes

boolean hasChildNodes(NodeEntry parentEntry)
                      throws ItemNotFoundException,
                             AccessDeniedException,
                             RepositoryException

Parameters:

parentEntry -

Returns:

Throws:

ItemNotFoundException

AccessDeniedException

RepositoryException

getChildNodes

NodeIterator getChildNodes(NodeEntry parentEntry)
                           throws ItemNotFoundException,
                                  AccessDeniedException,
                                  RepositoryException

Parameters:

parentEntry -

Returns:

Throws:

ItemNotFoundException

AccessDeniedException

RepositoryException

hasChildProperties

boolean hasChildProperties(NodeEntry parentEntry)
                           throws ItemNotFoundException,
                                  AccessDeniedException,
                                  RepositoryException

Parameters:

parentEntry -

Returns:

Throws:

ItemNotFoundException

AccessDeniedException

RepositoryException

getChildProperties

PropertyIterator getChildProperties(NodeEntry parentEntry)
                                    throws ItemNotFoundException,
                                           AccessDeniedException,
                                           RepositoryException

Parameters:

parentEntry -

Returns:

Throws:

ItemNotFoundException

AccessDeniedException

RepositoryException