ILock

Interface for locks used to synchronize work or parallel processes and to prevent collisions.

Description

The ILock interface provides the methods to create locks used to synchronize work or parallel processes and to prevent collisions.

Important points

  • The interface allows to manage multiple locks identified by unique keys.

Instance methods

acquireLock

Makes a single attempt to acquire a lock by its key. It returns a positive or negative result immediately.

Future acquireLock(String? correlationId, String key, int ttl, int timeout)

  • correlationId: String? -(optional) transaction id used to trace execution through a call chain.
  • key: String - unique lock key to acquire.
  • ttl: int - lock timeout (time to live) in milliseconds.
  • timeout: int - lock acquisition timeout.

tryAcquireLock

Makes a single attempt to acquire a lock by its key. It returns a positive or negative result immediately.

Future<bool> tryAcquireLock(String? correlationId, String key, int ttl)

  • correlationId: String? -(optional) transaction id used to trace execution through a call chain.
  • key: String - unique lock key to acquire.
  • ttl: int - lock timeout (time to live) in milliseconds.
  • return: Future<bool> - lock result

releaseLock

Releases a prevously acquired lock by its key.

Future releaseLock(String? correlationId, String key)

  • correlationId: String? - (optional) transaction id used to trace execution through a call chain.
  • key: String - unique lock key to release.