知识卡片
gRPC契约生成调用骨架
.proto 文件同时声明服务方法和请求、响应消息。原书的 HelloService.Say(HelloRequest) returns (HelloReply) 经代码生成后,客户端获得绑定 Channel 的调用 Stub,服务端获得待实现的服务基类;两端按同一契约理解方法和消息类型。[[Protobuf先定义消息契约]]侧重消息结构,这里补全服务方法与两端代码的关系。
原书示例:客户端构造 HelloRequest 并用 blocking Stub 调用 say;服务端实现 say 后通过 StreamObserver 交付回复。示例代码没有在本任务中运行。gRPC Java 生成代码文档可核对这些角色。
结构图: 类图仅展示原书 HelloWorld 示例中的生成类型与调用关系,省略生成器和运行时的其他类型。
classDiagram
class HelloServiceGrpc {
+newBlockingStub(Channel) HelloServiceBlockingStub
}
class HelloServiceBlockingStub {
+say(HelloRequest) HelloReply
}
class HelloServiceImplBase {
+say(HelloRequest, StreamObserver) void
}
class HelloServiceImpl {
+say(HelloRequest, StreamObserver) void
}
class HelloRequest
class HelloReply
HelloServiceGrpc ..> HelloServiceBlockingStub : 创建
HelloServiceImplBase <|-- HelloServiceImpl
HelloServiceBlockingStub ..> HelloRequest : 发送
HelloServiceImpl ..> HelloReply : 返回
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
原书出处
参考来源
- 位置:《115-RPC实战与核心原理》第07章《06|RPC实战:剖析gRPC源码,动手实现一个完整的RPC》(源文件:`_epub-src/OEBPS/Text/07.html`)
- 结论依据:原书 `.proto`、客户端 `HelloServiceBlockingStub` 和服务端 `HelloServiceImpl` 示例共同展示服务/消息契约及生成代码的两端角色;官方 gRPC Java 文档核验生成 Stub 和服务基类的关系。
- 原始内容:有了这段代码,我们就可以为客户端和服务器端生成消息对象和 RPC 基础代码。我们可以利用 Protocol Buffer 的编译器 protoc,再配合 gRPC Java 插件(protoc-gen-grpc-java)