1、概述mysql
acl 工程是一個跨平臺的通用網絡通訊庫及服務器編程框架，同時提供更多的其它有價值功能。經過該庫，用戶能夠很是容易地編寫支持多種模式的服務器程序、WEB 應用程序以及數據庫應用程序。此外，該庫還提供了 XML/JSON/MIME 編碼及解碼功能，這些編碼解碼庫均支持流式解析模式，從而使之更適應不一樣的網絡通信方式。ios
本工程主要包含 5 個庫及大量示例。5 個庫的說明以下：git
1) lib_acl: 該庫是最基礎的庫，其它 4 個庫均依賴於該庫; 該庫以 C 語言實現。github
2) lib_protocol: 該庫主要實現了 http/ping/smtp 協議; 該庫以 C 語言實現。算法
3) lib_acl_cpp: 該庫用 C++ 語言封裝了 lib_acl/lib_protocol 兩個庫，同時增長了一些其它有價值的功能應用。sql
4) lib_dict: 該庫主要實現了 KEY-VALUE 的字典式存儲庫，該庫另外還依賴於 BDB, CDB 以及 tokyocabinet 庫。數據庫
5) lib_tls: 該庫封裝了 openssl 庫，使 lib_acl 的通訊模式能夠支持 ssl。編程
2、平臺支持及編譯json
整個工程目前支持 Linux(AS4/5/6, CS4/5/6), Windows, MacOS, FreeBSD, Solaris X86。數組
1) Linux/Unix: 直接在終端命令行方式下分別進入 lib_acl/lib_protocol/lib_acl_cpp/lib_dict/lib_tls 目錄下，運行 make 命令便可。
2) Windows: 能夠用 VC2003/VC2008/VC2010/vc2012 進行編譯。(若是您須要用 VC6/VC2002/VC2005 編譯，能夠參考 VC2003 的編譯條件)。
當在 WIN32 環境下使用動態庫時有幾點須要注意：
a) 使用 lib_acl 的動態庫時，須要在用戶的工程預約義: ACL_DLL;
b) 使用 lib_protocol 動態庫中的 HTTP 庫，SMTP庫或 ICMP 庫時，須要在工程中預約義 HTTP_DLL 、SMTP_DLL或 ICMP_DLL;
c) 使用 lib_acl_cpp 的動態庫時，須要在工程中預約義 ACL_CPP_DLL;
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/win32 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 環境下支持多種服務器模式的服務器框架(基於 POSTFIX 的服務器框架改造)，目前主要支持多進程模式、多進程多線程模式、多進程非阻塞模式、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 庫的示例