每个服务启动之后,都有一个整形数来表示id,也可以使用字符串id来表示,例如::01000010
,其实就是把id:0x01000010
转换成字符串。
但是这个数字的表示方式会根据服务的启动先后顺序而变化,不是一个固定的值。如果想要方便的获取某个服务,那么可以通过给服务设置别名来。
5.1 本地别名与全局别名
在skynet中,服务别名可以分为两种:
一种是本地别名,本地别名只能在当前skynet节点使用,本地别名必须使用
.
开头,例如:.testalias
一种是全局别名,全局别名可以在所有skynet中使用,全局别名不能以
.
开头, 例如:testalias
5.2 别名注册与查询接口
------------------------------[[取别名]]--------------------------
local skynet = require "skynet"
require "skynet.manager"
--给当前服务定一个别名,可以是全局别名,也可以是本地别名
skynet.register(aliasname)
--给指定servicehandler的服务定一个别名,可以是全局别名,也可以是本地别名
skynet.name(aliasname, servicehandler)
-------------------------------------------------------------------
----------------------[[查询别名]]------------------------------
--查询本地别名为aliasname的服务,返回servicehandler,不存在就返回nil
skynet.localname(aliasname)
--[[
查询别名为aliasname的服务,可以是全局别名也可以是本地别名,
1、当查询本地别名时,返回servicehandler,不存在就返回nil
2、当查询全局别名时,返回servicehandler,不存在就阻塞等待到该服务初始化完成
]]--
local skynet = require "skynet.harbor"
harbor.queryname(aliasname)
-------------------------------------------------------------------
注意:本地别名与全局别名可以同时存在。
5.3 给服务注册别名
5.3.1给普通服取别名
示例代码:testalias.lua
local skynet = require "skynet"
require "skynet.manager"
local harbor = require "skynet.harbor"
skynet.start(function()
local handle = skynet.newservice("test")
skynet.name(".testalias", handle) --给服务起一个本地别名
skynet.name("testalias", handle) --给服务起一个全局别名
handle = skynet.localname(".testalias")
skynet.error("localname .testalias handle", skynet.address(handle))
handle = skynet.localname("testalias") --只能查本地,不能查全局别名
skynet.error("localname testalias handle", skynet.address(handle))
handle = harbor.queryname(".testalias")
skynet.error("queryname .testalias handle", skynet.address(handle))
handle = harbor.queryname("testalias")
skynet.error("queryname testalias handle", skynet.address(handle))
end)
上面服务通过skynet.newservice来启动一个test.lua服务,test.lua代码如下:
local skynet = require "skynet"
skynet.start(function()
skynet.error("My new service")
end)
运行结果:
$ ./skynet examples/config testalias #运行main.lua后在终端输入 [:0100000a] LAUNCH snlua testalias [:0100000b] LAUNCH snlua test [:0100000b] My new service [:0100000a] localname .testalias handle :0100000b #skynet.localname查到本地名 [:0100000a] localname testalias handle nil #skynet.localname查不到全局名 [:0100000a] queryname .testalias handle :0100000b #harbor.queryname查到本地名 [:0100000a] queryname testalias handle :0100000b #harbor.queryname查到全局名
5.3.2 全局别名查询阻塞
如果全局别名不存在,那么这个时候调用函数harbor.queryname
,将会阻塞,直到全局别名的服务创建成功。
示例代码:testalias.lua
local skynet = require "skynet"
require "skynet.manager"
local harbor = require "skynet.harbor"
skynet.start(function()
handle = skynet.localname(".testalias") --查询本地别名不阻塞
skynet.error("localname .testalias handle", skynet.address(handle))
handle = skynet.localname("testalias") --无法查询全局别名
skynet.error("localname testalias handle", skynet.address(handle))
handle = harbor.queryname(".testalias") --查询本地别名不阻塞
skynet.error("queryname .testalias handle", skynet.address(handle))
handle = harbor.queryname("testalias") --查询全局别名阻塞
skynet.error("queryname testalias handle", skynet.address(handle))
end)
运行结果:
$ ./skynet examples/config testalias [:0100000a] LAUNCH snlua testalias [:0100000a] localname .testalias handle nil #skynet.localname查到本地名 [:0100000a] localname testalias handle nil #skynet.localname查不到全局名 [:0100000a] queryname .testalias handle nil #harbor.queryname查到本地名 #harbor.queryname查不到全局名, 函数阻塞
5.3.3 多节点中的全局别名
启动两个skynet节点,在节点1取别名,节点2查询别名:
节点1,testaliasname.lua
local skynet = require "skynet"
require "skynet.manager"
local harbor = require "skynet.harbor"
skynet.start(function()
local handle = skynet.newservice("test")
skynet.name(".testalias", handle) --给服务起一个本地别名
skynet.name("testalias", handle) --给服务起一个全局别名
end)
节点2, testaliasquery.lua
local skynet = require "skynet"
require "skynet.manager"
local harbor = require "skynet.harbor"
skynet.start(function()
handle = skynet.localname(".testalias")
skynet.error("localname .testalias handle", skynet.address(handle))
handle = skynet.localname("testalias")
skynet.error("localname testalias handle", skynet.address(handle))
handle = harbor.queryname(".testalias")
skynet.error("queryname .testalias handle", skynet.address(handle))
handle = harbor.queryname("testalias")
skynet.error("queryname testalias handle", skynet.address(handle))
end)
先启动节点1运行testaliasname.lua,再启动节点2运行
testaliasquery
[:0200000a] LAUNCH snlua testaliasquery
[:0200000a] localname .testalias handle nil
[:0200000a] localname testalias handle nil
[:0200000a] queryname .testalias handle nil
[:0200000a] queryname testalias handle :0100000b --查询到节点1创建的服务
5.3.4 杀死带别名的服务
给一个服务取了别名后,杀死它,本地别名将会注销掉,但是全局别名依然存在,通过全局别名查询到的handle已经没有意义。如果通过handle进行一些操作将得到不可预知的问题。
local skynet = require "skynet"
require "skynet.manager"
local harbor = require "skynet.harbor"
skynet.start(function()
local handle = skynet.newservice("test")
skynet.name(".testalias", handle) --给服务起一个本地别名
skynet.name("testalias", handle) --给服务起一个全局别名
handle = skynet.localname(".testalias")
skynet.error("localname .testalias handle", skynet.address(handle))
handle = skynet.localname("testalias")
skynet.error("localname testalias handle", skynet.address(handle))
handle = harbor.queryname(".testalias")
skynet.error("queryname .testalias handle", skynet.address(handle))
handle = harbor.queryname("testalias")
skynet.error("queryname testalias handle", skynet.address(handle))
skynet.kill(handle) --杀死带别名服务
handle = skynet.localname(".testalias")
skynet.error("localname .testalias handle", skynet.address(handle))
handle = skynet.localname("testalias")
skynet.error("localname testalias handle", skynet.address(handle))
handle = harbor.queryname(".testalias")
skynet.error("queryname .testalias handle", skynet.address(handle))
handle = harbor.queryname("testalias")
skynet.error("queryname testalias handle", skynet.address(handle))
end)
运行结果:
testalias [:0100000a] LAUNCH snlua testalias [:0100000b] LAUNCH snlua test [:0100000b] My new service [:0100000a] localname .testalias handle :0100000b [:0100000a] localname testalias handle nil [:0100000a] queryname .testalias handle :0100000b [:0100000a] queryname testalias handle :0100000b [:0100000a] KILL :100000b [:0100000a] localname .testalias handle nil [:0100000a] localname testalias handle nil [:0100000a] queryname .testalias handle nil [:0100000a] queryname testalias handle :0100000b #全局别名还存在,但是已经杀死该服务了。
skynet的全局别名服务是在cslave里面实现的,现在不允许二次修改全局别名绑定关系,所以全局别名一般用来给一个永远不会退出的服务来启用。
但是有些情况下,我们确实需要二次修改全局别名绑定关系,那么这个时候,我们可以尝试去修改一下cslave.lua
文件,修改内容如下:
function harbor.REGISTER(fd, name, handle)
--assert(globalname[name] == nil) --将这一行注释掉
globalname[name] = handle
response_name(name)
socket.write(fd, pack_package("R", name, handle))
skynet.redirect(harbor_service, handle, "harbor", 0, "N " .. name)
end
运行一个二次修改全局别名绑定关系的服务,例如:
local skynet = require "skynet"
require "skynet.manager"
local harbor = require "skynet.harbor"
skynet.start(function()
local handle = skynet.newservice("test")
skynet.name("testalias", handle) --给服务起一个全局别名
handle = harbor.queryname("testalias")
skynet.error("queryname testalias handle", skynet.address(handle))
skynet.kill(handle) --杀死带全局别名服务
handle = skynet.newservice("test")
skynet.name("testalias", handle) --全局别名给其他服务使用
handle = harbor.queryname("testalias")
skynet.error("queryname testalias handle", skynet.address(handle))
end)
运行结果:
testalias [:0100000a] LAUNCH snlua testalias [:0100000b] LAUNCH snlua test [:0100000b] My new service [:0100000a] queryname testalias handle :0100000b [:0100000a] KILL :100000b [:0100000c] LAUNCH snlua test [:0100000c] My new service [:0100000a] queryname testalias handle :0100000c #服务别名二次修改成功
5.4 全局别名与全局唯一服名区别
全局唯一服名与这里的全局别名是两个概念的名词。
全局唯一服名称: 是用来标识服务是唯一的,服务名称一般就是脚本名称,无法更改。
全局别名: 是用来给服务起别名的,既可以给普通服起别名,也可以给全局唯一服起别名。
他们两种名字是在不同的体系中的,有各种的起名字的方式,以及查询的方式。
所以不要尝试用skynet.queryservice查询一个全局别名,也不要尝试使用harbor.queryname去查询一个全局唯一服。
例如:
local handle = skynet.uniqueservice("test") --启动一个全局唯一服,名字为test
handle = harbor.queryname("test") --查不到的,会一直阻塞
或者:
local handle = skynet.uniqueservice("test") --启动一个全局唯一服,名字为test
skynet.name("testalias", handle) --再起一个全局别名
handle = skynet.queryservice("testalias") --查不到的,也会一直阻塞