Type Alias ILockBase

Type declaration

• acquire:function

  • acquire(): ITask<boolean>

  • The acquire method acquires a lock only if the key is not already acquired by different owner.

    Returns ITask<boolean>

    Returns true if the lock is not already acquired otherwise false is returned.

• acquireBlocking:function

  • acquireBlocking(settings?: LockAquireBlockingSettings): ITask<boolean>

  • The acquireBlocking method acquires a lock only if the key is not already acquired by different owner. If the lock is not acquired, it retries every settings.interval until settings.time is reached.

    Parameters

    • Optionalsettings: LockAquireBlockingSettings

    Returns ITask<boolean>

    Returns true if the lock is not already acquired otherwise false is returned.

• acquireBlockingOrFail:function

  • acquireBlockingOrFail(settings?: LockAquireBlockingSettings): ITask<void>

  • The acquireBlockingOrFail method acquires a lock only if the key is not already acquired by different owner. If the lock is not acquired, it retries every settings.interval until settings.time is reached. Throws an error if the lock is already acquired by different owner.

    Parameters

    • Optionalsettings: LockAquireBlockingSettings

    Returns ITask<void>

    Throws

    FailedAcquireLockError

• acquireOrFail:function

  • acquireOrFail(): ITask<void>

  • The acquireOrFail method acquires a lock only if the key is not already acquired by different owner. Throws an error if the lock is already acquired by different owner.

    Returns ITask<void>

    Throws

    FailedAcquireLockError

• forceRelease:function

  • forceRelease(): ITask<boolean>

  • The forceRelease method releases a lock regardless of the owner.

    Returns ITask<boolean>

    Returns true if the lock exists or false if the lock doesnt exists.

• refresh:function

  • refresh(ttl?: ITimeSpan): ITask<boolean>

  • The refresh method updates the ttl of the lock if expireable and owned by the same owner.

    Parameters

    • Optionalttl: ITimeSpan

    Returns ITask<boolean>

    Returns true if the lock is refreshed otherwise false is returned.

• refreshOrFail:function

  • refreshOrFail(ttl?: ITimeSpan): ITask<void>

  • The refreshOrFail method updates the ttl of the lock if expireable and owned by the same owner. Throws an error if the lock is not owned by same owner. Throws an error if the key is unexpirable.

    Parameters

    • Optionalttl: ITimeSpan

    Returns ITask<void>

    Throws

    FailedRefreshLockError

• release:function

  • release(): ITask<boolean>

  • The release method releases a lock if owned by the same owner.

    Returns ITask<boolean>

    Returns true if the lock is released otherwise false is returned.

• releaseOrFail:function

  • releaseOrFail(): ITask<void>

  • The releaseOrFail method releases a lock if owned by the same owner. Throws an error if the lock is not owned by same owner.

    Returns ITask<void>

    Throws

    FailedReleaseLockError

• runBlockingOrFail:function

  • runBlockingOrFail<TValue = void>(
        asyncFn: AsyncLazy<TValue>,
        settings?: LockAquireBlockingSettings,
    ): ITask<TValue>

  • The runBlockingOrFail method wraps an Invokable or ITask with the acquireBlockingOrFail and release method.

    Type Parameters

    • TValue = void

    Parameters

    • asyncFn: AsyncLazy<TValue>
    • Optionalsettings: LockAquireBlockingSettings

    Returns ITask<TValue>

    Throws

    FailedAcquireLockError

• runOrFail:function

  • runOrFail<TValue = void>(asyncFn: AsyncLazy<TValue>): ITask<TValue>

  • The runOrFail method wraps an Invokable or ITask with the acquireOrFail and release method.

    Type Parameters

    • TValue = void

    Parameters

    • asyncFn: AsyncLazy<TValue>

    Returns ITask<TValue>

    Throws

    FailedAcquireLockError