Package com.coditory.sherlock

Interface Sherlock

All Known Implementing Classes:
SherlockStub
public interface Sherlock
Manages distributed locks.

  • Method Details

    • initialize

      void initialize()
      Initializes underlying infrastructure. If this method is not invoked explicitly then it can be invoked implicitly when acquiring or releasing a lock for the first time.

      Initialization creates indexes and tables.

    • createLock

      @NotNull @NotNull com.coditory.sherlock.DistributedLockBuilder<DistributedLock> createLock()
      Creates a distributed single-entrant lock builder. Single-entrant lock can be acquired only once. Even the same owner cannot acquire the same lock again. 
      
 assert lock.acquire() == true
 assert lock.acquire() == false
      Returns:
      the lock builder

    • createLock

      @NotNull default @NotNull DistributedLock createLock(@NotNull @NotNull String lockId)
      Creates a single-entrant lock with default configuration.
      Parameters:
      lockId - lock identifier
      Returns:
      the lock
      See Also:

    • createReentrantLock

      @NotNull @NotNull com.coditory.sherlock.DistributedLockBuilder<DistributedLock> createReentrantLock()
      Creates a distributed reentrant lock. Reentrant lock may be acquired multiple times by the same owner: 
      
 assert reentrantLock.acquire() == true
 assert reentrantLock.acquire() == true
      Returns:
      the reentrant lock builder

    • createReentrantLock

      @NotNull default @NotNull DistributedLock createReentrantLock(@NotNull @NotNull String lockId)
      Creates a reentrant lock with default configuration.
      Parameters:
      lockId - lock identifier
      Returns:
      the reentrant lock
      See Also:

    • createOverridingLock

      @NotNull @NotNull com.coditory.sherlock.DistributedLockBuilder<DistributedLock> createOverridingLock()
      Create a distributed overriding lock. Returned lock may acquire or release any other lock without checking its state: 
      
 assert someLock.acquire() == true
 assert overridingLock.acquire() == true

      It could be used for administrative actions.

      Returns:
      the overriding lock builder

    • createOverridingLock

      @NotNull default @NotNull DistributedLock createOverridingLock(@NotNull @NotNull String lockId)
      Creates an overriding lock with default configuration.
      Parameters:
      lockId - lock identifier
      Returns:
      the overriding lock
      See Also:

    • forceReleaseAllLocks

      boolean forceReleaseAllLocks()
      Force releases all acquired locks.

      It could be used for administrative actions.

      Returns:
      ReleaseResult

    • forceReleaseLock

      default boolean forceReleaseLock(@NotNull @NotNull String lockId)
      Force releases a lock.

      It could be used for administrative actions.

      Parameters:
      lockId - lock identifier
      Returns:
      ReleaseResult