org.jboss.cache.lock
Class NodeBasedLockManager

java.lang.Object
  org.jboss.cache.lock.AbstractLockManager
      org.jboss.cache.lock.NodeBasedLockManager

All Implemented Interfaces:

LockManager

Direct Known Subclasses:

PessimisticNodeBasedLockManager

Deprecated. since this is specific to legacy locking schemes

@Deprecated
public class NodeBasedLockManager
extends AbstractLockManager

Since:

2.2

Author:

Mircea.Markus@jboss.com

Field Summary

protected DataContainer	dataContainer Deprecated.
protected NodeSPI	rootNode Deprecated.

Fields inherited from class org.jboss.cache.lock.AbstractLockManager

configuration, lockAcquisitionTimeout

Constructor Summary

NodeBasedLockManager()
Deprecated.

Method Summary

Collection<Object>	getReadOwners(Fqn f) Deprecated. Retrieves the read lock owners, if any, for the current Fqn.
Collection<Object>	getReadOwners(NodeSPI node) Deprecated. Retrieves the read lock owners, if any, for the current Fqn.
Object	getWriteOwner(Fqn f) Deprecated. Retrieves the write lock owner, if any, for the current Fqn.
Object	getWriteOwner(NodeSPI node) Deprecated. Retrieves the write lock owner, if any, for the current Fqn.
void	inject(DataContainer dataContainer) Deprecated.
boolean	isLocked(Fqn fqn) Deprecated. Returns true if the node is locked (either for reading or writing) by anyone, and false otherwise.
boolean	isLocked(NodeSPI n) Deprecated. Returns true if the node is locked (either for reading or writing) by anyone, and false otherwise.
boolean	isLocked(NodeSPI n, LockType type) Deprecated. Returns true if the node is locked (either for reading or writing) by anyone, and false otherwise.
boolean	lock(Fqn fqn, LockType lockType, Object owner) Deprecated. Acquires a lock of type lockType, for a given owner, on a specific Node in the cache, denoted by fqn.
boolean	lock(Fqn fqn, LockType lockType, Object owner, long timeout) Deprecated. Acquires a lock of type lockType, for a given owner, on a specific Node in the cache, denoted by fqn.
boolean	lock(NodeSPI node, LockType lockType, Object owner) Deprecated. As LockManager.lock(org.jboss.cache.Fqn, LockType, Object) except that a NodeSPI is passed in instead of an Fqn.
boolean	lock(NodeSPI node, LockType lockType, Object owner, long timeout) Deprecated. As LockManager.lock(org.jboss.cache.Fqn, LockType, Object, long) except that a NodeSPI is passed in instead of an Fqn.
boolean	lockAll(NodeSPI node, LockType lockType, Object owner) Deprecated. Locks the node and all child nodes, acquiring lock of type specified for the owner specified.
boolean	lockAll(NodeSPI node, LockType lockType, Object owner, long timeout) Deprecated. Locks the node and all child nodes, acquiring lock of type specified for the owner specified.
boolean	lockAll(NodeSPI node, LockType lockType, Object owner, long timeout, boolean excludeInternalFqns) Deprecated. Locks the node and all child nodes, acquiring lock of type specified for the owner specified.
boolean	lockAllAndRecord(Fqn fqn, LockType lockType, InvocationContext ctx) Deprecated. Locks the node and all child nodes, acquiring lock of type specified for the owner specified.
boolean	lockAllAndRecord(NodeSPI node, LockType lockType, InvocationContext ctx) Deprecated. Locks the node and all child nodes, acquiring lock of type specified for the owner specified.
boolean	lockAndRecord(Fqn fqn, LockType lockType, InvocationContext ctx) Deprecated. Acquires a lock of type lockType, on a specific Node in the cache, denoted by fqn.
boolean	lockAndRecord(NodeSPI node, LockType lockType, InvocationContext ctx) Deprecated. Acquires a lock of type lockType, on a specific Node in the cache, denoted by fqn.
boolean	ownsLock(Fqn fqn, LockType lockType, Object owner) Deprecated. Tests whether a given owner owns a lock of lockType on a particular Fqn.
boolean	ownsLock(Fqn fqn, Object owner) Deprecated. Tests whether a given owner owns any sort of lock on a particular Fqn.
boolean	ownsLock(NodeSPI node, Object owner) Deprecated. Tests whether a given owner owns any sort of lock on a particular Fqn.
String	printLockInfo() Deprecated. Prints lock information for all locks.
String	printLockInfo(NodeSPI node) Deprecated. Prints lock information about a node (and its children) to a String.
void	setRootNode() Deprecated.
void	unlock(Fqn fqn, Object owner) Deprecated. Releases the lock passed in, held by the specified owner
void	unlock(InvocationContext ctx) Deprecated. Releases locks present in an invocation context and transaction entry, if one is available.
void	unlock(NodeSPI node, Object owner) Deprecated. Releases the lock passed in, held by the specified owner
void	unlockAll(NodeSPI node) Deprecated. Releases locks on a given node and all children for all owners.
void	unlockAll(NodeSPI node, Object owner) Deprecated. Releases locks on a given node and all children for a given owner.

