【从零开始学Skynet】基础篇（三）：服务模块常用API

1、服务模块       

          Skynet提供了开启服务和发送消息的API，必须要先掌握它们。列出了Skynet中8个最重要的API，PingPong程序会用到它们。

更多API可以参见：https://github.com/cloudwu/skynet/wiki/APIList

 2、程序开发 

        初看API文档可能一头雾水，结合下面的实例开发才能融会贯通。

        按如下图所示，开启两个ping类型的服务ping1和ping2，让ping1给ping2发消息，ping2收到

后回应ping1，ping1收到再回应ping2，不断循环。

3、代码实现 

（1）主服务

           在skynet/examples目录下新建main_ping.lua文件，输入如下所示代码：

local skynet = require "skynet"
skynet.start(function()skynet.error("[PingMain] start")local ping1 = skynet.newservice("Ping")local ping2 = skynet.newservice("Ping")skynet.send(ping1, "lua", "start", ping2)skynet.exit()
end)

1. 主服务启动服务后，会先打印“[PingMain]start”的日志输出；
2. 然后开启两个ping类型的服务，它们的地址分别存为ping1和ping2；
3. 再调用skynet.send，让主服务向ping1发送名 为“start”的消息（图中的阶段①），附带一个参数ping2；
4. 最后，主服务完成使命，退出。

（2）ping服务

         在skynet/examples目录下新建ping.lua文件，输入如下所示代码：

local skynet = require "skynet"local CMD = {}function CMD.start(source, target)skynet.send(target, "lua", "ping", 1)
endfunction CMD.ping(source, count)local id = skynet.self()skynet.error("["..id.."] recv ping count="..count)skynet.sleep(100)skynet.send(source, "lua", "ping", count+1)
endskynet.start(function()skynet.dispatch("lua", function(session, source, cmd, ...)local f = assert(CMD[cmd])f(source,...)end)
end)

1. 先用skynet.start初始化服务；
2. 然后在回调方法中调用skynet.dispatch，指定lua类型消息的处理方法，参数session代表消息的唯一id，可暂时先不管。source代表消息来源，指发送消息的服务地址，cmd代表消息名，“...”是一个可变参数，内容由发送方的skynet.send或skynet.call指定。       
3. 收到其他服务的消息后，查找CMD[cmd]这个方法是否存 在，如果存在就调用它；
4. 当ping1服务收到主服务的“start”消息时，程序会调用CMD.start(source, ...)。其中，参数source代表消息来源，其他参数由发送方传送。
5. ping服务可以接收两种消息：一种是主服务发来的start消息；另一种是其他ping服务发来的ping消息。

（3）配置文件

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

（4）运行结果

        最后打开终端，输入如下指令，显示运行结果。