Package org.alfresco.repo.virtual.bundle

Class VirtualLockServiceExtension

java.lang.Object

org.alfresco.traitextender.SingletonExtension<E,T>

org.alfresco.traitextender.SpringBeanExtension<LockServiceExtension,LockServiceTrait>

org.alfresco.repo.virtual.bundle.VirtualLockServiceExtension

All Implemented Interfaces:

LockServiceExtension, LockService

public class VirtualLockServiceExtension
extends SpringBeanExtension<LockServiceExtension,LockServiceTrait>
implements LockServiceExtension

Field Summary

Fields inherited from interface org.alfresco.service.cmr.lock.LockService

TIMEOUT_INFINITY

Constructor Summary

Constructors

Constructor	Description
VirtualLockServiceExtension()

Method Summary

Modifier and Type	Method	Description
void	checkForLock(NodeRef nodeRef)	Checks to see if the current user has access to the specified node.
void	enableLocks()	After calling suspendLocks turn the locks back on.
String	getAdditionalInfo(NodeRef nodeRef)	Retrieve the additional lock info associated with a node ref.
LockState	getLockState(NodeRef nodeRef)	Retrieve the lock properties for the given NodeRef.
LockStatus	getLockStatus(NodeRef nodeRef)	Gets the lock status for the node reference relative to the current user.
LockStatus	getLockStatus(NodeRef nodeRef, String userName)	Gets the lock status for the node reference for the specified user.
LockType	getLockType(NodeRef nodeRef)	Gets the lock type for the node indicated.
boolean	isLocked(NodeRef nodeRef)	Indicates if the node is locked for the current user.
boolean	isLockedAndReadOnly(NodeRef nodeRef)	Indicates if the node is locked AND it's *not* a WRITE_LOCK for the current user.
void	lock(Collection<NodeRef> nodeRefs, LockType lockType, int timeToExpire)	Places a lock on all the nodes referenced in the passed list.
void	lock(NodeRef nodeRef, LockType lockType)	Places a lock on a node.
void	lock(NodeRef nodeRef, LockType lockType, int timeToExpire)	Places a persistent lock on a node.
void	lock(NodeRef nodeRef, LockType lockType, int timeToExpire, boolean lockChildren)	Places a lock on a node and optionally on all its children.
void	lock(NodeRef nodeRef, LockType lockType, int timeToExpire, Lifetime lifetime)	Places a lock on a node.
void	lock(NodeRef nodeRef, LockType lockType, int timeToExpire, Lifetime lifetime, boolean lockChildren)	Places a lock on a node and optionally on all its children.
void	lock(NodeRef nodeRef, LockType lockType, int timeToExpire, Lifetime lifetime, String additionalInfo)	Places a lock on a node.
void	setEphemeralExpiryThreshold(int threshSecs)	Specifies the maximum expiry time for which a request for an ephemeral lock will be honoured.
void	setSmartStore(VirtualStore smartStore)
void	suspendLocks()	Allow the current transaction to update a node despite any locks that may be on it.
void	unlock(Collection<NodeRef> nodeRefs)	Removes a lock on the nodes provided.
void	unlock(NodeRef nodeRef)	Removes the lock on a node; if there is no lock then nothing is done.
void	unlock(NodeRef nodeRef, boolean lockChildren)	Removes the lock on a node and optional on its children.
void	unlock(NodeRef nodeRef, boolean lockChildren, boolean allowCheckedOut)	Removes the lock on a node and optional on its children.

Methods inherited from class org.alfresco.traitextender.SpringBeanExtension

register, setExtensionPoint

Methods inherited from class org.alfresco.traitextender.SingletonExtension

acceptsTrait, acceptsTraitClass, getTrait

Methods inherited from class java.lang.Object

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

Constructor Details

VirtualLockServiceExtension

public VirtualLockServiceExtension()

Method Details

setSmartStore

public void setSmartStore(VirtualStore smartStore)

lock

public void lock(NodeRef nodeRef,
 LockType lockType)
          throws UnableToAquireLockException