Methods inherited from class org.jboss.cache.lock.AbstractLockManager

getLockOwner, injectConfiguration, setLockAcquisitionTimeout

Methods inherited from class java.lang.Object

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

Field Detail

dataContainer

protected DataContainer dataContainer

Deprecated.

rootNode

protected NodeSPI rootNode

Deprecated.

Constructor Detail

NodeBasedLockManager

public NodeBasedLockManager()

Deprecated.

Method Detail

inject

public void inject(DataContainer dataContainer)

Deprecated.

setRootNode

public void setRootNode()

Deprecated.

lock

public boolean lock(Fqn fqn,
                    LockType lockType,
                    Object owner)

Deprecated.

Description copied from interface: LockManager

Acquires a lock of type lockType, for a given owner, on a specific Node in the cache, denoted by fqn. This method will try for Configuration.getLockAcquisitionTimeout() milliseconds and give up if it is unable to acquire the required lock.

Parameters:

fqn - Fqn to lock

lockType - type of lock to acquire

owner - owner to acquire the lock for

Returns:

true if the lock was acquired, false otherwise.

lock

public boolean lock(Fqn fqn,
                    LockType lockType,
                    Object owner,
                    long timeout)

Deprecated.

Description copied from interface: LockManager

Acquires a lock of type lockType, for a given owner, on a specific Node in the cache, denoted by fqn. This method will try for timeout milliseconds and give up if it is unable to acquire the required lock.

Parameters:

fqn - Fqn to lock

lockType - type of lock to acquire

owner - owner to acquire the lock for

timeout - maximum length of time to wait for (in millis)

Returns:

true if the lock was acquired, false otherwise.

lock

public boolean lock(NodeSPI node,
                    LockType lockType,
                    Object owner)

Deprecated.

Description copied from interface: LockManager

As LockManager.lock(org.jboss.cache.Fqn, LockType, Object) except that a NodeSPI is passed in instead of an Fqn.

Parameters:

node - node to lock

lockType - type of lock to acquire

owner - owner to acquire the lock for

Returns:

true if the lock was acquired, false otherwise.

lock

public boolean lock(NodeSPI node,
                    LockType lockType,
                    Object owner,
                    long timeout)

Deprecated.

Description copied from interface: LockManager

As LockManager.lock(org.jboss.cache.Fqn, LockType, Object, long) except that a NodeSPI is passed in instead of an Fqn.

Parameters:

node - node to lock

lockType - type of lock to acquire

owner - owner to acquire the lock for

timeout - maximum length of time to wait for (in millis)

Returns:

true if the lock was acquired, false otherwise.

lockAndRecord

public boolean lockAndRecord(Fqn fqn,
                             LockType lockType,
                             InvocationContext ctx)

Deprecated.

Description copied from interface: LockManager

Acquires a lock of type lockType, on a specific Node in the cache, denoted by fqn. This method will try for a period of time and give up if it is unable to acquire the required lock. The period of time is specified in Option.getLockAcquisitionTimeout() and, if this is unset, the default timeout set in Configuration.getLockAcquisitionTimeout() is used.

In addition, any locks acquired are added to the context OR transaction entry using InvocationContext.addLock(Object).

The owner for the lock is determined by passing the invocation context to LockManager.getLockOwner(org.jboss.cache.InvocationContext).

Parameters:

fqn - Fqn to lock

lockType - type of lock to acquire

ctx - invocation context associated with this invocation

Returns:

true if the lock was acquired, false otherwise.

lockAndRecord

public boolean lockAndRecord(NodeSPI node,
                             LockType lockType,
                             InvocationContext ctx)

Deprecated.

Description copied from interface: LockManager

Acquires a lock of type lockType, on a specific Node in the cache, denoted by fqn. This method will try for a period of time and give up if it is unable to acquire the required lock. The period of time is specified in Option.getLockAcquisitionTimeout() and, if this is unset, the default timeout set in Configuration.getLockAcquisitionTimeout() is used.

In addition, any locks acquired are added to the context OR transaction entry using InvocationContext.addLock(Object).

The owner for the lock is determined by passing the invocation context to LockManager.getLockOwner(org.jboss.cache.InvocationContext).

Parameters:

node - Fqn to lock

lockType - type of lock to acquire

ctx - invocation context associated with this invocation

Returns:

true if the lock was acquired, false otherwise.

unlock

public void unlock(InvocationContext ctx)

Deprecated.

Description copied from interface: LockManager

Releases locks present in an invocation context and transaction entry, if one is available.

Locks are released in reverse order of which they are acquired and registered.

Lock owner is determined by passing the invocation context to LockManager.getLockOwner(org.jboss.cache.InvocationContext)

Parameters:

ctx - invocation context to inspect

unlock

public void unlock(Fqn fqn,
                   Object owner)

Deprecated.

Description copied from interface: LockManager

Releases the lock passed in, held by the specified owner

Parameters:

fqn - Fqn of the node to unlock

owner - lock owner

unlock

public void unlock(NodeSPI node,
                   Object owner)

Deprecated.

Description copied from interface: LockManager

Releases the lock passed in, held by the specified owner

Parameters:

node - Node to unlock

owner - lock owner

lockAll

public boolean lockAll(NodeSPI node,
                       LockType lockType,
                       Object owner)

Deprecated.

Description copied from interface: LockManager

Locks the node and all child nodes, acquiring lock of type specified for the owner specified. If only some locks are acquired, all locks are released and the method returns false.

This method will try for Configuration.getLockAcquisitionTimeout() milliseconds and give up if it is unable to acquire the required lock.

Parameters:

node - Node to lock

lockType - type of lock to acquire

owner - owner to acquire the lock for

Returns:

true if the lock was acquired, false otherwise.

lockAll

public boolean lockAll(NodeSPI node,
                       LockType lockType,
                       Object owner,
                       long timeout)

Deprecated.

Description copied from interface: LockManager

Locks the node and all child nodes, acquiring lock of type specified for the owner specified. If only some locks are acquired, all locks are released and the method returns false. Internal Fqns are included as well.

Parameters:

node - Node to lock

lockType - type of lock to acquire

owner - owner to acquire the lock for

timeout - maximum length of time to wait for (in millis)

Returns:

true if all locks were acquired, false otherwise.

lockAll

public boolean lockAll(NodeSPI node,
                       LockType lockType,
                       Object owner,
                       long timeout,
                       boolean excludeInternalFqns)

Deprecated.

Description copied from interface: LockManager

Locks the node and all child nodes, acquiring lock of type specified for the owner specified. If only some locks are acquired, all locks are released and the method returns false.

Parameters:

node - Node to lock

lockType - type of lock to acquire

owner - owner to acquire the lock for

timeout - maximum length of time to wait for (in millis)

excludeInternalFqns - if true, any Fqns that are internal are excluded.

Returns:

true if all locks were acquired, false otherwise.

lockAllAndRecord

public boolean lockAllAndRecord(Fqn fqn,
                                LockType lockType,
                                InvocationContext ctx)

Deprecated.

Description copied from interface: LockManager

Locks the node and all child nodes, acquiring lock of type specified for the owner specified. If only some locks are acquired, all locks are released and the method returns false.

In addition, any locks acquired are added to the context OR transaction entry using InvocationContext.addLock(Object).

The owner for the lock is determined by passing the invocation context to LockManager.getLockOwner(org.jboss.cache.InvocationContext).

Parameters:

fqn - Node to lock

lockType - type of lock to acquire

ctx - invocation context associated with this invocation

Returns:

true if all locks were acquired, false otherwise.

lockAllAndRecord

public boolean lockAllAndRecord(NodeSPI node,
                                LockType lockType,
                                InvocationContext ctx)

Deprecated.

Description copied from interface: LockManager

Locks the node and all child nodes, acquiring lock of type specified for the owner specified. If only some locks are acquired, all locks are released and the method returns false.

In addition, any locks acquired are added to the context OR transaction entry using InvocationContext.addLock(Object).

The owner for the lock is determined by passing the invocation context to LockManager.getLockOwner(org.jboss.cache.InvocationContext).

Parameters:

node - Node to lock

lockType - type of lock to acquire

ctx - invocation context associated with this invocation

Returns:

true if all locks were acquired, false otherwise.

unlockAll

public void unlockAll(NodeSPI node,
                      Object owner)

Deprecated.

Description copied from interface: LockManager

Releases locks on a given node and all children for a given owner.

Parameters:

node - node to unlock

owner - lock owner

unlockAll

public void unlockAll(NodeSPI node)

Deprecated.

Description copied from interface: LockManager

Releases locks on a given node and all children for all owners. Use with care.

Parameters:

node - node to unlock

ownsLock

public boolean ownsLock(Fqn fqn,
                        LockType lockType,
                        Object owner)

Deprecated.

Description copied from interface: LockManager

Tests whether a given owner owns a lock of lockType on a particular Fqn.

Parameters:

fqn - fqn to test

lockType - type of lock to test for

owner - owner

Returns:

true if the owner does own the specified lock type on the specified node, false otherwise.

ownsLock

public boolean ownsLock(Fqn fqn,
                        Object owner)

Deprecated.

Description copied from interface: LockManager

Tests whether a given owner owns any sort of lock on a particular Fqn.

Parameters:

fqn - fqn to test

owner - owner

Returns:

true if the owner does own the specified lock type on the specified node, false otherwise.

ownsLock

public boolean ownsLock(NodeSPI node,
                        Object owner)

Deprecated.

Description copied from interface: LockManager

Tests whether a given owner owns any sort of lock on a particular Fqn.

Parameters:

node - to test

owner - owner

Returns:

true if the owner does own the specified lock type on the specified node, false otherwise.

isLocked

public boolean isLocked(NodeSPI n)

Deprecated.

Description copied from interface: LockManager

Returns true if the node is locked (either for reading or writing) by anyone, and false otherwise.

Parameters:

n - node to inspect

Returns:

true of locked; false if not.

isLocked

public boolean isLocked(Fqn fqn)

Deprecated.

Description copied from interface: LockManager

Returns true if the node is locked (either for reading or writing) by anyone, and false otherwise.

Parameters:

fqn - node to inspect

Returns:

true of locked; false if not.

isLocked

public boolean isLocked(NodeSPI n,
                        LockType type)

Deprecated.

Description copied from interface: LockManager

Returns true if the node is locked (either for reading or writing) by anyone, and false otherwise.

Parameters:

n - node to inspect

type - lockType to test for

Returns:

true of locked; false if not.

getWriteOwner

public Object getWriteOwner(Fqn f)

Deprecated.

Description copied from interface: LockManager

Retrieves the write lock owner, if any, for the current Fqn.

Parameters:

f - Fqn to inspect

Returns:

the owner of the lock, or null if not locked.

getReadOwners

public Collection<Object> getReadOwners(Fqn f)

Deprecated.

Description copied from interface: LockManager

Retrieves the read lock owners, if any, for the current Fqn.

Parameters:

f - Fqn to inspect

Returns:

a collection of read lock owners, or an empty collection if not locked.

getWriteOwner

public Object getWriteOwner(NodeSPI node)

Deprecated.

Description copied from interface: LockManager

Retrieves the write lock owner, if any, for the current Fqn.

Parameters:

node - the node to inspect

Returns:

the owner of the lock, or null if not locked.

getReadOwners

public Collection<Object> getReadOwners(NodeSPI node)

Deprecated.

Description copied from interface: LockManager

Retrieves the read lock owners, if any, for the current Fqn.

Parameters:

node - the node to inspect

Returns:

a collection of read lock owners, or an empty collection if not locked.

printLockInfo

public String printLockInfo(NodeSPI node)

Deprecated.

Description copied from interface: LockManager

Prints lock information about a node (and its children) to a String.

Parameters:

node - node to inspect

printLockInfo

public String printLockInfo()

Deprecated.

Description copied from interface: LockManager

Prints lock information for all locks.

Returns:

lock information