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 Details

    • 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.
    • trySetPermits

      reactor.core.publisher.Mono<Boolean> trySetPermits(int permits, Duration timeToLive)
      Tries to set number of permits with defined time to live.
      Parameters:
      permits - number of permits
      timeToLive - time to live
      Returns:
      true if permits has been set successfully, otherwise false.
    • tryAcquire

      @Deprecated reactor.core.publisher.Mono<Boolean> tryAcquire(long waitTime, TimeUnit unit)
      Deprecated.
      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(Duration waitTime)
      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
      Returns:
      true if a permit was acquired and false otherwise
    • tryAcquire

      @Deprecated reactor.core.publisher.Mono<Boolean> tryAcquire(int permits, long waitTime, TimeUnit unit)
      Deprecated.
      Parameters:
      permits - amount of permits
      waitTime - the maximum time to wait
      unit - the time unit
      Returns:
      true if permits were acquired and false otherwise
    • tryAcquire

      reactor.core.publisher.Mono<Boolean> tryAcquire(int permits, Duration waitTime)
      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