ee.telekom.workflow.core.lock

Interface LockService

All Known Implementing Classes:

LockServiceImpl

public interface LockService

Provides a lock service to manage a cluster wide shared lock.

All operations are implemented atomically such that they are safe for concurrent usage from different JVM's.

The service is intended as a mean to determine the cluster's master node.

Method Summary

Modifier and Type	Method and Description
boolean	acquireLock() Attempts to acquire the cluster's lock
boolean	eagerAcquire() Releases expired locks and afterwards attempts to refresh its own lock or acquire the lock.
Date	getLockExpireDate() Returns the locks expire date or null if no cluster is not locked.
String	getLockOwner() Returns the cluster's lock owner.
boolean	isOwnLock()
boolean	refreshOwnLock() Attempts to refresh the owned lock.
boolean	releaseExpiredLock() Attempt to release the cluster's lock if it has expired.
boolean	releaseOwnLock() Releases the owned lock.

Method Detail

eagerAcquire

boolean eagerAcquire()

Releases expired locks and afterwards attempts to refresh its own lock or acquire the lock.

Returns:

true, if lock is owned. Otherwise false.

acquireLock

boolean acquireLock()

Attempts to acquire the cluster's lock

Returns:

true, if lock was acquired. Otherwise false.

isOwnLock

boolean isOwnLock()

Returns:

true, if lock is owned by this node. Otherwise false.

refreshOwnLock

boolean refreshOwnLock()

Attempts to refresh the owned lock. Refreshing the lock means to postpone its expiration date.

Returns:

true, if lock was refreshed. Otherwise false.

releaseOwnLock

boolean releaseOwnLock()

Releases the owned lock.

Returns:

true, if lock was released. Otherwise false.

releaseExpiredLock

boolean releaseExpiredLock()

Attempt to release the cluster's lock if it has expired.

Returns:

true, if the lock was expired and is now released.

getLockOwner

String getLockOwner()

Returns the cluster's lock owner.

Returns:

the cluster's lock owner.

getLockExpireDate

Date getLockExpireDate()

Returns the locks expire date or null if no cluster is not locked.

Returns:

the locks expire date or null if no cluster is not locked.