org.redisson.api.RPermitExpirableSemaphoreAsync Maven / Gradle / Ivy
Show all versions of redisson-all Show documentation
/**
* Copyright (c) 2013-2024 Nikita Koksharov
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.redisson.api;
import java.util.List;
import java.util.concurrent.TimeUnit;
/**
* Asynchronous interface for Semaphore object with lease time parameter support for each acquired permit.
*
* Each permit identified by own id and could be released only using its id.
* Permit id is a 128-bits unique random identifier generated each time during acquiring.
*
*
Works in non-fair mode. Therefore order of acquiring is unpredictable.
*
* @author Nikita Koksharov
*
*/
public interface RPermitExpirableSemaphoreAsync extends RExpirableAsync {
/**
* Acquires a permit and returns its id.
* Waits if necessary until a permit became available.
*
* @return permit id
*/
RFuture acquireAsync();
/**
* Acquires defined amount of permits and returns their ids.
* Waits if necessary until all permits became available.
*
* @param permits the number of permits to acquire
* @return permits ids
* @throws IllegalArgumentException if permits is negative
*/
RFuture> acquireAsync(int permits);
/**
* Acquires a permit with defined leaseTime and return its id.
* Waits if necessary until a permit became available.
*
* @param leaseTime permit lease time
* @param unit time unit
* @return permit id
*/
RFuture acquireAsync(long leaseTime, TimeUnit unit);
/**
* Acquires defined amount of permits and return their ids.
* Waits if necessary until all permits became available.
*
* @param permits the number of permits to acquire
* @param leaseTime permit lease time
* @param unit time unit
* @return permits ids
* @throws IllegalArgumentException if permits is negative
*/
RFuture> acquireAsync(int permits, long leaseTime, TimeUnit unit);
/**
* Tries to acquire currently available permit and return its id.
*
* @return permit id if a permit was acquired and {@code null}
* otherwise
*/
RFuture tryAcquireAsync();
/**
* Tries to acquire defined amount of currently available permits and returns their ids.
*
* @param permits the number of permits to acquire
* @return permits ids if permits were acquired and empty list
* otherwise
* @throws IllegalArgumentException if permits is negative
*/
RFuture> tryAcquireAsync(int permits);
/**
* Tries to acquire currently available permit and return its id.
* Waits up to defined waitTime if necessary until a permit became available.
*
* @param waitTime the maximum time to wait
* @param unit the time unit
* @return permit id if a permit was acquired and {@code null}
* if the waiting time elapsed before a permit was acquired
*/
RFuture tryAcquireAsync(long waitTime, TimeUnit unit);
/**
* Tries to acquire currently available permit
* with defined leaseTime and return its id.
* Waits up to defined waitTime if necessary until a permit became available.
*
* @param waitTime the maximum time to wait
* @param leaseTime permit lease time, use -1 to make it permanent
* @param unit the time unit
* @return permit id if a permit was acquired and null
* if the waiting time elapsed before a permit was acquired
*/
RFuture tryAcquireAsync(long waitTime, long leaseTime, TimeUnit unit);
/**
* Tries to acquire defined amount of currently available permits
* with defined leaseTime and returns their ids.
* Waits up to defined waitTime if necessary until permits became available.
*
* @param permits the number of permits to acquire
* @param waitTime the maximum time to wait
* @param leaseTime permit lease time, use -1 to make it permanent
* @param unit the time unit
* @return permits ids if permits were acquired and empty list
* if the waiting time elapsed before permit were acquired
* @throws IllegalArgumentException if permits is negative
*/
RFuture> tryAcquireAsync(int permits, long waitTime, long leaseTime, TimeUnit unit);
/**
* Tries to release permit by its id.
*
* @param permitId permit id
* @return true if a permit has been released and false
* otherwise
*/
RFuture tryReleaseAsync(String permitId);
/**
* Tries to release defined permits by their ids.
*
* @param permitsIds - permits ids
* @return amount of released permits
* @throws IllegalArgumentException if permitsIds is null or empty
*/
RFuture tryReleaseAsync(List permitsIds);
/**
* Releases a permit by its id. Increases the number of available permits.
* Throws an exception if permit id doesn't exist or has already been released.
*
* @param permitId - permit id
* @return void
*/
RFuture releaseAsync(String permitId);
/**
* Releases permits by their ids.
* Increases the number of available permits.
* Throws an exception if permits ids don't exist or have already been released.
*
* @param permitsIds - permit id
* @throws IllegalArgumentException if permitsIds is null or empty
*/
RFuture releaseAsync(List permitsIds);
/**
* Returns number of available permits.
*
* @return number of permits
*/
RFuture availablePermitsAsync();
/**
* Returns the number of permits.
*
* @return number of permits
*/
RFuture getPermitsAsync();
/**
* Returns the number of acquired permits.
*
* @return number of acquired permits
*/
RFuture acquiredPermitsAsync();
/**
* Tries to set number of available permits.
*
* @param permits - number of permits
* @return true if permits has been set successfully, otherwise false.
*/
RFuture trySetPermitsAsync(int permits);
/**
* Sets the number of permits to the provided value.
* Calculates the delta between the given permits value and the
* current number of permits, then increases the number of available permits by delta.
*
* @param permits - number of permits
*/
RFuture setPermitsAsync(int permits);
/**
* Increases or decreases the number of available permits by defined value.
*
* @param permits amount of permits to add/remove
* @return void
*/
RFuture addPermitsAsync(int permits);
/**
* Overrides and updates lease time for defined permit id.
*
* @param permitId permit id
* @param leaseTime permit lease time, use -1 to make it permanent
* @param unit the time unit
* @return true if permits has been updated successfully, otherwise false.
*/
RFuture updateLeaseTimeAsync(String permitId, long leaseTime, TimeUnit unit);
}