使用 acl 编写 UDP 网络程序
? ? ? 在当今网络世界，虽然大部分网络应用都是基于 TCP 的，但有时 UDP 的网络通信也有用武之处。acl 的网络库中不仅提供了基于 TCP 的网络套接字流，同时也提供了 UDP 的网络库（目前 acl 库的网络部分仅提供了基本的 UDP 功能，如果想实现 UDP 重传及可靠性机制，大家可以参考 udt --https://sourceforge.net/projects/udt/ 库）。
? ? ? 使用 acl 网络库无论编写客户端还是服务器程序，都需要首先调用 acl_vstream_bind 接口绑定本机地址，该函数的定义如下：
/** * 针对 UDP 通信，该函数用来绑定本地 UDP 地址，如果绑定成功，则创建 * ACL_VSTREAM 对象, 用户可以象调用 ACL_VSTREAM 对象的读写接口 * @param addr {const char*} 本地 UDP 地址，格式：ip:port * @param rw_timeout {int} 读写超时时间(秒) * @return {ACL_VSTREAM*} 返回 NULL 表示绑定失败 */ACL_API ACL_VSTREAM *acl_vstream_bind(const char *addr, int rw_timeout);?? ? ? 然后就可以调用 acl_vstream_read/acl_vstream_write 两个函数以 UDP 方式进行网络数据的读写了，因为 UDP 传输是不保证顺序及可靠性的，所以 acl 网络库中的其它读写函数就不被用在 UDP 读写操作中。
?
? ? ? 下面一个简单的 UDP 服务端程序：
static void udp_server(void){const char *addr = "127.0.0.1:1088";char buf[4096];int ret;ACL_VSTREAM *stream = acl_vstream_bind(addr, 0); /* 绑定 UDP 套接口 */if (stream == NULL) {printf("acl_vstream_bind %s error %s\r\n", addr, acl_last_serror());return;}printf("bind udp addr %s ok\r\n", addr);while (1) {/* 等待客户端数据 */ret = acl_vstream_read(stream, buf, sizeof(buf) - 1);if (ret == ACL_VSTREAM_EOF) {printf("acl_vstream_read error %s\r\n", acl_last_serror());break;}/* 输出服务器绑定地址及远程客户端地址 */printf("local addr: %s, peer addr: %s, total: %d\r\n",ACL_VSTREAM_LOCAL(stream), ACL_VSTREAM_PEER(stream), i);/* 回写数据至客户端 */ret = acl_vstream_write(stream, buf, ret);if (ret == ACL_VSTREAM_EOF) {printf("acl_vtream_writen error %s\r\n", acl_last_serror());break;}}/* 关闭 UDP 套接字 */acl_vstream_close(stream);}?
? ? ? 使用 acl 编写的 UDP 客户端示例如下：
static void udp_client(void){const char *local_addr = "127.0.0.1:1089"; /* 本客户端绑定的地址 */const char *peer_addr = "127.0.0.1:1088"; /* 服务端绑定的地址 */int i, ret, dlen;char buf[1024], data[1024];ACL_VSTREAM *stream = acl_vstream_bind(local_addr, 2); /* 绑定 UDP 套接口 */if (stream == NULL) {printf("acl_vstream_bind %s error %s\r\n",local_addr, acl_last_serror());return;}memset(data, 'X', sizeof(data);dlen = sizeof(data);for (i = 0; i < 100; i++) {/* 每次写时需要设定服务端地址 */acl_vstream_set_peer(stream, peer_addr);/* 向服务端写入数据包 */ret = acl_vstream_write(stream, data, dlen);if (ret == ACL_VSTREAM_EOF) {printf("acl_vtream_writen error %s\r\n",acl_last_serror());break;}/* 从服务端读取数据 */ret = acl_vstream_read(stream, buf, sizeof(buf));if (ret == ACL_VSTREAM_EOF) {printf("acl_vstream_read error %s\r\n",acl_last_serror());break;}}/* 关闭客户端 UDP 套接字 */acl_vstream_close(stream);}? ? ? ?由以上两个例子可以看出，使用 acl 网络库编写 UDP 程序也是非常简单的，但有几点需要注意：
? ? ? 1、虽然 acl 网络库中的 UDP 功能也借用 ACL_VSTREAM 结构定义及 acl_vstream_xxx 等接口定义，但 UDP 传输依然是数据包式（即非流式），所以 acl 网络库中的有关 TCP 的使用方法在 UDP 中并不适合（如：acl_vstream_readn, acl_vstream_gets）；
? ? ? 2、UDP 传输不保证顺序性及可靠性，所以 acl 网络库在绑定 UDP 端口时允许用户指定读超时时间；
? ? ? 3、使用 acl 网络库编写 UDP 客户端时，在每次向服务端写数据时，最好每次都先通过 acl_vstream_set_peer 设定服务端绑定地址。
?
? ? ? 参考：
? ? ? acl 项目下载地址：https://sourceforge.net/projects/acl/
? ? ? svn：svn://svn.code.sf.net/p/acl/code/trunk acl-code
? ? ??github：https://github.com/zhengshuxin/acl
? ? ? udp 服务端示例：acl\samples\udp_server
? ? ? udp 客户端示例：acl\samples\udp_client