acl 框架库简介

 1、概述

    acl 工程是一个跨平台的通用网络通讯库，同时提供更多的其它有价值功能。经过该库，用户能够很是容易地编写支持多种模式的服务器程序、WEB 应用程序以及数据库应用程序。此外，该库还提供了 XML/JSON/MIME 编码及解码功能，这些编码解码库均支持流式解析模式，从而使之更适应不一样的网络通信方式。

    本工程主要包含 5 个库及大量示例。5 个库的说明以下：

    1) lib_acl: 该库是最基础的库，其它 4 个库均依赖于该库; 该库以 C 语言实现。

    2) lib_protocol: 该库主要实现了 http 协议及 icmp/ping 协议; 该库以 C 语言实现。

    3) lib_acl_cpp: 该库用 C++ 语言封装了 lib_acl/lib_protocol 两个库，同时增长了一些其它有价值的功能应用。

    4) lib_dict: 该库主要实现了 KEY-VALUE 的字典式存储库，该库另外还依赖于 BDB, CDB 以及 tokyocabinet 库。

    5) lib_tls: 该库封装了 openssl 库，使 lib_acl 的通讯模式能够支持 ssl。

 

2、平台支持及编译

    整个工程目前支持 Linux(AS4,5,6, CS4,5,6), Windows, MacOS, (本来也支持 FreeBSD, Solaris, 如今若是谁有这些环境，能够轻松移植到这些平台上）。

    1) Linux/MacOS: 直接在终端命令行方式下分别进入 lib_acl/lib_protocol/lib_acl_cpp/lib_dict/lib_tls 目录下，运行 make 命令便可。

    2) Windows: 能够用 VC2003/VC2010/vc2012 进行编译。(若是您须要用 VC6/VC2005/VC2008 编译，能够参考 VC2003 的编译条件)。

    当在 WIN32 环境下使用动态库时有几点须要注意：

    a) 使用 lib_acl 的动态库时，须要在用户的工程预约义: ACL_DLL;

    b) 使用 lib_protocol 动态库中的 HTTP 库或 ICMP 库时，须要在工程中预约义 HTTP_DLL 、SMTP_DLL或 ICMP_DLL;

    c) 使用 lib_acl_cpp 的动态库时，须要在工程中预约义 ACL_CPP_DLL，若是您使用用 VC2003 编译环境则还须要预约义 VC2003;

    d) 使用 lib_dict 的动态库时，须要在工程中预约义 DICT_DLL;

    e) 使用 lib_tls 的动态库时，须要在工程中预约义 TLS_DLL。

 

