skynet.dispatch 使用示例详解

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

skynet.dispatch 函数详解

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

1. 函数定义与参数

skynet.dispatch(type, func)
  • type:消息类型(字符串或数字)。
    • 常见类型:
      • "lua":默认的 Lua 消息协议(对应 skynet.PTYPE_LUA)。
      • "socket":网络消息(对应 skynet.PTYPE_SOCKET)。
      • 自定义类型:通过 skynet.register_protocol 注册的协议类型。
  • func:消息处理函数,格式为 function(session, source, ...)
    • session:会话 ID,用于响应消息(如 skynet.ret)。
    • source:发送方服务的地址(skynet.address 格式)。
    • ...:消息内容(由协议定义的解包逻辑生成)。

2. 消息处理流程

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

  • 协议匹配:根据消息类型(如 "lua")找到对应的解包函数。
  • 消息解包:调用协议注册的 unpack 函数,将二进制数据解析为 Lua 值。
  • 分发处理:调用 skynet.dispatch 注册的处理函数,传入 sessionsource 和解包后的数据。
  • 协程调度:处理函数在一个独立的协程中执行,避免阻塞其他消息处理。

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)

说明

  • 当收到 "lua" 类型的消息时,解析出命令 cmd 和参数。
  • 根据 cmd 执行逻辑,并通过 skynet.ret 返回结果。

示例 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)
  • 自定义协议需要先通过 skynet.register_protocol 注册。
  • 收到类型为 "myproto" 的消息时,调用自定义解包函数,并处理数据。

4. 关键机制

(1) 协程与阻塞操作

  • 协程调度:每条消息的处理在独立协程中执行,互不阻塞。
  • 阻塞 API:若处理函数中调用 skynet.callskynet.sleep 等阻塞 API,当前协程会被挂起,直到操作完成。
skynet.dispatch("lua", function(session, source, cmd)
    if cmd == "slow_task" then
        skynet.sleep(100)  -- 挂起协程 1 秒
        skynet.ret("Done")
    end
end)

(2) 消息响应

  • skynet.ret:用于向发送方返回响应。
    • 若消息是请求(skynet.call),必须调用 skynet.ret
    • 若消息是通知(skynet.send),无需返回。
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. 典型应用场景

  • RPC 调用:处理远程服务请求并返回结果。
  • 网络消息:解析 TCP/UDP 数据包,如游戏协议、HTTP 请求。
  • 定时任务:通过 skynet.timeout 触发延时逻辑。

总结

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

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

相关文章

  • 自动驾驶技术之V2X技术的介绍

    自动驾驶技术之V2X技术的介绍

    本章内容介绍了如何利用车辆自身的智能,还可以借助外部环境实现信息的获取,这一类技术统称为V2X技术。接下来我们大家一起来学习吧
    2021-08-08
  • vscode 配置eslint和prettier正确方法

    vscode 配置eslint和prettier正确方法

    ESLint 是一款语法检测工具而prettier 是一个代码格式化插件,今天给大家分享vscode 配置eslint和prettier正确方法,感兴趣的朋友一起看看吧
    2021-07-07
  • 鸿蒙(HarmonyOS)实现隐私政策弹窗效果

    鸿蒙(HarmonyOS)实现隐私政策弹窗效果

    但在HarmonyOS中,由于系统弹窗的显示优先级高于其他组件,即使跳转到Web页面,弹窗依然会显示在最上层,下面给大家分享鸿蒙(HarmonyOS)实现隐私政策弹窗,感兴趣的朋友跟随小编一起看看吧
    2024-08-08
  • Trae AI IDE的使用教程(全网最全)

    Trae AI IDE的使用教程(全网最全)

    字节推出TraeAIIDE专为中文开发者设计,集AI编码、Builder/Chat模式于一体,支持代码编辑、运行、样式改造及交互增强,提升开发效率与体验,感兴趣的可以了解一下
    2025-07-07
  • Prometheus + Grafana 构建强大的监控和数据可视化系统(最新推荐)

    Prometheus + Grafana 构建强大的监控和数据可视化系统(最新推荐)

    Prometheus 是一个时间序列数据库,但是,它不仅仅是一个时间序列数据库,它涵盖了可以绑定的整个生态系统工具集及其功能,非常适合Kubernetes集群的监控,这篇文章主要介绍了Prometheus + Grafana 构建强大的监控和数据可视化系统,需要的朋友可以参考下
    2024-05-05
  • 关于Python与Golang语言的对比分析

    关于Python与Golang语言的对比分析

    这篇文章主要为大家介绍了关于Python与Golang的语言对比分析,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-05-05
  • 深入剖析网关gateway原理

    深入剖析网关gateway原理

    这篇文章主要介绍了网关gateway,本文从网关的背景开始讲起,一次论述网关的依赖,负载均衡,网关的选型等等进行深入的剖细,让大家可以更深一步的了解
    2021-08-08
  • JetPack开发中使用CameraX完成拍照和拍视频功能

    JetPack开发中使用CameraX完成拍照和拍视频功能

    CameraX 是一个 Google 推出的 JetPack 组件。今天给大家分享JetPack之使用CameraX完成拍照和拍视频,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧
    2020-06-06
  • 关于程序员生活的一份调查,看看你属于哪一个群体吧

    关于程序员生活的一份调查,看看你属于哪一个群体吧

    这篇文章主要介绍了关于程序员生活的一份调查,看看你属于哪一个群体吧,需要的朋友可以参考下
    2014-09-09
  • 教你给《羊了个羊》配置一套智能客服系统

    教你给《羊了个羊》配置一套智能客服系统

    这篇文章主要介绍了如何给《羊了个羊》配置一套智能客服系统,通过微信小游戏接入智能客服的演示就完成了,希望能够对更多小游戏、小程序开发团队有所帮助,需要的朋友可以参考下
    2022-09-09

最新评论