网络与服务器编程框架库 acl_3.0.12 发布

acl 3.0.12 版本发布了。

项目主页：https://sourceforge.net/projects/acl/
技术文章主页：http://zsxxsz.ietye.com/

acl 是 one Advanced C/C++ library 的简称，主要包括网络通信库以及服务器框架库等功能，支持 Linux/Windows 平台；整个 acl 项目主要包含三个函数库：

• lib_acl：纯C开发的最基础库，主要包含网络通信及服务器编程框架以及其它丰富的功能)
• lib_protocol：包含 HTTP/PING/SMTP 通信协议的C语言实现
• lib_acl_cpp：基于 lib_acl 及 lib_protocol 两个C库，提供了更为强大的编程接口及丰富的功能类

acl 包括以下丰富的常用函数库：

1. 常见网络应用库： SMTP 客户端库/PING 库/memcache 客户端库/handlersocket 客户端库/beanstalk 客户端库
2. HTTP 网络库：HTTP 客户端/服务端库，C++版 HttpServlet 类，HTTP COOKIE/HTTP SESSION 等
3. 邮件解析库：mime解析库/RFC2047/RFC2048/mime base64/mime qp/mime uucode 等
4. 网络通信库：阻塞/非阻塞网络 IO 库(其中 lib_acl_cpp 库通过嵌入 polarssl 而具备了 SSL 的能力)
5. 服务器框架：包括进程池模式、线程池模式、非阻塞模式、UDP通信模式及触发器模式
6. 事件引擎：支持 select、poll(for unix)、epoll（for linux)、kqueue（for bsd)、devpoll(for solaris)、iocp(for win32)、win32 窗口消息(for win32）事件引擎
7. 通用连接池库：高效的连接池基础类库，支持丰富的功能
8. 数据库客户端库：对原生的数据库客户端库进行了二次封装，使编程更为简易，功能更为丰富
9. xml/json 流式解析库：区别于网上其它已有的 xml/json 解析库，acl 中的 xml/json 解析库采用有限状态机方式解析数据，处理方式更为灵活

本次 acl 升级除了一些常见 bug 修复外，主要针对 ACL 的通信模块增加了 UDP 的通信能力，同时增加了 UDP 服务器通信模板。主要改进包括：

1. 基础库lib_acl改进

• feature：acl_single_server.c, acl_ioctl_server.c, acl_aio_server.c, acl_udp_server.c 增加了可以获得本地监听套接口流对象集合的函数
• feature：master 服务器框架增加了专门针对 UDP 的服务器模板 acl_udp_server.c/acl_udp_params.h
• feature：ACL_VSTREAM 支持 UDP 传输; acl_vstream_net.c 中增加了 acl_vstream_bind 函数用来绑定 UDP 传输模式
• feature：ACL_VSTREAM 增加了 acl_vstream_set_local_addr, acl_vstream_set_peer_addr
• feature：ACL_VSTREAM 中添加了 struct sockaddr_in 类型的两个指针，以便于 ACL_VSTREAM 很容易支持 UDP 传输
• feature：ACL_VSTREAM 对象增加了 acl_vstream_set_local, acl_vstream_set_remote, acl_vstream_set_path 三个函数
• performance：ACL_VSTREAM 中将 remote_addr, local_addr 定义为指针，从而大大减少了 ACL_VSTREAM 对象创建时的尺寸大小
• compile：增加了工程文件 Makefile.db，使用该工程文件编译，则可以使用 mysql 数据库功能，使用 Makefile 工程文件编译，则可以 lib_acl.a 更为干净 (即不依赖于任何第三方库)
• bugfix：events_select.c/events_select_thr.c 当套接字监听集合为空时休眠的时间单位为秒，需要将微秒级的 delay 转为秒级
• other：events 模块 ACL_EVENT_NOTIFY_RDWR/ACL_EVENT_NOTIFY_TIME 函数接口类型重新定义，在回调函数中增加了 ACL_EVENT，ACL_VSTREAM 参数，从而方便用户直接使用；因为这两个接口的重新定义，导致了很多功能模块做相应修改，主要影响的模块有：event, master, aio, ioctl
• other：将 master 模块下的源文件代码排版整理了一下
• other：acl_vstream.c：acl_vstream_set_remote 重命名为 acl_vstream_set_peer

2. 应用协议库lib_protocol改进

• bugfix：http_chat_async.c 中 http_res_body_get_async/http_req_body_get_async 两个函数没有对 ctx->read_cnt 置 0
• other：lib_acl 库中 ACL_EVENT_NOTIFY_RDWR/ACL_EVENT_NOTIFY_TIME 函数接口定义的修改，与之相关的模块(icmp)进行了修改
• other：因为 lib_acl 基础库中的 ACL_VSTREAM 读写回调函数接口变更，调整了与之相关的部分内部接口，主要影响到了 icmp 模块中 icmp_stream.c 中的内部接口

3. 功能丰富的C++库lib_acl_cpp改进

• feature：aio_stream 增加了 get_peer/get_local 用来获得网络连接流的本地及远程地址
• feature：master_udp 服务器模板增加了可在 proc_on_init() 虚函数中获得本地绑定套接字流对象集合的函数功能：get_sstreams()
• feature：master 服务器框架增加了 master_udp 服务模板类
• feature：connect_manager 类增加了根据键值字符串的哈希值获取连接池对象的虚函数，从而有利于在分布式环境里使用连接池
• feature：connect_manager/connect_pool 类增加了针对每个连接池有一个其位于连接池集合中的下标索引
• feature：http_request::request 中原来只能指定 GET/POST 两种请求方法，现在可以指定多种请求方法
• feature：http_header 允许设置自定义 (即除 GET/POST/PUT/CONNECT/PURGE之个) 的请求头命令字
• feature：memcache 类支持流式读写数据，从而可以支持大 value 的存取方式
• feature：master_threads 类在单独运行方式的使用场景接近于在 acl_master 框架下的运行场景
• feature：master_threads/master_aio/master_proc 类支持在单独运行模式下监听多个地址
• feature：acl_cpp_init.cpp 中添加了 WIN32 下关闭 DOS 窗口的函数
• feature：http/memcache 模块增加了连接池管理类
• compile：acl_cpp_init.cpp 中 freopen 返回的文件句柄因为未被使用而使编译器报警
• compile：增加了 Makefile.db 工程文件，使用该文件编译则需要 mysql/sqlite 库; 如果不需要数据库相关的功能，则使用 Makefile 工程文件进行编译
• bugfix：memcache 类中当连接异常中断重试时会因请求数据被清掉而出错，原因是请求与响应共用同一个缓冲区所致，现将请求缓冲区与响应缓冲区分开
• bugfix：memcache.cpp 当调用 open 函数连接 memcached 服务器失败时，用 valgrind 检查出记录错误日志时引用了一个未经初始化的变量
• samples：增加了针对 UDP 的测试用例 udp_client
• other：lib_acl 库中 ACL_EVENT_NOTIFY_RDWR/ACL_EVENT_NOTIFY_TIME 函数接口定义的修改，与之相关的模块进行了修改
• other：因为 lib_acl 基础库中的 ACL_VSTREAM 读写回调函数接口变更，调整了与之相关的部分内部接口，主要影响到了 ssl_stream/ssl_aio_stream
• other：connpool/http_request_pool/memcache_pool：调整了构造函数，去掉了最后一个参数