com.webmethods.portal.service.task

Interface ITaskLockingService

All Superinterfaces:

IClusterLockingService

Deprecated.

@Deprecated
public interface ITaskLockingService
extends IClusterLockingService

Class ITaskLockingService is used to manage cluster-wide locks on tasks. Following code can be used to obtain singleton instance of the ITaskLockingService:

ITaskSystem taskSystem = (ITaskSystem) PortalSystem.getTaskProvider();
ITaskLockingService ls = taskSystem.getTaskLockingService();

Field Summary

Fields inherited from interface com.webmethods.portal.system.lock.IClusterLockingService

LOCKING_SERVICE_NAME, TASK_LOCK_MAX_TIME, TASK_LOCK_MAX_WAIT_TIME

Method Summary

Modifier and Type	Method and Description
ITaskLock	acquireLock(IURI sourceURI, IURI taskURI, long validTime, long waitTime) Deprecated.
ITaskLock	acquireLock(IURI sourceURI, IURI taskURI, long validTime, long waitTime, boolean newChange) Deprecated. Acquires distributed lock for the given task.
ITaskLock	getLock(IURI taskURI) Deprecated. Returns instance of any existing lock for the specified task instance
boolean	isLightweightLocking() Deprecated. Whether lock service uses lightweight locking.
void	releaseLock(ITaskLock lock) Deprecated. Releases previously acquired lock
void	setLightweightLocking(boolean value) Deprecated. Sets lightweight locking use.

Methods inherited from interface com.webmethods.portal.system.lock.IClusterLockingService

releaseLock

Method Detail

acquireLock

ITaskLock acquireLock(IURI sourceURI,
                      IURI taskURI,
                      long validTime,
                      long waitTime,
                      boolean newChange)
               throws PortalException

Deprecated.

Acquires distributed lock for the given task. Lock is owned by source object. Lock will be valid specified time. If there is an active lock on the given task this API call may wait for current lock to expire to be released up to specified waitTime.

Specified by:

acquireLock in interface IClusterLockingService

Parameters:

sourceURI - source URI for the lock owner

taskURI - uri of the task to be locked

validTime - time in millis the lock will be valid. 0 - indefinite

waitTime - waiting time to acquire a lock. 0 - immediately exit if lock can not be obtained)

Returns:

acquired lock instance or null if unable to acquire a lock

Throws:

PortalException

acquireLock

ITaskLock acquireLock(IURI sourceURI,
                      IURI taskURI,
                      long validTime,
                      long waitTime)
               throws PortalException

Deprecated.

Specified by:

acquireLock in interface IClusterLockingService

Throws:

PortalException

releaseLock

void releaseLock(ITaskLock lock)
          throws PortalException

Deprecated.

Releases previously acquired lock

Parameters:

lock - to be released

Throws:

PortalException

getLock

ITaskLock getLock(IURI taskURI)
           throws PortalException

Deprecated.

Returns instance of any existing lock for the specified task instance

Specified by:

getLock in interface IClusterLockingService

Parameters:

taskURI - uri of the task to return lock for

Returns:

active lock instance or null if not does not exist

Throws:

PortalException

isLightweightLocking

boolean isLightweightLocking()

Deprecated.

Whether lock service uses lightweight locking. Can be safely used only inside single JVM, not across the cluster

Specified by:

isLightweightLocking in interface IClusterLockingService

setLightweightLocking

void setLightweightLocking(boolean value)

Deprecated.

Sets lightweight locking use. Can be safely used only inside single JVM, not across the cluster

Specified by:

setLightweightLocking in interface IClusterLockingService