package com.lambdaworks.redis;
import java.io.Closeable;
import java.util.List;
import java.util.Map;
import com.lambdaworks.redis.output.CommandOutput;
import com.lambdaworks.redis.protocol.CommandArgs;
import com.lambdaworks.redis.protocol.ProtocolKeyword;
/**
*
* Basic synchronous executed commands.
*
* @param <K> Key type.
* @param <V> Value type.
* @author Mark Paluch
* @since 3.0
* @deprecated Use {@link com.lambdaworks.redis.api.sync.BaseRedisCommands}
*/
@Deprecated
public interface BaseRedisConnection<K, V> extends Closeable {
/**
* Post a message to a channel.
*
* @param channel the channel type: key
* @param message the message type: value
* @return Long integer-reply the number of clients that received the message.
*/
Long publish(K channel, V message);
/**
* Lists the currently *active channels*.
*
* @return List<K> array-reply a list of active channels, optionally matching the specified pattern.
*/
List<K> pubsubChannels();
/**
* Lists the currently *active channels*.
*
* @param channel the key
* @return List<K> array-reply a list of active channels, optionally matching the specified pattern.
*/
List<K> pubsubChannels(K channel);
/**
* Returns the number of subscribers (not counting clients subscribed to patterns) for the specified channels.
*
* @param channels channel keys
* @return array-reply a list of channels and number of subscribers for every channel.
*/
Map<K, Long> pubsubNumsub(K... channels);
/**
* Returns the number of subscriptions to patterns.
*
* @return Long integer-reply the number of patterns all the clients are subscribed to.
*/
Long pubsubNumpat();
/**
* Echo the given string.
*
* @param msg the message type: value
* @return V bulk-string-reply
*/
V echo(V msg);
/**
* Return the role of the instance in the context of replication.
*
* @return List<Object> array-reply where the first element is one of master, slave, sentinel and the additional
* elements are role-specific.
*/
List<Object> role();
/**
* Ping the server.
*
* @return String simple-string-reply
*/
String ping();
/**
* Switch connection to Read-Only mode when connecting to a cluster.
*
* @return String simple-string-reply.
*/
String readOnly();
/**
* Switch connection to Read-Write mode (default) when connecting to a cluster.
*
* @return String simple-string-reply.
*/
String readWrite();
/**
* Close the connection.
*
* @return String simple-string-reply always OK.
*/
String quit();
/**
* Create a SHA1 digest from a Lua script.
*
* @param script script content
* @return the SHA1 value
*/
String digest(V script);
/**
* Discard all commands issued after MULTI.
*
* @return String simple-string-reply always {@code OK}.
*/
String discard();
/**
* Execute all commands issued after MULTI.
*
* @return List<Object> array-reply each element being the reply to each of the commands in the atomic transaction.
*
* When using {@code WATCH}, {@code EXEC} can return a
*/
List<Object> exec();
/**
* Mark the start of a transaction block.
*
* @return String simple-string-reply always {@code OK}.
*/
String multi();
/**
* Watch the given keys to determine execution of the MULTI/EXEC block.
*
* @param keys the key
* @return String simple-string-reply always {@code OK}.
*/
String watch(K... keys);
/**
* Forget about all watched keys.
*
* @return String simple-string-reply always {@code OK}.
*/
String unwatch();
/**
* Wait for replication.
*
* @param replicas minimum number of replicas
* @param timeout timeout in milliseconds
* @return number of replicas
*/
Long waitForReplication(int replicas, long timeout);
/**
* Dispatch a command to the Redis Server. Please note the command output type must fit to the command response.
*
* @param type the command, must not be {@literal null}.
* @param output the command output, must not be {@literal null}.
* @param <T> response type
* @return the command response
*/
<T> T dispatch(ProtocolKeyword type, CommandOutput<K, V, T> output);
/**
* Dispatch a command to the Redis Server. Please note the command output type must fit to the command response.
*
* @param type the command, must not be {@literal null}.
* @param output the command output, must not be {@literal null}.
* @param args the command arguments, must not be {@literal null}.
* @param <T> response type
* @return the command response
*/
<T> T dispatch(ProtocolKeyword type, CommandOutput<K, V, T> output, CommandArgs<K, V> args);
/**
* Close the connection. The connection will become not usable anymore as soon as this method was called.
*/
@Override
void close();
/**
*
* @return true if the connection is open (connected and not closed).
*/
boolean isOpen();
}