Redis学习手册(实例代码)

在之前的博客中已经非常详细的介绍了Redis的各种操作命令、运行机制和服务器初始化参数配置。本篇博客是该系列博客中的最后一篇，在这里将给出基于Redis客户端组件访问并操作Redis服务器的代码示例。然而需要说明的是，由于Redis官方并未提供基于C接口的Windows平台客户端，因此下面的示例仅可运行于Linux/Unix平台。但是对于使用其它编程语言的开发者而言，如C#和Java，Redis则提供了针对这些语言的客户端组件，通过该方式，同样可以达到基于Windows平台与Redis服务器进行各种交互的目的。
   该篇博客中使用的客户端来自于Redis官方网站，是Redis推荐的基于C接口的客户端组件，见如下链接：
   https://github.com/antirez/hiredis
   在下面的代码示例中，将给出两种最为常用的Redis命令操作方式，既普通调用方式和基于管线的调用方式。
   注：在阅读代码时请留意注释。

  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.h>
  8
  9 void doTest()
 10 {
 11     int timeout = 10000;
 12     struct timeval tv;
 13     tv.tv_sec = timeout / 1000;
 14     tv.tv_usec = timeout * 1000;
 15     //以带有超时的方式链接Redis服务器，同时获取与Redis连接的上下文对象。 16     //该对象将用于其后所有与Redis操作的函数。 17     redisContext* c = redisConnectWithTimeout("192.168.149.137",6379,tv);
 18     if (c->err) {
 19         redisFree(c);
 20         return;
 21     }
 22     const char* command1 = "set stest1 value1";
 23     redisReply* r = (redisReply*)redisCommand(c,command1);
 24     //需要注意的是，如果返回的对象是NULL，则表示客户端和服务器之间出现严重错误，必须重新链接。 25     //这里只是举例说明，简便起见，后面的命令就不再做这样的判断了。 26     if (NULL == r) {
 27         redisFree(c);
 28         return;
 29     }
 30     //不同的Redis命令返回的数据类型不同，在获取之前需要先判断它的实际类型。 31     //至于各种命令的返回值信息，可以参考Redis的官方文档，或者查看该系列博客的前几篇 32     //有关Redis各种数据类型的博客。:) 33     //字符串类型的set命令的返回值的类型是REDIS_REPLY_STATUS，然后只有当返回信息是"OK" 34     //时，才表示该命令执行成功。后面的例子以此类推，就不再过多赘述了。 35     if (!(r->type == REDIS_REPLY_STATUS && strcasecmp(r->str,"OK") == 0)) {
 36         printf("Failed to execute command[%s].\n",command1);
 37         freeReplyObject(r);
 38         redisFree(c);
 39         return;
 40     }
 41     //由于后面重复使用该变量，所以需要提前释放，否则内存泄漏。 42     freeReplyObject(r);
 43     printf("Succeed to execute command[%s].\n",command1);
 44
 45     const char* command2 = "strlen stest1";
 46     r = (redisReply*)redisCommand(c,command2);
 47     if (r->type != REDIS_REPLY_INTEGER) {
 48         printf("Failed to execute command[%s].\n",command2);
 49         freeReplyObject(r);
 50         redisFree(c);
 51         return;
 52     }
 53     int length = r->integer;
 54     freeReplyObject(r);
 55     printf("The length of 'stest1' is %d.\n",length);
 56     printf("Succeed to execute command[%s].\n",command2);
 57
 58     const char* command3 = "get stest1";
 59     r = (redisReply*)redisCommand(c,command3);
 60     if (r->type != REDIS_REPLY_STRING) {
 61         printf("Failed to execute command[%s].\n",command3);
 62         freeReplyObject(r);
 63         redisFree(c);
 64         return;
 65     }
 66     printf("The value of 'stest1' is %s.\n",r->str);
 67     freeReplyObject(r);
 68     printf("Succeed to execute command[%s].\n",command3);
 69
 70     const char* command4 = "get stest2";
 71     r = (redisReply*)redisCommand(c,command4);
 72     //这里需要先说明一下，由于stest2键并不存在，因此Redis会返回空结果，这里只是为了演示。 73     if (r->type != REDIS_REPLY_NIL) {
 74         printf("Failed to execute command[%s].\n",command4);
 75         freeReplyObject(r);
 76         redisFree(c);
 77         return;
 78     }
 79     freeReplyObject(r);
 80     printf("Succeed to execute command[%s].\n",command4);
 81
 82     const char* command5 = "mget stest1 stest2";
 83     r = (redisReply*)redisCommand(c,command5);
 84     //不论stest2存在与否，Redis都会给出结果，只是第二个值为nil。 85     //由于有多个值返回，因为返回应答的类型是数组类型。 86     if (r->type != REDIS_REPLY_ARRAY) {
 87         printf("Failed to execute command[%s].\n",command5);
 88         freeReplyObject(r);
 89         redisFree(c);
 90         //r->elements表示子元素的数量，不管请求的key是否存在，该值都等于请求是键的数量。 91         assert(2 == r->elements);
 92         return;
 93     }
 94     for (int i = 0; i < r->elements; ++i) {
 95         redisReply* childReply = r->element[i];
 96         //之前已经介绍过，get命令返回的数据类型是string。 97         //对于不存在key的返回值，其类型为REDIS_REPLY_NIL。 98         if (childReply->type == REDIS_REPLY_STRING)
 99             printf("The value is %s.\n",childReply->str);
100     }
101     //对于每一个子应答，无需使用者单独释放，只需释放最外部的redisReply即可。102     freeReplyObject(r);
103     printf("Succeed to execute command[%s].\n",command5);
104
105     printf("Begin to test pipeline.\n");
106     //该命令只是将待发送的命令写入到上下文对象的输出缓冲区中，直到调用后面的107     //redisGetReply命令才会批量将缓冲区中的命令写出到Redis服务器。这样可以108     //有效的减少客户端与服务器之间的同步等候时间，以及网络IO引起的延迟。109     //至于管线的具体性能优势，可以考虑该系列博客中的管线主题。110     if (REDIS_OK != redisAppendCommand(c,command1)
111         || REDIS_OK != redisAppendCommand(c,command2)
112         || REDIS_OK != redisAppendCommand(c,command3)
113         || REDIS_OK != redisAppendCommand(c,command4)
114         || REDIS_OK != redisAppendCommand(c,command5)) {
115         redisFree(c);
116         return;
117     }
118
119     redisReply* reply = NULL;
120     //对pipeline返回结果的处理方式，和前面代码的处理方式完全一直，这里就不再重复给出了。121     if (REDIS_OK != redisGetReply(c,(void**)&reply)) {
122         printf("Failed to execute command[%s] with Pipeline.\n",command1);
123         freeReplyObject(reply);
124         redisFree(c);
125     }
126     freeReplyObject(reply);
127     printf("Succeed to execute command[%s] with Pipeline.\n",command1);
128
129     if (REDIS_OK != redisGetReply(c,(void**)&reply)) {
130         printf("Failed to execute command[%s] with Pipeline.\n",command2);
131         freeReplyObject(reply);
132         redisFree(c);
133     }
134     freeReplyObject(reply);
135     printf("Succeed to execute command[%s] with Pipeline.\n",command2);
136
137     if (REDIS_OK != redisGetReply(c,(void**)&reply)) {
138         printf("Failed to execute command[%s] with Pipeline.\n",command3);
139         freeReplyObject(reply);
140         redisFree(c);
141     }
142     freeReplyObject(reply);
143     printf("Succeed to execute command[%s] with Pipeline.\n",command3);
144
145     if (REDIS_OK != redisGetReply(c,(void**)&reply)) {
146         printf("Failed to execute command[%s] with Pipeline.\n",command4);
147         freeReplyObject(reply);
148         redisFree(c);
149     }
150     freeReplyObject(reply);
151     printf("Succeed to execute command[%s] with Pipeline.\n",command4);
152
153     if (REDIS_OK != redisGetReply(c,(void**)&reply)) {
154         printf("Failed to execute command[%s] with Pipeline.\n",command5);
155         freeReplyObject(reply);
156         redisFree(c);
157     }
158     freeReplyObject(reply);
159     printf("Succeed to execute command[%s] with Pipeline.\n",command5);
160     //由于所有通过pipeline提交的命令结果均已为返回，如果此时继续调用redisGetReply，161     //将会导致该函数阻塞并挂起当前线程，直到有新的通过管线提交的命令结果返回。162     //最后不要忘记在退出前释放当前连接的上下文对象。163     redisFree(c);
164     return;
165 }
166
167 int main()
168 {
169     doTest();
170     return 0;
171 }
172
173 //输出结果如下：174 //Succeed to execute command[set stest1 value1].175 //The length of 'stest1' is 6.176 //Succeed to execute command[strlen stest1].177 //The value of 'stest1' is value1.178 //Succeed to execute command[get stest1].179 //Succeed to execute command[get stest2].180 //The value is value1.181 //Succeed to execute command[mget stest1 stest2].182 //Begin to test pipeline.183 //Succeed to execute command[set stest1 value1] with Pipeline.184 //Succeed to execute command[strlen stest1] with Pipeline.185 //Succeed to execute command[get stest1] with Pipeline.186 //Succeed to execute command[get stest2] with Pipeline.187 //Succeed to execute command[mget stest1 stest2] with Pipeline.

