详解redis操作命令

1、 登录

[root@bigdata1 bin]# ./redis-cli     本机登录

[root@bigdata1 bin]# ./redis-cli -h 127.0.0.1 -p 6379 –a password   远程登录

127.0.0.1:6379> quit    退出

2、 数据类型

Redis支持五种数据类型:string(字符串),hash(哈希),list(列表),set(集合)及zset(sorted set:有序集合)。

String(字符串):string是redis最基本的类型,你可以理解成与Memcached一模一样的类型,一个key对应一个value。

string类型是二进制安全的。意思是redis的string可以包含任何数据。比如jpg图片或者序列化的对象 。

String类型是Redis最基本的数据类型,一个键最大能存储512MB。

Hash(哈希):

Redis hash 是一个键值(key=>value)对集合。

Redis hash是一个string类型的field和value的映射表,hash特别适合用于存储对象。

每个 hash 可以存储 232 -1 键值对(40多亿)。

List(列表):

Redis 列表是简单的字符串列表,按照插入顺序排序。你可以添加一个元素到列表的头部(左边)或者尾部(右边)。

列表最多可存储 232 - 1 元素 (4294967295, 每个列表可存储40多亿)。

Set(集合

Redis的Set是string类型的无序集合。

集合是通过哈希表实现的,所以添加,删除,查找的复杂度都是O(1)。

Zset(有序集合):

Redis zset 和 set 一样也是string类型元素的集合,且不允许重复的成员。

不同的是每个元素都会关联一个double类型的分数。redis正是通过分数来为集合中的成员进行从小到大的排序。

zset的成员是唯一的,但分数(score)却可以重复。

3、 命令介绍

String(字符串):

127.0.0.1:6379> SET key "value"  设置key

127.0.0.1:6379> GET key    读取key

127.0.0.1:6379> GETRANGE key 0 3    读取key对应的value前四个字符

127.0.0.1:6379>GETSET db mongodb   设定key的value,并返回旧value,没有旧值,返回nil

127.0.0.1:6379> MGET key1 key2  返回一个或者多个给定的key值

Hash(哈希):

127.0.0.1:6379> HMSET myhash field1 "Hello" field2 "World"  同时将多个 field-value (字段-值)对设置到哈希表中。

127.0.0.1:6379> HGET KEY_NAME FIELD_NAME  用于返回哈希表中指定字段的值

127.0.0.1:6379> HEXISTS myhash field1  哈希表含有给定字段,返回 1 。 如果哈希表不含有给定字段,或 key 不存在,返回 0

127.0.0.1:6379> HKEYS myhash   获取哈希表中的所有域(field)

List(列表):

127.0.0.1:6379> LPUSH KEY_NAME VALUE1.. VALUEN  将一个或多个值插入到列表头部

127.0.0.1:6379> LRANGE list1 0 -1  返回列表中指定区间内的元素

Set(集合

127.0.0.1:6379> SADD myset "hello"  命令将一个或多个成员元素加入到集合中,已经存在于集合的成员元素将被忽略。

127.0.0.1:6379> SMEMBERS myset1   返回集合中的所有的成员。 不存在的集合 key 被视为空集合。

Zset(有序集合):

127.0.0.1:6379>ZADD myzset 2 "two" 3 "three"  用于将一个或多个成员元素及其分数值加入到有序集当中。

127.0.0.1:6379>ZCARD myzset   获取结合中元素的数量。

4、 封装的redis基本命令

 

import java.util.HashMap;

import java.util.List;

import java.util.Map;

import java.util.Set;

 

import org.springframework.context.support.ClassPathXmlApplicationContext;

 

import redis.clients.jedis.BinaryClient;

import redis.clients.jedis.BinaryClient.LIST_POSITION;

import redis.clients.jedis.JedisCluster;

 

import org.apache.commons.logging.Log;

import org.apache.commons.logging.LogFactory;

 

public class redisCluster {

private static final Log log = LogFactory.getLog(redisCluster.class);

JedisCluster jedisCluster=null;

ClassPathXmlApplicationContext context=null;

/**

 * 构造函数,初始化jedis连接池

 */

    public redisCluster(){

     try{

     context = new ClassPathXmlApplicationContext("classpath:spring/spring-context.xml");

context.start();

jedisCluster = (JedisCluster) context.getBean("jedisCluster");

     }

        catch(Exception e){

         log.error("==>redisCluster context start error:", e);

         context.stop();

         System.exit(0);

        }

    }

    /**

     * 关闭连接

     */

    public void closeRedisCluster(){

     jedisCluster.close();

    }

    //Key(键)

    /**

     * 删除指定的key

     * @param key

     * @return 删除的数量

     */

    public Long delete(String key){

     return jedisCluster.del(key);

    }

    /**

     * 检查指定的key是否存在

     * @param key

     * @return 存在:返回1  不存在:返回0

     */

    public Boolean exists(String key){

     return jedisCluster.exists(key);

    }

    /**

     * 为给定 key 设置生存时间,当 key 过期时(生存时间为 0 ),它会被自动删除

     * 可以对一个已经带有生存时间的 key 执行 EXPIRE 命令,新指定的生存时间会取代旧的生存时间

     * @param key

     * @param seconds 秒

     * @return 成功:返回1  失败:返回0

     */

    public Long expire(String key,int seconds){

     return jedisCluster.expire(key, seconds);

    }

    /**

     * EXPIREAT 的作用和 EXPIRE 类似,都用于为 key 设置生存时间

     * 不同在于 EXPIREAT 命令接受的时间参数是 UNIX 时间戳(unix timestamp)

     * @param key

     * @param unixTime  秒

     * @return 成功:返回1  失败:返回0

     */

    public long expireAt(String key,long unixTime){

     return jedisCluster.expireAt(key, unixTime);

    }

    /**

     * 将当前数据库的 key 移动到给定的数据库 db 当中

     * 如果当前数据库(源数据库)和给定数据库(目标数据库)有相同名字的给定 key ,或者 key 不存在于当前数据库,那么 MOVE 没有任何效果

     * @param key

     * @param dbIndex

     * @return 成功:返回1  失败:返回0

     */

    public Long move(String key,int dbIndex){

     return jedisCluster.move(key, dbIndex);

    }

    /**

     * 移除给定 key 的生存时间,将这个 key 从『易失的』(带生存时间 key )转换成『持久的』(一个不带生存时间、永不过期的 key )

     * @param key

     * @return  成功:返回1  失败:返回0

     */

    public long persist(String key){

     return jedisCluster.persist(key);

    }

    /**

     * 为给定 key 设置生存时间,当 key 过期时(生存时间为 0 ),它会被自动删除

     * 可以对一个已经带有生存时间的 key 执行 EXPIRE 命令,新指定的生存时间会取代旧的生存时间

     * @param key

     * @param seconds 毫秒

     * @return 成功:返回1  失败:返回0

     */

    public long pexpire(String key,long milliseconds){

     return jedisCluster.pexpire(key, milliseconds);

    }

    /**

     * EXPIREAT 的作用和 EXPIRE 类似,都用于为 key 设置生存时间

     * 不同在于 EXPIREAT 命令接受的时间参数是 UNIX 时间戳(unix timestamp)

     * @param key

     * @param unixTime  毫秒

     * @return 成功:返回1  失败:返回0

     */

    public long pexpireAt(String key,long millisecondsTimestamp){

     return jedisCluster.pexpireAt(key, millisecondsTimestamp);

    }

    /**

     * 返回或保存给定列表、集合、有序集合 key 中经过排序的元素

     * 排序默认以数字作为对象,值被解释为双精度浮点数,然后进行比较

     * @param key

     * @return

     */

    public List<String> sort(String key){

     return jedisCluster.sort(key);

    }

    /**

     * 以秒为单位,返回给定 key 的剩余生存时间(TTL, time to live)

     * @param key

     * @return key不存在:返回-2   key存在但没有设置生存时间:返回-1   

     */

    public long ttl(String key){

     return jedisCluster.ttl(key);

    }

    /**

     * 返回 key 所储存的值的类型

     * @param key

     * @return none (key不存在)  string (字符串)  list (列表)  set (集合)  zset (有序集)   hash (哈希表)

     */

    public String type(String key){

     return jedisCluster.type(key);

    }

    //String(字符串)

    /**

     * 如果 key 已经存在并且是一个字符串, APPEND 命令将 value 追加到 key 原来的值的末尾

     * 如果 key 不存在, APPEND 就简单地将给定 key 设为 value ,就像执行 SET key value 一样

     * @param key

     * @param value

     * @return  追加 value 之后, key 中字符串的长度

     */

    public Long append(String key,String value){

     return jedisCluster.append(key, value);

    }

    /**

     * 计算给定字符串中,被设置为 1 的比特位的数量

     * @param key

     * @return  被设置为 1 的位的数量

     */

    public Long bitCount(String key){

     return jedisCluster.bitcount(key);

    }

    /**

     * 通过指定额外的 start 或 end 参数,可以让计数只在特定的位上进行

     * @param key

     * @param start

     * @param end

     * @return 被设置为 1 的位的数量

     */

    public Long bitCount(String key,Long start,Long end){

     return jedisCluster.bitcount(key, start, end);

    }

    /**

     * 将 key 中储存的数字值减一

     * 如果 key 不存在,那么 key 的值会先被初始化为 0 ,然后再执行 DECR 操作

     * 如果值包含错误的类型,或字符串类型的值不能表示为数字,那么返回一个错误

     * @param key

     * @return  执行 DECR 命令之后 key 的值

     */

    public Long decr(String key){

     return jedisCluster.decr(key);

    }

    /**

     * 将 key 所储存的值减去减量 decrement

     * 如果 key 不存在,那么 key 的值会先被初始化为 0 ,然后再执行 DECRBY 操作

     * 如果值包含错误的类型,或字符串类型的值不能表示为数字,那么返回一个错误

     * @param key

     * @param integer

     * @return 减去 decrement 之后, key 的值

     */

    public Long decrBy(String key,long integer){

     return jedisCluster.decrBy(key, integer);

    }

    /**

     * 返回 key 所关联的字符串值

     * 如果 key 不存在那么返回特殊值 nil

     * 假如 key 储存的值不是字符串类型,返回一个错误,因为 GET 只能用于处理字符串值

     * @param key

     * @return 当 key 不存在时,返回 nil ,否则,返回 key 的值,如果 key 不是字符串类型,那么返回一个错误

     */

     public String get(String key){

         return jedisCluster.get(key);

     }

     /**

      * 对 key 所储存的字符串值,获取指定偏移量上的位(bit)

      * 当 offset 比字符串值的长度大,或者 key 不存在时,返回 0

      * @param key

      * @param offset

      * @return 字符串值指定偏移量上的位(bit)

      */

     public Boolean getbit(String key,Long offset){

      return jedisCluster.getbit(key, offset);

     }

     /**

      * 返回 key 中字符串值的子字符串,字符串的截取范围由 start 和 end 两个偏移量决定(包括 start 和 end 在内)

      * 负数偏移量表示从字符串最后开始计数, -1 表示最后一个字符, -2 表示倒数第二个,以此类推。

      * @param key

      * @param startOffset

      * @param endOffset

      * @return 截取得出的子字符串

      */

     public String getrange(String key,long startOffset,long endOffset){

      return jedisCluster.getrange(key, startOffset, endOffset);

     }

     /**

      * 将给定 key 的值设为 value ,并返回 key 的旧值(old value)

      * 当 key 存在但不是字符串类型时,返回一个错误

      * @param key

      * @param value

      * @return 返回给定 key 的旧值,当 key 没有旧值时,也即是, key 不存在时,返回 nil

      */

     public String getSet(String key,String value){

      return jedisCluster.getSet(key, value);

     }

     /**

      * 将 key 中储存的数字值增一

      * 如果 key 不存在,那么 key 的值会先被初始化为 0 ,然后再执行 INCR 操作

      * 如果值包含错误的类型,或字符串类型的值不能表示为数字,那么返回一个错误

      * @param key

      * @return 执行 INCR 命令之后 key 的值

      */

     public Long incr(String key){

      return jedisCluster.incr(key);

     }

     /**

      * 将 key 所储存的值加上增量 increment

      * 如果 key 不存在,那么 key 的值会先被初始化为 0 ,然后再执行 INCRBY 命令

      * 如果值包含错误的类型,或字符串类型的值不能表示为数字,那么返回一个错误

      * @param key

      * @param integer

      * @return 加上 increment 之后, key 的值

      */

     public Long incrBy(String key,long integer){

      return jedisCluster.incrBy(key, integer);

     }

     /**

      * 为 key 中所储存的值加上浮点数增量 increment

      * 如果 key 不存在,那么 INCRBYFLOAT 会先将 key 的值设为 0 ,再执行加法操作

      * 如果命令执行成功,那么 key 的值会被更新为(执行加法之后的)新值,并且新值会以字符串的形式返回给调用者

      * @param key

      * @param value

      * @return 执行命令之后 key 的值

      */

    public double incrByFloat(String key,double value){

     return jedisCluster.incrByFloat(key, value);

    }

    /**

     * 将字符串值 value 关联到 key

     * 如果 key 已经持有其他值, SET 就覆写旧值,无视类型

     * @param key

     * @param value

     * @return 返回ok

     */

    public String set(String key,String value){    

    return jedisCluster.set(key, value);

    }

    /**

     * 对 key 所储存的字符串值,设置或清除指定偏移量上的位(bit)

     * 位的设置或清除取决于 value 参数,可以是 0 也可以是 1

     * 当 key 不存在时,自动生成一个新的字符串值

     * @param key

     * @param offset

     * @param value

     * @return 指定偏移量原来储存的位

     */

    public Boolean setbit(String key,Long offset,String value){

     return jedisCluster.setbit(key, offset, value);

    }

    /**

     * 对 key 所储存的字符串值,设置或清除指定偏移量上的位(bit)

     * 位的设置或清除取决于 value 参数,可以是 0 也可以是 1

     * 当 key 不存在时,自动生成一个新的字符串值

     * @param key

     * @param offset

     * @param value

     * @return 指定偏移量原来储存的位

     */

    public Boolean setbit(String key,long offset,Boolean value){

     return jedisCluster.setbit(key, offset, value);

    }

    /**

     * 将值 value 关联到 key ,并将 key 的生存时间设为 seconds (以秒为单位)

     * 如果 key 已经存在, SETEX 命令将覆写旧值

     * @param key

     * @param seconds

     * @param value

     * @return 设置成功时返回 OK ,当 seconds 参数不合法时,返回一个错误

     */

    public String setex(String key,int seconds,String value){

     return jedisCluster.setex(key, seconds, value);

    }   

    /**

     * 将 key 的值设为 value ,当且仅当 key 不存在

     * 若给定的 key 已经存在,则 SETNX 不做任何动作

     * @param key

     * @param value

     * @return 设置成功,返回 1,设置失败,返回 0

     */

    public Long setnx(String key,String value){

     return jedisCluster.setnx(key, value);

    }

    /**

     * 用 value 参数覆写(overwrite)给定 key 所储存的字符串值,从偏移量 offset 开始

     * 不存在的 key 当作空白字符串处理

     * @param key

     * @param offset

     * @param value

     * @return 被 SETRANGE 修改之后,字符串的长度

     */

    public Long setrange(String key,Long offset,String value){

     return jedisCluster.setrange(key, offset, value);

    }

    /**

     * 返回 key 所储存的字符串值的长度

     * 当 key 储存的不是字符串值时,返回一个错误

     * @param key

     * @return 字符串值的长度,当 key 不存在时,返回 0

     */

    public Long strlen(String key){

     return jedisCluster.strlen(key);

    }

    //Hash(哈希表)

    /**

     * 删除哈希表 key 中的一个或多个指定域,不存在的域将被忽略

     * @param key

     * @param fields 格式为:field,field,field....

     * @return 被成功移除的域的数量,不包括被忽略的域

     */

    public Long hdel(String key,String fields){

     return jedisCluster.hdel(key,fields);

    }

    /**

     * 查看哈希表 key 中,给定域 field 是否存在

     * @param key

     * @param field

     * @return 如果哈希表含有给定域,返回 1,如果哈希表不含有给定域,或 key 不存在,返回 0

     */

    public Boolean hexists(String key,String field){

     return jedisCluster.hexists(key, field);

    }

    /**

     * 返回哈希表 key 中给定域 field 的值

     * @param key

     * @param field

     * @return 给定域的值,当给定域不存在或是给定 key 不存在时,返回 nil

     */

    public String hget(String key,String field){

     return jedisCluster.hget(key, field);

    }

    /**

     * 返回哈希表 key 中,所有的域和值

     * 在返回值里,紧跟每个域名(field name)之后是域的值(value),所以返回值的长度是哈希表大小的两倍

     * @param key

     * @return 以列表形式返回哈希表的域和域的值,若 key 不存在,返回空列表

     */

    public Map<String,String> hgetAll(String key){

       return jedisCluster.hgetAll(key);

    }

    /**

     * 为哈希表 key 中的域 field 的值加上增量 increment

     * 增量也可以为负数,相当于对给定域进行减法操作

     * 如果 key 不存在,一个新的哈希表被创建并执行 HINCRBY 命令

     * 如果域 field 不存在,那么在执行命令前,域的值被初始化为 0

     * 对一个储存字符串值的域 field 执行 HINCRBY 命令将造成一个错误

     * @param key

     * @param field

     * @param value

     * @return 执行 HINCRBY 命令之后,哈希表 key 中域 field 的值

     */

    public Long hincrBy(String key,String field,long value){

     return jedisCluster.hincrBy(key, field, value);

    }

    /**

     * 返回哈希表 key 中的所有域

     * @param key

     * @return 一个包含哈希表中所有域的表,当 key 不存在时,返回一个空表

     */

    public Set<String> hkeys(String key){

     return jedisCluster.hkeys(key);

    }

    /**

     * 返回哈希表 key 中域的数量

     * @param key

     * @return 哈希表中域的数量,当 key 不存在时,返回 0

     */

    public Long hlen(String key){

     return jedisCluster.hlen(key);

    }

    /**

     * 返回哈希表 key 中,一个或多个给定域的值

     * 如果给定的域不存在于哈希表,那么返回一个 nil 值

     * 因为不存在的 key 被当作一个空哈希表来处理,所以对一个不存在的 key 进行 HMGET 操作将返回一个只带有 nil 值的表

     * @param key  

     * @param fields 格式为:field,field,field........

     * @return 一个包含多个给定域的关联值的表,表值的排列顺序和给定域参数的请求顺序一样

     */

    public List<String> hmget(String key,String fields){

     return jedisCluster.hmget(key, fields);

    }

    /**

     * 同时将多个 field-value (域-值)对设置到哈希表 key 中

     * 此命令会覆盖哈希表中已存在的域

     * 如果 key 不存在,一个空哈希表被创建并执行 HMSET 操作

     * @param key

     * @param fieldValues field,value,field,value....

     * @return 如果命令执行成功,返回 OK ,当 key 不是哈希表(hash)类型时,返回一个错误

     */

    public String hmset(String key,String fieldValues){

     String[] fieldValue=fieldValues.split(",");

     Map<String,String> map=new HashMap<String,String>();

     for(int i=0;i<fieldValue.length;i++){

     map.put(fieldValue[i],fieldValue[i+1]);

     }

     return jedisCluster.hmset(key,map);

    }

    /**

     * 将哈希表 key 中的域 field 的值设为 value

     * 如果 key 不存在,一个新的哈希表被创建并进行 HSET 操作

     * 如果域 field 已经存在于哈希表中,旧值将被覆盖

     * @param key

     * @param field

     * @param value

     * @return 如果 field 是哈希表中的一个新建域,并且值设置成功,返回 1,如果哈希表中域 field 已经存在且旧值已被新值覆盖,返回 0

     */

    public Long hset(String key,String field,String value){

     return jedisCluster.hset(key, field, value);

    }

    /**

     * 将哈希表 key 中的域 field 的值设置为 value ,当且仅当域 field 不存在

     * 若域 field 已经存在,该操作无效

     * 如果 key 不存在,一个新哈希表被创建并执行 HSETNX 命令

     * @param key

     * @param field

     * @param value

     * @return  设置成功,返回 1 ,如果给定域已经存在且没有操作被执行,返回 0

     */

    public Long hsetnx(String key,String field,String value){

     return jedisCluster.hsetnx(key, field, value);

    }

    /**

     * 返回哈希表 key 中所有域的值

     * @param key

     * @return 一个包含哈希表中所有值的表,当 key 不存在时,返回一个空表

     */

    public List<String> hvals(String key){   

     return jedisCluster.hvals(key);

    }

    //List(列表)

    /**

     *  LPOP 命令的阻塞版本,当给定列表内没有任何元素可供弹出的时候,连接将被 BLPOP 命令阻塞,直到等待超时或发现可弹出元素为止

     * @param timeout 超时时间,设置为0 表示无限制等待

     * @param key

     * @return

     */

    public String blpop(int timeout,String key){

     List<String> value=jedisCluster.blpop(timeout, key);

     return value.get(0);

    }

    /**

     *  RPOP 命令的阻塞版本,当给定列表内没有任何元素可供弹出的时候,连接将被 BLPOP 命令阻塞,直到等待超时或发现可弹出元素为止

     * @param timeout 超时时间,设置为0 表示无限制等待

     * @param key

     * @return

     */

    public String brpop(int timeout,String key){

     List<String> value=jedisCluster.brpop(timeout, key);

     return value.get(0);

    }

    /**

     * 返回列表 key 中,下标为 index 的元素。

     *下标(index)参数 start 和 stop 都以 0 为底,也就是说,以 0 表示列表的第一个元素,以 1 表示列表的第二个元素,以此类推

     *你也可以使用负数下标,以 -1 表示列表的最后一个元素, -2 表示列表的倒数第二个元素,以此类推

     *如果 key 不是列表类型,返回一个错误

     * @param key

     * @param index

     * @return

     */

    public String lindex(String key,long index){

     return jedisCluster.lindex(key, index);

    }

    /**

     * 将值 value 插入到列表 key 当中,位于值 pivot 之前或之后

     * 当 pivot 不存在于列表 key 时,不执行任何操作

     * 当 key 不存在时, key 被视为空列表,不执行任何操作

     * 如果 key 不是列表类型,返回一个错误

     * @param key

     * @param where  值为BEFORE或者AFTER

     * @param pivot

     * @param value

     * @return 成功:返回list长度  无pivot:返回-1   key不存在或者空列表:返回0 where输入错误:返回-2

     */

    public long linsert(String key,String where,String pivot,String value){

        long result=-2;

     if(where.toUpperCase()=="BEFORE"){

           result=jedisCluster.linsert(key,LIST_POSITION.BEFORE, pivot, value);

     }

     else if(where.toUpperCase()=="AFTER"){

        result=jedisCluster.linsert(key,LIST_POSITION.AFTER, pivot, value);

     }

     return result;

    }

    /**

     * 返回列表 key 的长度

     * 如果 key 不存在,则 key 被解释为一个空列表,返回 0

     * 如果 key 不是列表类型,返回一个错误

     * @param key

     * @return

     */

    public long llen(String key){

     return jedisCluster.llen(key);

    }

    /**

     * 移除并返回列表 key 的头元素

     * @param key

     * @return

     */

    public String lpop(String key){

     return jedisCluster.lpop(key);

    }

    /**

     * 将一个或多个值 value 插入到列表 key 的表头

     * 如果 key 不存在,一个空列表会被创建并执行 LPUSH 操作

     * 当 key 存在但不是列表类型时,返回一个错误

     * @param key

     * @param values  要插入的value的组合,格式为:value,value,......

     * @return 列表长度

     */

    public long lpush(String key,String values){

     return jedisCluster.lpush(key,values);

    }

    /**

     * 将值 value 插入到列表 key 的表头

     * @param key

     * @param value

     * @return 列表长度

     */

    public long lpushx(String key,String value){

     return jedisCluster.lpushx(key, value);

    }

    /**

     * 返回列表 key 中指定区间内的元素,区间以偏移量 start 和 stop 指定

     * 下标(index)参数 start 和 stop 都以 0 为底,也就是说,以 0 表示列表的第一个元素,以 1 表示列表的第二个元素,以此类推

     * 你也可以使用负数下标,以 -1 表示列表的最后一个元素, -2 表示列表的倒数第二个元素,以此类推。

     * @param key

     * @param start

     * @param stop

     * @return

     */

    public List<String> lrange(String key,long start,long stop){

     return jedisCluster.lrange(key, start, stop);

    }

    /**

     * count > 0 : 从表头开始向表尾搜索,移除与 value 相等的元素,数量为 count

     * count < 0 : 从表尾开始向表头搜索,移除与 value 相等的元素,数量为 count 的绝对值

     * count = 0 : 移除表中所有与 value 相等的值

     * @param key

     * @param count

     * @param value

     * @return  被移除元素的数量

     */

    public long lrem(String key,long count,String value){

     return jedisCluster.lrem(key, count, value);

    }

    /**

     * 将列表 key 下标为 index 的元素的值设置为 value

     * 当 index 参数超出范围,或对一个空列表( key 不存在)进行 LSET 时,返回一个错误

     * @param key

     * @param index

     * @param value

     * @return

     */

    public String lset(String key,long index,String value){

     return jedisCluster.lset(key, index, value);

    }

    /**

     * 对一个列表进行修剪(trim),就是说,让列表只保留指定区间内的元素,不在指定区间之内的元素都将被删除

     * @param key

     * @param start

     * @param end

     * @return 成功返回OK

     */

    public String ltrim(String key,long start,long end){

     return jedisCluster.ltrim(key, start, end);

    }

    /**

     * 移除并返回列表 key 的尾元素

     * 当 key 不存在时,返回 nil

     * @param key

     * @return

     */

    public String rpop(String key){

     return jedisCluster.rpop(key);

    }

    /**

     * 将一个或多个值 value 插入到列表 key 的表尾

     * 如果 key 不存在,一个空列表会被创建并执行 RPUSH 操作

     * 当 key 存在但不是列表类型时,返回一个错误

     * @param key

     * @param values  要插入的value的组合,格式为:value,value,......

     * @return 列表长度

     */

    public long rpush(String key,String values){

     return jedisCluster.rpush(key,values);

    }

    /**

     * 将值 value 插入到列表 key 的表尾

     * @param key

     * @param value

     * @return 列表长度

     */

    public long rpushx(String key,String value){

     return jedisCluster.rpushx(key, value);

    }

    //Set(集合)

    /**

     * 将一个或多个 member 元素加入到集合 key 当中,已经存在于集合的 member 元素将被忽略

     * 假如 key 不存在,则创建一个只包含 member 元素作成员的集合

     * 当 key 不是集合类型时,返回一个错误

     * @param key

     * @param members 格式为:member,member,.......

     * @return 被添加到集合中的新元素的数量,不包括被忽略的元素

     */

    public long sadd(String key,String members){

     return jedisCluster.sadd(key, members);

    }

    /**

     * 返回集合 key 的基数(集合中元素的数量)

     * @param key

     * @return 集合的基数,当 key 不存在时,返回 0

     */

    public long scard(String key){

     return jedisCluster.scard(key);

    }

    /**

     * 判断 member 元素是否集合 key 的成员

     * @param key

     * @param member

     * @return 如果 member 元素是集合的成员,返回 1,如果 member 元素不是集合的成员,或 key 不存在,返回 0

     */

    public Boolean sismember(String key,String member){

     return jedisCluster.sismember(key, member);

    }

    /**

     * 返回集合 key 中的所有成员,不存在的 key 被视为空集合

     * @param key

     * @return 集合中的所有成员

     */

    public Set<String> smembers(String key){

     return jedisCluster.smembers(key);

    }

    /**

     * 移除并返回集合中的一个随机元素

     * @param key

     * @return 被移除的随机元素,当 key 不存在或 key 是空集时,返回 nil

     */

    public String spop(String key){

     return jedisCluster.spop(key);

    }

    /**

     * 移除并返回集合中的一个随机元素

     * @param key

     * @return 被移除的随机元素,当 key 不存在或 key 是空集时,返回 nil

     */

    public Set<String> spop(String key,long count){

     return jedisCluster.spop(key, count);

    }

    /**

     * 只提供了 key 参数,那么返回集合中的一个随机元素, 不做删除

     * @param key

     * @return 返回一个元素;如果集合为空,返回 nil

     */

    public String srandMember(String key){

     return jedisCluster.srandmember(key);

    }

    /**

     * 如果 count 为正数,且小于集合基数,那么命令返回一个包含 count 个元素的数组,数组中的元素各不相同。如果 count 大于等于集合基数,那么返回整个集合

     * 如果 count 为负数,那么命令返回一个数组,数组中的元素可能会重复出现多次,而数组的长度为 count 的绝对值

     * @param key

     * @param count

     * @return 返回一个数组;如果集合为空,返回空数组

     */

    public List<String> srandMember(String key,int count){

     return jedisCluster.srandmember(key, count);

    }

    /**

     * 返回一个数组;如果集合为空,返回空数组

     * @param key

     * @param members 格式为:member,member,......

     * @return 被成功移除的元素的数量,不包括被忽略的元素

     */

    public long srem(String key,String members){

     return jedisCluster.srem(key, members);

    }

    //SortedSet(有序集合)

    /**

     * 将一个member 元素及其 score 值加入到有序集 key 当中

     * 如果某个 member 已经是有序集的成员,那么更新这个 member 的 score 值,并通过重新插入这个 member 元素,来保证该 member 在正确的位置上

     * @param key

     * @param score

     * @param member

     * @return 被成功添加的新成员的数量,不包括那些被更新的、已经存在的成员

     */

    public long zadd(String key,double score,String member){

     return jedisCluster.zadd(key, score, member);

    }

    /**

     * 将一个或多个 member 元素及其 score 值加入到有序集 key 当中

     * 如果某个 member 已经是有序集的成员,那么更新这个 member 的 score 值,并通过重新插入这个 member 元素,来保证该 member 在正确的位置上

     * @param key

     * @param scoreMembers 格式为:member,score,member,score,......

     * @return 被成功添加的新成员的数量,不包括那些被更新的、已经存在的成员

     */

    public long zadd(String key,String scoreMembers){

     String[] scoreMember=scoreMembers.split(",");

     Map<String,Double> map=new HashMap<String,Double>();

     for(int i=0;i<scoreMember.length;i++){

     map.put(scoreMember[i],Double.valueOf(scoreMember[i+1]));

     }

     return jedisCluster.zadd(key, map);

    }

    /**

     * 返回有序集 key 的基数

     * @param key

     * @return 当 key 存在且是有序集类型时,返回有序集的基数,当 key 不存在时,返回 0

     */

    public long zcard(String key){

     return jedisCluster.zcard(key);

    }

    /**

     * 返回有序集 key 中, score 值在 min 和 max 之间(默认包括 score 值等于 min 或 max )的成员的数量

     * @param key

     * @param min

     * @param max

     * @return score 值在 min 和 max 之间的成员的数量

     */

    public long zcount(String key,double min,double max){

     return jedisCluster.zcount(key, min, max);

    }

    /**

     * 为有序集 key 的成员 member 的 score 值加上增量 increment

     * 可以通过传递一个负数值 increment ,让 score 减去相应的值,比如 ZINCRBY key -5 member ,就是让 member 的 score 值减去 5

     * 当 key 不存在,或 member 不是 key 的成员时, ZINCRBY key increment member 等同于 ZADD key increment member

     * 当 key 不是有序集类型时,返回一个错误

     * @param key

     * @param score

     * @param member

     * @return member 成员的新 score 值

     */

    public double zincrby(String key,double increment,String member){

     return jedisCluster.zincrby(key, increment, member);

    }

    /**

     * 返回有序集 key 中,指定区间内的成员,其中成员的位置按 score 值递增(从小到大)来排序

     * 具有相同 score 值的成员按字典序(lexicographical order )来排列

     * 下标参数 start 和 stop 都以 0 为底,也就是说,以 0 表示有序集第一个成员,以 1 表示有序集第二个成员,以此类推。

     * 你也可以使用负数下标,以 -1 表示最后一个成员, -2 表示倒数第二个成员,以此类推

     * @param key

     * @param start

     * @param end

     * @return 指定区间内,带有 score 值(可选)的有序集成员的列表

     */

    public Set<String> zrange(String key,long start,long end){

     return jedisCluster.zrange(key, start, end);

    }

    /**

     * 返回有序集 key 中,所有 score 值介于 min 和 max 之间(包括等于 min 或 max )的成员。有序集成员按 score 值递增(从小到大)次序排列

     * @param key

     * @param min

     * @param max

     * @return 指定区间内,带有 score 值(可选)的有序集成员的列表

     */

    public Set<String> zrangeByScore(String key,String min,String max){

     return jedisCluster.zrangeByScore(key, min, max);

    }

    /**

     * 返回有序集 key 中,所有 score 值介于 min 和 max 之间(包括等于 min 或 max )的成员。有序集成员按 score 值递增(从小到大)次序排列

     * @param key

     * @param min

     * @param max

     * @return 指定区间内,带有 score 值(可选)的有序集成员的列表

     */

    public Set<String> zrangeByScore(String key,double min,double max){

     return jedisCluster.zrangeByScore(key, min, max);

    }

    /**

     * 返回有序集 key 中,所有 score 值介于 min 和 max 之间(包括等于 min 或 max )的成员。有序集成员按 score 值递增(从小到大)次序排列

     * 可选的 LIMIT 参数指定返回结果的数量及区间(就像SQL中的 SELECT LIMIT offset, count ),注意当 offset 很大时,定位 offset 的操作可能需要遍历整个有序集,此过程最坏复杂度为 O(N) 时间

     * @param key

     * @param min

     * @param max

     * @return 指定区间内,带有 score 值(可选)的有序集成员的列表

     */

    public Set<String> zrangeByScore(String key,String min,String max,int offset,int count){

     return jedisCluster.zrangeByScore(key, min, max, offset, count);

    }

    /**

     * 返回有序集 key 中,所有 score 值介于 min 和 max 之间(包括等于 min 或 max )的成员。有序集成员按 score 值递增(从小到大)次序排列

     * 可选的 LIMIT 参数指定返回结果的数量及区间(就像SQL中的 SELECT LIMIT offset, count ),注意当 offset 很大时,定位 offset 的操作可能需要遍历整个有序集,此过程最坏复杂度为 O(N) 时间

     * @param key

     * @param min

     * @param max

     * @return 指定区间内,带有 score 值(可选)的有序集成员的列表

     */

    public Set<String> zrangeByScore(String key,double min,double max,int offset,int count){

     return jedisCluster.zrangeByScore(key, min, max, offset, count);

    }

    /**

     * 返回有序集 key 中成员 member 的排名。其中有序集成员按 score 值递增(从小到大)顺序排列

     * 排名以 0 为底,也就是说, score 值最小的成员排名为 0

     * @param key

     * @param member

     * @return

     */

    public long zrank(String key,String member){

     return jedisCluster.zrank(key, member);

    }

    /**

     * 移除有序集 key 中的一个或多个成员,不存在的成员将被忽略

     * 当 key 存在但不是有序集类型时,返回一个错误

     * @param key

     * @param members 格式为:member,member,......

     * @return 被成功移除的成员的数量,不包括被忽略的成员

     */

    public long zrem(String key,String members){

     return jedisCluster.zrem(key, members);

    }

    /**

     * 移除有序集 key 中,指定排名(rank)区间内的所有成员

     * 区间分别以下标参数 start 和 stop 指出,包含 start 和 stop 在内

     * @param key

     * @param start

     * @param end

     * @return 被移除成员的数量

     */

    public long zremRangeByRank(String key,long start,long end){

     return jedisCluster.zremrangeByRank(key, start, end);

    }

    /**

     * 移除有序集 key 中,所有 score 值介于 min 和 max 之间(包括等于 min 或 max )的成员。

     * @param key

     * @param start

     * @param end

     * @return 被移除成员的数量

     */

    public long zremRangeByScore(String key,String start,String end){

     return jedisCluster.zremrangeByScore(key, start, end);

    }

    /**

     * 移除有序集 key 中,所有 score 值介于 min 和 max 之间(包括等于 min 或 max )的成员。

     * @param key

     * @param start

     * @param end

     * @return 被移除成员的数量

     */

    public long zremRangeByScore(String key,double start,double end){

     return jedisCluster.zremrangeByScore(key, start, end);

    }

    /**

     * 返回有序集 key 中,指定区间内的成员

     * 其中成员的位置按 score 值递减(从大到小)来排列

     * @param key

     * @param start

     * @param end

     * @return 指定区间内,带有 score 值(可选)的有序集成员的列表

     */

    public Set<String> zrevRange(String key,long start,long end){

     return jedisCluster.zrevrange(key, start, end);

    }

    /**

     * 返回有序集 key 中,所有 score 值介于 max 和 min 之间(包括等于 max 或 min )的成员。有序集成员按 score 值递减(从大到小)次序排列

     * @param key

     * @param min

     * @param max

     * @return 指定区间内,带有 score 值(可选)的有序集成员的列表

     */

    public Set<String> zrevrangeByScore(String key,String max,String min){

     return jedisCluster.zrevrangeByScore(key, max, min);

    }

    /**

     * 返回有序集 key 中,所有 score 值介于 max 和 min 之间(包括等于 max 或 min )的成员。有序集成员按 score 值递减(从大到小)次序排列

     * @param key

     * @param min

     * @param max

     * @return 指定区间内,带有 score 值(可选)的有序集成员的列表

     */

    public Set<String> zrevrangeByScore(String key,double max,double min){

     return jedisCluster.zrevrangeByScore(key, max, min);

    }

    /**

     * 返回有序集 key 中,所有 score 值介于 max 和 min 之间(包括等于 max 或 min )的成员。有序集成员按 score 值递减(从大到小)次序排列

     * 可选的 LIMIT 参数指定返回结果的数量及区间(就像SQL中的 SELECT LIMIT offset, count ),注意当 offset 很大时,定位 offset 的操作可能需要遍历整个有序集,此过程最坏复杂度为 O(N) 时间

     * @param key

     * @param min

     * @param max

     * @return 指定区间内,带有 score 值(可选)的有序集成员的列表

     */

    public Set<String> zrevrangeByScore(String key,String max,String min,int offset,int count){

     return jedisCluster.zrevrangeByScore(key, max,min , offset, count);

    }

    /**

     * 返回有序集 key 中,所有 score 值介于 max 和 min 之间(包括等于 max 或 min )的成员。有序集成员按 score 值递减(从大到小)次序排列

     * 可选的 LIMIT 参数指定返回结果的数量及区间(就像SQL中的 SELECT LIMIT offset, count ),注意当 offset 很大时,定位 offset 的操作可能需要遍历整个有序集,此过程最坏复杂度为 O(N) 时间

     * @param key

     * @param min

     * @param max

     * @return 指定区间内,带有 score 值(可选)的有序集成员的列表

     */

    public Set<String> zrevrangeByScore(String key,double max,double min,int offset,int count){

     return jedisCluster.zrevrangeByScore(key, max, min, offset, count);

    }

    /**

     * 返回有序集 key 中成员 member 的排名。其中有序集成员按 score 值递减(从大到小)排序

     * 排名以 0 为底,也就是说, score 值最大的成员排名为 0

     * @param key

     * @param member

     * @return 如果 member 是有序集 key 的成员,返回 member 的排名,如果 member 不是有序集 key 的成员,返回 nil

     */

    public long zrevRank(String key,String member){

     return jedisCluster.zrevrank(key, member);

    }

    /**

     * 返回有序集 key 中,成员 member 的 score 值

     * 如果 member 元素不是有序集 key 的成员,或 key 不存在,返回 nil

     * @param key

     * @param member

     * @return member 成员的 score 值

     */

    public Double zscore(String key,String member){

     return jedisCluster.zscore(key, member);

    }

    //Connection(连接)

    /**

     * 通过设置配置文件中 requirepass 项的值(使用命令 CONFIG SET requirepass password ),可以使用密码来保护 Redis 服务器

     * 如果开启了密码保护的话,在每次连接 Redis 服务器之后,就要使用 AUTH 命令解锁,解锁之后才能使用其他 Redis 命令

     * 如果 AUTH 命令给定的密码 password 和配置文件中的密码相符的话,服务器会返回 OK 并开始接受命令输入

     * 另一方面,假如密码不匹配的话,服务器将返回一个错误,并要求客户端需重新输入密码。

     * @param password

     * @return 密码匹配时返回 OK ,否则返回一个错误

     */

public String auth(String password){

     return jedisCluster.auth(password);

    }

/**

 * 打印一个特定的信息 message ,测试时使用

 * @param message

 * @return message 自身

 */

public String echo(String message){

return jedisCluster.echo(message);

}

/**

 * 使用客户端向 Redis 服务器发送一个 PING ,如果服务器运作正常的话,会返回一个 PONG

 * 通常用于测试与服务器的连接是否仍然生效,或者用于测量延迟值

 * @return 如果连接正常就返回一个 PONG ,否则返回一个连接错误

 */

public String ping(){

return jedisCluster.ping();

}

/**

 * 请求服务器关闭与当前客户端的连接

 * 一旦所有等待中的回复(如果有的话)顺利写入到客户端,连接就会被关闭

 * @return 总是返回 OK

 */

public String quit(){

return jedisCluster.quit();

}

/**

 * 切换到指定的数据库,数据库索引号 index 用数字值指定,以 0 作为起始索引值,默认使用 0 号数据库

 * @param index

 * @return ok

 */

public String select(int index){

return jedisCluster.select(index);

}

//Server(服务器)

/**

 * 执行一个 AOF文件 重写操作。重写会创建一个当前 AOF 文件的体积优化版本

 * @return 反馈信息

 */

public String bgreWriteAof(){

return jedisCluster.bgrewriteaof();

}

/**

 * 在后台异步(Asynchronously)保存当前数据库的数据到磁盘

 * BGSAVE 命令执行之后立即返回 OK ,然后 Redis fork 出一个新子进程,原来的 Redis 进程(父进程)继续处理客户端请求,而子进程则负责将数据保存到磁盘,然后退出

 * @return 反馈信息

 */

public String bgSave(){

return jedisCluster.bgsave();

}

/**

 * 返回当前数据库的 key 的数量

 * @return 当前数据库的 key 的数量

 */

public long dbSize(){

return jedisCluster.dbSize();

}

/**

 * 清空整个 Redis 服务器的数据(删除所有数据库的所有 key )

 * @return 总是返回 OK

 */

public String flushAll(){

return jedisCluster.flushAll();

}

/**

 * 清空当前数据库中的所有 key

 * @return 总是返回 OK

 */

public String flushDB(){

return jedisCluster.flushDB();

}

/**

 * 返回关于 Redis 服务器的各种信息和统计数值

 * @return

 */

public String info(){

return jedisCluster.info();

}

/**

 * 以一种易于解释(parse)且易于阅读的格式,返回关于 Redis 服务器的各种信息和统计数值

 * @param section

 * @return

 */

public String info(String section){

return jedisCluster.info(section);

}

/**

 * 返回最近一次 Redis 成功将数据保存到磁盘上的时间,以 UNIX 时间戳格式表示

 * @return

 */

public long lastsave(){

return jedisCluster.lastsave();

}

/**

 * SAVE 命令执行一个同步保存操作,将当前 Redis 实例的所有数据快照(snapshot)以 RDB 文件的形式保存到硬盘

 * @return 保存成功时返回 OK

 */

public String save(){

return jedisCluster.save();

}

/**

 * SHUTDOWN 命令执行以下操作:停止所有客户端

 * 如果有至少一个保存点在等待,执行 SAVE 命令

 * 如果 AOF 选项被打开,更新 AOF 文件

 * 关闭 redis 服务器(server)

 * 如果持久化被打开的话, SHUTDOWN 命令会保证服务器正常关闭而不丢失任何数据

 * @return 执行失败时返回错误,执行成功时不返回任何信息,服务器和客户端的连接断开,客户端自动退出

 */

public String shutdown(){

return jedisCluster.shutdown();

}

/**

 * SLAVEOF 命令用于在 Redis 运行时动态地修改复制(replication)功能的行为

 * 通过执行 SLAVEOF host port 命令,可以将当前服务器转变为指定服务器的从属服务器(slave server)

 * @param host

 * @param port

 * @return 总是返回 OK

 */

public String slaveof(String host,int port){

return jedisCluster.slaveof(host, port);

}

}

 

 

posted @ 2022-02-25 15:10  七月的尾巴_葵花  阅读(1981)  评论(0编辑  收藏  举报