acl 库
acl 库的功能参见文章 acl介绍 及 https://github.com/zhengshuxin/acl,本文主要讲述如何编译和使用 acl 库。
acl 下其实有四个库:lib_acl (基础库)、lib_protocol(http 和 icmp 协议库)、lib_acl_cpp(封装了 lib_acl 和 lib_protocol 两个 C 库的 C++ 版本实现,更是增加了丰富的功能)、lib_dict(封装了 bdb, cdb, Tokyo Cabinet 库的用于字典查询的库)以及 lib_tls(封装了openssl部分功能的库,主要用于 lib_acl 的 ssl 加密传输)。其中,笔者用的最多还是 lib_acl 、lib_protocol 以及 lib_acl_cpp(目前用得最多的库)三个库,所以本文主要介绍这三个库的编译与使用。
开始时 acl 库是支持 Linux、Solaris、FreeBSD 和 Windows 平台的,其它几个平台欢迎读者进行移植。
一、Linux/UNIX 平台上编译(需要使用 gcc/g++编译器及 gnu make 命令)
1、编译 lib_acl.a 库(使用 gcc 编译器)
进入 lib_acl 目录,直接运行 make,正常情况下便可在 lib 目录下生成 lib_acl.a 静态库,用户在使用 lib_acl.a 编写自己的程序时,需要在自己的 Makefile 文件中添加如下选项:
1.1、编译选项:-I 指定 lib_acl.a 头文件所在目录(头文件在 lib_acl/include 目录下),-DLINUX2 指定 Linux 平台
1.2、链接选项:-L 指定 lib_acl.a 所在目录,-l_acl 指定需要链接 lib_acl.a 库
1.3、用户需要在自己的源程序中包含 lib_acl 的头文件,如下:
#include "lib_acl.h"
2、编译 lib_protocol.a 库(使用 gcc 编译器)
进入 lib_protocol 目录,直接运行 make,正常情况下便可以在 lib 目录下生成 lib_protocol.a 静态库,用户在使用 lib_protocol.a 编写自己的程序时,需要在自己的 Makefile 文件中添加如下选项:
2.1、编译选项:-I 指定 lib_protocol.a 头文件目录(在 lib_protocol/include 目录下),-DLINUX2 指定 Linux 平台
2.2、链接选项:-L 指定 lib_protocol.a 所在目录,-L 指定 lib_acl.a 所在目录,-l_protocol -l_acl
2.3、用户需要在自己的应用程序中包含 lib_protocol 头文件,如下:
#include "lib_protocol.h"
3、编译 lib_acl_cpp.a 库(使用 g++ 编译器)
进入 lib_acl_cpp 目录,运行 make static 编译 lib_acl_cpp.a 静态库,便可 lib 目录下生成 lib_acl_cpp.a,用户在使用 lib_acl_cpp.a 编写程序时,需要在自己的 Makefile 文件中添加如下选项:
3.1、编译选项:-I 指定 lib_acl_cpp.a 头文件目录(在 lib_acl_cpp/include 目录下),-DLINUX2 指定 Linux 平台
3.2、链接选项:-L 指定 lib_acl_cpp.a 所在目录,-L 指定 lib_protocol.a 所在目录,-L 指定 lib_acl.a 目录,
如:-L./lib_acl_cpp/lib -l_acl_cpp -L./lib_protocol/lib -l_protocol -L./lib_acl/lib -l_acl,一定要注意这三个库的依赖关系:lib_protocol.a 依赖于 lib_acl.a,lib_acl_cpp.a 依赖于 lib_protocol.a 及 lib_acl.a,在使用 g++ 进行编译时必须保证库的依赖顺序,被依赖的库总是应放在后面,否则在链接程序时会报函数不存在。
3.3、用户需要在自己的应用中包含 lib_acl.hpp 头文件,如下:
#include "acl_cpp/lib_acl.hpp"
如果程序仅用到了 lib_acl_cpp.a 库中类及函数,则只需要包含 lib_acl_cpp.a 的头文件即可,至于该库所依赖的 lib_protocol.a 及 lib_acl.c 库的头文件已经做了特殊隐含处理,不必显式包含。
二、Windows 平台
2.1 编译(vc2003/vc2008/vc2010/vc2012)
在 acl 项目的根目录下,多个 VC 的工程文件,用户可根据自身需要打开工程文件:acl_cpp_vc2003.sln,acl_cpp_vc2008.sln,acl_cpp_vc2010.sln,acl_cpp_vc2012.sln(最早也支持VC6)。用户可以选择编译 lib_acl、lib_protocol、lib_acl_cpp 的静态库调试版、静态库发布版、动态库调试版以及动态库发布版,编译完成后,会在 acl\dist\lib\win32 目录生成的静态库有:
lib_acl_vc20xxd.lib、lib_acl_vc20xx.lib、lib_protocol_vc20xxd.lib 和 lib_protocol_vc20xx.lib;
生成的与动态库相关的文件有:lib_acl_d.dll/lib_acl_d.lib,lib_acl.dll/lib_acl.lib,lib_protocol_d.dll/lib_protocol_d.lib,lib_protocol.dll/lib_protocol.lib,lib_acl_cpp_d.dll/lib_acl_cpp_d.lib,lib_acl_cpp.dll/lib_acl_cpp.lib。
2.2 使用
a)在 win32 平台下使用 lib_acl 和 lib_protocol 静态库时,只需要在包含目录中添加 lib_acl/include、lib_protocol/include 以及 lib_acl_cpp/include 所在的路径,在链接时指定静态库路径及静态库名称。
b)在 win32 平台下使用 lib_acl 的动态库时,不仅要做与 a) 中所指定的操作,而且需要在预处理器定义中添加:ACL_DLL;在使用 lib_protocol 的动态库,需要在预处理器定义中添加:HTTP_DLL 和 ICMP_DLL;在使用 lib_acl_cpp 的动态库时,需要在预处理器定义中添加:ACL_CPP_DLL。
三、 注意事项
因为 lib_acl 是最基础的库,而 lib_protocol 依赖于 lib_acl,lib_acl_cpp 依赖于 lib_protocol 和 lib_acl,所在生成动态库时,需要注意生成顺序,编译顺序为:lib_acl,lib_protocol,lib_acl_cpp。
原文件地址:http://zsxxsz.iteye.com/blog/1535688
一、概述
acl 工程是一个跨平台的通用网络通信库及服务器编程框架,同时提供更多的其它有价值功能。通过该库,用户可以非常容易地编写支持多种模式的服务器程序、WEB 应用程序以及数据库应用程序。此外,该库还提供了 XML/JSON/MIME 编码及解码功能,这些编码解码库均支持流式解析模式,从而使之更适应不同的网络通讯方式。
本工程主要包含 5 个库及大量示例。5 个库的说明如下:
1) lib_acl: 该库是最基础的库,其它 4 个库均依赖于该库; 该库以 C 语言实现。
2) lib_protocol: 该库主要实现了 http/ping/smtp 协议; 该库以 C 语言实现。
3) lib_acl_cpp: 该库用 C++ 语言封装了 lib_acl/lib_protocol 两个库,同时增加了一些其它有价值的功能应用。
4) lib_fiber: 该库为高性能的网络协程库,支持大并发、高性能。
5) lib_dict: 该库主要实现了 KEY-VALUE 的字典式存储库,该库另外还依赖于 BDB, CDB 以及 tokyocabinet 库。
6) lib_tls: 该库封装了 openssl 库,使 lib_acl 的通信模式可以支持 ssl。
二、平台支持及编译
整个工程目前支持 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。
三、本工程目录结构说明
1) lib_acl/src
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/src
2.1 http:HTTP 协议相关的库,支持 HTTP/1.1,通讯方式支持同步/异步方式
2.2 icmp:icmp/ping 协议库,支持同步/异步通信方式
2.3 smtp:支持 SMTP 客户端通信库
3) lib_acl_cpp/src
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) lib_fiber
4,1) c: 该目录主要是支持 C 语言的网络协程库
4.2) cpp: 该目录使用 C++ 对 C 协程库进行了封装
4.3) samples: 该目录有大量的使用协程的例子
4.4) 有关协程的更多内容,参考:http://zsxxsz.iteye.com/category/360229
5) lib_acl/samples:该目录下的程序主要是基于 lib_acl 及 lib_protocol 库的示例
6) lib_acl_cpp/samples:该目录下的程序主要是基于 lib_acl_cpp 库的示例
微博:http://weibo.com/zsxxsz/