Description copied from interface: LockService

Places a lock on a node.

The lock prevents any other user or process from comitting updates to the node until the lock is released.

The lock will be owned by the current user.

A lock made with this call will never expire.

Specified by:

lock in interface LockService

Parameters:

nodeRef - a reference to a node

lockType - the lock type

Throws:

UnableToAquireLockException - thrown if the lock could not be obtained

lock

public void lock(NodeRef nodeRef,
 LockType lockType,
 int timeToExpire)
          throws UnableToAquireLockException

Description copied from interface: LockService

Places a persistent lock on a node.

The lock prevents any other user or process from comitting updates to the node until the lock is released.

The lock will be owned by the current user.

If the time to expire is 0 then the lock will never expire. Otherwise the timeToExpire indicates the number of seconds before the lock expires. When a lock expires the lock is considered to have been released.

If the node is already locked and the user is the lock owner then the lock will be renewed with the passed timeToExpire.

Specified by:

lock in interface LockService

Parameters:

nodeRef - a reference to a node

lockType - the lock type

timeToExpire - the number of seconds before the locks expires.

Throws:

UnableToAquireLockException - thrown if the lock could not be obtained

lock

public void lock(NodeRef nodeRef,
 LockType lockType,
 int timeToExpire,
 Lifetime lifetime)
          throws UnableToAquireLockException

Description copied from interface: LockService

Places a lock on a node.

The lock prevents any other user or process from comitting updates to the node until the lock is released.

The lock will be owned by the current user.

If the time to expire is 0 then the lock will never expire. Otherwise the timeToExpire indicates the number of seconds before the lock expires. When a lock expires the lock is considered to have been released.

If the node is already locked and the user is the lock owner then the lock will be renewed with the passed timeToExpire.

Specified by:

lock in interface LockService

Parameters:

nodeRef - a reference to a node

lockType - the lock type

timeToExpire - the number of seconds before the locks expires.

lifetime - allows persistent or ephemeral locks to be specified.

Throws:

UnableToAquireLockException - thrown if the lock could not be obtained

lock

public void lock(NodeRef nodeRef,
 LockType lockType,
 int timeToExpire,
 Lifetime lifetime,
 String additionalInfo)
          throws UnableToAquireLockException

Description copied from interface: LockService

Places a lock on a node.

The lock prevents any other user or process from comitting updates to the node until the lock is released.

The lock will be owned by the current user.

If the time to expire is 0 then the lock will never expire. Otherwise the timeToExpire indicates the number of seconds before the lock expires. When a lock expires the lock is considered to have been released.

If the node is already locked and the user is the lock owner then the lock will be renewed with the passed timeToExpire.

Specified by:

lock in interface LockService

Parameters:

nodeRef - a reference to a node

lockType - the lock type

timeToExpire - the number of seconds before the locks expires.

lifetime - allows persistent or ephemeral locks to be specified.

additionalInfo - additional lock data stored alongside core lock data such as timeToExpire. NOTE: only valid for ephemeral locks.

Throws:

UnableToAquireLockException - thrown if the lock could not be obtained

lock

public void lock(NodeRef nodeRef,
 LockType lockType,
 int timeToExpire,
 boolean lockChildren)
          throws UnableToAquireLockException

Description copied from interface: LockService

Places a lock on a node and optionally on all its children.

The lock prevents any other user or process from committing updates to the node until the lock is released.

The lock will be owned by the current user.

If any one of the child locks can not be taken then an exception will be raised and all locks cancelled.

If the time to expire is 0 then the lock will never expire. Otherwise the timeToExpire indicates the number of seconds before the lock expires. When a lock expires the lock is considered to have been released.

If the node is already locked and the user is the lock owner then the lock will be renewed with the passed timeToExpire.

Specified by:

lock in interface LockService

Parameters:

nodeRef - a reference to a node

lockType - the lock type

timeToExpire - the number of seconds before the locks expires.

lockChildren - if true indicates that all the children (and grandchildren, etc) of the node will also be locked, false otherwise

Throws:

