【从零开始学Skynet】基础篇（四）：网络模块常用API

游戏服务端要处理客户端请求，作为服务端引擎，网络编程也是Skynet的核心功能。

1、学习网络模块

skynet.socket模块提供了网络编程的API，常用的API如下表所示：

Lua API	说明
socket.listen(address ,port)	监听一个端口，返回一个 id ，供 start 使用。
socket.start(id , accept)	accept 是一个函数。每当一个监听的 id 对应的 socket 上有连接接入的时候，都会调用 accept 函数。这个函数会得到接入连接的 id 以及 ip 地址。你可以做后续操作。
socket.read(id, sz)	从一个 socket 上读 sz 指定的字节数。如果读到了指定长度的字符串，它把这个字符串返回。如果连接断开导致字节数不够，将返回一个 false 加上读到的字符串。如果 sz 为 nil ，则返回尽可能多的字节数，但至少读一个字节（若无新数据，会阻塞）。
socket.write(id, str)	把一个字符串置入正常的写队列，skynet框架会在 socket 可写时发送它。
socket.close(id)	关闭一个连接，这个 API 有可能阻塞住执行流。因为如果有其它coroutine 正在阻塞读这个id对应的连接，会先驱使读操作结束，close操作才返回。

socket.read中所谓的阻塞模式和 skynet.call一样，都利用了Lua的协程机制。调用socket.read，服务有可能被挂起，直到接收到数据，才会往下执行。

更多API参见：https://github.com/cloudwu/skynet/wiki/Socket

2、功能开发

学完上面的API，我们来写一个Echo程序，Echo程序其实就是一个开启处理客户端消息的服务，它会把收到的内容原封不动地发回给客户端。以下是Echo程序的示意图：

3、代码实现

（1）主服务

本例只需开启一个服务，在skynet/examples目录下创建main_echo.lua文件，输入代码如下所示：

local skynet = require "skynet"
local socket = require "skynet.socket"function connect(fd, addr)--启用连接print(fd.." connected addr:"..addr)socket.start(fd)--消息处理while true dolocal readdata = socket.read(fd)--正常接收if readdata ~= nil thenprint(fd.." recv "..readdata)socket.write(fd, readdata)--断开连接elseprint(fd.." close ")socket.close(fd)endend
endskynet.start(function()local listenfd = socket.listen("0.0.0.0", 8888)socket.start(listenfd ,connect)
end)

代码说明：

先引入skynet和skynet.socket这两个模块；
使用skynet.start启动服务后，依次调用socket.listen和socket.start来监听8888端口；
新客户端发起连接时，connect方法将被调用；
在while循环里，程序先用socket.read接收数据，如果收到数据（if readdata~=nil的真分

支），则通过socket.write将数据发回客户端；如果客户端断开了连接（if readdata~=nil的假分支），则调用socket.close关闭连接；
“0.0.0.0”表示不限制客户端的IP。

（2）配置文件

在skynet/examples目录下创建config_echo文件，也可以拿之前的配置文件修改"start"的值即可，配置参数如下所示：

include "config.path"thread = 8
logger = nil
logpath = "."
harbor = 0
start = "main_echo"	-- main script
bootstrap = "snlua bootstrap"	-- The service for bootstrap
-- snax_interface_g = "snax_g"
cpath = root.."cservice/?.so"
-- daemon = "./skynet.pid"

4、运行代码

（1）输入如下指令即可运行：

cd skynet
./skynet examples/config_echo

如果开启服务端时提示“init service failed: ./lualib/skynet/socket.lua:414: Listen error”，意味着监听端口8888被占用，可能是多次运行服务端所致，可以执行“killall skynet”命令关闭所有的Skynet进程。

（2）重新打开终端输入命令，显示如下结果，表示运行成功；