org.apache.jackrabbit.jcr2spi.lock
Class LockManagerImpl

java.lang.Object
  org.apache.jackrabbit.jcr2spi.lock.LockManagerImpl

All Implemented Interfaces:

LockManager, SessionListener

public class LockManagerImpl
extends java.lang.Object
implements LockManager, SessionListener

LockManagerImpl... TODO: TOBEFIXED. Lock objects obtained through this mgr are not informed if another session is or becomes lock-holder and removes the lock again.

Constructor Summary

LockManagerImpl(WorkspaceManager wspManager, ItemManager itemManager, CacheBehaviour cacheBehaviour)

Method Summary

void	addLockToken(java.lang.String lt) Delegates this call to WorkspaceManager.addLockToken(String).
void	checkLock(NodeState nodeState) Check whether the given node state is locked by somebody else than the current session.
javax.jcr.lock.Lock	getLock(NodeState nodeState) If the session created a lock on the node with the given state, we already know the lock.
java.lang.String[]	getLockTokens() Returns the lock tokens present on the SessionInfo this manager has been created with.
boolean	isLocked(NodeState nodeState) 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(NodeState nodeState, boolean isDeep, boolean isSessionScoped) Lock a node.
void	loggedOut(javax.jcr.Session session) Called when a Session has been 'closed' by calling Session.logout()
void	loggingOut(javax.jcr.Session session) Called when a Session is about to be 'closed' by calling Session.logout()
void	removeLockToken(java.lang.String lt) If the lock addressed by the token is session-scoped, this method will throw a LockException, such as defined by JSR170 v.1.0.1 for Session.removeLockToken(String). Otherwise the call is delegated to WorkspaceManager.removeLockToken(String).
void	unlock(NodeState nodeState) Removes the lock on a node.

Methods inherited from class java.lang.Object

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

Constructor Detail

LockManagerImpl

public LockManagerImpl(WorkspaceManager wspManager,
                       ItemManager itemManager,
                       CacheBehaviour cacheBehaviour)

Method Detail

lock

public javax.jcr.lock.Lock lock(NodeState nodeState,
                                boolean isDeep,
                                boolean isSessionScoped)
                         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

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:

LockManager.lock(NodeState,boolean,boolean)

unlock

public void unlock(NodeState nodeState)
            throws javax.jcr.lock.LockException,
                   javax.jcr.RepositoryException

Description copied from interface: LockManager

Removes the lock on a node.

Specified by:

unlock in interface LockManager

Parameters:

nodeState -

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:

LockManager.unlock(NodeState)

getLock

public javax.jcr.lock.Lock getLock(NodeState nodeState)
                            throws javax.jcr.lock.LockException,
                                   javax.jcr.RepositoryException

If the session created a lock on the node with the given state, we already know the lock. Otherwise, the node state and its ancestores are searched for properties indicating a lock.
Note, that the flag indicating session-scoped lock cannot be retrieved unless the current session is the lock holder.

Specified by:

getLock in interface LockManager

Parameters:

nodeState -

Returns:

lock object

Throws:

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

javax.jcr.RepositoryException

See Also:

LockManager.getLock(NodeState)

isLocked

public boolean isLocked(NodeState nodeState)
                 throws javax.jcr.RepositoryException

Description copied from interface: LockManager

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:

nodeState -

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

See Also:

LockManager.isLocked(NodeState)

checkLock

public void checkLock(NodeState nodeState)
               throws javax.jcr.lock.LockException,
                      javax.jcr.RepositoryException

Description copied from interface: LockManager

Check whether the given node state 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. If the node is not locked at all this method returns silently.

Specified by:

checkLock in interface LockManager

Parameters:

nodeState -

Throws:

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

javax.jcr.RepositoryException - if some other error occurs

See Also:

LockManager.checkLock(NodeState)

getLockTokens

public java.lang.String[] getLockTokens()

Returns the lock tokens present on the SessionInfo this manager has been created with.

Specified by:

getLockTokens in interface LockManager

Returns:

See Also:

LockManager.getLockTokens()

addLockToken

public void addLockToken(java.lang.String lt)
                  throws javax.jcr.lock.LockException,
                         javax.jcr.RepositoryException

Delegates this call to WorkspaceManager.addLockToken(String). If this succeeds this method will inform all locks stored in the local map in order to give them the chance to update their lock information.

Specified by:

addLockToken in interface LockManager

Parameters:

lt - added lock token

Throws:

javax.jcr.lock.LockException

javax.jcr.RepositoryException

See Also:

LockManager.addLockToken(String)

removeLockToken

public void removeLockToken(java.lang.String lt)
                     throws javax.jcr.lock.LockException,
                            javax.jcr.RepositoryException

If the lock addressed by the token is session-scoped, this method will throw a LockException, such as defined by JSR170 v.1.0.1 for Session.removeLockToken(String).
Otherwise the call is delegated to WorkspaceManager.removeLockToken(String). All locks stored in the local lock map are notified by the removed token in order have them updated their lock information.

Specified by:

removeLockToken in interface LockManager

Parameters:

lt - removed lock token

Throws:

javax.jcr.lock.LockException

javax.jcr.RepositoryException

See Also:

LockManager.removeLockToken(String)

loggingOut

public void loggingOut(javax.jcr.Session session)

Description copied from interface: SessionListener

Called when a Session is about to be 'closed' by calling Session.logout()

Specified by:

loggingOut in interface SessionListener

Parameters:

session -

See Also:

SessionListener.loggingOut(Session)

loggedOut

public void loggedOut(javax.jcr.Session session)

Description copied from interface: SessionListener

Called when a Session has been 'closed' by calling Session.logout()

Specified by:

loggedOut in interface SessionListener

Parameters:

session -

See Also:

SessionListener.loggedOut(Session)