org.apache.jackrabbit.core
Class BatchedItemOperations

java.lang.Object
  org.apache.jackrabbit.core.ItemValidator
      org.apache.jackrabbit.core.BatchedItemOperations

public class BatchedItemOperations
extends ItemValidator

BatchedItemOperations is an internal helper class that provides both high- and low-level operations directly on the ItemState level.

Field Summary

static int	CHECK_ACCESS option for checkAddNode(org.apache.jackrabbit.core.state.NodeState, org.apache.jackrabbit.spi.Name, org.apache.jackrabbit.spi.Name, int) and checkRemoveNode(org.apache.jackrabbit.core.state.NodeState, int) methods: check access rights
static int	CHECK_CONSTRAINTS option for checkAddNode(org.apache.jackrabbit.core.state.NodeState, org.apache.jackrabbit.spi.Name, org.apache.jackrabbit.spi.Name, int) and checkRemoveNode(org.apache.jackrabbit.core.state.NodeState, int) methods: check constraints defined in node type
static int	CHECK_LOCK option for checkAddNode(org.apache.jackrabbit.core.state.NodeState, org.apache.jackrabbit.spi.Name, org.apache.jackrabbit.spi.Name, int) and checkRemoveNode(org.apache.jackrabbit.core.state.NodeState, int) methods: check lock status
static int	CHECK_REFERENCES option for checkRemoveNode(org.apache.jackrabbit.core.state.NodeState, int) method: check that target node is not being referenced
static int	CHECK_VERSIONING option for checkAddNode(org.apache.jackrabbit.core.state.NodeState, org.apache.jackrabbit.spi.Name, org.apache.jackrabbit.spi.Name, int) and checkRemoveNode(org.apache.jackrabbit.core.state.NodeState, int) methods: check checked-out status
protected static int	CLONE
protected static int	CLONE_REMOVE_EXISTING
protected static int	COPY
protected LockManager	lockMgr lock manager used for checking locking status
protected SessionImpl	session current session used for checking access rights and locking status
protected UpdatableItemStateManager	stateMgr wrapped item state manager

Fields inherited from class org.apache.jackrabbit.core.ItemValidator

hierMgr, ntReg, resolver

Constructor Summary

BatchedItemOperations(UpdatableItemStateManager stateMgr, NodeTypeRegistry ntReg, LockManager lockMgr, SessionImpl session, HierarchyManager hierMgr)
Creates a new BatchedItemOperations instance.

Method Summary