该示例代码已经调试通过，同时也用Valgrind进行了运行时检查，不存在任何内存泄露，特此声明。

Redis学习手册(实例代码)相关推荐

SQLite学习手册(实例代码二)
三.高效的批量数据插入: 在给出操作步骤之前先简单说明一下批量插入的概念,以帮助大家阅读其后的示例代码.事实上,批量插入并不是什么新的概念,在其它关系型数据库的C接口API中都提供了一定的支持,只是接 ...
SQLite学习手册(实例代码一)
一.获取表的Schema信息: 1). 动态创建表. 2). 根据sqlite3提供的API,获取表字段的信息,如字段数量以及每个字段的类型. 3). 删除该表. 见以下代码及 ...
转-Redis学习手册(目录)
为什么自己当初要选择Redis作为数据存储解决方案中的一员呢?现在能想到的原因主要有三.其一,Redis不仅性能高效,而且完全免费.其二,是基于C/C++开发的服务器,这里应该有一定的感情因素吧.最后 ...
Redis学习手册1—数据结构之字符串
Redis数据结构之字符串字符串存储结构命令 SET命令改变覆盖规则 GET命令 GETSET命令 MSET命令 MGET命令 MSETNX命令 STRLEN命令 GETRANGE SETRA ...
Redis学习手册(事务)
一.概述: 和众多其它数据库一样,Redis作为NoSQL数据库也同样提供了事务机制.在Redis中,MULTI/EXEC/DISCARD/WATCH这四个命令是我们实现事务的基石.相信对有关系型数据 ...
php中使用redis队列操作实例代码
例1,入队操作: <?php $redis = new Redis(); $redis->connect('127.0.0.1',6379); while(True){try{$value ...
Redis学习手册(Sorted-Sets数据类型)
一.概述: Sorted-Sets和Sets类型极为相似,它们都是字符串的集合,都不允许重复的成员出现在一个Set中.它们之间的主要差别是Sorted-Sets中的每一个成员都会有一个分数(score ...
Redis学习手册(String数据类型)
2019独角兽企业重金招聘Python工程师标准>>> 一.概述: 字符串类型是Redis中最为基础的数据存储类型,它在Redis中是二进制安全的,这便意味着该类型可以接受任何格式的 ...
Redis学习手册(List数据类型)（转）
一.概述: 在Redis中,List类型是按照插入顺序排序的字符串链表.和数据结构中的普通链表一样,我们可以在其头部(left)和尾部(right)添加新的元素.在插入时,如果该键并不存在,Redi ...

Redis学习手册(实例代码)

Redis学习手册(实例代码)相关推荐

最新文章

热门文章