.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 : 返回