void	cancel() Cancel an update operation.
void	checkAddNode(NodeState parentState, Name nodeName, Name nodeTypeName, int options) Checks if adding a child node called nodeName of node type nodeTypeName to the given parent node is allowed in the current context.
void	checkRemoveNode(NodeState targetState, int options) Checks if removing the given target node is allowed in the current context.
void	checkRemoveNode(NodeState targetState, NodeId parentId, int options) Checks if removing the given target node from the specifed parent is allowed in the current context.
NodeId	clone(NodeState srcState, NodeState destParentState, Name destName) Implementation of clone(Path, Path) that has already determined the affected NodeStates.
NodeId	clone(Path srcPath, Path destPath) Clones the subtree at the node srcAbsPath in to the new location at destAbsPath.
NodeId	copy(Path srcPath, ItemStateManager srcStateMgr, HierarchyManager srcHierMgr, AccessManager srcAccessMgr, Path destPath, int flag) Copies the tree at srcPath retrieved using the specified srcStateMgr to the new location at destPath.
NodeId	copy(Path srcPath, Path destPath, int flag) Copies the tree at srcPath to the new location at destPath.
NodeState	createNodeState(NodeState parent, Name nodeName, Name nodeTypeName, Name[] mixinNames, NodeId id) Creates a new node.
NodeState	createNodeState(NodeState parent, Name nodeName, Name nodeTypeName, Name[] mixinNames, NodeId id, NodeDef def) Creates a new node based on the given definition.
PropertyState	createPropertyState(NodeState parent, Name propName, int type, int numValues) Creates a new property.
PropertyState	createPropertyState(NodeState parent, Name propName, int type, PropDef def) Creates a new property based on the given definition.
void	destroy(ItemState state) Destroy an item state.
void	edit() Starts an edit operation on the wrapped state manager.
NodeDef	findApplicableNodeDefinition(Name name, Name nodeTypeName, NodeState parentState) Helper method that finds the applicable definition for a child node with the given name and node type in the parent node's node type and mixin types.
PropDef	findApplicablePropertyDefinition(Name name, int type, boolean multiValued, NodeState parentState) Helper method that finds the applicable definition for a property with the given name, type and multiValued characteristic in the parent node's node type and mixin types.
PropDef	findApplicablePropertyDefinition(Name name, int type, NodeState parentState) Helper method that finds the applicable definition for a property with the given name, type in the parent node's node type and mixin types.
ItemState	getItemState(ItemId id) Retrieves the state of the item with the given id.
protected ItemState	getItemState(ItemStateManager srcStateMgr, ItemId id) Retrieves the state of the item with the specified id using the given item state manager.
protected NodeState	getNodeState(ItemStateManager srcStateMgr, HierarchyManager srcHierMgr, Path nodePath) Retrieves the state of the node at nodePath using the given item state manager.
NodeState	getNodeState(NodeId id) Retrieves the state of the node with the given id.
NodeState	getNodeState(Path nodePath) Retrieves the state of the node at the given path.
PropertyState	getPropertyState(PropertyId id) Retrieves the state of the property with the given id.
NodeId	move(Path srcPath, Path destPath) Moves the tree at srcPath to the new location at destPath.
void	removeNode(Path nodePath) Removes the specified node, recursively removing its properties and child nodes.
void	removeNodeState(NodeState target) Unlinks the specified node state from its parent and recursively removes it including its properties and child nodes.
void	store(ItemState state) Store an item state.
void	update() End an update operation.
void	verifyCanRead(Path nodePath) Verifies that the node at nodePath can be read.
void	verifyCanWrite(Path nodePath) Verifies that the node at nodePath is writable.
protected void	verifyCheckedOut(Path nodePath) Verifies that the node at nodePath is checked-out; throws a VersionException if that's not the case.
protected void	verifyNotProtected(Path nodePath) Verifies that the node at nodePath is not protected.
protected void	verifyUnlocked(Path nodePath) Verifies that the node at nodePath is not locked by somebody else than the current session.

Methods inherited from class org.apache.jackrabbit.core.ItemValidator

getEffectiveNodeType, safeGetJCRPath, safeGetJCRPath, validate, validate

Methods inherited from class java.lang.Object

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

Field Detail

COPY

protected static final int COPY

See Also:

Constant Field Values

CLONE

protected static final int CLONE

See Also:

Constant Field Values

CLONE_REMOVE_EXISTING

protected static final int CLONE_REMOVE_EXISTING

See Also:

Constant Field Values

CHECK_ACCESS

public static final int CHECK_ACCESS

option for checkAddNode(org.apache.jackrabbit.core.state.NodeState, org.apache.jackrabbit.spi.Name, org.apache.jackrabbit.spi.Name, int) and checkRemoveNode(org.apache.jackrabbit.core.state.NodeState, int) methods:

check access rights

See Also:

Constant Field Values

CHECK_LOCK

public static final int CHECK_LOCK

option for checkAddNode(org.apache.jackrabbit.core.state.NodeState, org.apache.jackrabbit.spi.Name, org.apache.jackrabbit.spi.Name, int) and checkRemoveNode(org.apache.jackrabbit.core.state.NodeState, int) methods:

check lock status

See Also:

Constant Field Values

CHECK_VERSIONING

public static final int CHECK_VERSIONING

option for checkAddNode(org.apache.jackrabbit.core.state.NodeState, org.apache.jackrabbit.spi.Name, org.apache.jackrabbit.spi.Name, int) and checkRemoveNode(org.apache.jackrabbit.core.state.NodeState, int) methods:

check checked-out status

See Also:

Constant Field Values

CHECK_CONSTRAINTS

public static final int CHECK_CONSTRAINTS

option for checkAddNode(org.apache.jackrabbit.core.state.NodeState, org.apache.jackrabbit.spi.Name, org.apache.jackrabbit.spi.Name, int) and checkRemoveNode(org.apache.jackrabbit.core.state.NodeState, int) methods:

