一、概述
（可以直接略过此段）redis 最近做为 nosql 数据服务应用越来越广泛，其相对于 memcached 的最大优点是提供了更加丰富的数据结构，所以应用场景就更为广泛。redis 的出现可谓是广大网络应用开发者的福音，同时有大量的开源人员贡献了客户端代码，象针对 java 语言的 jedis，php 语言的 phpredis/predis 等，这些语言的 redis 库既丰富又好用，而对 C/C++ 程序员似乎就没那么幸运了，官方提供了 C 版的 hiredis 作为客户端库，很多爱好者都是基于 hiredis 进行二次封装和开发形成了 C++ 客户端库，但这些库（包括官方的 hiredis）大都使用麻烦，给使用者造成了许多出错的机会。一直想开发一个更易用的接口型的 C++ 版 redis 客户端库（注：官方提供的库基本属于协议型的，这意味着使用者需要花费很多精力去填充各个协议字段同时还得要分析服务器可能返回的不同的结果类型），但每当看到 redis 那 150 多个客户端命令时便心生退缩，因为要给每个命令提供一个方便易用的 C++ 函数接口，则意味着非常巨大的开发工作量。
在后来的多次项目开发中被官方的 hiredis 库屡次摧残后，终于忍受不了，决定重新开发一套全新的 redis 客户端 API，该库不仅要实现这 150 多个客户端命令，同时需要提供方便灵活的连接池及连接池集群管理功能（幸运的是在 acl 库中已经具备了通用的网络连接池及连接池集群管理模块），另外，根据之前的实践，有可能提供的函数接口要远大于这 150 多个，原因是针对同一个命令可能会因为不同的参数类型场景提供多个函数接口（最终的结果是提供了3，4百个函数 API，7000+行源码，2000+行头文件）；在仔细研究了 redis 的通信协议后便着手开始进行设计开发了（redis 的协议设计还是非常简单实用的，即能支持二进制，同时又便于手工调试）。在开发过程中大量参考了 网站上的中文在线翻译版（非常感谢 黄键宏 同学的辛勤工作）。
二、acl redis 库分类
根据 redis 的数据结构类型，分成 12 个大类，每个大类提供不同的函数接口，这 12 个 C++ 类展示如下：
1、redis_key：redis 所有数据类型的统一键操作类；因为 redis 的数据结构类型都是基本的 KEY-VALUE 类型，其中 VALUE 分为不同的数据结构类型；
2、redis_connectioin：与 redis-server 连接相关的类；
3、redis_server：与 redis-server 服务管理相关的类；
4、redis_string：redis 中用来表示字符串的数据类型；
5、redis_hash：redis 中用来表示哈希表的数据类型；每一个数据对象由 “KEY-域值对集合” 组成，即一个 KEY 对应多个“域值对”，每个“域值对”由一个字段名与字段值组成；
6、redis_list：redis 中用来表示列表的数据类型；
7、redis_set：redis 中用来表示集合的数据类型；
8、redis_zset：redis 中用来表示有序集合的数据类型；
9、redis_pubsub：redis 中用来表示“发布-订阅”的数据类型；
10、redis_hyperloglog：redis 中用来表示 hyperloglog 基数估值算法的数据类型；
11、redis_script：redis 中用来与 lua 脚本进行转换交互的数据类型；
12、redis_transaction：redis 中用以事务方式执行多条 redis 命令的数据类型（注：该事务处理方式与数据库的事务有很大不同，redis 中的事务处理过程没有数据库中的事务回滚机制，仅能保证其中的多条命令都被执行或都不被执行）；
除了以上对应于官方 redis 命令的 12 个类别外，在 acl 库中还提供了另外几个类：
13、redis_command：以上 12 个类的基类；
14、redis_client：redis 客户端网络连接类；
15、redis_result：redis 命令结果类；
16、redis_pool：针对以上所有命令支持连接池方式；
17、redis_manager：针对以上所有命令允许与多个 redis-server 服务建立连接池集群（即与每个 redis-server 建立一个连接池）。
三、acl redis 使用举例
1）、下面是一个使用 acl 框架中 redis 客户端库的简单例子：
/** * @param conn {acl::redis_client&} redis 连接对象 * @return {bool} 操作过程是否成功 */bool test_redis_string(acl::redis_client& conn, const char* key){// 创建 redis string 类型的命令操作类对象，同时将连接类对象与操作类// 对象进行绑定acl::redis_string string_operation(&conn);const char* value = "test_value";// 添加 K-V 值至 redis-server 中if (string_operation.set(key, value) == false){const acl::redis_result* res = string_operation.get_result();printf("set key: %s error: %s\r\n",key, res ? res->get_error() : "unknown error");return false;}printf("set key: %s ok!\r\n", key);// 需要重置连接对象的状态，或直接调用 conn.reset() 也可string_operation.reset();// 从 redis-server 中取得对应 key 的值acl::string buf;if (string_operation.get(key, buf) == false){const acl::redis_result* res = string_operation.get_result();printf("get key: %s error: %s\r\n",key, res ? res->get_error() : "unknown error");return false;}printf("get key: %s ok, value: %s\r\n", key, buf.c_str());// 探测给定 key 是否存在于 redis-server 中，需要创建 redis 的 key// 类对象，同时将 redis 连接对象与之绑定acl::redis_key key_operation;conn.reset(); // 重置连接状态key_operation.set_client(conn); // 将连接对象与操作对象进行绑定if (key_operation.exists(key) == false){if (conn.eof()){printf("disconnected from redis-server\r\n");return false;}printf("key: %s not exists\r\n", key);}elseprintf("key: %s exists\r\n", key);// 删除指定 key 的字符串类对象conn.reset(); // 先重置连接对象状态if (key_operation.del(key, NULL) < 0){printf("del key: %s error\r\n", key);return false;}elseprintf("del key: %s ok\r\n", key);return true;}/** * @param redis_addr {const char*} redis-server 服务器地址， * 格式为：ip:port，如：127.0.0.1:6379 * @param conn_timeout {int} 连接 redis-server 的超时时间(秒) * @param rw_timeout {int} 与 redis-server 进行通信的 IO 超时时间(秒) */bool test_redis(const char* redis_addr, int conn_timeout, int rw_timeout){// 创建 redis 客户端网络连接类对象acl::redis_client conn(redis_addr, conn_timeout, rw_timeout);const char* key = "test_key";return test_redis_string(conn, key);}旅行，有一种苍凉，“浮云游子意，落日故人情”，
