redis.clients.jedis.commands.DatabasePipelineCommands Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of jedis Show documentation
Jedis is a blazingly small and sane Redis java client.
There is a newer version: 5.2.0
package redis.clients.jedis.commands;

import redis.clients.jedis.Response;
import redis.clients.jedis.params.MigrateParams;

public interface DatabasePipelineCommands {

  /**
   * Select the DB with having the specified zero-based numeric index.
   *
   * @param index the index of db
   * @return OK
   */
  Response select(int index);

  /**
   * Return the number of keys in the currently-selected database.
   *
   * @return The number of keys
   */
  Response dbSize();

  /**
   * This command swaps two Redis databases, so that immediately all the clients connected to a
   * given database will see the data of the other database, and the other way around.
   *
   * @param index1
   * @param index2
   * @return OK
   */
  Response swapDB(int index1, int index2);

  /**
   * Move the specified key from the currently selected DB to the specified destination DB. Note
   * that this command returns 1 only if the key was successfully moved, and 0 if the target key was
   * already there or if the source key was not found at all, so it is possible to use MOVE as a
   * locking primitive.
   *
   * @param key     The specified key
   * @param dbIndex Specified destination database
   * @return 1 if the key was moved, 0 if the key was not moved because already present on the target
   * DB or was not found in the current DB
   */
  Response move(String key, int dbIndex);

  /**
   * Binary version of {@link DatabaseCommands#move(String, int) MOVE}.
   *
   * @see DatabaseCommands#move(String, int)
   */
  Response move(byte[] key, int dbIndex);

  /**
   * Copy the value stored at the source key to the destination key.
   *
   * @param srcKey  The source key.
   * @param dstKey  The destination key.
   * @param db      Allows specifying an alternative logical database index for the destination key.
   * @param replace Removes the destination key before copying the value to it, in order to avoid error.
   */
  Response copy(String srcKey, String dstKey, int db, boolean replace);

  /**
   * Binary version of {@link DatabasePipelineCommands#copy(String, String, int, boolean) COPY}.
   *
   * @see DatabasePipelineCommands#copy(String, String, int, boolean)
   */
  Response copy(byte[] srcKey, byte[] dstKey, int db, boolean replace);

  /**
   * Binary version of {@link DatabasePipelineCommands#migrate(String, int, String, int, int) MIGRATE}.
   *
   * @see DatabasePipelineCommands#migrate(String, int, String, int, int)
   */
  Response migrate(String host, int port, byte[] key, int destinationDB, int timeout);

  /**
   * Binary version of {@link DatabasePipelineCommands#migrate(String, int, int, int, MigrateParams, String...) MIGRATE}.
   *
   * @see DatabasePipelineCommands#migrate(String, int, int, int, MigrateParams, String...)
   */
  Response migrate(String host, int port, int destinationDB, int timeout, MigrateParams params, byte[]... keys);

  /**
   * Migrate Command
   * Atomically transfer a key from a source Redis instance to a destination Redis instance.
   * On success the key is deleted from the original instance and is guaranteed to exist in
   * the target instance.
   *
   * @param host          Target host
   * @param port          Target port
   * @param key           Migrate key
   * @param destinationDB Target db
   * @param timeout       The maximum idle time in any moment of the communication with the
   *                      destination instance in milliseconds.
   * @return OK on success, or NOKEY if no keys were found in the source instance
   */
  Response migrate(String host, int port, String key, int destinationDB, int timeout);

  /**
   * Migrate Command
   * Atomically transfer a key from a source Redis instance to a destination Redis instance.
   * On success the key is deleted from the original instance and is guaranteed to exist in
   * the target instance.
   *
   * @param host          Target host
   * @param port          Target port
   * @param destinationDB Target db
   * @param timeout       The maximum idle time in any moment of the communication with the
   *                      destination instance in milliseconds.
   * @param params        {@link MigrateParams}
   * @param keys          The keys to migrate
   * @return OK on success, or NOKEY if no keys were found in the source instance.
   */
  Response migrate(String host, int port, int destinationDB, int timeout, MigrateParams params, String... keys);

}