网络与服务器编程框架库 acl 3.0.14 发布

acl 3.0.14 版本发布了。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库，提供了更为强大的编程接口及丰富的功能类

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

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 中的网络服务器框架及网络通信库的性能，此外，修复了一些在 solaris(x86) 上的一些不兼容性问题。主要改进包括： 

一、基础 C 库：lib_acl 

• 新特性：acl_json.c 增加了 acl_json_node_duplicate 用于复制一个 JSON 结点对象到一个新的 JSON 结点中；增加了 acl_json_create 用于根据一个 JSON 结点创建一个完全的 JSON 对象
• 新特性：acl_json_util.c 增加了 acl_json_node_build 用于根据一个 JSON 结点生成 JSON 字符串
• 性能优化：acl_vstream.c，__sys_read 函数中当流的 sys_read_ready 为 1 时，则不会调用系统 API select 判断超时过程，从而减少一次系统调用，因为 sys_read_ready 标志位会在事件模块(event_xxx) 中被设置
• 性能优化：acl_aio_server.c, acl_ioctl_server.c 服务器模块参加了控制参数：master_status_notify，当启动多个子进程时，该参数决定是否向acl_master 主进程汇报子进程的状态，当 master_prefork 预启动参数打开且该值 > 1 时，将 master_status_notify 设置为 0，则子进程不再向 acl_master 主进程汇报状态，有助于减少 acl_master 主进程的负载
• 性能优化：acl_vstream.c, 在 acl_vstream_readn 中，为减少 read 次数，当输入缓冲区较小时，则自动启用双缓冲读方式
• 问题修复：acl_json_parse.c，json_val() 函数中没有针对转义内容做特殊处理
• 问题修复：acl_vstream.c，在 acl_vstream_ctl 函数中，当控制参数为 ACL_VSTREAM_CTL_PATH 时，对 stream->addr_peer 的赋值有问题（此 bug 由高版本的 gcc4.8.2 检测出）
• 编译：Makefile 支持 solaris 编译
• 其它：去掉了 event 目录下的 events_kernel2.c 及 events_kernel3.c
• 其它：acl_msg.c，在函数 acl_last_serror() 中分配的线程局部变量在主线程中无法被正常释放，会导致 valgrind 报错

二、网络应用协议库：lib_protocol 

• 问题修复：http_chat_sync.c，在函数 http_res_body_get_sync 中，当为 chunked 传输方式时，需要设置 ctx->chunk.chunk_oper = CHUNK_OPER_HEAD
• 编译：Makefile 支持 solaris 编译
• 其它：http_hdr_res.c/http_hdr_req.c，内部的线程局部变量无法在主线程中释放，会导致 valgrind 报警告

三、功能丰富的C++库：lib_acl_cpp 

• 新特性：新增加 event 模块，将 master_timer 定时器类改名为 event_timer 类放于 event 模块中
• 新特性：在基类 master_base 中添加了方法 proc_set_timer 用于添加进程级别的定时器，(同时移除了 master_threads 子类中的 proc_set_timer 方法)，这样 master_base 的所有子类 (master_threads, master_aio, master_proc, master_udp, master_trigger) 都可以添加进程级别的定时器
• 新特性：master 模块增加了定时器类 master_timer
• 新特性：json 类增加了以下功能函数：                    a) 构造函数 json(const json_node&)，可以根据一个 json 对象的某一个 json 结点创建一个新的 json 对象 
                      b) duplicate_node 根据一个 json 对象的某个 json 结点复制一个新的 json 结点 
                      c) to_string 新的将 json 对象转换为字符串的函数
• 新特性：json_node 类增加了以下功能函数：                    a) to_string 根据 json 结点生成 json 字符串的函数 
                      b) set_tag 用来替换标签名 
                      c) set_text 当 json 结点为叶结点时用来替换标签值
• 新特性：http_header 类丰富了 set_url 及请求构造函数的参数类型，允许 URL 参数中含有请求参数，且内部会自动解析 url 中的主机名及参数
• 新特性：http_header 类添加了请求参数添加方法：add_int 及 add_format
• 新特性：http_header add_param 允许参数值为空指针或空串
• 新特性：http_header::set_host 仅是将主机字符串添加至成员变量 host_ 中
• 新特性：http_header::set_url 中允许添加类似于 http://www.test.com 的 url(即末尾可以没有 '/')
• 新特性：http_client 类增加了 chunked 传输方式；
• 新特性：http_request 类增加流式写函数：write_head/write_body；
• 新特性：http_response 类增加了流式写数据方式
• 新特性：HttpServletRequest 类增加了几个获取 HTTP 请求头参数的方法
• 新特性：http_utils::get_addr 的 url 参数既可以是 HTTP 也可以是 HTTPS
• 新特性：master_threads 模板支持新的定时器
• 问题修复：connect_pool::put 在归还连接给连接池时，为了让过期连接尽快回收，需要调用 push_front，原来调用了 push_back
• 问题修复：http_header.cpp，http_header::date_format 在 WIN32 编译出错
• 问题修复：json.cpp, json::getElementsByTags() 内部未对空指针做判断
• 问题修复：http_header.cpp, http_header::date_format 在 UNIX 平台下 gmtime 是线程不安全的，所以需要使用 gmtime_r
• 问题修复：http_download.cpp 的构造函数中调用 ACL_SAFE_STRNCPY 时第三个参数给出错误的尺寸大小（此 bug 由高版本的 gcc4.8.2 检测出）
• 问题修复：Makefile 支持 solaris(x86) 编译
• 新增示例：samples/json2, 用于测试级联提取数据的例子
• 新增示例：samples/ 目录下新增加了 json 测试用例 json3/json4
• 示例：samples/master_udp_threads：该例子中的线程局部变量的静态用法 __thread 无法支持 solaris，改为动态方式使用线程局部变量方式
• 注释：修正 connect_manager::init 原来错误的参数格式描述
• 注释：消除了几个头文件中由 doxygen 检测出的错误注释
• 其它：stream 模块的异步流部分，将 aio_timer_callback 等类声明从 aio_handle 类中移除成为独立的类
• 其它：调整类 http_client 中的两个函数 get_respond_head  和 get_request_head 的返回值限制，去掉 const 限定词

技术博客：http://zsxxsz.iteye.com/ 
下载地址：http://sourceforge.net/projects/acl/ 
svn：svn checkout svn://svn.code.sf.net/p/acl/code/trunk acl-code 
Github地址：https://github.com/zhengshuxin/acl