使用 acl 库开发简单的客户端与服务器程序

      以前写过一些如何使用 acl 的服务器框架编写服务器程序的技术文章（http://zsxxsz.iteye.com/category/210570，http://zsxxsz.iteye.com/category/80224），若是仅是写一些简单的服务器程序，有时倒没必要如此麻烦， acl 的 C++ 库部分也提供了一些简单的服务器类，本文将介绍如何使用这些简单的类来实现一些服务器程序和网络客户端程序。

      首先介绍 acl 中的服务器类：server_socket。该类定义了以下几个简单方法：

 

/**
	 * 开始监听给定服务端地址
	 * @param addr {const char*} 服务器监听地址，格式为：
	 *  ip:port；在 unix 环境下，还能够是域套接口，格式为：
	 *   /path/xxx
	 * @return {bool} 监听是否成功
	 */
	bool open(const char* addr);

	/**
	 * 关闭已经打开的监听套接口
	 * @return {bool} 是否正常关闭
	 */
	bool close();

	/**
	 * 接收客户端链接并建立客户端链接流
	 * @param timeout {int} 在阻塞模式下，当该值 > 0 时，采用超时
	 *  方式接收客户端链接，若在指定时间内未得到客户端链接，则返回 NULL
	 * @return {socket_stream*} 返回空表示接收失败
	 */
	socket_stream* accept(int timeout = 0);

	/**
	 * 得到监听的地址
	 * @return {const char*} 返回值非空指针
	 */
	const char* get_addr() const
	{
		return addr_;
	}

 

      使用上述网络服务类的步骤是：调用 open 监听本机的一个网络地址（若是是UNIX平台，还能够监听UNIX域套接口）------> 调用 accept 方法等待远程客户端链接本服务器 ------> 当服务器程序接收到客户端链接时 accept 方法返回客户端链接网络流(socket_stream) ------> 启动一个线程处理这个客户端链接。下面为一个简单的服务器程序：

 

#include "acl_cpp/lib_acl.hpp"

// 处理客户端链接的线程类
class client_thread : public acl::thread
{
public:
	client_thread(acl::socket_stream* client)
	: client_(client)
	{
	}

	~client_thread()
	{
		delete client_;
	}

protected:
	// 实现基类 acl::thread 中定义的纯虚方法
	void* run()
	{
		acl::string buf;
		while (true)
		{
			// 从客户端链接读一行数据，第二个参数为 false 意思是但愿
			// socket_stream 在读到一行数据时保留 \r\n
			if (client_->gets(buf, false) == false)
				return NULL;

			printf("gets one line: %s", buf.c_str());

			// 回写所读到的一行数据
			if (client_->write(buf) == -1)
				return NULL;
		}
	}

private:
	acl::socket_stream* client_;
};

int main(void)
{
	const char* addr = "0.0.0.0:8080";
	acl::socket_server server;

	// 监听本机网络地址
	if (server.open(addr) == false)
	{
		printf("listen addr: %s error: %s\r\n", addr, acl::last_serror());
		return -1
	}

	while (true)
	{
		// 等待客户端链接本服务器程序
		acl::socket_stream* client = server.accept();
		if (client == NULL)
		{
			printf("accept error: %s\r\n", acl::last_serror());
			return -1;
		}

		// 建立一个子线程用来处理该客户端链接
		client_thread* thread = new client_thread(client);

		// 将线程设为分离模式，这样当线程退出时会自行释放线程相关资源
		thread->set_detachable(true);

		// 启动该线程
		thread->start();
	}

	return 0;
}

       上面例子很是简单，毋庸详述，关于如何使用 acl 编写多线程程序，请参照：使用 acl_cpp 库编写多线程程序。下面再给出一个简单的网络客户端例子：

#include "acl_cpp/lib_acl.hpp"

int main(void)
{
	const char* server_addr = "127.0.0.1:8080";
	int   conn_timeout = 10 /* 链接服务器超时时间，单位：秒 */
	int   rw_timeout = 10 /* 网络 IO 超时时间，单位：秒 */;
	acl::socket_stream conn;

	// 链接远程服务器
	if (conn.open(server_addr, conn_timeout, rw_timeout) == false)
	{
		printf("connect server: %s error: %s\r\n",
			server_addr, acl::last_serror());
		return -1;
	}

	const char* req = "hello world!\r\n";

	acl::string buf;

	// 向服务器写一行数据，同时从服务器读一行数据，循环 10 次
	for (int i = 0; i < 10; i++)
	{
		// 向服务器发送一行数据
		if (conn.write(req, strlen(req)) == -1)
		{
			printf("write request to server error: %s\r\n",
				acl::last_serror());
			return -1;
		}

		// 从服务器读一行数据，注：第二个参数为默认的 true，意思是得到
		// 一行数据后自动将尾部的 \r\n 去掉
		if (conn.gets(buf) == false)
		{
			printf("gets one line from server error: %s\r\n",
				acl::last_serror();
			return -1;
		}

		printf("response: %s\r\n", buf.c_str());
	}

	return 0;
}

 

 

   参考连接：

   技术博客：http://zsxxsz.iteye.com/

   download：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