文档章节

acl 框架库简介

郑树新
 郑树新
发布于 2013/12/28 21:40
字数 2087
阅读 463
收藏 6
点赞 1
评论 0

 一、概述

    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。

 

二、平台支持及编译

    整个工程目前支持 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。

 

三、本工程目录结构说明

    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


© 著作权归作者所有

共有 人打赏支持
郑树新

郑树新

粉丝 97
博文 87
码字总数 161171
作品 2
昌平
程序员
协作半驻留式服务器程序开发框架 --- 基于 Postfix 服务器框架改造

一、概述  现在大家在和Java, PHP, .net写应用程序时,都会用到一些成熟的服务框架,所以开发效率是比较高的。而在用C/C++写服务器程序时,用的就五花八门了,有些人用ACE, 有些人用ICE(号...

郑树新 ⋅ 2014/08/31 ⋅ 2

acl_cpp 1.1.1.2 发布,C++网络框架库

经过了长时间的测试与项目实践,aclcpp 1.1.1.2 版本终于发布了,aclcpp 基于 C 语言版本的 acl 框架库而写的C++库,具备如下特性: 1)同步/异步网络通信框架;同步流既支持网络通信,又支持...

郑树新 ⋅ 2012/08/19 ⋅ 3

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

acl 3.0.19 版本 (项目主页:https://sourceforge.net/projects/acl/,技术文章主页:http://zsxxsz.iteye.com/ ) 发布了,acl 是 one advanced C/C++ library 的简称,主要包括网络通信库以...

郑树新 ⋅ 2014/06/23 ⋅ 7

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

acl 3.0.12 版本 (项目主页:https://sourceforge.net/projects/acl/, 技术文章主页:http://zsxxsz.ietye.com/) 发布了,acl 是 one Advanced C/C++ library 的简称,主要包括网络通信库以及...

郑树新 ⋅ 2013/10/03 ⋅ 0

acl 跨平台网络通信与服务器框架 3.0.21 发布

acl 3.0.21 版本发布了,acl 是 oneadvanced C/C++ library 的简称,主要包括网络通信库以及服务器框架库等功能,支持Linux/Windows/Solaris/FreeBsd/MacOS 平台;整个 acl项目主要包含三个函...

郑树新 ⋅ 2014/10/31 ⋅ 6

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

acl 3.0.18 版本 (项目主页:https://sourceforge.net/projects/acl/,技术文章主页:http://zsxxsz.iteye.com/)) 发布了,acl 是 one advanced C/C++ library 的简称,主要包括网络通信库以...

郑树新 ⋅ 2014/04/07 ⋅ 2

acl -- 网络及服务器编程框架库 3.0.15 版本发布

acl 3.0.15 版本 (项目主页:https://sourceforge.net/projects/acl/,技术文章主页:http://zsxxsz.iteye.com/)) 发布了,acl 是 one Advanced C/C++ library 的简称,主要包括网络通信库以...

郑树新 ⋅ 2014/01/25 ⋅ 2

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

acl 3.0.13 版本 (项目主页:https://sourceforge.net/projects/acl/) 发布了,acl 是 one Advanced C/C++ library 的简称,主要包括网络通信库以及服务器框架库等功能,支持 Linux/Windows ...

郑树新 ⋅ 2013/11/04 ⋅ 6

acl 3.1.1 版本发布,跨平台网络通信与服务器框架

acl 3.1.1 版本发布了,acl 是 one advanced C/C++ library的简称,主要包括网络通信库以及服务器框架库等功能,支持 Linux/Windows/Solaris/FreeBsd/MacOS 平台;整个acl项目主要包含三个函...

郑树新 ⋅ 2015/03/30 ⋅ 0

acl redis C++ 库被 redis 官方收录

acl 库中的新增模块 redis C++ 客户端库被 redis 官方正式收录,参见 http://redis.io/clients 中的 C++ 部分,其中 “redis-client for C++” 库即为 acl redis C++ 客户端库。acl 中的 re...

郑树新 ⋅ 2015/03/09 ⋅ 10

没有更多内容

加载失败,请刷新页面

加载更多

下一页

OSChina 周日乱弹 —— 这么好的姑娘都不要了啊

Osc乱弹歌单(2018)请戳(这里) 【今日歌曲】 @TigaPile :分享曾惜的单曲《讲真的》 《讲真的》- 曾惜 手机党少年们想听歌,请使劲儿戳(这里) @首席搬砖工程师 :怎样约女孩子出来吃饭,...

小小编辑 ⋅ 24分钟前 ⋅ 1

Jenkins实践3 之脚本

#!/bin/sh# export PROJ_PATH=项目路径# export TOMCAT_PATH=tomcat路径killTomcat(){pid=`ps -ef | grep tomcat | grep java|awk '{print $2}'`echo "tom...

晨猫 ⋅ 今天 ⋅ 0

Spring Bean的生命周期

前言 Spring Bean 的生命周期在整个 Spring 中占有很重要的位置,掌握这些可以加深对 Spring 的理解。 首先看下生命周期图: 再谈生命周期之前有一点需要先明确: Spring 只帮我们管理单例模...

素雷 ⋅ 今天 ⋅ 0

zblog2.3版本的asp系统是否可以超越卢松松博客的流量[图]

最近访问zblog官网,发现zlbog-asp2.3版本已经进入测试阶段了,虽然正式版还没有发布,想必也不久了。那么作为aps纵横江湖十多年的今天,blog2.2版本应该已经成熟了,为什么还要发布这个2.3...

原创小博客 ⋅ 今天 ⋅ 0

聊聊spring cloud的HystrixCircuitBreakerConfiguration

序 本文主要研究一下spring cloud的HystrixCircuitBreakerConfiguration HystrixCircuitBreakerConfiguration spring-cloud-netflix-core-2.0.0.RELEASE-sources.jar!/org/springframework/......

go4it ⋅ 今天 ⋅ 0

二分查找

二分查找,也称折半查找、二分搜索,是一种在有序数组中查找某一特定元素的搜索算法。搜素过程从数组的中间元素开始,如果中间元素正好是要查找的元素,则搜素过程结束;如果某一特定元素大于...

人觉非常君 ⋅ 今天 ⋅ 0

VS中使用X64汇编

需要注意的是,在X86项目中,可以使用__asm{}来嵌入汇编代码,但是在X64项目中,再也不能使用__asm{}来编写嵌入式汇编程序了,必须使用专门的.asm汇编文件来编写相应的汇编代码,然后在其它地...

simpower ⋅ 今天 ⋅ 0

ThreadPoolExecutor

ThreadPoolExecutor public ThreadPoolExecutor(int corePoolSize, int maximumPoolSize, long keepAliveTime, ......

4rnold ⋅ 昨天 ⋅ 0

Java正无穷大、负无穷大以及NaN

问题来源:用Java代码写了一个计算公式,包含除法和对数和取反,在页面上出现了-infinity,不知道这是什么问题,网上找答案才明白意思是负的无穷大。 思考:为什么会出现这种情况呢?这是哪里...

young_chen ⋅ 昨天 ⋅ 0

前台对中文编码,后台解码

前台:encodeURI(sbzt) 后台:String param = URLDecoder.decode(sbzt,"UTF-8");

west_coast ⋅ 昨天 ⋅ 0

没有更多内容

加载失败,请刷新页面

加载更多

下一页

返回顶部
顶部