Skynet服务器框架(九) snax框架
什么是 snax
由于 skynet 的 API 还是比较偏底层,为简化服务的编写提供一套简单的 API ,便有了这套 snax
框架,解决的问题:
“编写一个
skynet
内部服务,处理发送给它的消息。snax
并不会取代skynet
原有的 api ,只是方便实现这类简单需求而已。”—— 云风
换句话说,snax
就是对 skynet API 的部分封装而产生的一个框架
编写 skynet 服务:
在了解如何使用 snax
来编写一个服务之前,先大致了解一下直接使用 skynet 的 API 是如何创建一个服务的,这里服务仅实现消息响应部分的功能:
通常是在
skynet.start
中会调用skynet.dispatch
接口:skynet.start(function() skynet.dispatch("lua", function(session, address, ...) dispatch(...) end)
首先,用
skynet.start
来注册 skynet 服务的启动函数,并确定这个服务用什么协议来解析消息(一般选择“lua”
协议,因为这种协议是为 lua 设计的,可以最高效地把 lua 原生数据序列化);然后,规定消息的第一个传入数据为字符串,表示消息类型,利用此类型区分不同消息的响应:
local command = {} function command.foobar(...) end local function dispatch(cmd, ...) command[cmd](...) end
skynet 内部的消息分两种:
- 单向推送
skynet.send
- 发起请求,等待回应
skynet.call
对于请求的回应操作,使用
skynet.ret
接口来实现,但此 API 并不负责数据打包。所以,如果使用 lua 协议,通常写成skynet.ret(skynet.pack(...))
的形式,以完成数据打包
和回应请求
这两个步骤。- 单向推送
为了兼容
skynet.send
和skynet.call
的调用需求,需要对dispatch
做一下优化:local function dispatch(cmd, ...) --先判断command函数集中包不包含当前传入 cmd 的处理函数,假如未定义则不再往下执行 local f = assert(command[cmd]) --执行 cmd 对应的处理函数 local r = f(...) --判断是否有返回结果 if r ~= NORET then --打包数据并回传给消息发送方 skynet.ret(skynet.pack(r)) end end
启动 skynet 服务的接口:
skynet.newservice(name,...)
这里
name
是服务对应的.lua
文件的名称。
编写 snax 服务:
1.配置:
要使用 snax
框架来编写我们的服务,首先需要在 Config
中配置 snax
参数项,配置内容是查找使用 snax 框架格式编写的服务文件的目录。
2.格式要求:
每个 snax
服务都有一个用于启动服务的名字,推荐按 lua 的模块命名规则,但目前不推荐服务名中包含”点”(在路径搜索上尚未支持 .
与 /
的替换)。在启动服务时会按查找路径搜索对应的文件。
snax
服务用 lua 编写,但并不是一个独立的 lua 程序。它里面包含了一组 lua 函数,会被 snax
框架分析加载。
3.使用 snax
框架:
snax
框架是把一些通用代码放到一个简单的框架中而得到的一个更易于使用的 API 。看完了 skynet API 的实现过程之后,我们再用 snax
来编写一个功能完全相同的服务,然后进行对比讲解:
-- foobar服务
local i = 0
local hello = "hello"
function response.echo(data)
return data, i
end
function subscribe.touch()
i = i + 1
end
function init( ... )
print ("service start:", ...)
end
function exit(...)
print ("service exit:", ...)
end
init()
:启动此服务时会调用此函数,并把启动参数传给它,这是每个 snax 服务都必须定义的;exit()
:这是此 snax 服务退出要执行的代码,通常用于响应服务退出时间,同样也可以传入一些参数;response.
:以response.
开头的函数表示返回值会通过调用skynet.ret
返回;subscribe.
:以subscribe.
开头的函数表示返回值会被扔掉不会返回。
关于 snax 的传入参数,并没有对类型设置项目,可以传入 lua 的复杂数据类型,而 skynet 服务则受限于底层C源码限制,只接受传入字符串类型的启动参数。
4.snax
服务API:
这里以上面写的 snax 服务为例,启动该服务并调用该服务的内部函数:
--启动服务
local p = snax.newservice ("foobar", "hello world")
--调用服务中的函数
print(p.req.echo("foobar"))
print(p.pub.touch())
--退出服务
snax.exit(p)
snax.newservice
:这是 snax 框架启动一个 snax 服务的接口,第一个参数是 snax 服务实现脚本的名称,第二个参数才是传入服务中init
方法的启动参数;req
:对应于 snax 服务中的response
pub
:对应于 snax 服务中的subscribe
snax.exit
:结束一个 snax 服务的接口
snax.newservice
会在config
文件中配置的snax
路径上找到"foobar"
模块并加载。由于 skynet 的核心是 C 编写的,所以服务的启动参数只能是一个 字符串。为了更加灵活,snax
在实现时规定了启动服务的消息,newserice
的启动参数是用 lua 协议打包,通过启动消息传递的,也就不受限制了。
其他:
snax
不仅提供了更为简便的创建服务的 API,而且还提供了热更新的接口,随后的内容会做详细的展开和应用举例。
参考:
Skynet服务器框架(九) snax框架的更多相关文章
- Skynet服务器框架(八) 任务和消息调度机制
引言: 在我看来,消息和任务调度应该是skynet的核心,整个skynet框架的核心其实就是一个消息管理系统.在skynet中可以把每个功能都当做一个服务,整个skynet工程在执行过程中会创建很多个 ...
- Skynet服务器框架(十) CentOS 防火墙设置
引言: 今天修改了 skynet 服务器的 IP 地址(即 config 文件中的 address 和 master 两项参数,IP 与当前及其的保持一致,端口号为 2017),然后使用一个简单的客户 ...
- [Python之路] 实现简易HTTP服务器与MINI WEB框架(利用WSGI实现服务器与框架解耦)
本文描述如果简单实现自定义Web服务器与自定义简易框架,并且不断进行版本迭代,从而清晰的展现服务器与Web框架之间是如何结合.如何配合工作的.以及WSGI是什么. 本文帖的代码有点多,但基本每次迭代修 ...
- 【2022-09-09】Django框架(九)
Django框架(九) cookie与session简介 网址的发展史: 1.起初网站都没有保存用户功能的需求,所有用户访问返回的结果都是一样的. 比如:新闻网页,博客网页,小说... (这些网页是不 ...
- 关于vue 框架与后台框架的混合使用的尝试
这几天我在研究前台框架和后台框架融合的问题,进行了一些尝试; 我前台选择的是 vue,当然也可以选择 react 等其他 mvvm 框架,不过 vue 对于我来说是最熟悉的; 后台话,我选择的是 ph ...
- 关于vue 框架与后台框架的混合使用的尝试------转载
这几天我在研究前台框架和后台框架融合的问题,进行了一些尝试; 我前台选择的是 vue,当然也可以选择 react 等其他 mvvm 框架,不过 vue 对于我来说是最熟悉的; 后台话,我选择的是 ph ...
- 分布式定时任务框架——python定时任务框架APScheduler扩展
http://bbs.7boo.org/forum.php?mod=viewthread&tid=14546 如果将定时任务部署在一台服务器上,那么这个定时任务就是整个系统的单点,这台服务器出 ...
- SSM框架和SSH框架的区别
SSH和SSM定义 SSH 通常指的是 Struts2 做控制器(controller),spring 管理各层的组件,hibernate 负责持久化层. SSM 则指的是 SpringMVC 做控制 ...
- 整合Spring框架和Hibernate框架
-------------------siwuxie095 整合 Spring 框架和 Hibernate 框架 1.导 ...
随机推荐
- vs LNK2019 无法解析的外部符号 ***,该符号在函数 WinMain 中被引用
一般链接错误都是因为包含头文件与lib库不匹配(无导出函数.lib库的release debug版本混乱.库引用的优先级.编译器设置mt/mtd等等)造成的. 错误 LNK2019 无法解 ...
- 20145312 《Java程序设计》第七周学习总结
20145312 <Java程序设计>第七周学习总结 学习笔记 Chapter 13时间与日期 13.1 认识时间与日期 13.1.1 时间的度量 格林威治标准时间 世界时:观测远方星体跨 ...
- 《Java 程序设计》团队博客第十一周(第一次)
<Java 程序设计>团队博客第十一周(第一次) 团队项目 1.项目内容.目标 项目内容 本组的团队项目准备实现一个有关于大富翁有的游戏程序. 大富翁游戏,以经营权为主要的游戏方式,通过购 ...
- 20145211《网络渗透》msf辅助模块的应用
20145211<网络渗透>msf辅助模块的应用 一.实验准备 启用VB的kali,需要用到桥接,VMware桥接总是罢工…… 二.实验步骤 最好开桥接模式,要不然你就多开几个虚拟机(只要 ...
- Linux内存管理的基本框架⭐⭐
Linux内核的映射机制设计成三层,在页面目录和页面表中间增设了一层“中间目录”.在代码中,页面目录称为PGD,中间目录称为PMD,而页面表称为PT.PT中的表项称为PTE,PTE是“Page Tab ...
- HAproxy的安装配置及动静分离
/////////////////////////////目录//////////////////////////////////////////一.安装HAproxy二.编写HAproxy启动脚本三 ...
- java:历史回顾
1.String和StringBuffer区别 2.Runtime和System类,包括对象垃圾收集 Rumtime.gc() System.gc() 调用的其实就是Runtime的gc回收 3.da ...
- findContours函数参数详解
http://blog.csdn.net/dcrmg/article/details/51987348
- Tracing on Linux
The Linux tracing APIs are a relatively new addition to the kernel and one of the most powerful new ...
- Jdev 本地RUN页面时候,将异常直接显示出来,而不是乱码
本地运行页面时,经常会遇到以下错误 oracle.jbo.JboException: JBO-29000: JBO-29000: JBO-26028: ???? MemberAttributesDis ...