Package org.redisson.api

Interface RFencedLockRx

All Superinterfaces:

RLockRx

public interface RFencedLockRx
extends RLockRx

Redis based implementation of Fenced Lock with reentrancy support.

Each lock acquisition increases fencing token. It should be checked if it's greater or equal with the previous one by the service guarded by this lock and reject operation if condition is false.

Author:

Nikita Koksharov

Method Summary

Modifier and Type	Method	Description
io.reactivex.rxjava3.core.Single<Long>	getToken()	Returns current fencing token
io.reactivex.rxjava3.core.Single<Long>	lockAndGetToken()	Acquires the lock and returns increased fencing token.
io.reactivex.rxjava3.core.Single<Long>	lockAndGetToken(long leaseTime, TimeUnit unit)	Acquires the lock with defined leaseTime and returns increased fencing token.
io.reactivex.rxjava3.core.Maybe<Long>	tryLockAndGetToken()	Tries to acquire the lock and returns increased fencing token if operation successful.
io.reactivex.rxjava3.core.Maybe<Long>	tryLockAndGetToken(long waitTime, long leaseTime, TimeUnit unit)	Tries to acquire the lock with defined leaseTime and returns increased fencing token.
io.reactivex.rxjava3.core.Maybe<Long>	tryLockAndGetToken(long waitTime, TimeUnit unit)	Tries to acquire the lock and returns increased fencing token.

Methods inherited from interface org.redisson.api.RLockRx

forceUnlock, getHoldCount, getName, isLocked, lock, lock, lock, lock, remainTimeToLive, tryLock, tryLock, tryLock, tryLock, tryLock, unlock, unlock

Method Details

getToken

io.reactivex.rxjava3.core.Single<Long> getToken()

Returns current fencing token

Returns:

fencing token

lockAndGetToken

io.reactivex.rxjava3.core.Single<Long> lockAndGetToken()

Acquires the lock and returns increased fencing token. Waits if necessary until lock became available.

Returns:

fencing token

lockAndGetToken

io.reactivex.rxjava3.core.Single<Long> lockAndGetToken(long leaseTime,
 TimeUnit unit)

Acquires the lock with defined leaseTime and returns increased fencing token. Waits if necessary until lock became available.

Lock will be released automatically after defined leaseTime interval.

Parameters:

leaseTime - the maximum time to hold the lock after it's acquisition, if it hasn't already been released by invoking unlock. If leaseTime is -1, hold the lock until explicitly unlocked.

unit - the time unit

Returns:

fencing token

tryLockAndGetToken

io.reactivex.rxjava3.core.Maybe<Long> tryLockAndGetToken()

Tries to acquire the lock and returns increased fencing token if operation successful.

Returns:

fencing token if lock acquired otherwise null

tryLockAndGetToken

io.reactivex.rxjava3.core.Maybe<Long> tryLockAndGetToken(long waitTime,
 TimeUnit unit)

Tries to acquire the lock and returns increased fencing token. Waits up to defined waitTime if necessary until the lock became available.

Parameters:

waitTime - the maximum time to acquire the lock

unit - time unit

Returns:

fencing token if lock is successfully acquired, otherwise null if lock is already set.

tryLockAndGetToken

io.reactivex.rxjava3.core.Maybe<Long> tryLockAndGetToken(long waitTime,
 long leaseTime,
 TimeUnit unit)

Tries to acquire the lock with defined leaseTime and returns increased fencing token. Waits up to defined waitTime if necessary until the lock became available.

Lock will be released automatically after defined leaseTime interval.

Parameters:

waitTime - the maximum time to acquire the lock

leaseTime - lease time

unit - time unit

Returns:

fencing token if lock is successfully acquired, otherwise null if lock is already set.