org.apache.jackrabbit.core.lock

Class XALockManager

java.lang.Object

org.apache.jackrabbit.core.lock.XALockManager

All Implemented Interfaces:

LockManager, org.apache.jackrabbit.data.core.InternalXAResource

public class XALockManager
extends Object
implements LockManager, org.apache.jackrabbit.data.core.InternalXAResource

Session-local lock manager that implements the semantical changes inside transactions. This manager validates lock/unlock operations inside its view of the locking space.

Constructor Summary

Constructors

Constructor and Description
XALockManager(LockManagerImpl lockMgr) Create a new instance of this class.

Method Summary

Methods

Modifier and Type	Method and Description
void	addLockToken(SessionImpl session, String lt) Invoked by a session to inform that a lock token has been added.
void	afterOperation(org.apache.jackrabbit.data.core.TransactionContext tx)
void	associate(org.apache.jackrabbit.data.core.TransactionContext tx)
void	beforeOperation(org.apache.jackrabbit.data.core.TransactionContext tx)
void	checkLock(NodeImpl node) Check whether the node given is locked by somebody else than the current session.
void	checkLock(org.apache.jackrabbit.spi.Path path, javax.jcr.Session session) Check whether the path given is locked by somebody else than the session described.
void	checkUnlock(javax.jcr.Session session, NodeImpl node) Returns true if the specified session is allowed to unlock the node; otherwise returns false.
void	commit(org.apache.jackrabbit.data.core.TransactionContext tx)
boolean	differentXAEnv(LockInfo info) Return a flag indicating whether a lock info belongs to a different XA environment.
javax.jcr.lock.Lock	getLock(NodeImpl node) Returns the Lock object that applies to a node.
javax.jcr.lock.Lock[]	getLocks(SessionImpl session) Returns all locks owned by the specified session.
boolean	holdsLock(NodeImpl node) Returns true if the node given holds a lock; otherwise returns false.
boolean	isLocked(NodeImpl node) Returns true if this node is locked either as a result of a lock held by this node or by a deep lock on a node above this node; otherwise returns false
javax.jcr.lock.Lock	lock(NodeImpl node, boolean isDeep, boolean isSessionScoped) Lock a node.
javax.jcr.lock.Lock	lock(NodeImpl node, boolean isDeep, boolean isSessionScoped, long timoutHint, String ownerInfo) Lock a node.
void	prepare(org.apache.jackrabbit.data.core.TransactionContext tx)
void	removeLockToken(SessionImpl session, String lt) Invoked by a session to inform that a lock token has been removed.
void	rollback(org.apache.jackrabbit.data.core.TransactionContext tx)
void	unlock(NodeImpl node) Removes the lock on a node given by its path.

Methods inherited from class java.lang.Object

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

Constructor Detail

XALockManager

public XALockManager(LockManagerImpl lockMgr)

Create a new instance of this class.

Parameters:

lockMgr - lockMgr global lock manager

Method Detail

lock

public javax.jcr.lock.Lock lock(NodeImpl node,
                       boolean isDeep,
                       boolean isSessionScoped)
                         throws javax.jcr.lock.LockException,
                                javax.jcr.RepositoryException

Lock a node. Checks whether the node is not locked and then returns a lock object for this node.

Specified by:

lock in interface LockManager

Parameters:

node - node

isDeep - whether the lock applies to this node only

isSessionScoped - whether the lock is session scoped

Returns:

lock object

Throws:

javax.jcr.lock.LockException - if this node already is locked, or some descendant node is locked and isDeep is true

javax.jcr.RepositoryException

See Also:

Node.lock(boolean, boolean)

lock

public javax.jcr.lock.Lock lock(NodeImpl node,
                       boolean isDeep,
                       boolean isSessionScoped,
                       long timoutHint,
                       String ownerInfo)
                         throws javax.jcr.lock.LockException,
                                javax.jcr.RepositoryException

Description copied from interface: LockManager

Lock a node. Checks whether the node is not locked and then returns a lock object for this node.

Specified by:

lock in interface LockManager

Parameters:

node - Node to create the lock for.

isDeep - whether the lock applies to this node only

isSessionScoped - whether the lock is session scoped

timoutHint - Desired lock timeout in seconds.

ownerInfo - Optional string acting as information about the owner.

Returns:

the lock.

Throws:

javax.jcr.lock.LockException - if this node already is locked, or some descendant node is locked and isDeep is true

javax.jcr.RepositoryException

See Also:

LockManager.lock(NodeImpl, boolean, boolean, long, String)

getLock

public javax.jcr.lock.Lock getLock(NodeImpl node)
                            throws javax.jcr.lock.LockException,
                                   javax.jcr.RepositoryException

Returns the Lock object that applies to a node. This may be either a lock on this node itself or a deep lock on a node above this node.

Specified by:

getLock in interface LockManager

Parameters:

node - node

Returns:

lock object

Throws:

javax.jcr.lock.LockException - if this node is not locked

javax.jcr.RepositoryException

See Also:

Node.getLock()

getLocks

public javax.jcr.lock.Lock[] getLocks(SessionImpl session)
                               throws javax.jcr.RepositoryException

