xRedis

C++ Redis client, support the data slice storage, redis cluster, connection pool, read/write separation.

Features:

• Support multi-node distributed storage of data, can customize the sharding rules;
• Support to connect to master and slave nodes of each shard at the same time, support separation of master and slave reads and writes;
• Support connection pooling for each storage node;
• Support simultaneous connection of multiple data sharding clusters;
• Support for connecting to official clusters, single or multiple nodes
  Support to set up a connection pool to each node, the client side automatically calculates the slot distribution.
  Support automatic calculation of node index position, support Redis cluster node change connection automatic switch;
  The connection pool to the cluster is automatically updated when the add/delete /slot distribution of the official cluster node changes.
• Provide easy to use C++ interface encapsulation, has implemented most of the Redis command;
• Only rely on the Hiredis library;
• Multi-thread safety
• Support password connection;
• Support Linux and Windows platforms

中文版说明文档点这里

Dependencies

xredis requires hiredis only

Install

First step install libhiredis, on a Debian system you can use:

sudo apt-get install libhiredis-dev

on centos/redhat/fedora system you can use:

sudo yum install hiredis-devel

Then checkout the code and compile it

git clone https://github.com/0xsky/xredis
cd xredis
make
sudo make install

Usage

#Accessing redis or  redis Cluster using the xRedisClusterClient class
#include "xRedisClusterClient.h"
int main(int argc, char **argv) {
    xRedisClusterClient redisclient;
    # Connect to REDIS and establish a connection pool 
    # If this node is a member of the REDIS cluster, 
    # a connection pool is automatically established for each primary node in the cluster.
    std::string passwd = "passwd123";
    bool bRet = redisclient.connect("127.0.0.1", 6379, passwd, 4);
    RedisResult result;
    redisclient.command(result, "set %s %s", "key", "hello");
    printf("type:%d integer:%lld str:%s \r\n",
        result.type(), result.integer(), result.str());
   while (true) {
        usleep(1000*1000*6);
        redisclient.keepalive();
    }
    return 0;
}

Todo

Support redis sentinel

Documentation

xRedis API Site

See examples directory for some examples

blog: xSky’s Blog

xRedis QQ Group: 190107312