Type Alias IWriterLock

Type declaration

• acquireWriter:function

  • acquireWriter(): ITask<boolean>

  • The acquireWriter 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.

• acquireWriterBlocking:function

  • acquireWriterBlocking(
        settings?: SharedLockAquireBlockingSettings,
    ): ITask<boolean>

  • The acquireWriterBlocking 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: SharedLockAquireBlockingSettings

    Returns ITask<boolean>

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

• acquireWriterBlockingOrFail:function

  • acquireWriterBlockingOrFail(
        settings?: SharedLockAquireBlockingSettings,
    ): ITask<void>

  • The acquireWriterBlockingOrFail 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: SharedLockAquireBlockingSettings

    Returns ITask<void>

    Throws

    FailedAcquireWriterLockError

• acquireWriterOrFail:function

  • acquireWriterOrFail(): ITask<void>

  • The acquireWriterOrFail 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

    FailedAcquireWriterLockError

• forceReleaseWriter:function

  • forceReleaseWriter(): ITask<boolean>

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

    Returns ITask<boolean>

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

• refreshWriter:function

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

  • The refreshWriter 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.

• refreshWriterOrFail:function

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

  • The refreshWriterOrFail 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

    FailedRefreshWriterLockError

• releaseWriter:function

  • releaseWriter(): ITask<boolean>

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

    Returns ITask<boolean>

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

• releaseWriterOrFail:function

  • releaseWriterOrFail(): ITask<void>

  • The releaseWriterOrFail 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

    FailedReleaseWriterLockError

• runWriterBlockingOrFail:function

  • runWriterBlockingOrFail<TValue = void>(
        asyncFn: AsyncLazy<TValue>,
        settings?: SharedLockAquireBlockingSettings,
    ): ITask<TValue>

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

    Type Parameters

    • TValue = void

    Parameters

    • asyncFn: AsyncLazy<TValue>
    • Optionalsettings: SharedLockAquireBlockingSettings

    Returns ITask<TValue>

    Throws

    FailedAcquireWriterLockError

• runWriterOrFail:function

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

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

    Type Parameters

    • TValue = void

    Parameters

    • asyncFn: AsyncLazy<TValue>

    Returns ITask<TValue>

    Throws

    FailedAcquireWriterLockError