UnableToAquireLockException - thrown if the lock could not be obtained

lock

public void lock(NodeRef nodeRef,
 LockType lockType,
 int timeToExpire,
 Lifetime lifetime,
 boolean lockChildren)
          throws UnableToAquireLockException

Description copied from interface: LockService

Places a lock on a node and optionally on all its children.

The lock prevents any other user or process from committing updates to the node until the lock is released.

The lock will be owned by the current user.

If the time to expire is 0 then the lock will never expire. Otherwise the timeToExpire indicates the number of seconds before the lock expires. When a lock expires the lock is considered to have been released.

If the node is already locked and the user is the lock owner then the lock will be renewed with the passed timeToExpire.

Specified by:

lock in interface LockService

Parameters:

nodeRef - a reference to a node

lockType - the lock type

timeToExpire - the number of seconds before the locks expires.

lifetime - allows persistent or ephemeral locks to be specified.

lockChildren - if true indicates that all the children (and grandchildren, etc) of the node will also be locked, false otherwise

Throws:

UnableToAquireLockException - thrown if the lock could not be obtained

lock

public void lock(Collection<NodeRef> nodeRefs,
 LockType lockType,
 int timeToExpire)
          throws UnableToAquireLockException

Description copied from interface: LockService

Places a lock on all the nodes referenced in the passed list.

The lock prevents any other user or process from comitting updates to the node until the lock is released.

The lock will be owned by the current user.

If the time to expire is 0 then the lock will never expire. Otherwise the timeToExpire indicates the number of seconds before the lock expires. When a lock expires the lock is considered to have been released.

If the node is already locked and the current user is the lock owner then the lock will be renewed with the passed timeToExpire.

Specified by:

lock in interface LockService

Parameters:

nodeRefs - a list of node references

lockType - the type of lock being created

timeToExpire - the number of seconds before the locks expires.

Throws:

UnableToAquireLockException - thrown if the lock could not be obtained

unlock

public void unlock(NodeRef nodeRef)
            throws UnableToReleaseLockException

Description copied from interface: LockService

Removes the lock on a node; if there is no lock then nothing is done.

The user must have sufficient permissions to remove the lock (ie: be the owner of the lock or have admin rights) and the node must not be checked out. Otherwise an exception will be raised.

Specified by:

unlock in interface LockService

Parameters:

nodeRef - a reference to a node

Throws:

UnableToReleaseLockException - thrown if the lock could not be released

unlock

public void unlock(NodeRef nodeRef,
 boolean lockChildren)
            throws UnableToReleaseLockException

Description copied from interface: LockService

Removes the lock on a node and optional on its children.

The user must have sufficient permissions to remove the lock(s) (ie: be the owner of the lock(s) or have admin rights) and the node(s) must not be checked out. Otherwise an exception will be raised.

If one of the child nodes is not locked then it will be ignored and the process continue without error.

If the lock on any one of the child nodes cannot be released then an exception will be raised.

Specified by:

unlock in interface LockService

Parameters:

nodeRef - a node reference

lockChildren - if true then all the children (and grandchildren, etc) of the node will also be unlocked, false otherwise

Throws:

UnableToReleaseLockException - thrown if the lock could not be released

unlock

public void unlock(NodeRef nodeRef,
 boolean lockChildren,
 boolean allowCheckedOut)
            throws UnableToReleaseLockException

Description copied from interface: LockService

Removes the lock on a node and optional on its children.

The user must have sufficient permissions to remove the lock(s) (ie: be the owner of the lock(s) or have admin rights) otherwise an exception will be raised.

If one of the child nodes is not locked then it will be ignored and the process continue without error.

If the lock on any one of the child nodes cannot be released then an exception will be raised.

Specified by:

unlock in interface LockService

Parameters:

nodeRef - a node reference

lockChildren - if true then all the children (and grandchildren, etc) of the node will also be unlocked, false otherwise

allowCheckedOut - is it permissable for a node to be a checked out node?

Throws:

UnableToReleaseLockException - thrown if the lock could not be released

unlock

