org.redisson.api

Interface RSemaphoreReactive

All Superinterfaces:

RExpirableReactive, RObjectReactive

public interface RSemaphoreReactive
extends RExpirableReactive

Reactive interface of Redis based Semaphore.

Works in non-fair mode. Therefore order of acquiring is unpredictable.

Author:

Nikita Koksharov

Method Summary

Modifier and Type	Method and Description
reactor.core.publisher.Mono<Void>	acquire() Acquires a permit.
reactor.core.publisher.Mono<Void>	acquire(int permits) Acquires defined amount of permits.
reactor.core.publisher.Mono<Void>	addPermits(int permits) Increases or decreases the number of available permits by defined value.
reactor.core.publisher.Mono<Integer>	availablePermits() Returns amount of available permits.
reactor.core.publisher.Mono<Integer>	drainPermits() Acquires and returns all permits that are immediately available.
reactor.core.publisher.Mono<Void>	release() Releases a permit.
reactor.core.publisher.Mono<Void>	release(int permits) Releases defined amount of permits.
reactor.core.publisher.Mono<Boolean>	tryAcquire() Acquires a permit.
reactor.core.publisher.Mono<Boolean>	tryAcquire(int permits) Tries to acquire defined amount of currently available permits.
reactor.core.publisher.Mono<Boolean>	tryAcquire(int permits, long waitTime, TimeUnit unit) Tries to acquire defined amount of currently available permits.
reactor.core.publisher.Mono<Boolean>	tryAcquire(long waitTime, TimeUnit unit) Tries to acquire currently available permit.
reactor.core.publisher.Mono<Boolean>	trySetPermits(int permits) Tries to set number of permits.

Methods inherited from interface org.redisson.api.RExpirableReactive

clearExpire, expire, expireAt, expireAt, remainTimeToLive

Methods inherited from interface org.redisson.api.RObjectReactive

addListener, copy, delete, dump, getCodec, getIdleTime, getName, isExists, migrate, move, removeListener, rename, renamenx, restore, restore, restoreAndReplace, restoreAndReplace, sizeInMemory, touch, unlink

Method Detail

tryAcquire

reactor.core.publisher.Mono<Boolean> tryAcquire()

Acquires a permit. Waits if necessary until a permit became available.

Returns:

true if a permit was acquired and false otherwise

tryAcquire

reactor.core.publisher.Mono<Boolean> tryAcquire(int permits)

Tries to acquire defined amount of currently available permits.

Parameters:

permits - the number of permits to acquire

Returns:

true if permits were acquired and false otherwise

acquire

reactor.core.publisher.Mono<Void> acquire()

Acquires a permit. Waits if necessary until a permit became available.

Returns:

void

acquire

reactor.core.publisher.Mono<Void> acquire(int permits)

Acquires defined amount of permits. Waits if necessary until all permits became available.

Parameters:

permits - the number of permits to acquire

Returns:

void

Throws:

IllegalArgumentException - if permits is negative

release

reactor.core.publisher.Mono<Void> release()

Releases a permit.

Returns:

void

release

reactor.core.publisher.Mono<Void> release(int permits)

Releases defined amount of permits.

Parameters:

permits - amount

Returns:

void

trySetPermits

reactor.core.publisher.Mono<Boolean> trySetPermits(int permits)

Tries to set number of permits.

Parameters:

permits - - number of permits

Returns:

true if permits has been set successfully, otherwise false.

tryAcquire

reactor.core.publisher.Mono<Boolean> tryAcquire(long waitTime,
                                                TimeUnit unit)

Tries to acquire currently available permit. Waits up to defined waitTime if necessary until a permit became available.

Parameters:

waitTime - the maximum time to wait

unit - the time unit

Returns:

true if a permit was acquired and false otherwise

tryAcquire

reactor.core.publisher.Mono<Boolean> tryAcquire(int permits,
                                                long waitTime,
                                                TimeUnit unit)

Tries to acquire defined amount of currently available permits. Waits up to defined waitTime if necessary until all permits became available.

Parameters:

permits - amount of permits

waitTime - the maximum time to wait

unit - the time unit

Returns:

true if permits were acquired and false otherwise

addPermits

reactor.core.publisher.Mono<Void> addPermits(int permits)

Increases or decreases the number of available permits by defined value.

Parameters:

permits - amount of permits to add/remove

availablePermits

reactor.core.publisher.Mono<Integer> availablePermits()

Returns amount of available permits.

Returns:

number of permits

drainPermits

reactor.core.publisher.Mono<Integer> drainPermits()

Acquires and returns all permits that are immediately available.

Returns:

number of permits