org.redisson.api.RExpirableRx 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.time.Duration;
import java.time.Instant;
import java.util.Date;
import java.util.concurrent.TimeUnit;
import io.reactivex.rxjava3.core.Single;
/**
* Base interface for all Redisson objects
* which support expiration or TTL
*
* @author Nikita Koksharov
*
*/
public interface RExpirableRx extends RObjectRx {
/**
* Use {@link #expire(Duration)} instead
*
* @param timeToLive - timeout before object will be deleted
* @param timeUnit - timeout time unit
* @return true if the timeout was set and false if not
*/
@Deprecated
Single expire(long timeToLive, TimeUnit timeUnit);
/**
* Use {@link #expire(Instant)} instead
*
* @param timestamp - expire date
* @return true if the timeout was set and false if not
*/
@Deprecated
Single expireAt(Date timestamp);
/**
* Use {@link #expire(Instant)} instead
*
* @param timestamp - expire date in milliseconds (Unix timestamp)
* @return true if the timeout was set and false if not
*/
@Deprecated
Single expireAt(long timestamp);
/**
* Set an expire date for object. When expire date comes
* the key will automatically be deleted.
*
* @param instant - expire date
* @return true if the timeout was set and false if not
*/
Single expire(Instant instant);
/**
* Sets an expiration date for this object only if it has been already set.
* When expire date comes the object will automatically be deleted.
*
* Requires Redis 7.0.0 and higher.
*
* @param time expire date
* @return true if the timeout was set and false if not
*/
Single expireIfSet(Instant time);
/**
* Sets an expiration date for this object only if it hasn't been set before.
* When expire date comes the object will automatically be deleted.
*
* Requires Redis 7.0.0 and higher.
*
* @param time expire date
* @return true if the timeout was set and false if not
*/
Single expireIfNotSet(Instant time);
/**
* Sets an expiration date for this object only if it's greater than expiration date set before.
* When expire date comes the object will automatically be deleted.
*
* Requires Redis 7.0.0 and higher.
*
* @param time expire date
* @return true if the timeout was set and false if not
*/
Single expireIfGreater(Instant time);
/**
* Sets an expiration date for this object only if it's less than expiration date set before.
* When expire date comes the object will automatically be deleted.
*
* Requires Redis 7.0.0 and higher.
*
* @param time expire date
* @return true if the timeout was set and false if not
*/
Single expireIfLess(Instant time);
/**
* Sets a timeout for this object. After the timeout has expired,
* the key will automatically be deleted.
*
* @param duration timeout before object will be deleted
* @return true if the timeout was set and false if not
*/
Single expire(Duration duration);
/**
* Sets a timeout for this object only if it has been already set.
* After the timeout has expired, the key will automatically be deleted.
*
* Requires Redis 7.0.0 and higher.
*
* @param duration timeout before object will be deleted
* @return true if the timeout was set and false if not
*/
Single expireIfSet(Duration duration);
/**
* Sets a timeout for this object only if it hasn't been set before.
* After the timeout has expired, the key will automatically be deleted.
*
* Requires Redis 7.0.0 and higher.
*
* @param duration timeout before object will be deleted
* @return true if the timeout was set and false if not
*/
Single expireIfNotSet(Duration duration);
/**
* Sets a timeout for this object only if it's greater than timeout set before.
* After the timeout has expired, the key will automatically be deleted.
*
* Requires Redis 7.0.0 and higher.
*
* @param duration timeout before object will be deleted
* @return true if the timeout was set and false if not
*/
Single expireIfGreater(Duration duration);
/**
* Sets a timeout for this object only if it's less than timeout set before.
* After the timeout has expired, the key will automatically be deleted.
*
* Requires Redis 7.0.0 and higher.
*
* @param duration timeout before object will be deleted
* @return true if the timeout was set and false if not
*/
Single expireIfLess(Duration duration);
/**
* Clear an expire timeout or expire date for object in mode.
* Object will not be deleted.
*
* @return true if the timeout was cleared and false if not
*/
Single clearExpire();
/**
* Returns remaining time of the object in milliseconds.
*
* @return time in milliseconds
* -2 if the key does not exist.
* -1 if the key exists but has no associated expire.
*/
Single remainTimeToLive();
/**
* Returns expiration time of the object as the absolute Unix expiration timestamp in milliseconds.
*
* Requires Redis 7.0.0 and higher.
*
* @return Unix time in milliseconds
* -2 if the key does not exist.
* -1 if the key exists but has no associated expiration time.
*/
Single getExpireTime();
}