public void unlock(Collection<NodeRef> nodeRefs)
            throws UnableToReleaseLockException

Description copied from interface: LockService

Removes a lock on the nodes provided.

The user must have sufficient permissions to remove the locks (ie: be the owner of the locks or have admin rights) otherwise an exception will be raised.

If one of the nodes is not locked then it will be ignored and the process will continue without an error.

If the lock on any one of the nodes cannot be released than an exception will be raised and the process rolled back.

Specified by:

unlock in interface LockService

Parameters:

nodeRefs - the node references

Throws:

UnableToReleaseLockException - thrown if the lock could not be released

getLockStatus

public LockStatus getLockStatus(NodeRef nodeRef)

Description copied from interface: LockService

Gets the lock status for the node reference relative to the current user.

Specified by:

getLockStatus in interface LockService

Parameters:

nodeRef - the node reference

Returns:

the lock status

See Also:

• LockService.getLockStatus(NodeRef)

getLockStatus

public LockStatus getLockStatus(NodeRef nodeRef,
 String userName)

Description copied from interface: LockService

Gets the lock status for the node reference for the specified user.

Specified by:

getLockStatus in interface LockService

Parameters:

nodeRef - the node reference

userName - the user name

Returns:

the lock status

See Also:

• LockService.getLockStatus(NodeRef)

getLockType

public LockType getLockType(NodeRef nodeRef)

Description copied from interface: LockService

Gets the lock type for the node indicated.

Returns null if the node is not locked.

Throws an exception if the node does not have the lock aspect.

Specified by:

getLockType in interface LockService

Parameters:

nodeRef - the node reference

Returns:

the lock type, null is returned if the object in question has no lock

checkForLock

public void checkForLock(NodeRef nodeRef)

Description copied from interface: LockService

Checks to see if the current user has access to the specified node.

If the node is locked by another user then a NodeLockedException is thrown.

Gets the user reference from the current session.

Specified by:

checkForLock in interface LockService

Parameters:

nodeRef - the node reference

suspendLocks

public void suspendLocks()

Description copied from interface: LockService

Allow the current transaction to update a node despite any locks that may be on it.

Used for the system to be able to update locked nodes.

Specified by:

suspendLocks in interface LockService

enableLocks

public void enableLocks()

Description copied from interface: LockService

After calling suspendLocks turn the locks back on.

Specified by:

enableLocks in interface LockService

getAdditionalInfo

public String getAdditionalInfo(NodeRef nodeRef)

Description copied from interface: LockService

Retrieve the additional lock info associated with a node ref.

Specified by:

getAdditionalInfo in interface LockService

Parameters:

nodeRef - NodeRef

Returns:

Additional info string or null

getLockState

public LockState getLockState(NodeRef nodeRef)

Description copied from interface: LockService

Retrieve the lock properties for the given NodeRef.

Do NOT use the returned information to determine the actual state of a lock, use LockService.getLockStatus(NodeRef) and other LockService methods for this purpose.

The returned data is intended for information purposes only, e.g. returning the timeout in a WebDAV response.

Specified by:

getLockState in interface LockService

Parameters:

nodeRef - NodeRef

Returns:

LockState

setEphemeralExpiryThreshold

public void setEphemeralExpiryThreshold(int threshSecs)

Description copied from interface: LockService

Specifies the maximum expiry time for which a request for an ephemeral lock will be honoured. Requests for ephemeral locks with expiry times greater than this value will be automatically converted to a request for a persistent lock.

Specified by:

setEphemeralExpiryThreshold in interface LockService

Parameters:

threshSecs - int

isLocked

public boolean isLocked(NodeRef nodeRef)

Description copied from interface: LockService

Indicates if the node is locked for the current user.

Specified by:

isLocked in interface LockService

Returns:

isLockedAndReadOnly

public boolean isLockedAndReadOnly(NodeRef nodeRef)

Description copied from interface: LockService

Indicates if the node is locked AND it's *not* a WRITE_LOCK for the current user.

Specified by:

isLockedAndReadOnly in interface LockService

Returns: