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.导 ...
随机推荐
- 20145307第三次JAVA学习实验报告
20145307 <Java程序设计>第三次实验报告 北京电子科技学院(BESTI)实验报告 课程:Java程序设计 班级:1453 指导教师:娄嘉鹏 实验日期:2016.04.22 实验 ...
- JavaScript中字符操作之大小写转换
1.toUpperCase() 方法用于把字符串转换为大写 var str = prompt("请输入需转换大写的字符串:"); str = str.toUpperCase() ...
- win64 Python下安装PIL出错解决2.7版本 (3.6版本可以使用)
转自:http://blog.csdn.net/lhh31/article/details/51979293 1.软件版本 首先我先安装了 python 2.7 pip是 8.1.2 2.当我要安装 ...
- MR案例:单表关联查询
"单表关联"这个实例要求从给出的数据中寻找所关心的数据,它是对原始数据所包含信息的挖掘. 需求:实例中给出 child-parent(孩子—父母)表,要求输出 grandchild ...
- Jenkins FreeStyle or Pipeline Job
FreeStyle Job: 1. 需要在页面添加模块配置项与参数完成配置 2. 每个Job仅能实现一个开发功能 3. 无法将配置代码化,不利于Job配置迁移与版本控制 4. 逻辑相对简单,无额外学习 ...
- ubuntu下wget的配置文件在哪里
答:/etc/wgetrc 这个文件里可以指定代理,如: http_proxy = http://myproxy.com:8080
- CentOS 6.2配置本地yum源
转载自http://www.cnblogs.com/centoser/articles/2411694.html#undefined 一.挂载本地光盘到系统:把Cent6.2安装光盘放入光驱,在终端命 ...
- springboot部署在云服务器上
1.window云服务器上 在本地的SpringBoot的根目录下 mvn clean package 打包jar 在云服务上安装jdk 将jar拷贝到云服务器上 在jar包所在的相应的位置,执行ja ...
- webservice用cxf发布SOAP
cxf的安装,就是把文件解压,然后配置环境变量 http://cxf.apache.org/download.html这是官网下载 解压到这里 环境变量 wsdl2java命令测试 1.新建java项 ...
- HDU 3594 Cactus(仙人掌问题)
http://acm.hdu.edu.cn/showproblem.php?pid=3594 题意: 一个有向图,判断是否强连通和每条边只在一个环中. 思路: 仙人掌问题. 用Tarjan算法判断强连 ...