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

acl 3.0.13 版本 (项目主页：https://sourceforge.net/projects/acl/，技术文章主页：http://zsxxsz.iteye.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 升级除了一些常见 bug 修复外，主要针对 ACL 的C++(lib_acl_cpp)模块增加了 线程及线程池类库。

 

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 解析库采用有限状态机方式解析数据，处理方式更为灵活

 

一、基础库：lib_acl

. acl_debug.c: 调整了参数的表示方法，调整后的调试标签及级别字符串的格式: 1:1, 2:10, 3:8...  or 1:1; 2:10; 3:8...

. feature: acl_master 服务器模板添加了 master_debug 配置项，方便用户在使用 acl 的服务器框架时调试日志

. feature: acl_aio_app_main.c/acl_ioctl_app_main.c, 增加了配置项 master_deny_banner 允许用户自定义拒绝连接的内容信息

. feature: acl_pthread_pool.c 增加了 acl_pthread_pool_qlen 函数，提供当前线程池队列中未被处理的任务数量

. performance: acl_vstream.c，将 __vstream_sys_read 的读过程进行了优化，改名为 __sys_read，以允许将用户输入的缓冲区做为系统 read 的内存地址，从而在调用 

acl_vstream_readn/acl_vstream_read 时避免了数据的二次拷贝

. compile: acl_aio_app_main.c, 其中在调用 write 时，需要判断返回值，否则会在高版本 gcc 上报警告

. bugfix: acl_mylog.c, 当通过 UDP 方式记录日志时，因为之前 acl_vstream.c 允许注册外部接口的改变而发生了不兼容性问题

. bugfix: acl_xml_util.c, acl_xml_tag_add() 在调用 acl_token_tree_add 时，第三个参数应该调用 ACL_TOKEN_F_STOP，原来是 ACL_TOKEN_F_PASS

 

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

. feature: 增加了线程类(stdlib/thread)及线程池类(stdlib/thread_pool)

. feature: thread 类分离出一个基类 thread_job，从而使逻辑更为清晰

. feature: 当使用 GCC 进行编译时，针对所有具有变参的函数接口定义添加了属性限定---__attribute__((format(printf, n, m)))，这样便于在编译期就能发现因参数使用不当而导致的错误

. feature: HttpServletResponse 类支持 Transfer-Encoding: chunked 传输方式

. feature: connect_manager/connect_pool 允许动态添加、删除连接池对象

. bugfix: master_udp.cpp，当以 alone 方式运行时，没有将 socket_stream 赋给 ACL_VSTREAM::context，导致在 service_main 时又重新打开一次

. bugfix: thread.cpp，当线程为分离方式创建时 thread::thread_run 在调用完虚函数 run 后不得再引用线程对象的 return_arg_，否则会造成内存非法访问

. bugfix: db/db_mysql.cpp, 在打开 mysql 连接时设置字符集，判断是否设置成功的方法有误

. bugfix: master_udp.cpp, master_udp::service_main() 中的 socket_stream 是临时堆栈变量，如果被用户外部引用则可能造成内存非法访问

. samples: 增加了 master_udp_threads，该例子将线程池与 master_udp 模板结合

. samples: 增加了测试用例 thread_client，一个多线程网络客户端程序

. samples: 增加了测试用例 thread 用以测试线程类

. samples: 增加了测试用例 thread_pool 用以测试线程池类

. samples: 添加了 master_aio_proxy 用作纯 TCP 非阻塞代理

 

 github 地址：https://github.com/acl-dev/acl