What APIs does redis have?

1. Introduction to Redis Client

1.1. Introduction

Jedis Client is a Java-oriented client recommended by the Redis official website. The library file implements encapsulation and calling of various APIs.

Jedis source code project address: https://github.com/xetorthio/jedis

1.2. It is best to use

Redis Client and service The version corresponding to the client. In this example, Redis 2.8.19 is used and the client uses jedis -2.6.3. Just add the following reference to the Maven project.

<dependency>
         <groupId>redis.clients</groupId>
         <artifactId>jedis</artifactId>
         <version>2.6.3</version>
         <type>jar</type>
         <scope>compile</scope>
   </dependency>

1.3. Notes

Redis Client has many docking versions. This project currently uses Jedis as the officially recommended Java docking client, which is based on its good connection with Redis. The version supports docking with API, and try to avoid using obsolete interfaces in coding.

Redis is currently in the transition period for the new version. Version 3.0 is not yet stable. However, since version 3.0 provides the latest cluster functions, it may be upgraded to 3.0 after the stable version is released in the future. The currently used Jedis supports the current version of 3.0. API.

2. Commonly used APIs for Redis Client

2.1. Environmental requirements

Language: Java

JDK ：1.7

Redis : 2.8.19 (stable version)

2.2. System usage

2.2.1. Establish connection

Normal connection

Jedis jedis = new Jedis("localhost");
       jedis.set("foo", "bar");
       String value = jedis.get("foo");
       System.out.println(value);

Set connection pool configuration

This method is used to get the connection pool configuration used by the redis connection pool connection. The connection pool configuration can also be injected through spring To configure the corresponding configuration, the connection pool uses the commonly used org.apache.commons.pool2.impl.GenericObjectPoolConfig for connection pool management

The configuration file is as follows

#redis服务器ip #   
    redis.ip=172.30.5.117 
   
    #redis服务器端口号# 
    redis.port=6379 
     
    ###jedis##pool##config### 
    #jedis的最大分配对象# 
    jedis.pool.maxActive=1024 
   
    #jedis最大保存idel状态对象数 # 
    jedis.pool.maxIdle=200 
   
    #jedis池没有对象返回时，最大等待时间 # 
    jedis.pool.maxWait=1000 
   
    #jedis调用borrowObject方法时，是否进行有效检查# 
    jedis.pool.testOnBorrow=true 
   
    #jedis调用returnObject方法时，是否进行有效检查 # 
    jedis.pool.testOnReturn=true

Connection pool configuration instantiation code (can also be configured through spring injection):

   /**
    * 获取化连接池配置
    * @return JedisPoolConfig
    * */
   private JedisPoolConfig getPoolConfig(){
      if(config == null){
         config = new JedisPoolConfig();
         //最大连接数
config.setMaxTotal(Integer.valueOf(getResourceBundle().getString("redis.pool.maxTotal")));
         //最大空闲连接数
config.setMaxIdle(Integer.valueOf(getResourceBundle().getString("redis.pool.maxIdle")));
         //获取连接时的最大等待毫秒数(如果设置为阻塞时BlockWhenExhausted),如果超时就抛异常, 小于零:阻塞不确定的时间,  默认-1
config.setMaxWaitMillis(Long.valueOf(getResourceBundle().getString("redis.pool.maxWaitMillis")));
         //在获取连接的时候检查有效性, 默认false
config.setTestOnBorrow(Boolean.valueOf(getResourceBundle().getString("redis.pool.testOnBorrow")));
         //在获取返回结果的时候检查有效性, 默认false
config.setTestOnReturn(Boolean.valueOf(getResourceBundle().getString("redis.pool.testOnReturn")));
      }
      return config;
   }

Normal connection pool connection

  这里展示的是普通的连接池方式链接redis的方案，跟普通的数据库连接池的操作方式类似；
/**
        * 初始化JedisPool
        * */
   private void initJedisPool(){
      if(pool == null){
         //获取服务器IP地址
         String ipStr = getResourceBundle().getString("redis.ip");
         //获取服务器端口
         int portStr = Integer.valueOf(getResourceBundle()
.getString("redis.port"));
         //初始化连接池
         pool = new JedisPool(getPoolConfig(), ipStr,portStr);
      }
   }

Sentinel connection pool connection

