在以前有关使用 acl 的技术文章（如：使用 acl::master_threads 类编写多进程多线程服务器程序 ，用 acl::master_aio 类编写高并发非阻塞服务器程序，使用 acl::master_proc 类编写多进程服务器程序）中，对如何使用 acl 服务器框架类编写服务器应用程序做了较为详细的描述，但手工输入这些代码毕竟是比较烦人的，在 acl 的 app/ 目录下有一个向导程序：wizard，可以帮助开发者快速生成服务器框架模板，开发者只需在相关位置添加业务逻辑代码即可。下面是使用 wizard 向导程序的简要过程：

      首先在 acl 的根目录下编译所有的 acl 的基础库：make all，然后进入 app/wizard 目录生成 wizard 程序：make，运行 ./wizard，出现如下界面：

[zsx@localhost wizard]$ ./wizard select one below:m: master_service; d: db; h: http; q: exit# 上面过程提示用户生成哪种应用的程序，我们此处是编写服务器，所以选择：m>m# 接着 wizard 提示我们输入应用程序名称，此处可以写：echo_serverplease input your program name: echo_server# 然后 wizard 提示选择何种服务器框架模板，此处选择 t 表示使用多进程多线程服务器模板# 各个参数类型说明如下：# t：多进程多线程服务器模板# p：多进程服务器模板# a：多进程非阻塞服务器模板# g：触发器服务器模板choose master_service type:t: for master_threads; p: for master_proc; a: for master_aio; g: for master_trigger; s: skip choose>tcreate echo_server/Makefile ok.create echo_server/echo_server.sln ok.create echo_server/echo_server.vcproj ok.create echo_server/Makefile.in okcreate echo_server/stdafx.h okcreate echo_server/stdafx.cpp okcreate common_files ok!create echo_server/echo_server.cf ok.create echo_server/Makefile.in okcreate echo_server/main.cpp okcreate echo_server/master_service.h okcreate echo_server/master_service.cpp okcreate master_threads ok!------------------------------------------------------------------------------select one below:m: master_service; d: db; h: http; q: exit>qBye!

      OK，输入几个字母，按几下回车，一个相对完整的服务器程序便生成了。从上面的生成过程不难看出 wizard 向导程序不仅生成了源文件，而且生成了工程文件以及服务器配置文件。

      进入 echo_server 目录，打开自动生成的 master_service.cpp 文件，修改 master_service::thread_on_read 函数内容如下：

bool master_service::thread_on_read(acl::socket_stream* conn){        acl::string buf;                // 从客户端连接流中读取一行数据，读操作参见：acl_cpp/stream/istream.hpp        if (client->gets(buf, false) == false)        {                printf("gets from client error, closed it!\r\n");                // 返回 false 通知服务器框架将该客户端连接关闭                return false;        }                // 将从客户端连接流中读到数据回写，写操作参见：acl_cpp/stream/ostream.hpp        if (client->write(buf) == -1)        {                // 返回 false 通知服务器框架将该客户端连接关闭                printf("write to client error, closed it!\r\n");                return false;        }        // 返回 true 通知服务器框架继续监听该客户端连接的下一个请求过程        return true;}

      同时修改 master_service::thread_on_accept 函数，内容如下：

bool master_service::thread_on_accept(acl::socket_stream* conn){        // 设置客户端连接读写超时时间(秒)        conn->set_rw_timeout(10);        // 向客户端发送欢迎信息        if (conn->format("+OK Welcome!\r\n") == -1)        {                printf("write to client error, close it!\r\n");                // 返回 false 通知服务器框架关闭客户端连接                return false;        }        // 返回 true 通知框架监控该客户端流的可读状态        return true;}

     一个非常简单的 echo 服务器程序完成，编译之(make)，然后先以命令行方式进行测试：./echo_server alone 该服务器程序提示如下信息：listen on: 127.0.0.1:8888，意思是它现在开始监听本机回路地址的 8888 端口。可以手工通过 telnet 命令测试它：      

[zsx@localhost ~]$ telnet 127.0.0.1 8888Trying 127.0.0.1...Connected to localhost.localdomain (127.0.0.1).Escape character is ‘^]‘.+OK Welcome!hello world!hello world!

     当然，正式的生产环境下需要将 echo_server 程序放在 acl_master 服务器框架下运行，部署方式参见：acl服务器模块的部署--示例 ，acl 服务器模块的部署 。

参考：

     acl 库下载：https://sourceforge.net/projects/acl/

     svn: svn://svn.code.sf.net/p/acl/code/

     QQ 群：242722074