check constraints defined in node type

See Also:

Constant Field Values

CHECK_REFERENCES

public static final int CHECK_REFERENCES

option for checkRemoveNode(org.apache.jackrabbit.core.state.NodeState, int) method:

check that target node is not being referenced

See Also:

Constant Field Values

stateMgr

protected final UpdatableItemStateManager stateMgr

wrapped item state manager

lockMgr

protected final LockManager lockMgr

lock manager used for checking locking status

session

protected final SessionImpl session

current session used for checking access rights and locking status

Constructor Detail

BatchedItemOperations

public BatchedItemOperations(UpdatableItemStateManager stateMgr,
                             NodeTypeRegistry ntReg,
                             LockManager lockMgr,
                             SessionImpl session,
                             HierarchyManager hierMgr)

Creates a new BatchedItemOperations instance.

Parameters:

stateMgr - item state manager

ntReg - node type registry

lockMgr - lock manager

session - current session

hierMgr - hierarchy manager

Method Detail

edit

public void edit()
          throws java.lang.IllegalStateException

Starts an edit operation on the wrapped state manager. At the end of this operation, either update() or cancel() must be invoked.

Throws:

java.lang.IllegalStateException - if the state manager is already in edit mode

store

public void store(ItemState state)
           throws java.lang.IllegalStateException

Store an item state.

Parameters:

state - item state that should be stored

Throws:

java.lang.IllegalStateException - if the manager is not in edit mode.

destroy

public void destroy(ItemState state)
             throws java.lang.IllegalStateException

Destroy an item state.

Parameters:

state - item state that should be destroyed

Throws:

java.lang.IllegalStateException - if the manager is not in edit mode.

update

public void update()
            throws javax.jcr.RepositoryException,
                   java.lang.IllegalStateException

End an update operation. This will save all changes made since the last invocation of edit(). If this operation fails, no item will have been saved.

Throws:

javax.jcr.RepositoryException - if the update operation failed

java.lang.IllegalStateException - if the state manager is not in edit mode

cancel

public void cancel()
            throws java.lang.IllegalStateException

Cancel an update operation. This will undo all changes made since the last invocation of edit().

Throws:

java.lang.IllegalStateException - if the state manager is not in edit mode

clone

public NodeId clone(Path srcPath,
                    Path destPath)
             throws javax.jcr.nodetype.ConstraintViolationException,
                    javax.jcr.AccessDeniedException,
                    javax.jcr.version.VersionException,
                    javax.jcr.PathNotFoundException,
                    javax.jcr.ItemExistsException,
                    javax.jcr.lock.LockException,
                    javax.jcr.RepositoryException,
                    java.lang.IllegalStateException

Clones the subtree at the node srcAbsPath in to the new location at destAbsPath. This operation is only supported:

• If the source element has the mixin mix:shareable (or some derived node type)
• If the parent node of destAbsPath has not already a shareable node in the same shared set as the node at srcPath.

Parameters:

srcPath - source path

destPath - destination path

Returns:

the node id of the destination's parent

Throws:

javax.jcr.nodetype.ConstraintViolationException - if the operation would violate a node-type or other implementation-specific constraint.

javax.jcr.version.VersionException - if the parent node of destAbsPath is versionable and checked-in, or is non-versionable but its nearest versionable ancestor is checked-in. This exception will also be thrown if removeExisting is true, and a UUID conflict occurs that would require the moving and/or altering of a node that is checked-in.

javax.jcr.AccessDeniedException - if the current session does not have sufficient access rights to complete the operation.

javax.jcr.PathNotFoundException - if the node at srcAbsPath in srcWorkspace or the parent of destAbsPath in this workspace does not exist.

javax.jcr.ItemExistsException - if a property already exists at destAbsPath or a node already exist there, and same name siblings are not allowed or if removeExisting is false and a UUID conflict occurs.

javax.jcr.lock.LockException - if a lock prevents the clone.

javax.jcr.RepositoryException - if the last element of destAbsPath has an index or if another error occurs.

java.lang.IllegalStateException

clone