This connection pool is used for The master-slave switching mechanism of Sentinel in Redis can correctly obtain the correct server connection when the server is switched due to server downtime. When the server adopts this deployment strategy, it is recommended to use this connection pool for operation;

 private void initJedisSentinelPool(){
      if(sentinelpool == null){
         //监听器列表
         Set<String> sentinels = new HashSet<String>();
         //监听器1
         sentinels.add(new HostAndPort("192.168.50.236",
26379).toString());
         //监听器2
         sentinels.add(new HostAndPort("192.168.50.237",
26379).toString());
//实际使用的时候在properties里配置即可：redis.sentinel.hostandports
=192.168.50.236:26379,192.168.50.237:26379
getResourceBundle().getString("redis.sentinel.hostandports")
//mastername是服务器上的master的名字，在master服务器的sentinel.conf中配置:
                     //[sentinel monitor server-1M  192.168.50.236 6379 2]
                     //中间的server-1M即为这里的masterName
         String masterName = getResourceBundle()
.getString("redis.sentinel.masterName");
         //初始化连接池
         sentinelpool = new JedisSentinelPool(masterName,
sentinels, getPoolConfig());
      }
   }

ShardedJedisPool Connection pool sharded connection

   /**
        * 初始化ShardedJedisPool
        * Redis在容灾处理方面可以通过服务器端配置Master-Slave模式来实现。
        * 而在分布式集群方面目前只能通过客户端工具来实现一致性哈希分布存储，即key分片存储。
        * Redis可能会在3.0版本支持服务器端的分布存储
        * */
   private void initShardedJedisPool() {
      if (shardPool == null) {
         // 创建多个redis共享服务
         String redis1Ip = getResourceBundle().getString("redis1.ip");
         int redis1Port = Integer.valueOf(bundle.getString("redis.port"));
         JedisShardInfo jedisShardInfo1 = new JedisShardInfo(redis1Ip, redis1Port);
         String redis2Ip = getResourceBundle().getString("redis2.ip");
         int redis2Port = Integer.valueOf(bundle.getString("redis.port"));
         JedisShardInfo jedisShardInfo2 = new JedisShardInfo(redis2Ip, redis2Port);
 
         List<JedisShardInfo> serverlist = new LinkedList<JedisShardInfo>();
         serverlist.add(jedisShardInfo1);
         serverlist.add(jedisShardInfo2);
         // 初始化连接池
         shardPool = new ShardedJedisPool(getPoolConfig(),serverlist);
      }
   }

Read-write-delete operation

// 从池中获取一个Jedis对象
      Jedis jedis = sentinelpool.getSentinelpoolResource();
      String keys = "name";
   // 删除key-value对象，如果key不存在则忽略此操作
      jedis.del(keys);
   // 存数据
      jedis.set(keys, "snowolf");
// 判断key是否存在，不存在返回false存在返回true
      jedis.exists(keys);
   // 取数据
      String value = jedis.get(keys);
   // 释放对象池（3.0将抛弃该方法）
      sentinelpool.returnSentinelpoolResource(jedis);

3. Sample code

1. Simple append of String

// 从池中获取一个Jedis对象
   JedisUtil.getInstance().STRINGS.append(key, value);

2. Price time Sorting (provided that the SortSet of price and time has been stored)

//Execute level 2 sorting operation ()

String stPriceSet = “stPriceSet”;//stPriceSet价格的sortset列表名
String stTimeSet = “stTimeSet”; // stTimeSet时间的sortset列表名
   Set<Tuple> sumSet = JedisUtilEx.getInstance()
.getSortSetByPirceUpAndTimeDown(stPriceSet, stTimeSet);
//排序以后可以重复获取上次排序结果(缓存时间10分钟)
Set<Tuple> sumSet = JedisUtilEx.getInstance()
getLastPirceUpAndTimeDownSet();

3. Price time sorting (provided that the price and time have been stored) SortSet)

//执行2级排序操作
String stPriceSet = “stPriceSet”;//stPriceSet价格的sortset列表名
String stTimeSet = “stTimeSet”; // stTimeSet时间的sortset列表名
   Set<Tuple> sumSet = JedisUtilEx.getInstance()
. getSortSetByPirceDownAndTimeDown (stPriceSet, stTimeSet);
   //排序以后可以重复获取上次排序结果(缓存时间10分钟)
Set<Tuple> sumSet = JedisUtilEx.getInstance()
getLastPirceDownAndTimeDownSet ();

4.  Save JavaBeans to the hash table

// bean继承至RedisBean
JedisUtilEx.getInstance().setBeanToHash(bean);

5.  Read JavaBeans from the hash table

//uuid为业务制定的唯一标识符规则（相当于主键）
String uuid = “1”; //该ID是我们提前就知道的
//T继承至RedisBean;
JedisUtilEx.getInstance().getBeanFromHash (uuid,Class<T> cls);

6.  Load the JavaBean list into the hash

//list中的bean继承至RedisBean
List<T> beanList = …;
JedisUtilEx.getInstance().setBeanListToHash(beanList);
//异步版本的存储列表到hash
JedisUtilEx.getInstance().setBeanListToHashSyn(beanList);

7. Common operation process example

