Redis C客戶端API

工程師WWW發表於2014-08-15
Redis客戶端API

一、Redis安裝步驟：

1.redis server安裝

wget http://redis.googlecode.com/files/redis-2.4.6.tar.gz #下載檔案
tar xzf redis-2.4.6.tar.gz
cd redis-2.4.6
make
cp src/redis-server src/redis-cli /usr/bin/ #方便在終端在任何地方直接執行
cp redis.conf /etc/
ufw allow 6379 #ubuntu下開啟埠

修改/etc/redis.conf,讓server以守護程式在後臺執行。
daemonize yes

2.啟動redis服務
redis-server /etc/redis.conf

3.檢測redis服務是否正常啟動

ps -ef | grep redis


Hiredis客戶端下載地址：https://github.com/antirez/hiredis/zipball/master


二、Hiredis安裝步驟：
tar zxvf antirez-hiredis-v0.10.1-0-g3cc6a7f.zip
cd antirez-hiredis-3cc6a7f
make

mkdir /usr/lib/hiredis
cp libhiredis.so /usr/lib/hiredis #將動態連線庫libhiredis.so至/usr/lib/hiredis
mkdir /usr/include/hiredis
cp hiredis.h /usr/include/hiredis


1.連線hiredis伺服器
#include <stdio.h>
#include <hiredis/hiredis.h>

redisContext *conn = redisConnect("127.0.0.1", 6379); //redis server預設埠
if(conn->err){
printf("connection error: %s", conn->str);
}

2.傳送命令至伺服器
redisReply *reply = redisCommand(conn, "set key value");

3.關閉Reply物件
freeReplyObject(reply);

4.關閉連線

redisFree(conn);


hiredis是redis資料庫的C介面，目前只能在linux下使用，幾個基本的函式就可以操作redis資料庫了。

 

函式原型：redisContext *redisConnect(const char *ip, int port)

說明：該函式用來連線redis資料庫，引數為資料庫的ip地址和埠，一般redis資料庫的埠為6379

該函式返回一個結構體redisContext。

 

函式原型：void *redisCommand(redisContext *c, const char *format, ...);

說明：該函式執行命令，就如sql資料庫中的SQL語句一樣，只是執行的是redis資料庫中的操作命令，第一個引數為連線資料庫時返回的redisContext，剩下的引數為變參，就如C標準函式printf函式一樣的變參。返回值為void*，一般強制轉換成為redisReply型別的進行進一步的處理。

 

函式原型void freeReplyObject(void *reply);

說明：釋放redisCommand執行後返回的redisReply所佔用的記憶體

 

函式原型：void redisFree(redisContext *c);

說明：釋放redisConnect()所產生的連線。

 

下面用一個簡單的例子說明：

[cpp] view plaincopy
  1. #include <stdio.h>  
  2. #include <stdlib.h>  
  3. #include <stddef.h>  
  4. #include <stdarg.h>  
  5. #include <string.h>  
  6. #include <assert.h>  
  7. #include <hiredis/hiredis.h>  
  8.   
  9. void doTest()  
  10. {  
  11.     //redis預設監聽埠為6387 可以再配置檔案中修改  
  12.     redisContext* c = redisConnect("127.0.0.1", 6379);  
  13.     if ( c->err)  
  14.     {  
  15.         redisFree(c);  
  16.         printf("Connect to redisServer faile\n");  
  17.         return ;  
  18.     }  
  19.     printf("Connect to redisServer Success\n");  
  20.       
  21.     const char* command1 = "set stest1 value1";  
  22.     redisReply* r = (redisReply*)redisCommand(c, command1);  
  23.       
  24.     if( NULL == r)  
  25.     {  
  26.         printf("Execut command1 failure\n");  
  27.         redisFree(c);  
  28.         return;  
  29.     }  
  30.     if( !(r->type == REDIS_REPLY_STATUS && strcasecmp(r->str,"OK")==0))  
  31.     {  
  32.         printf("Failed to execute command[%s]\n",command1);  
  33.         freeReplyObject(r);  
  34.         redisFree(c);  
  35.         return;  
  36.     }     
  37.     freeReplyObject(r);  
  38.     printf("Succeed to execute command[%s]\n", command1);  
  39.       
  40.     const char* command2 = "strlen stest1";  
  41.     r = (redisReply*)redisCommand(c, command2);  
  42.     if ( r->type != REDIS_REPLY_INTEGER)  
  43.     {  
  44.         printf("Failed to execute command[%s]\n",command2);  
  45.         freeReplyObject(r);  
  46.         redisFree(c);  
  47.         return;  
  48.     }  
  49.     int length =  r->integer;  
  50.     freeReplyObject(r);  
  51.     printf("The length of 'stest1' is %d.\n", length);  
  52.     printf("Succeed to execute command[%s]\n", command2);  
  53.       
  54.       
  55.     const char* command3 = "get stest1";  
  56.     r = (redisReply*)redisCommand(c, command3);  
  57.     if ( r->type != REDIS_REPLY_STRING)  
  58.     {  
  59.         printf("Failed to execute command[%s]\n",command3);  
  60.         freeReplyObject(r);  
  61.         redisFree(c);  
  62.         return;  
  63.     }  
  64.     printf("The value of 'stest1' is %s\n", r->str);  
  65.     freeReplyObject(r);  
  66.     printf("Succeed to execute command[%s]\n", command3);  
  67.       
  68.     const char* command4 = "get stest2";  
  69.     r = (redisReply*)redisCommand(c, command4);  
  70.     if ( r->type != REDIS_REPLY_NIL)  
  71.     {  
  72.         printf("Failed to execute command[%s]\n",command4);  
  73.         freeReplyObject(r);  
  74.         redisFree(c);  
  75.         return;  
  76.     }  
  77.     freeReplyObject(r);  
  78.     printf("Succeed to execute command[%s]\n", command4);     
  79.       
  80.       
  81.     redisFree(c);  
  82.       
  83. }  
  84.   
  85. int main()  
  86. {  
  87.     doTest();  
  88.     return 0;  
  89. }  

 

執行結果為：



相關文章