public NodeId clone(NodeState srcState,
                    NodeState destParentState,
                    Name destName)
             throws javax.jcr.nodetype.ConstraintViolationException,
                    javax.jcr.AccessDeniedException,
                    javax.jcr.version.VersionException,
                    javax.jcr.PathNotFoundException,
                    javax.jcr.ItemExistsException,
                    javax.jcr.lock.LockException,
                    javax.jcr.RepositoryException,
                    java.lang.IllegalStateException

Implementation of clone(Path, Path) that has already determined the affected NodeStates.

Parameters:

srcState - source state

destParentState - destination parent state

destName - destination name

Returns:

the node id of the destination's parent

Throws:

javax.jcr.nodetype.ConstraintViolationException - if the operation would violate a node-type or other implementation-specific constraint.

javax.jcr.version.VersionException - if the parent node of destAbsPath is versionable and checked-in, or is non-versionable but its nearest versionable ancestor is checked-in. This exception will also be thrown if removeExisting is true, and a UUID conflict occurs that would require the moving and/or altering of a node that is checked-in.

javax.jcr.AccessDeniedException - if the current session does not have sufficient access rights to complete the operation.

javax.jcr.PathNotFoundException - if the node at srcAbsPath in srcWorkspace or the parent of destAbsPath in this workspace does not exist.

javax.jcr.ItemExistsException - if a property already exists at destAbsPath or a node already exist there, and same name siblings are not allowed or if removeExisting is false and a UUID conflict occurs.

javax.jcr.lock.LockException - if a lock prevents the clone.

javax.jcr.RepositoryException - if the last element of destAbsPath has an index or if another error occurs.

java.lang.IllegalStateException

See Also:

clone(Path, Path)

copy

public NodeId copy(Path srcPath,
                   Path destPath,
                   int flag)
            throws javax.jcr.nodetype.ConstraintViolationException,
                   javax.jcr.AccessDeniedException,
                   javax.jcr.version.VersionException,
                   javax.jcr.PathNotFoundException,
                   javax.jcr.ItemExistsException,
                   javax.jcr.lock.LockException,
                   javax.jcr.RepositoryException

Copies the tree at srcPath to the new location at destPath. Returns the id of the node at its new position.

Precondition: the state manager needs to be in edit mode.

Parameters:

srcPath -

destPath -

flag - one of

• COPY
• CLONE
• CLONE_REMOVE_EXISTING

Returns:

the id of the node at its new position

Throws:

javax.jcr.nodetype.ConstraintViolationException

javax.jcr.AccessDeniedException

javax.jcr.version.VersionException

javax.jcr.PathNotFoundException

javax.jcr.ItemExistsException

javax.jcr.lock.LockException

javax.jcr.RepositoryException

copy

public NodeId copy(Path srcPath,
                   ItemStateManager srcStateMgr,
                   HierarchyManager srcHierMgr,
                   AccessManager srcAccessMgr,
                   Path destPath,
                   int flag)
            throws javax.jcr.nodetype.ConstraintViolationException,
                   javax.jcr.AccessDeniedException,
                   javax.jcr.version.VersionException,
                   javax.jcr.PathNotFoundException,
                   javax.jcr.ItemExistsException,
                   javax.jcr.lock.LockException,
                   javax.jcr.RepositoryException,
                   java.lang.IllegalStateException

Copies the tree at srcPath retrieved using the specified srcStateMgr to the new location at destPath. Returns the id of the node at its new position.

Precondition: the state manager needs to be in edit mode.

Parameters:

srcPath -

srcStateMgr -

srcHierMgr -

srcAccessMgr -

destPath -

flag - one of

• COPY
• CLONE
• CLONE_REMOVE_EXISTING

Returns:

the id of the node at its new position

Throws:

javax.jcr.nodetype.ConstraintViolationException

javax.jcr.AccessDeniedException

javax.jcr.version.VersionException

javax.jcr.PathNotFoundException

javax.jcr.ItemExistsException

javax.jcr.lock.LockException

javax.jcr.RepositoryException

java.lang.IllegalStateException - if the state mananger is not in edit mode

move

public NodeId move(Path srcPath,
                   Path destPath)
            throws javax.jcr.nodetype.ConstraintViolationException,
                   javax.jcr.version.VersionException,
                   javax.jcr.AccessDeniedException,
                   javax.jcr.PathNotFoundException,
                   javax.jcr.ItemExistsException,
                   javax.jcr.lock.LockException,
                   javax.jcr.RepositoryException,
                   java.lang.IllegalStateException

Moves the tree at srcPath to the new location at destPath. Returns the id of the moved node.

Precondition: the state manager needs to be in edit mode.

Parameters:

srcPath -

destPath -

Returns:

the id of the moved node

Throws:

javax.jcr.nodetype.ConstraintViolationException

javax.jcr.version.VersionException

javax.jcr.AccessDeniedException

javax.jcr.PathNotFoundException

javax.jcr.ItemExistsException

javax.jcr.lock.LockException

javax.jcr.RepositoryException

java.lang.IllegalStateException - if the state manager is not in edit mode

removeNode

public void removeNode(Path nodePath)
                throws javax.jcr.nodetype.ConstraintViolationException,
                       javax.jcr.AccessDeniedException,
                       javax.jcr.version.VersionException,
                       javax.jcr.lock.LockException,
                       javax.jcr.ItemNotFoundException,
                       javax.jcr.ReferentialIntegrityException,
                       javax.jcr.RepositoryException,
                       java.lang.IllegalStateException

Removes the specified node, recursively removing its properties and child nodes.

Precondition: the state manager needs to be in edit mode.

Parameters:

nodePath -

Throws:

javax.jcr.nodetype.ConstraintViolationException

javax.jcr.AccessDeniedException

javax.jcr.version.VersionException

javax.jcr.lock.LockException

javax.jcr.ItemNotFoundException

javax.jcr.ReferentialIntegrityException

javax.jcr.RepositoryException

java.lang.IllegalStateException

checkAddNode

public void checkAddNode(NodeState parentState,
                         Name nodeName,
                         Name nodeTypeName,
                         int options)
                  throws javax.jcr.nodetype.ConstraintViolationException,
                         javax.jcr.AccessDeniedException,
                         javax.jcr.version.VersionException,
                         javax.jcr.lock.LockException,
                         javax.jcr.ItemNotFoundException,
                         javax.jcr.ItemExistsException,
                         javax.jcr.RepositoryException

Checks if adding a child node called nodeName of node type nodeTypeName to the given parent node is allowed in the current context.

Parameters:

parentState -

nodeName -

nodeTypeName -

options - bit-wise OR'ed flags specifying the checks that should be performed; any combination of the following constants:

• CHECK_ACCESS: make sure current session is granted read & write access on parent node
• CHECK_LOCK: make sure there's no foreign lock on parent node
• CHECK_VERSIONING: make sure parent node is checked-out
• CHECK_CONSTRAINTS: make sure no node type constraints would be violated
• CHECK_REFERENCES

Throws:

javax.jcr.nodetype.ConstraintViolationException

javax.jcr.AccessDeniedException

javax.jcr.version.VersionException

javax.jcr.lock.LockException

javax.jcr.ItemNotFoundException

javax.jcr.ItemExistsException

javax.jcr.RepositoryException

checkRemoveNode

public void checkRemoveNode(NodeState targetState,
                            int options)
                     throws javax.jcr.nodetype.ConstraintViolationException,
                            javax.jcr.AccessDeniedException,
                            javax.jcr.version.VersionException,
                            javax.jcr.lock.LockException,
                            javax.jcr.ItemNotFoundException,
                            javax.jcr.ReferentialIntegrityException,
                            javax.jcr.RepositoryException

Checks if removing the given target node is allowed in the current context.

Parameters:

targetState -

options - bit-wise OR'ed flags specifying the checks that should be performed; any combination of the following constants:

• CHECK_ACCESS: make sure current session is granted read access on parent and remove privilege on target node
• CHECK_LOCK: make sure there's no foreign lock on parent node
• CHECK_VERSIONING: make sure parent node is checked-out
• CHECK_CONSTRAINTS: make sure no node type constraints would be violated
• CHECK_REFERENCES: make sure no references exist on target node

Throws:

javax.jcr.nodetype.ConstraintViolationException

javax.jcr.AccessDeniedException

javax.jcr.version.VersionException

javax.jcr.lock.LockException

javax.jcr.ItemNotFoundException

javax.jcr.ReferentialIntegrityException

javax.jcr.RepositoryException

checkRemoveNode

public void checkRemoveNode(NodeState targetState,
                            NodeId parentId,
                            int options)
                     throws javax.jcr.nodetype.ConstraintViolationException,
                            javax.jcr.AccessDeniedException,
                            javax.jcr.version.VersionException,
                            javax.jcr.lock.LockException,
                            javax.jcr.ItemNotFoundException,
                            javax.jcr.ReferentialIntegrityException,
                            javax.jcr.RepositoryException

Checks if removing the given target node from the specifed parent is allowed in the current context.

Parameters:

targetState -

parentId -

options - bit-wise OR'ed flags specifying the checks that should be performed; any combination of the following constants:

• CHECK_ACCESS: make sure current session is granted read access on parent and remove privilege on target node
• CHECK_LOCK: make sure there's no foreign lock on parent node
• CHECK_VERSIONING: make sure parent node is checked-out
• CHECK_CONSTRAINTS: make sure no node type constraints would be violated
• CHECK_REFERENCES: make sure no references exist on target node

Throws:

javax.jcr.nodetype.ConstraintViolationException

javax.jcr.AccessDeniedException

javax.jcr.version.VersionException

javax.jcr.lock.LockException

javax.jcr.ItemNotFoundException

javax.jcr.ReferentialIntegrityException

javax.jcr.RepositoryException

verifyCanWrite

public void verifyCanWrite(Path nodePath)
                    throws javax.jcr.PathNotFoundException,
                           javax.jcr.AccessDeniedException,
                           javax.jcr.nodetype.ConstraintViolationException,
                           javax.jcr.version.VersionException,
                           javax.jcr.lock.LockException,
                           javax.jcr.RepositoryException

Verifies that the node at nodePath is writable. The following conditions must hold true:

• the node must exist
• the current session must be granted read & write access on it
• the node must not be locked by another session
• the node must not be checked-in
• the node must not be protected

Parameters:

nodePath - path of node to check

Throws:

javax.jcr.PathNotFoundException - if no node exists at nodePath of the current session is not granted read access to the specified path

javax.jcr.AccessDeniedException - if write access to the specified path is not allowed

javax.jcr.nodetype.ConstraintViolationException - if the node at nodePath is protected

javax.jcr.version.VersionException - if the node at nodePath is checked-in

javax.jcr.lock.LockException - if the node at nodePath is locked by another session

javax.jcr.RepositoryException - if another error occurs

verifyCanRead

public void verifyCanRead(Path nodePath)
                   throws javax.jcr.PathNotFoundException,
                          javax.jcr.RepositoryException

Verifies that the node at nodePath can be read. The following conditions must hold true:

• the node must exist
• the current session must be granted read access on it

Parameters:

nodePath - path of node to check

Throws:

javax.jcr.PathNotFoundException - if no node exists at nodePath of the current session is not granted read access to the specified path

javax.jcr.RepositoryException - if another error occurs

findApplicableNodeDefinition

public NodeDef findApplicableNodeDefinition(Name name,
                                            Name nodeTypeName,
                                            NodeState parentState)
                                     throws javax.jcr.RepositoryException,
                                            javax.jcr.nodetype.ConstraintViolationException

Helper method that finds the applicable definition for a child node with the given name and node type in the parent node's node type and mixin types.

Parameters:

name -

nodeTypeName -

parentState -

Returns:

a NodeDef

Throws:

javax.jcr.nodetype.ConstraintViolationException - if no applicable child node definition could be found

javax.jcr.RepositoryException - if another error occurs

findApplicablePropertyDefinition

public PropDef findApplicablePropertyDefinition(Name name,
                                                int type,
                                                boolean multiValued,
                                                NodeState parentState)
                                         throws javax.jcr.RepositoryException,
                                                javax.jcr.nodetype.ConstraintViolationException

Helper method that finds the applicable definition for a property with the given name, type and multiValued characteristic in the parent node's node type and mixin types. If there more than one applicable definitions then the following rules are applied:

• named definitions are preferred to residual definitions
• definitions with specific required type are preferred to definitions with required type UNDEFINED

Parameters:

name -

type -

multiValued -

parentState -

Returns:

a PropDef

Throws:

javax.jcr.nodetype.ConstraintViolationException - if no applicable property definition could be found

javax.jcr.RepositoryException - if another error occurs

findApplicablePropertyDefinition

public PropDef findApplicablePropertyDefinition(Name name,
                                                int type,
                                                NodeState parentState)
                                         throws javax.jcr.RepositoryException,
                                                javax.jcr.nodetype.ConstraintViolationException

Helper method that finds the applicable definition for a property with the given name, type in the parent node's node type and mixin types. Other than findApplicablePropertyDefinition(Name, int, boolean, NodeState) this method does not take the multiValued flag into account in the selection algorithm. If there more than one applicable definitions then the following rules are applied:

• named definitions are preferred to residual definitions
• definitions with specific required type are preferred to definitions with required type UNDEFINED
• single-value definitions are preferred to multiple-value definitions

Parameters:

name -

type -

parentState -

Returns:

a PropDef

Throws:

javax.jcr.nodetype.ConstraintViolationException - if no applicable property definition could be found

javax.jcr.RepositoryException - if another error occurs

createNodeState

public NodeState createNodeState(NodeState parent,
                                 Name nodeName,
                                 Name nodeTypeName,
                                 Name[] mixinNames,
                                 NodeId id)
                          throws javax.jcr.ItemExistsException,
                                 javax.jcr.nodetype.ConstraintViolationException,
                                 javax.jcr.RepositoryException,
                                 java.lang.IllegalStateException

Creates a new node.

Note that access rights are not enforced!

Precondition: the state manager needs to be in edit mode.

Parameters:

parent -

nodeName -

nodeTypeName -

mixinNames -

id -

Returns:

Throws:

javax.jcr.ItemExistsException

javax.jcr.nodetype.ConstraintViolationException

javax.jcr.RepositoryException

java.lang.IllegalStateException - if the state mananger is not in edit mode

createNodeState

public NodeState createNodeState(NodeState parent,
                                 Name nodeName,
                                 Name nodeTypeName,
                                 Name[] mixinNames,
                                 NodeId id,
                                 NodeDef def)
                          throws javax.jcr.ItemExistsException,
                                 javax.jcr.nodetype.ConstraintViolationException,
                                 javax.jcr.RepositoryException,
                                 java.lang.IllegalStateException

Creates a new node based on the given definition.

Note that access rights are not enforced!

Precondition: the state manager needs to be in edit mode.

Parameters:

parent -

nodeName -

nodeTypeName -

mixinNames -

id -

def -

Returns:

Throws:

javax.jcr.ItemExistsException

javax.jcr.nodetype.ConstraintViolationException

javax.jcr.RepositoryException

java.lang.IllegalStateException

createPropertyState

public PropertyState createPropertyState(NodeState parent,
                                         Name propName,
                                         int type,
                                         int numValues)
                                  throws javax.jcr.ItemExistsException,
                                         javax.jcr.nodetype.ConstraintViolationException,
                                         javax.jcr.RepositoryException,
                                         java.lang.IllegalStateException

Creates a new property.

Note that access rights are not enforced!

Precondition: the state manager needs to be in edit mode.

Parameters:

parent -

propName -

type -

numValues -

Returns:

Throws:

javax.jcr.ItemExistsException

javax.jcr.nodetype.ConstraintViolationException

javax.jcr.RepositoryException

java.lang.IllegalStateException - if the state mananger is not in edit mode

createPropertyState

public PropertyState createPropertyState(NodeState parent,
                                         Name propName,
                                         int type,
                                         PropDef def)
                                  throws javax.jcr.ItemExistsException,
                                         javax.jcr.RepositoryException

Creates a new property based on the given definition.

Note that access rights are not enforced!

Precondition: the state manager needs to be in edit mode.

Parameters:

parent -

propName -

type -

def -

Returns:

Throws:

javax.jcr.ItemExistsException

javax.jcr.RepositoryException

removeNodeState

public void removeNodeState(NodeState target)
                     throws javax.jcr.RepositoryException

Unlinks the specified node state from its parent and recursively removes it including its properties and child nodes.

