在 openresty 中使用 capnp lua 库

1. 安装必要的工具和库

bash 复制代码
apt-get install capnproto luarocks

luarocks install lua-capnproto
luarocks install lua-cjson

lua-cjson 库不是必须的,是由于后面的演示程序要使用,就一起装上了。

可以看下库的安装位置:

bash 复制代码
root@350983744ebf:~# luarocks show lua-capnproto

lua-capnproto 0.1.4-5 - Lua-capnproto is a pure lua implementation of capnproto based on LuaJIT.

Lua-capnproto is a pure lua implementation of capnproto based on LuaJIT.

License:        BSD
Homepage:       https://github.com/calio/lua-capnproto
Installed in:   /usr/local

Modules:
        capnp (/usr/local/share/lua/5.1/capnp.lua)
        capnp.compile (/usr/local/share/lua/5.1/capnp/compile.lua)
        capnp.util (/usr/local/share/lua/5.1/capnp/util.lua)
        handwritten_capnp (/usr/local/share/lua/5.1/handwritten_capnp.lua)
        handwritten_data_generator (/usr/local/share/lua/5.1/handwritten_data_generator.lua)
        random (/usr/local/share/lua/5.1/random.lua)
        schema_capnp (/usr/local/share/lua/5.1/schema_capnp.lua)
        test (/usr/local/share/lua/5.1/test.lua)
        tool (/usr/local/share/lua/5.1/tool.lua)

Depends on:
        lua ~> 5.1 (using 5.1-1)

默认库都是安装到了 /usr/local/share/lua/5.1/ 目录下。

2. 编译 capnp 文件

先将 openresty 自带的 luajit 程序目录加入 PATH 路径中:

bash 复制代码
export PATH=$PATH:/usr/local/openresty/luajit/bin

新建一个AddressBook.capnp 文件,内容如下:

@0xdbb9ad1f14bf0b36;  # unique file ID, generated by `capnp id`

struct Person {
  id @0 :UInt32;
  name @1 :Text;
  email @2 :Text;
  phones @3 :List(PhoneNumber);

  struct PhoneNumber {
    number @0 :Text;
    type @1 :Type;

    enum Type {
      mobile @0;
      home @1;
      work @2;
    }
  }

  employment :union {
    unemployed @4 :Void;
    employer @5 :Text;
    school @6 :Text;
    selfEmployed @7 :Void;
    # We assume that a person is only one of these.
  }
}

struct AddressBook {
  people @0 :List(Person);
}

然后编译 capnp 文件:

bash 复制代码
root@350983744ebf:~# capnp compile -olua AddressBook.capnp
root@350983744ebf:~# ls -lh
total 36K
-rw-r--r-- 1 root root  532 Oct 22 21:18 AddressBook.capnp
-rw-r--r-- 1 root root  21K Oct 22 21:20 AddressBook_capnp.lua

得到 AddressBook_capnp.lua 文件。

3. 写一个测试程序

新建一个目录,将 AddressBook_capnp.lua 文件放到这个目录。

bash 复制代码
root@350983744ebf:~# mkdir /usr/local/openresty/lua
root@350983744ebf:~# cd /usr/local/openresty/lua
root@350983744ebf:/usr/local/openresty/lua# cp /root/AddressBook_capnp.lua .

在这目录新建一个 lua 程序文件 main.lua,内容如下:

lua 复制代码
local addressBook = require "AddressBook_capnp"
local capnp = require "capnp"
local cjson = require "cjson"
local util = require "capnp.util"

local data = {
    people = {
        {
            id = 123,
            name = "Alice",
            email = "alice@example.com",
            phones = {
                {
                    number = "555-1212",
                    ["type"] = "MOBILE",
                },
            },
            employment = {
                school = "MIT",
            },
        },
        {
            id = 456,
            name = "Bob",
            email = "bob@example.com",
            phones = {
                {
                    number = "555-4567",
                    ["type"] = "HOME",
                },
                {
                    number = "555-7654",
                    ["type"] = "WORK",
                },
            },
            employment = {
                unemployed = "Void",
            },
        },
    }
}

local bin = addressBook.AddressBook.serialize(data)
local decoded = addressBook.AddressBook.parse(bin)

ngx.say(cjson.encode(decoded))

这个程序将一个 lua 数据【数据格式是按照 AddressBook.capnp 文件定义的】序列化成 capnp 二进制数据,然后将二进制数据反序列化成 lua 数据,最后使用 cjson 库将 lua 数据序列化成 json 格式,使用 nginx 输出。

4. 验证程序

修改 nginx 配置文件【 /usr/local/openresty/nginx/conf/nginx.conf】内容为:

worker_processes  1;

events {
    worker_connections  1024;
}

http {
    lua_package_path "/usr/local/openresty/lua/?.lua;;";
    
    server {
        listen       80;
        server_name  localhost;

        location /capnp {
            content_by_lua_file /usr/local/openresty/lua/main.lua;
        }
    }
}

启动 nginx 并验证结果:

root@350983744ebf:~# /usr/local/openresty/nginx/sbin/nginx        

root@350983744ebf:~# 
root@350983744ebf:~# curl 127.0.0.1/capnp
{"people":[{"phones":[{"number":"555-1212","type":"MOBILE"}],"id":123,"name":"Alice","employment":{"school":"MIT"},"email":"alice@example.com"},{"phones":[{"number":"555-4567","type":"HOME"},{"number":"555-7654","type":"WORK"}],"id":456,"name":"Bob","employment":{"unemployed":"Void"},"email":"bob@example.com"}]}

和预期相符。

相关推荐
red_redemption1 小时前
自由学习记录(23)
学习·unity·lua·ab包
善良的修罗3 小时前
postman 最强内置函数使用集合
测试工具·lua·postman
霍格沃兹测试开发学社测试人社区11 小时前
数据驱动与并行策略:用 JUnit 5 让软件测试更高效
软件测试·测试开发·junit
Dnelic-11 小时前
【单元测试】【Android】JUnit 4 和 JUnit 5 的差异记录
android·junit·单元测试·android studio·自学笔记
霍格沃兹测试开发学社测试人社区11 小时前
软件测试丨探索 JUnit 5 中的参数化与调度执行:提升软件测试的效率与灵活性
软件测试·测试开发·junit
Dnelic-1 天前
解决 Android 单元测试 No tests found for given includes:
android·junit·单元测试·问题记录·自学笔记
unix2linux1 天前
YOLO v5 Series - Image & Video Storage ( Openresty + Lua)
yolo·lua·openresty
最后一个bug1 天前
如何理解Lua 使用虚拟堆栈
linux·c语言·开发语言·嵌入式硬件·lua
半夏知半秋3 天前
lua-lru缓存算法解析
笔记·学习·算法·缓存·lua
最后一个bug3 天前
C语言执行Lua进行错误处理
linux·服务器·c语言·开发语言·嵌入式硬件·lua