//获取jedis引用
Jedis jedis = JedisUtil.getInstance().getJedis();
//执行业务以及调用jedis提供的接口功能
…
jedis.hset(…);
…
//执行完成以后务必释放资源
JedisUtil.getInstance().returnJedis(jedis);
//若以后不会使用JEDIS，需要关闭所有链接池
   RedisConnetcion.destroyAllPools();

8. Transaction execution process

//获取连接资源
   Jedis jd = JedisUtil.getInstance().getJedis();
//开启事务
Transaction ts = jd.multi();
//执行业务以及调用jedis提供的接口功能
…
jedis.hset(…);
…
//执行事务
   List<Object> list = ts.exec();
//释放资源
JedisUtil.getInstance().returnJedis(jd);

9. Asynchronous execution

//获取连接资源
   Jedis jedis = JedisUtil.getInstance().getJedis();
   //获取管道
Pipeline pipeline = jedis.pipelined();
//执行业务以及调用jedis提供的接口功能
…
jedis.hset(…);
…
//提交并释放管道
pipeline.syncAndReturnAll();
//释放资源
JedisUtil.getInstance().returnJedis(jedis);

10. How to obtain Jedis naming rules Synthetic KEY

//获取类的唯一键值key,例如：User:1(User为class,1为uuid)其中user继承于Reidsbean
JedisUtilEx.getInstance().getBeanKey(user);
//另一种获取类的唯一键值key的方法
JedisUtilEx.getInstance().getBeanKey(String uuid,Class<T> cls);
//获取bean对应的KEY(对应列的唯一键值key)
JedisUtilEx.getInstance().getBeanKey(String uuid,Class<T> cls,String... fileds);
//获取bean对应的KEY(集群key)
JedisUtilEx.getInstance().getBeanKey(Class<T> cls,String... fileds);

4. jedis operation commands:

1. Commands for value operations

 exists(key)：确认一个key是否存在
     del(key)：删除一个key
     type(key)：返回值的类型
     keys(pattern)：返回满足给定pattern的所有key
     randomkey：随机返回key空间的一个key
     rename(oldname, newname)：将key由oldname重命名为newname，若newname存在则删除newname表示的key
     dbsize：返回当前数据库中key的数目
     expire：设定一个key的活动时间（s）
     ttl：获得一个key的活动时间
     select(index)：按索引查询
     move(key, dbindex)：将当前数据库中的key转移到有dbindex索引的数据库
     flushdb：删除当前选择数据库中的所有key
     flushall：删除所有数据库中的所有key

2. Commands for String operations

  set(key, value)：给数据库中名称为key的string赋予值value
     get(key)：返回数据库中名称为key的string的value
     getset(key, value)：给名称为key的string赋予上一次的value
     mget(key1, key2,…, key N)：返回库中多个string（它们的名称为key1，key2…）的value
     setnx(key, value)：如果不存在名称为key的string，则向库中添加string，名称为key，值为value
     setex(key, time, value)：向库中添加string（名称为key，值为value）同时，设定过期时间time
     mset(key1, value1, key2, value2,…key N, value N)：同时给多个string赋值，名称为key i的string赋值value i
     msetnx(key1, value1, key2, value2,…key N, value N)：如果所有名称为key i的string都不存在，则向库中添加string，名称key i赋值为value i
     incr(key)：名称为key的string增1操作
     incrby(key, integer)：名称为key的string增加integer
     decr(key)：名称为key的string减1操作
     decrby(key, integer)：名称为key的string减少integer
     append(key, value)：名称为key的string的值附加value
     substr(key, start, end)：返回名称为key的string的value的子串

3. Commands for List operations

 rpush(key, value)：在名称为key的list尾添加一个值为value的元素
     lpush(key, value)：在名称为key的list头添加一个值为value的 元素
     llen(key)：返回名称为key的list的长度
     lrange(key, start, end)：返回名称为key的list中start至end之间的元素（下标从0开始，下同）
     ltrim(key, start, end)：截取名称为key的list，保留start至end之间的元素
     lindex(key, index)：返回名称为key的list中index位置的元素
     lset(key, index, value)：给名称为key的list中index位置的元素赋值为value
     lrem(key, count, value)：删除count个名称为key的list中值为value的元素。count为0，删除所有值为value的元素，count>0      从头至尾删除count个值为value的元素，count<0从尾到头删除|count|个值为value的元素。
     lpop(key)：返回并删除名称为key的list中的首元素
     rpop(key)：返回并删除名称为key的list中的尾元素
     blpop(key1, key2,… key N, timeout)：lpop 命令的block版本。即当timeout为0时，若遇到名称为key i的list不存在或该list为空，则命令结束。如果 timeout>0，则遇到上述情况时，等待timeout秒，如果问题没有解决，则对key i+1开始的list执行pop操作。
     brpop(key1, key2,… key N, timeout)：rpop的block版本。参考上一命令。
     rpoplpush(srckey, dstkey)：返回并删除名称为srckey的list的尾元素，并将该元素添加到名称为dstkey的list的头部

4. Commands for Set operations

  sadd(key, member)：向名称为key的set中添加元素member
     srem(key, member) ：删除名称为key的set中的元素member
     spop(key) ：随机返回并删除名称为key的set中一个元素
     smove(srckey, dstkey, member) ：将member元素从名称为srckey的集合移到名称为dstkey的集合
     scard(key) ：返回名称为key的set的基数
     sismember(key, member) ：测试member是否是名称为key的set的元素
     sinter(key1, key2,…key N) ：求交集
     sinterstore(dstkey, key1, key2,…key N) ：求交集并将交集保存到dstkey的集合
     sunion(key1, key2,…key N) ：求并集
     sunionstore(dstkey, key1, key2,…key N) ：求并集并将并集保存到dstkey的集合
     sdiff(key1, key2,…key N) ：求差集
     sdiffstore(dstkey, key1, key2,…key N) ：求差集并将差集保存到dstkey的集合
     smembers(key) ：返回名称为key的set的所有元素
     srandmember(key) ：随机返回名称为key的set的一个元素

5. Commands for zset (sorted set) operations

   zadd(key, score, member)：向名称为key的zset中添加元素member，score用于排序。如果该元素已经存在，则根据score更新该元素的顺序。
     zrem(key, member) ：删除名称为key的zset中的元素member
     zincrby(key, increment, member) ：如果在名称为key的zset中已经存在元素member，则该元素的score增加increment；否则向集合中添加该元素，其score的值为increment
     zrank(key, member) ：返回名称为key的zset（元素已按score从小到大排序）中member元素的rank（即index，从0开始），若没有member元素，返回“nil”
     zrevrank(key, member) ：返回名称为key的zset（元素已按score从大到小排序）中member元素的rank（即index，从0开始），若没有member元素，返回“nil”
     zrange(key, start, end)：返回名称为key的zset（元素已按score从小到大排序）中的index从start到end的所有元素
     zrevrange(key, start, end)：返回名称为key的zset（元素已按score从大到小排序）中的index从start到end的所有元素
     zrangebyscore(key, min, max)：返回名称为key的zset中score >= min且score <= max的所有元素
     zcard(key)：返回名称为key的zset的基数
     zscore(key, element)：返回名称为key的zset中元素element的score
     zremrangebyrank(key, min, max)：删除名称为key的zset中rank >= min且rank <= max的所有元素
     zremrangebyscore(key, min, max) ：删除名称为key的zset中score >= min且score <= max的所有元素
     zunionstore / zinterstore(dstkeyN, key1,…,keyN, WEIGHTS w1,…wN, AGGREGATE SUM|MIN|MAX)：对N个zset求并集和交集，并将最后的集合保存在dstkeyN中。对于集合中每一个元素的score，在进行AGGREGATE运算前，都要乘以对于的WEIGHT参数。如果没有提供WEIGHT，默认为1。默认的AGGREGATE是SUM，即结果集合中元素的score是所有集合对应元素进行 SUM运算的值，而MIN和MAX是指，结果集合中元素的score是所有集合对应元素中最小值和最大值。

6. Hash operations Operation commands

   hset(key, field, value)：向名称为key的hash中添加元素field<—>value
     hget(key, field)：返回名称为key的hash中field对应的value
     hmget(key, field1, …,field N)：返回名称为key的hash中field i对应的value
     hmset(key, field1, value1,…,field N, value N)：向名称为key的hash中添加元素field i<—>value i
     hincrby(key, field, integer)：将名称为key的hash中field的value增加integer
     hexists(key, field)：名称为key的hash中是否存在键为field的域
     hdel(key, field)：删除名称为key的hash中键为field的域
     hlen(key)：返回名称为key的hash中元素个数
     hkeys(key)：返回名称为key的hash中所有键
     hvals(key)：返回名称为key的hash中所有键对应的value
     hgetall(key)：返回名称为key的hash中所有的键（field）及其对应的value

5. Redis naming rules

Since all Redis data are key-value pairs, that is, all data can only be managed through key-value (Key), so

To standardize the naming rules, the jedis client packages a special naming rule production function, just call it! Code reference example code:

6. Reference materials

API: http://www.php.cn/dic/54.html

For more functions, you can refer to this document to call

For more Redis-related technical articles, please visit the Redis Tutorial column to learn!

The above is the detailed content of What APIs does redis have?. For more information, please follow other related articles on the PHP Chinese website!