lua-cmsgpack是一個開源的MessagePack實現(xiàn)方式、純C的庫,沒有任何其它依賴,編譯后可以直接被lua調(diào)用,目前主要支持Lua 5.1/5.2/5.3 版本。
1、什么是MessagePack?
官方的解釋是:
It's like JSON.
but fast and small.
跟JSON及其類似,但是比JSON更快并且占用空間更小,舉個官方給出的例子,直接截官方圖:
翻譯官方的解釋:
MessagePack是一種高效的二進(jìn)制序列化格式, 它允許在多種語言(如JSON)之間交換數(shù)據(jù),但它越來越小, 小整數(shù)被編碼為單個字節(jié),典型的短字符串除了字符串本身之外還需要一個額外的字節(jié)。
目前市面上流行的開發(fā)語言MessagePack幾乎支持,官方的地址為:http://msgpack.org/Lua MessagePack也提供了一套開源庫,地址在:https://github.com/fperrad/lua-MessagePack/。
但是,作者使用的是lua-cmsgpack,至于哪個比較優(yōu)異,作者還沒有去比較,主要是先發(fā)現(xiàn)了lua-cmsgpack,后面看了下README文件,使用方法應(yīng)該是差不多的,大家可以拿來參考。
2、編譯lua-cmsgpack
lua-cmsgpack包括官方提供的lua-MessagePack都需要自行編譯,因為可能平臺太多,所以官方?jīng)]有為每一個平臺提供編譯好的版本。lua-cmsgpack的github地址為:https://github.com/antirez/lua-cmsgpack
git clone下來之后需要安裝cmake工具,mac平臺直接在項目目錄:
cmake .
make
即可,當(dāng)然需要預(yù)先安裝lua,并且是5.1版本以上的。
主要說下CentOS平臺下cmake可能會出現(xiàn)的問題,如果cmake的過程出現(xiàn)以下錯誤:
Could NOT find Lua51 (missing: LUA_INCLUDE_DIR)
...
CMake Error at CMakeLists.txt:1 (cmake_minimum_required):
CMake 2.8 or higher is required. You are running version 2.6.4
Configuring incomplete, errors occurred!
出現(xiàn)以上錯誤的話,需要自行安裝lua的一些依賴庫,一般:
yum -y install lua lua-devel
就可以了,如果還不行,再試試下面的命令:
yum install ncurses-devel gcc gcc-c++ make
編譯完成之后會生成cmsgpack.so文件,使用的時候直接require進(jìn)去即可
3、lua調(diào)用例子
1 local cmsgpack = require "cmsgpack"
2
3 local tba = {1, 2, 3}
4
5 local tbb = {
6 a = 1,
7 b = 3
8 }
9
10 local msgpack = cmsgpack.pack(tba, tbb)
11
12 local res1, res2 = cmsgpack.unpack(msgpack)
13
14 for k, v in pairs(res1) do
15 print(k, v)
16 end
17
18 for i, v in pairs(res2) do
19 print(i, v)
20 end
運行效果:
#lua test_table.lua
1 1
2 2
3 3
a 1
b 3
cmsgpack.pack()可以把多個lua對象序列化成一個二進(jìn)制msgpack,執(zhí)行反序化的時候會返回對應(yīng)數(shù)量的lua對象,非常的方便。
4、結(jié)合redis存儲序列化后的msgpack
有趣的是redis也支持MessagePack,因此結(jié)合lua和lua-cmsgpack可以產(chǎn)生不錯的化學(xué)反應(yīng),下面是一個簡單的例子(結(jié)合OpenResty):
local cmsgpack = require "cmsgpack"
local redis = require "resty.redis"
local red = redis:new()
local ok, err = red:connect("127.0.0.1", 6379)
if not ok then
ngx.say("failed to connect: ", err)
return
end
local lua_table = {
a = 1,
b = 3
}
local msgpack = cmsgpack.pack(lua_table)
local ok, err = red:set("msg", msgpack)
if not ok then
ngx.say("failed to set dog: ", err)
return
end
local ret_pack = red:get("msg")
local ret_table = cmsgpack.unpack(ret_pack)
ngx.say(ret_table.a + ret_table.b)
測試返回結(jié)果:
4
在某些場合還是有不錯應(yīng)用場景的。