知识卡片

结构图卡 · 470.b.1.a.1.e

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 : 返回
这张卡片看不懂?

已有反馈 · 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)