gRPC-Lua 项目使用教程

1. 项目的目录结构及介绍

grpc-lua/
├── CMakeLists.txt
├── LICENSE
├── README.md
├── examples/
│   ├── CMakeLists.txt
│   ├── greeter_client.lua
│   ├── greeter_server.lua
│   └── protos/
│       └── helloworld.proto
├── grpc/
│   ├── CMakeLists.txt
│   ├── grpc.lua
│   ├── grpc_base.lua
│   ├── grpc_client.lua
│   ├── grpc_server.lua
│   └── protos/
│       └── helloworld_pb.lua
├── protos/
│   └── helloworld.proto
└── third_party/
    └── lua-protobuf/
        ├── LICENSE
        ├── README.md
        ├── lua/
        │   └── pb.lua
        └── protoc-gen-lua

目录结构说明

• CMakeLists.txt: 项目的主构建文件。
• LICENSE: 项目的许可证文件。
• README.md: 项目的说明文档。
• examples/: 包含示例代码的目录。
  • greeter_client.lua: 示例客户端代码。
  • greeter_server.lua: 示例服务器代码。
  • protos/: 示例协议文件目录。
    • helloworld.proto: 示例协议文件。
• grpc/: 包含 gRPC 核心库的目录。
  • grpc.lua: gRPC 主库文件。
  • grpc_base.lua: gRPC 基础库文件。
  • grpc_client.lua: gRPC 客户端库文件。
  • grpc_server.lua: gRPC 服务器库文件。
  • protos/: gRPC 协议文件目录。
    • helloworld_pb.lua: 生成的协议文件。
• protos/: 协议文件目录。
  • helloworld.proto: 协议文件。
• third_party/: 第三方依赖目录。
  • lua-protobuf/: Lua 协议缓冲库。
    • pb.lua: 协议缓冲库文件。
    • protoc-gen-lua: 协议缓冲编译器插件。

2. 项目的启动文件介绍

示例服务器启动文件

文件路径: examples/greeter_server.lua

local grpc = require "grpc"
local pb = require "pb"
local protoc = require "protoc"

-- 加载协议文件
protoc:loadfile("protos/helloworld.proto")

-- 创建 gRPC 服务器
local server = grpc.server()

-- 注册服务
server:add_service("helloworld.Greeter", {
    SayHello = function(req, resp)
        resp.message = "Hello " .. req.name
        return grpc.STATUS_OK
    end
})

-- 启动服务器
server:start("0.0.0.0:50051")

示例客户端启动文件

文件路径: examples/greeter_client.lua

local grpc = require "grpc"
local pb = require "pb"
local protoc = require "protoc"

-- 加载协议文件
protoc:loadfile("protos/helloworld.proto")

-- 创建 gRPC 客户端
local client = grpc.client("localhost:50051")

-- 调用服务
local req = { name = "world" }
local resp = client:call("helloworld.Greeter", "SayHello", req)

-- 输出响应
print(resp.message)

3. 项目的配置文件介绍

gRPC-Lua 项目本身没有独立的配置文件，配置主要通过代码进行。例如，服务器的启动地址和端口在 server:start("0.0.0.0:50051") 中指定，客户端的连接地址在 grpc.client("localhost:50051") 中指定。

如果需要更复杂的配置，可以在代码中进行相应的调整和扩展。