org.apache.jackrabbit.jcr2spi

Interface ItemManager

All Known Implementing Classes:

ItemManagerImpl

public interface ItemManager

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

The ItemManager's responsibilities 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

Methods

Modifier and Type	Method and Description
void	dispose() Disposes this ItemManager and frees resources.
javax.jcr.NodeIterator	getChildNodes(NodeEntry parentEntry)
javax.jcr.PropertyIterator	getChildProperties(NodeEntry parentEntry)
javax.jcr.Item	getItem(HierarchyEntry hierarchyEntry)
javax.jcr.Node	getNode(Path path)
javax.jcr.Property	getProperty(Path path)
boolean	hasChildNodes(NodeEntry parentEntry)
boolean	hasChildProperties(NodeEntry parentEntry)
boolean	itemExists(HierarchyEntry hierarchyEntry) Checks if the item for given HierarchyEntry exists.
boolean	nodeExists(Path path) Checks if the node with the given path exists.
boolean	propertyExists(Path path) Checks if the property with the given path exists.

Method Detail

dispose

void dispose()

Disposes this ItemManager and frees resources.

nodeExists

boolean nodeExists(Path path)
                   throws javax.jcr.RepositoryException

Checks if the node with the given path exists.

Parameters:

path - path to the node to be checked

Returns:

true if the specified item exists

Throws:

javax.jcr.RepositoryException

propertyExists

boolean propertyExists(Path path)
                       throws javax.jcr.RepositoryException

Checks if the property with the given path exists.

Parameters:

path - path to the property to be checked

Returns:

true if the specified item exists

Throws:

javax.jcr.RepositoryException

itemExists

boolean itemExists(HierarchyEntry hierarchyEntry)
                   throws javax.jcr.RepositoryException

Checks if the item for given HierarchyEntry exists.

Parameters:

hierarchyEntry -

Returns:

true if the specified item exists

Throws:

javax.jcr.RepositoryException

getNode

javax.jcr.Node getNode(Path path)
                       throws javax.jcr.PathNotFoundException,
                              javax.jcr.RepositoryException

Parameters:

path -

Returns:

Throws:

javax.jcr.PathNotFoundException

javax.jcr.RepositoryException

getProperty

javax.jcr.Property getProperty(Path path)
                               throws javax.jcr.PathNotFoundException,
                                      javax.jcr.RepositoryException

Parameters:

path -

Returns:

Throws:

javax.jcr.PathNotFoundException

javax.jcr.RepositoryException

getItem

javax.jcr.Item getItem(HierarchyEntry hierarchyEntry)
                       throws javax.jcr.ItemNotFoundException,
                              javax.jcr.RepositoryException

Parameters:

hierarchyEntry -

Returns:

Throws:

javax.jcr.ItemNotFoundException

javax.jcr.RepositoryException

hasChildNodes

boolean hasChildNodes(NodeEntry parentEntry)
                      throws javax.jcr.ItemNotFoundException,
                             javax.jcr.RepositoryException

Parameters:

parentEntry -

Returns:

Throws:

javax.jcr.ItemNotFoundException

javax.jcr.RepositoryException

getChildNodes

javax.jcr.NodeIterator getChildNodes(NodeEntry parentEntry)
                                     throws javax.jcr.ItemNotFoundException,
                                            javax.jcr.RepositoryException

Parameters:

parentEntry -

Returns:

Throws:

javax.jcr.ItemNotFoundException

javax.jcr.RepositoryException

hasChildProperties

boolean hasChildProperties(NodeEntry parentEntry)
                           throws javax.jcr.ItemNotFoundException,
                                  javax.jcr.RepositoryException

Parameters:

parentEntry -

Returns:

Throws:

javax.jcr.ItemNotFoundException

javax.jcr.RepositoryException

getChildProperties

javax.jcr.PropertyIterator getChildProperties(NodeEntry parentEntry)
                                              throws javax.jcr.ItemNotFoundException,
                                                     javax.jcr.RepositoryException

Parameters:

parentEntry -

Returns:

Throws:

javax.jcr.ItemNotFoundException

javax.jcr.RepositoryException