org.redisson.api.RObjectRx 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.concurrent.TimeUnit;
import org.redisson.client.codec.Codec;
import io.reactivex.rxjava3.core.Completable;
import io.reactivex.rxjava3.core.Single;
/**
* Base RxJava2 interface for all Redisson objects
*
* @author Nikita Koksharov
*
*/
public interface RObjectRx {
/**
* Returns number of seconds spent since last write or read operation over this object.
*
* @return number of seconds
*/
Single getIdleTime();
String getName();
Codec getCodec();
/**
* Returns bytes amount used by object in Redis memory.
*
* @return size in bytes
*/
Single sizeInMemory();
/**
* Restores object using its state returned by {@link #dump()} method.
*
* @param state - state of object
* @return void
*/
Completable restore(byte[] state);
/**
* Restores object using its state returned by {@link #dump()} method and set time to live for it.
*
* @param state - state of object
* @param timeToLive - time to live of the object
* @param timeUnit - time unit
* @return void
*/
Completable restore(byte[] state, long timeToLive, TimeUnit timeUnit);
/**
* Restores and replaces object if it already exists.
*
* @param state - state of the object
* @return void
*/
Completable restoreAndReplace(byte[] state);
/**
* Restores and replaces object if it already exists and set time to live for it.
*
* @param state - state of the object
* @param timeToLive - time to live of the object
* @param timeUnit - time unit
* @return void
*/
Completable restoreAndReplace(byte[] state, long timeToLive, TimeUnit timeUnit);
/**
* Returns dump of object
*
* @return dump
*/
Single dump();
/**
* Update the last access time of an object.
*
* @return true
if object was touched else false
*/
Single touch();
/**
* Delete the objects.
* Actual removal will happen later asynchronously.
*
* Requires Redis 4.0+
*
* @return true
if it was exist and deleted else false
*/
Single unlink();
/**
* Copy object from source Redis instance to destination Redis instance
*
* @param host - destination host
* @param port - destination port
* @param database - destination database
* @param timeout - maximum idle time in any moment of the communication with the destination instance in milliseconds
* @return void
*/
Completable copy(String host, int port, int database, long timeout);
/**
* Copy this object instance to the new instance with a defined name.
*
* @param destination name of the destination instance
* @return true
if this object instance was copied else false
*/
Single copy(String destination);
/**
* Copy this object instance to the new instance with a defined name and database.
*
* @param destination name of the destination instance
* @param database database number
* @return true
if this object instance was copied else false
*/
Single copy(String destination, int database);
/**
* Copy this object instance to the new instance with a defined name, and replace it if it already exists.
*
* @param destination name of the destination instance
* @return true
if this object instance was copied else false
*/
Single copyAndReplace(String destination);
/**
* Copy this object instance to the new instance with a defined name and database, and replace it if it already exists.
*
* @param destination name of the destination instance
* @param database database number
* @return true
if this object instance was copied else false
*/
Single copyAndReplace(String destination, int database);
/**
* Transfer a object from a source Redis instance to a destination Redis instance
* in mode
*
* @param host - destination host
* @param port - destination port
* @param database - destination database
* @param timeout - maximum idle time in any moment of the communication with the destination instance in milliseconds
* @return void
*/
Completable migrate(String host, int port, int database, long timeout);
/**
* Move object to another database in mode
*
* @param database - number of Redis database
* @return true
if key was moved false
if not
*/
Single move(int database);
/**
* Delete object in mode
*
* @return true
if object was deleted false
if not
*/
Single delete();
/**
* Rename current object key to newName
* in mode
*
* @param newName - new name of object
* @return void
*/
Completable rename(String newName);
/**
* Rename current object key to newName
* in mode only if new key is not exists
*
* @param newName - new name of object
* @return true
if object has been renamed successfully and false
otherwise
*/
Single renamenx(String newName);
/**
* Check object existence
*
* @return true
if object exists and false
otherwise
*/
Single isExists();
/**
* Adds object event listener
*
* @see org.redisson.api.ExpiredObjectListener
* @see org.redisson.api.DeletedObjectListener
*
* @param listener - object event listener
* @return listener id
*/
Single addListener(ObjectListener listener);
/**
* Removes object event listener
*
* @param listenerId - listener id
*/
Completable removeListener(int listenerId);
}