Returns all locks owned by the specified session.

Specified by:

getLocks in interface LockManager

Parameters:

session - session

Returns:

an array of lock objects

Throws:

javax.jcr.RepositoryException - if an error occurs

See Also:

SessionImpl.getLocks()

unlock

public void unlock(NodeImpl node)
            throws javax.jcr.lock.LockException,
                   javax.jcr.RepositoryException

Removes the lock on a node given by its path.

Specified by:

unlock in interface LockManager

Parameters:

node - node

Throws:

javax.jcr.lock.LockException - if this node is not locked or the session does not have the correct lock token

javax.jcr.RepositoryException

See Also:

Node.unlock()

holdsLock

public boolean holdsLock(NodeImpl node)
                  throws javax.jcr.RepositoryException

Returns true if the node given holds a lock; otherwise returns false.

Specified by:

holdsLock in interface LockManager

Parameters:

node - node

Returns:

true if the node given holds a lock; otherwise returns false

Throws:

javax.jcr.RepositoryException - If an exception occurs.

See Also:

Node.holdsLock()

isLocked

public boolean isLocked(NodeImpl node)
                 throws javax.jcr.RepositoryException

Returns true if this node is locked either as a result of a lock held by this node or by a deep lock on a node above this node; otherwise returns false

Specified by:

isLocked in interface LockManager

Parameters:

node - node

Returns:

true if this node is locked either as a result of a lock held by this node or by a deep lock on a node above this node; otherwise returns false

Throws:

javax.jcr.RepositoryException - If an exception occurs.

See Also:

Node.isLocked()

checkLock

public void checkLock(NodeImpl node)
               throws javax.jcr.lock.LockException,
                      javax.jcr.RepositoryException

Check whether the node given is locked by somebody else than the current session. Access is allowed if the node is not locked or if the session itself holds the lock to this node, i.e. the session contains the lock token for the lock.

Specified by:

checkLock in interface LockManager

Parameters:

node - node to check

Throws:

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

javax.jcr.RepositoryException - if some other error occurs

checkLock

public void checkLock(org.apache.jackrabbit.spi.Path path,
             javax.jcr.Session session)
               throws javax.jcr.lock.LockException,
                      javax.jcr.RepositoryException

Check whether the path given is locked by somebody else than the session described. Access is allowed if the node is not locked or if the session itself holds the lock to this node, i.e. the session contains the lock token for the lock.

Specified by:

checkLock in interface LockManager

Parameters:

path - path to check

session - session

Throws:

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

javax.jcr.RepositoryException - if some other error occurs

checkUnlock

public void checkUnlock(javax.jcr.Session session,
               NodeImpl node)
                 throws javax.jcr.lock.LockException,
                        javax.jcr.RepositoryException

Returns true if the specified session is allowed to unlock the node; otherwise returns false.

Specified by:

checkUnlock in interface LockManager

Parameters:

session - session

node - node

Throws:

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

javax.jcr.RepositoryException - if some other error occurs

addLockToken

public void addLockToken(SessionImpl session,
                String lt)
                  throws javax.jcr.RepositoryException

Invoked by a session to inform that a lock token has been added.

Specified by:

addLockToken in interface LockManager

Parameters:

session - session that has a added lock token

lt - added lock token

Throws:

javax.jcr.lock.LockException

javax.jcr.RepositoryException

removeLockToken

public void removeLockToken(SessionImpl session,
                   String lt)
                     throws javax.jcr.RepositoryException

Invoked by a session to inform that a lock token has been removed.

Specified by:

removeLockToken in interface LockManager

Parameters:

session - session that has a removed lock token

lt - removed lock token

Throws:

javax.jcr.lock.LockException

javax.jcr.RepositoryException

associate

public void associate(org.apache.jackrabbit.data.core.TransactionContext tx)

Specified by:

associate in interface org.apache.jackrabbit.data.core.InternalXAResource

beforeOperation

public void beforeOperation(org.apache.jackrabbit.data.core.TransactionContext tx)

Specified by:

beforeOperation in interface org.apache.jackrabbit.data.core.InternalXAResource

prepare

public void prepare(org.apache.jackrabbit.data.core.TransactionContext tx)
             throws org.apache.jackrabbit.data.core.TransactionException

Specified by:

prepare in interface org.apache.jackrabbit.data.core.InternalXAResource

Throws:

org.apache.jackrabbit.data.core.TransactionException

commit

public void commit(org.apache.jackrabbit.data.core.TransactionContext tx)

This will finish the update and unlock the shared lock manager.

Specified by:

commit in interface org.apache.jackrabbit.data.core.InternalXAResource

rollback

public void rollback(org.apache.jackrabbit.data.core.TransactionContext tx)

This will undo all updates and unlock the shared lock manager.

Specified by:

rollback in interface org.apache.jackrabbit.data.core.InternalXAResource

afterOperation

public void afterOperation(org.apache.jackrabbit.data.core.TransactionContext tx)

Specified by:

afterOperation in interface org.apache.jackrabbit.data.core.InternalXAResource

differentXAEnv

public boolean differentXAEnv(LockInfo info)

Return a flag indicating whether a lock info belongs to a different XA environment.