其它综合

关注公众号 jb51net

关闭
首页 > 网络编程 > 其它综合 > skynet.dispatch 使用

skynet.dispatch 使用示例详解

作者：monGyrate

skynet.dispatch 是 Skynet 框架中用于注册消息处理函数的核心 API,它的作用是为特定类型的消息绑定处理逻辑,当服务收到该类型的消息时,自动调用对应的处理函数,下面给大家介绍skynet.dispatch 使用,感兴趣的朋友一起看看吧

skynet.dispatch 函数详解

skynet.dispatch 是 Skynet 框架中用于注册消息处理函数的核心 API。它的作用是为特定类型的消息绑定处理逻辑，当服务收到该类型的消息时，自动调用对应的处理函数。以下是其详细解析：

1. 函数定义与参数

skynet.dispatch(type, func)

2. 消息处理流程

当服务收到一条消息时，Skynet 会执行以下步骤：

3. 使用示例

示例 1：处理 Lua 协议消息

local skynet = require "skynet"
-- 注册 Lua 类型消息的处理函数
skynet.dispatch("lua", function(session, source, cmd, ...)
    if cmd == "add" then
        local a, b = ...
        skynet.ret(skynet.pack(a + b))
    elseif cmd == "ping" then
        skynet.ret(skynet.pack("pong"))
    end
end)
skynet.start(function()
    -- 服务初始化代码
end)

说明：

示例 2：处理自定义协议消息

local skynet = require "skynet"
-- 注册自定义协议
skynet.register_protocol {
    name = "myproto",
    id = 100,  -- 自定义协议 ID（需唯一）
    unpack = function(msg, sz)
        -- 自定义解包逻辑（如 sproto 解析）
        return myproto.decode(msg, sz)
    end
}
-- 处理自定义协议消息
skynet.dispatch("myproto", function(session, source, data)
    print("Received:", data)
    skynet.ret()  -- 无返回值
end)
skynet.start(function()
    -- 服务初始化代码
end)

4. 关键机制

(1) 协程与阻塞操作

skynet.dispatch("lua", function(session, source, cmd)
    if cmd == "slow_task" then
        skynet.sleep(100)  -- 挂起协程 1 秒
        skynet.ret("Done")
    end
end)

(2) 消息响应

skynet.dispatch("lua", function(session, source, cmd)
    if session ~= 0 then  -- 需要响应
        skynet.ret(skynet.pack("Response"))
    end
end)

5. 与 skynet.register_protocol 的协作

协议注册：定义如何解析和打包消息。

skynet.register_protocol {
    name = "binary",
    id = skynet.PTYPE_USER,  -- 自定义 ID
    unpack = function(msg, sz) return msg, sz end,  -- 不解包，直接传递原始数据
    pack = skynet.pack  -- 默认打包函数
}

消息分发：通过 skynet.dispatch 绑定处理逻辑。

skynet.dispatch("binary", function(session, source, msg, sz)
    -- 处理二进制数据
end)

6. 注意事项

避免阻塞主线程：
若处理函数中有耗时操作（如大量计算、同步 IO），应使用 skynet.fork 创建新协程。

skynet.dispatch("lua", function(session, source, cmd)
    if cmd == "heavy_task" then
        skynet.fork(function()
            -- 在子协程中执行耗时操作
            local result = heavy_compute()
            skynet.ret(skynet.pack(result))
        end)
    end
end)

协程生命周期：
确保每个协程最终退出，避免内存泄漏（如通过 pcall 捕获异常）。

线程安全：
Skynet 服务是单线程的，但协程间共享 Lua 虚拟机状态，需谨慎处理共享数据（推荐使用 skynet.sharedata）。

7. 典型应用场景

总结

skynet.dispatch 是 Skynet 服务的消息处理入口，通过绑定协议类型与处理函数，实现灵活的消息分发机制。理解其协程调度、协议注册和响应机制，是构建高效 Skynet 服务的关键。结合 sproto 等协议工具，可以进一步简化网络通信的复杂性。

到此这篇关于skynet.dispatch 使用示例详解的文章就介绍到这了,更多相关skynet.dispatch 使用内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

阅读全文