API:
redisContext *redisConnect(const char *ip, int port);
redisContext *redisConnectWithTimeout(const char *ip, int port, const struct timeval tv);
redisContext *redisConnectNonBlock(const char *ip, int port);
void *redisCommand(redisContext *c, const char *format, ...);
redisReply *reply = (redisReply*)redisCommand(m_pContext, "SELECT %d", m_pCachePool->GetDBNum());
void freeReplyObject(void *reply); //释放redisCommand返回的对象
void redisFree(redisContext *c); //释放redisConnect返回的对象
1. redisConnect:
redisConnect() 用于返回一个“redisContext”句柄,用于维护一个Redis连接的状态信息。
struct redisContext 结构体中有一个“int err”成员,用于指示连接是否发生错误。
【redisContext 不是 线程安全的。】
使用举例:
redisContext *c = redisConnect("127.0.0.1", 6379);
if( c == NULL || c->err ) {
if(c) {
printf("Error: %s\n", c->errstr);
}
}
else {
printf("NULL, can't allocate redis context\n");
}
struct redisContext
结构体内容:
typedef struct redisContext {
int err;
char errstr[128];
int fd;
int flags;
char* obuf;
redisReader* reader;
} redisContext;
2. redisCommand :
redisCommand 用于发送命令:
redisReply *reply = (redisReply*)redisCommand((redisContext*)context, "SET foo bar");
if(reply && (reply->type == REDIS_REPLY_STATUS) && (strncmp(reply->str, "OK", 2)==0 ) )) {
freeReplyObject(reply);
return 0;
}
else {
log("select cache db failed");
return 2;
}
struct redisReply
结构体内容:
typedef struct redisReply {
int type; // REDIS_REPLY_* : 返回类型
long long integer;
int len;
char* str;
size_t elements;
struct redisReply** element;
} redisReply;
因不同的redis查询语句返回的信息类型不同,通过 redisReply结构体中的 type
字段进行表示:
REDIS_REPLY_STATUS, reply->str, reply->len //当回复类型是REDIS_REPLY_STATUS时,返回值存储在reply->str中
REDIS_REPLY_ERROR,
REDIS_REPLY_INTEGER, reply->integer //返回值存储在 reply->integer 中
REDIS_REPLY_NIL, The command replied with a nil object. There is no data to access.
REDIS_REPLY_STRING, reply->str, reply->len
REDIS_REPLY_ARRAY, reply->elements, reply->element[idx]
例如:
//string:
> set key value
OK
> get key
"value"
//hash:
> hset key1 field1 value1
(integer) 1
> hget key1 field1
"value1"
//list:
> lpush lkey1 element1 element2 element3
(integer) 3
3. redisFree :
使用redisFree断开连接并释放资源:
使用举例:
redisFree((redisContext*)context);
4. freeReplyObject:
redisCommand 返回的查询结果 redisReply 结构体,必须使用 freeReplyObject 函数显式的释放。
void freeReplyObject(void *reply);
遗留问题:
数据库连接池的数量设置为多大合适?