@PublicApi
public interface ClusterLockService
For safety reasons, an acquired lock will never time-out. However if the node that holds the lock is shutdown or is unable to reach the DB for an extended period then the lock is considered to no longer be valid and can be acquired by another node.
The Locks returned by this service are re-entrant.
A simple implementation of this Service can be provided by single-node apps in order to satisfy cross-product libraries that need it.
Lock names can be up to 255 characters. Obviously they should be namespaced adequately to avoid conflicts with other plugins - the reverse DNS name convention is recommended. Some implementations will store the lock name in the underlying database, and so the name may be treated as case-sensitive in some environments, and case-insensitive in other environments. To avoid unforeseen compatibility issues, consumers are recommended to use names that consist of "simple" ASCII characters (eg alphanumeric, hyphen and underscore).
Application developers should consider using one of the implementations provided by beehive-single-node,
beehive-db, or beehive-hazelcast instead of creating an implementation that is specific to the application.
SimpleClusterLockService (beehive-single-node) — for single node applicationsDatabaseClusterLockService (beehive-db) — for clustered applications that
use database objects to control cluster-wide locking behaviourHazelcastClusterLockService (beehive-hazelcast) — for clustered applications
that can use the Hazelcast library to implement distributed messaging and locking| Modifier and Type | Method and Description |
|---|---|
ClusterLock |
getLockForName(String lockName)
Returns the cluster-wide lock for the given name.
|
ClusterLock getLockForName(@Nonnull String lockName)
lockName - the globally unique lock identifierCopyright © 2022 Atlassian. All rights reserved.