3、本工程目录结构说明

    1) lib_acl

    1.1 init：主要用于初始化 acl 基础库

    1.2 stdlib：是一些比较基础的功能函数库，在 stdlib/ 根目录下主要包括一些有关日志记录、网络/文件流处理、VSTRING缓冲操做等功能函数；在 stdlib/ 下还有二级目录，以下：

    1.2.1 common：该目录主要为一些经常使用的数据结构及算法的功能函数库，象哈希表、链表、队列、动态数组、堆栈、缓存、平衡二叉树、模式匹配树等；

    1.2.2 memory：该目录主要包含与内存操做相关的函数库，象内存基础分配与校验、内存池管理、内存切片管理等；

    1.2.3 filedir：该目录主要包含与目录遍历、目录建立等相关的库；

    1.2.4 configure：该目录主要包含配置文件的分析库；

    1.2.5 iostuff：该目录主要包含一些经常使用的IO操做的函数库，象读/写超时、设置IO句柄的阻塞模式等；

    1.2.6 string：该目录主要包含一些经常使用的字符串操做的库，提供了比标准C更灵活高效的字符串操做功能；

    1.2.7 debug：主要用于协助调试内存的泄露等功能；

    1.2.8 sys：主要是与不一样操做系统平台相关的API的封装函数库；

    1.3 net：是与网络操做相关的函数库，包含网络监听、网络链接、DNS查询、套接口参数设置等功能；

    1.3.1 connect：主要是与网络链接相关的函数库，包含网络链接、域套接口链接等；

    1.3.2 listen：主要是与网络监听相关的函数库，包含网络监听、域套接口监听等；

    1.3.3 dns：主要是与DNS域名查询相关的函数库，包含对 gethostbyname 等接口的封装、按RFC1035标准直接发送UDP包方式进行查询等功能；

    1.4 event：主要封装了 select/poll/epoll/iocp/win message/kqueue/devpoll 等系统API接口，使处理网络事件更加灵活、高效、简单，另外还包含定时器接口，acl 中的不少网络应用都会用到这些接口，象 aio、master 等模块；

    1.5 aio：主要包含网络异步操做的功能函数，该套函数库在处理高并发时有很是高的效率，并且提供了比基础API更为高级的调用方式，比使用象 libevent 之类的函数库更为简单，并且是线程安全的；

    1.6 msg：主要包含了基于线程的消息事件及基于网络的消息事件功能；

    1.7 thread：主要是封装了各个OS平台下的基础线程API，使对外接口保持一致性，消除了平台的差别性，同时还提供了半驻留线程池的函数库，以及对于线程局部变量的扩展；

    1.8 db：主要是一些与数据库有关的功能库，定义了一个通用的数据库链接池的框架（而且实现了mysql的链接池实例）；一个简单的内存数据库（由哈希表、链表、平衡二叉树组合而成）；ZDB数据存储引擎，这是一个高效的基于数字键的存储引擎；

    1.9 proctl：win32 平台下父子进程控制功能库；

    1.10 code：常见编码函数库，包括 base64编解码、URL编解码以及一些汉字字符集编码等；

    1.11 unit_test：包含有关进行 C 语言单元测试的功能库；

    1.12 xml ：是一个流式的 xml 解析器及构造器，能够支持阻塞及阻塞式网络通讯；

    1.13 json ：是一个流式的 json 解析器及构造器，能够支持阻塞及阻塞式网络通讯；

    1.14 master：是在 UNIX 环境下支持多种服务器模式的服务器框架，目前主要支持多进程模式、多进程多线程模式、多进程非阻塞模式、UDP通讯模式以及多进程触发器模式；

 

    2) lib_protocol

    2.1 http：HTTP 协议相关的库，支持 HTTP/1.1，通信方式支持同步/异步方式

    2.2 icmp：icmp/ping 协议库，支持同步/异步通讯方式

    2.3 smtp：支持 SMTP 客户端通讯库

 

    3) lib_acl_cpp

    3.1 stdlib：主要包含字符串处理类(string)，xml/json 解析库，zlib 压缩库(依赖于 zlib 库), 日志记录类, 字符集转码(在UNIX环境下须要 iconv 库), 线程类/线程池类, 互斥类(支持线程锁、文件锁);

    3.2 mime：支持完整的与邮件编码相关的库(邮件的 rfc2045-rfc2047/rfc822/base64/uucode 编码及解码库)；

    3.3 master：封装了 C 版 lib_acl 库中的服务器框架，支持进程池模式、线程池模式、非阻塞模式、UDP 通讯模式以及触发器模式；

    3.4 stream：支持网络流/文件流，支持阻塞/非阻塞两种通讯方式，在非阻塞模式下支持 select/poll/epoll/iocp/win32 message/kqueue/devpoll；支持 ssl 加密传输(阻塞及非阻塞方式，须要 polarssl库);

    3.5 ipc：在非阻塞通讯方式，提供了阻塞模块与非阻塞模块整合的方式;

    3.6 http：比较完整的 HTTP 通讯库及协议解析库，支持客户端及服务端模式，支持 ssl/gzip 传输方式; 支持相似于 Java HttpServlet 方式的大部分接口，方便编写 CGI 及服务器程序；

    3.7 db：封装了 MYSQL/SQLITE 库，支持数据库链接池；

    3.8 hsocket：实现了完整的 handler-socket 客户端通讯库；

    3.9 beanstalk：支持消息队列服务器 beanstalkd 的客户端通讯库；

    3.10 connpool：通用的 TCP 链接池框架；

    3.11 memcache：支持 memcached 通讯协议的客户端库（支持链接池）；

    3.12 queue：磁盘文件队列管理器；

    3.13 session：会话管理器，目前支持使用 memcache 客户端库存储会话数据。

 

    4) samples：该目录下的程序主要是基于 lib_acl 及 lib_protocol 库的示例

    5) lib_acl_cpp/samples：该目录下的程序主要是基于 lib_acl_cpp 库的示例

 

下载：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

QQ 群：242722074