Redis教程(十五)：C語言串連作業碼執行個體

在之前的部落格中已經非常詳細的介紹了Redis的各種操作命令、運行機制和伺服器初始化參數配置。本篇部落格是該系列部落格中的最後一篇，在這裡將給出基於Redis用戶端組件訪問並操作Redis伺服器的程式碼範例。然而需要說明的是，由於Redis官方並未提供基於C介面的Windows平台用戶端，因此下面的樣本僅可運行於Linux/Unix平台。但是對於使用其它程式設計語言的開發人員而言，如C#和Java，Redis則提供了針對這些語言的用戶端組件，通過該方式，同樣可以達到基於Windows平台與Redis伺服器進行各種互動的目的。

該篇部落格中使用的用戶端來自於Redis官方網站，是Redis推薦的基於C介面的用戶端組件，見如下連結：
https://github.com/antirez/hiredis
在下面的程式碼範例中，將給出兩種最為常用的Redis命令操作方式，既普通調用方式和基於管線的調用方式。

註：在閱讀代碼時請留意注釋。

#include <stdio.h>#include <stdlib.h>#include <stddef.h>#include <stdarg.h>#include <string.h>#include <assert.h>#include <hiredis.h> void doTest(){  int timeout = 10000;  struct timeval tv;  tv.tv_sec = timeout / 1000;  tv.tv_usec = timeout * 1000;  //以帶有逾時的方式連結Redis伺服器，同時擷取與Redis串連的內容物件。  //該對象將用於其後所有與Redis操作的函數。  redisContext* c = redisConnectWithTimeout("192.168.149.137",6379,tv);  if (c->err) {    redisFree(c);    return;  }  const char* command1 = "set stest1 value1";  redisReply* r = (redisReply*)redisCommand(c,command1);  //需要注意的是，如果返回的對象是NULL，則表示用戶端和伺服器之間出現嚴重錯誤，必須重新連結。  //這裡只是舉例說明，簡便起見，後面的命令就不再做這樣的判斷了。  if (NULL == r) {    redisFree(c);    return;  }  //不同的Redis命令返回的資料類型不同，在擷取之前需要先判斷它的實際類型。  //至於各種命令的傳回值資訊，可以參考Redis的官方文檔，或者查看該系列部落格的前幾篇  //有關Redis各種資料類型的部落格。:)  //字串類型的set命令的傳回值的類型是REDIS_REPLY_STATUS，然後只有當返回資訊是"OK"  //時，才表示該命令執行成功。後面的例子以此類推，就不再過多贅述了。  if (!(r->type == REDIS_REPLY_STATUS && strcasecmp(r->str,"OK") == 0)) {    printf("Failed to execute command[%s].\n",command1);    freeReplyObject(r);    redisFree(c);    return;  }  //由於後面重複使用該變數，所以需要提前釋放，否則記憶體流失。  freeReplyObject(r);  printf("Succeed to execute command[%s].\n",command1);   const char* command2 = "strlen stest1";  r = (redisReply*)redisCommand(c,command2);  if (r->type != REDIS_REPLY_INTEGER) {    printf("Failed to execute command[%s].\n",command2);    freeReplyObject(r);    redisFree(c);    return;  }  int length = r->integer;  freeReplyObject(r);  printf("The length of 'stest1' is %d.\n",length);  printf("Succeed to execute command[%s].\n",command2);   const char* command3 = "get stest1";  r = (redisReply*)redisCommand(c,command3);  if (r->type != REDIS_REPLY_STRING) {    printf("Failed to execute command[%s].\n",command3);    freeReplyObject(r);    redisFree(c);    return;  }  printf("The value of 'stest1' is %s.\n",r->str);  freeReplyObject(r);  printf("Succeed to execute command[%s].\n",command3);   const char* command4 = "get stest2";  r = (redisReply*)redisCommand(c,command4);  //這裡需要先說明一下，由於stest2鍵並不存在，因此Redis會返回空結果，這裡只是為了示範。  if (r->type != REDIS_REPLY_NIL) {    printf("Failed to execute command[%s].\n",command4);    freeReplyObject(r);    redisFree(c);    return;  }  freeReplyObject(r);  printf("Succeed to execute command[%s].\n",command4);   const char* command5 = "mget stest1 stest2";  r = (redisReply*)redisCommand(c,command5);  //不論stest2存在與否，Redis都會給出結果，只是第二個值為nil。  //由於有多個值返回，因為返回應答的類型是數群組類型。  if (r->type != REDIS_REPLY_ARRAY) {    printf("Failed to execute command[%s].\n",command5);    freeReplyObject(r);    redisFree(c);    //r->elements表示子項目的數量，不管請求的key是否存在，該值都等於請求是鍵的數量。    assert(2 == r->elements);    return;  }  for (int i = 0; i < r->elements; ++i) {    redisReply* childReply = r->element[i];    //之前已經介紹過，get命令返回的資料類型是string。    //對於不存在key的傳回值，其類型為REDIS_REPLY_NIL。    if (childReply->type == REDIS_REPLY_STRING)      printf("The value is %s.\n",childReply->str);  }  //對於每一個子應答，無需使用者單獨釋放，只需釋放最外部的redisReply即可。  freeReplyObject(r);  printf("Succeed to execute command[%s].\n",command5);   printf("Begin to test pipeline.\n");  //該命令只是將待發送的命令寫入到內容物件的輸出緩衝區中，直到調用後面的  //redisGetReply命令才會批量將緩衝區中的命令寫出到Redis伺服器。這樣可以  //有效減少用戶端與伺服器之間的同步等候時間，以及網路IO引起的延遲。  //至於管線的具體效能優勢，可以考慮該系列部落格中的管線主題。  if (REDIS_OK != redisAppendCommand(c,command1)    || REDIS_OK != redisAppendCommand(c,command2)    || REDIS_OK != redisAppendCommand(c,command3)    || REDIS_OK != redisAppendCommand(c,command4)    || REDIS_OK != redisAppendCommand(c,command5)) {    redisFree(c);    return;  }   redisReply* reply = NULL;  //對pipeline返回結果的處理方式，和前面代碼的處理方式完全一直，這裡就不再重複給出了。  if (REDIS_OK != redisGetReply(c,(void**)&reply)) {    printf("Failed to execute command[%s] with Pipeline.\n",command1);    freeReplyObject(reply);    redisFree(c);  }  freeReplyObject(reply);  printf("Succeed to execute command[%s] with Pipeline.\n",command1);   if (REDIS_OK != redisGetReply(c,(void**)&reply)) {    printf("Failed to execute command[%s] with Pipeline.\n",command2);    freeReplyObject(reply);    redisFree(c);  }  freeReplyObject(reply);  printf("Succeed to execute command[%s] with Pipeline.\n",command2);   if (REDIS_OK != redisGetReply(c,(void**)&reply)) {    printf("Failed to execute command[%s] with Pipeline.\n",command3);    freeReplyObject(reply);    redisFree(c);  }  freeReplyObject(reply);  printf("Succeed to execute command[%s] with Pipeline.\n",command3);   if (REDIS_OK != redisGetReply(c,(void**)&reply)) {    printf("Failed to execute command[%s] with Pipeline.\n",command4);    freeReplyObject(reply);    redisFree(c);  }  freeReplyObject(reply);  printf("Succeed to execute command[%s] with Pipeline.\n",command4);   if (REDIS_OK != redisGetReply(c,(void**)&reply)) {    printf("Failed to execute command[%s] with Pipeline.\n",command5);    freeReplyObject(reply);    redisFree(c);  }  freeReplyObject(reply);  printf("Succeed to execute command[%s] with Pipeline.\n",command5);  //由於所有通過pipeline提交的命令結果均已為返回，如果此時繼續調用redisGetReply，  //將會導致該函數阻塞並掛起當前線程，直到有新的通過管線提交的命令結果返回。  //最後不要忘記在退出前釋放當前串連的內容物件。  redisFree(c);  return;} int main() {  doTest();  return 0;} //輸出結果如下：//Succeed to execute command[set stest1 value1].//The length of 'stest1' is 6.//Succeed to execute command[strlen stest1].//The value of 'stest1' is value1.//Succeed to execute command[get stest1].//Succeed to execute command[get stest2].//The value is value1.//Succeed to execute command[mget stest1 stest2].//Begin to test pipeline.//Succeed to execute command[set stest1 value1] with Pipeline.//Succeed to execute command[strlen stest1] with Pipeline.//Succeed to execute command[get stest1] with Pipeline.//Succeed to execute command[get stest2] with Pipeline.//Succeed to execute command[mget stest1 stest2] with Pipeline.

以上就是Redis教程(十五)：C語言串連作業碼執行個體的內容，更多相關內容請關注topic.alibabacloud.com（www.php.cn）！

