完成一次 RPC 调用

完成一次 RPC 调用

1. 生成 Demo 项目

使用安装好的 dubbogo-cli 工具,创建 demo 工程。

创建并切换目录

$ mkdir quickstart && cd quickstart

使用 dubbogo-cli 工具创建新项目

$ dubbogo-cli newDemo .

查看项目结构

$ tree .
.
├── api
│   ├── samples_api.pb.go
│   ├── samples_api.proto
│   └── samples_api_triple.pb.go
├── go-client
│   ├── cmd
│   │   └── client.go
│   └── conf
│       └── dubbogo.yaml
├── go-server
│   ├── cmd
│   │   └── server.go
│   └── conf
│       └── dubbogo.yaml
└── go.mod

可看到生成的项目中包含一个 client 项目和一个 server 项目,以及相关的配置文件。

1.1 查看接口描述文件 sample_api.proto

syntax = "proto3";
package api;

option go_package = "./;api";

// The greeting service definition.
service Greeter {
  // Sends a greeting
  rpc SayHello (HelloRequest) returns (User) {}
  // Sends a greeting via stream
  rpc SayHelloStream (stream HelloRequest) returns (stream User) {}
}

// The request message containing the user's name.
message HelloRequest {
  string name = 1;
}

// The response message containing the greetings
message User {
  string name = 1;
  string id = 2;
  int32 age = 3;
}

demo 项目中,默认生成了一个接口描述文件,接口服务名为 api.Greeter, 包含两个 RPC 方法,入参为 HelloRequest,返回值为 User,两个方法分别为普通 RPC 方法和 Streaming 类型 RPC 方法。

1.2 编译接口 (可选)

使用安装好的编译工具编译 pb 接口。

$ cd api
$ protoc --go_out=. --go-triple_out=. ./samples_api.proto

参数意义:--go_out=. 使用上述安装的 protoc-gen-go 插件,生成文件到当前目录,--go-triple_out=. 使用上述安装的 protoc-gen-go-triple 插件,生成文件到当前目录。

执行该指令后,会生成两个文件,分别是 sample_api.pb (包含 proto 结构) 和 sample_api_triple.pb.go (包含 triple 协议接口)。

在 demo 工程中,预先生成好了这两个文件,修改 .proto 文件后重新执行命令生成,即可覆盖。

2. 开启一次 RPC 调用

项目根目录执行

$ go mod tidy

拉取到最新的框架依赖(其中 Go SDK 版本和 module 名以个人机器配置为准):

module helloworld

go 1.21.1

require (
	dubbo.apache.org/dubbo-go/v3 v3.1.0
	github.com/dubbogo/gost v1.14.0
	github.com/dubbogo/grpc-go v1.42.10
	github.com/dubbogo/triple v1.2.2-rc3
	google.golang.org/protobuf v1.31.0
)

require (
	...
)

最后修改 October 8, 2023: fix: fix website error (#2829) (907f477a0b)