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 使用内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Debezium 与 Apache Kafka 的集成方式步骤详解

    Debezium 与 Apache Kafka 的集成方式步骤详解

    本文详细介绍了如何将Debezium与Apache Kafka集成,包括集成概述、步骤、注意事项等,通过KafkaConnect,Debezium可以捕获数据库变更并实时发送到Kafka Topic,实现数据的实时同步和分析,感兴趣的朋友一起看看吧
    2025-02-02
  • 使用Git Bash向GitHub上传本地项目

    使用Git Bash向GitHub上传本地项目

    这篇文章介绍了使用Git Bash向GitHub上传本地项目的方法,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2022-04-04
  • ffmpeg安装及音频转换指令应用

    ffmpeg安装及音频转换指令应用

    ffmpeg是一套可以用来记录、转换数字音频、视频,本文主要介绍了ffmpeg安装及音频转换指令应用,具有一定的参考价值,感兴趣的可以了解一下
    2024-02-02
  • ROS  TF坐标变换基本概念及使用案例

    ROS  TF坐标变换基本概念及使用案例

    本文介绍了TF坐标变换的基本概念以及TF在ROS中的表示形式,通过古月居的乌龟跟随的例子,分析了TF树的广播器和监听器最基本的书写形式,从中展示了如何提取和应用TF变换的信息,并介绍了5种最常用的TF树及TF信息的提取工具,感兴趣的朋友一起学习下吧
    2023-01-01
  • ChatGPT体验辅助写代码功能实测(附编程测试)

    ChatGPT体验辅助写代码功能实测(附编程测试)

    ChatGPT最近霸屏了,咱们也来玩玩,下面这篇文章主要给大家介绍使用ChatGPT辅助写代码的体验,需要的朋友可以参考下
    2023-02-02
  • bower 强大的管理web包管理工具

    bower 强大的管理web包管理工具

    bower是twitter的又一个开源项目,使用nodejs开发,用于web包管理。如果越来越多得开源项目都托管在github上,bower只需要将github上项目加上一个配置文件既可以使用bower方式使用安装包
    2013-12-12
  • APAP ALV进阶写法及优化详解

    APAP ALV进阶写法及优化详解

    这篇文章主要为大家介绍了APAP ALV进阶写法及优化详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-09-09
  • 到初创公司工作的五个理由

    到初创公司工作的五个理由

    这篇文章主要介绍了到初创公司工作的五个理由,在职业选择上并不来一定要去大公司,去初创公司工作一次会让你有更多的收获,需要的朋友可以参考下
    2014-09-09
  • 伪静态技术介绍与优缺点分析(较完整篇)

    伪静态技术介绍与优缺点分析(较完整篇)

    伪静态太适合用在普通的企业网站上了——既不要求高并发,但同时又很在乎seo(搜索引擎优化),而且也要求后台可动态更新。
    2009-11-11
  • 微信小程序开发工具介绍

    微信小程序开发工具介绍

    这篇文章主要为大家介绍了微信小程序开发工具及基本的使用,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步早日升职加薪
    2022-04-04

最新评论