Note that no checks (access rights etc.) are performed on the specified target node state. Those checks have to be performed beforehand by the caller. However, the (recursive) removal of target node's child nodes are subject to the following checks: access rights, locking, versioning.

Parameters:

target -

Throws:

javax.jcr.RepositoryException - if an error occurs

getNodeState

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

Retrieves the state of the node at the given path.

Note that access rights are not enforced!

Parameters:

nodePath -

Returns:

Throws:

javax.jcr.PathNotFoundException

javax.jcr.RepositoryException

getNodeState

public NodeState getNodeState(NodeId id)
                       throws javax.jcr.ItemNotFoundException,
                              javax.jcr.RepositoryException

Retrieves the state of the node with the given id.

Note that access rights are not enforced!

Parameters:

id -

Returns:

Throws:

javax.jcr.ItemNotFoundException

javax.jcr.RepositoryException

getPropertyState

public PropertyState getPropertyState(PropertyId id)
                               throws javax.jcr.ItemNotFoundException,
                                      javax.jcr.RepositoryException

Retrieves the state of the property with the given id.

Note that access rights are not enforced!

Parameters:

id -

Returns:

Throws:

javax.jcr.ItemNotFoundException

javax.jcr.RepositoryException

getItemState

public ItemState getItemState(ItemId id)
                       throws javax.jcr.ItemNotFoundException,
                              javax.jcr.RepositoryException

Retrieves the state of the item with the given id.

Note that access rights are not enforced!

Parameters:

id -

Returns:

Throws:

javax.jcr.ItemNotFoundException

javax.jcr.RepositoryException

verifyCheckedOut

protected void verifyCheckedOut(Path nodePath)
                         throws javax.jcr.PathNotFoundException,
                                javax.jcr.version.VersionException,
                                javax.jcr.RepositoryException

Verifies that the node at nodePath is checked-out; throws a VersionException if that's not the case.

A node is considered checked-out if it is versionable and checked-out, or is non-versionable but its nearest versionable ancestor is checked-out, or is non-versionable and there are no versionable ancestors.

Parameters:

nodePath -

Throws:

javax.jcr.PathNotFoundException

javax.jcr.version.VersionException

javax.jcr.RepositoryException

verifyUnlocked

protected void verifyUnlocked(Path nodePath)
                       throws javax.jcr.lock.LockException,
                              javax.jcr.RepositoryException

Verifies that the node at nodePath is not locked by somebody else than the current session.

Parameters:

nodePath - path of node to check

Throws:

javax.jcr.PathNotFoundException

javax.jcr.lock.LockException - if write access to the specified path is not allowed

javax.jcr.RepositoryException - if another error occurs

verifyNotProtected

protected void verifyNotProtected(Path nodePath)
                           throws javax.jcr.PathNotFoundException,
                                  javax.jcr.nodetype.ConstraintViolationException,
                                  javax.jcr.RepositoryException

Verifies that the node at nodePath is not protected.

Parameters:

nodePath - path of node to check

Throws:

javax.jcr.PathNotFoundException - if no node exists at nodePath

javax.jcr.nodetype.ConstraintViolationException - if write access to the specified path is not allowed

javax.jcr.RepositoryException - if another error occurs

getNodeState

protected NodeState getNodeState(ItemStateManager srcStateMgr,
                                 HierarchyManager srcHierMgr,
                                 Path nodePath)
                          throws javax.jcr.PathNotFoundException,
                                 javax.jcr.RepositoryException

Retrieves the state of the node at nodePath using the given item state manager.

Note that access rights are not enforced!

Parameters:

srcStateMgr -

srcHierMgr -

nodePath -

Returns:

Throws:

javax.jcr.PathNotFoundException

javax.jcr.RepositoryException

getItemState

protected ItemState getItemState(ItemStateManager srcStateMgr,
                                 ItemId id)
                          throws javax.jcr.ItemNotFoundException,
                                 javax.jcr.RepositoryException

Retrieves the state of the item with the specified id using the given item state manager.

Note that access rights are not enforced!

Parameters:

srcStateMgr -

id -

Returns:

Throws:

javax.jcr.ItemNotFoundException

javax.jcr.RepositoryException