知识卡片
接口定义生成两侧存根
RPC 的服务定义可作为客户端与服务端共同的契约。书中 gRPC 示例先用 Protocol Buffers 文件定义服务、方法和消息,再生成两侧可用的 Stub:服务端实现生成的服务基类,客户端通过生成的 Stub 构造请求并调用方法。这样参数与返回值形式来自同一份定义,减少手写两套接口造成的偏差。契约变更仍需要双方重新生成、部署并核对兼容性;生成代码本身不会保证运行中的服务版本一致。
结构图:
类图中的“客户端Stub”为原文未给出具体类名的示意节点;.proto 是生成输入,不是代码类型。
classDiagram
class HelloServiceGrpc
class HelloServiceImplBase {
+say(HelloRequest, StreamObserver~HelloResponse~)
}
class HelloServiceImpl {
+say(HelloRequest, StreamObserver~HelloResponse~)
}
class 客户端Stub {
+say(HelloRequest)
}
class HelloClient
HelloServiceImplBase <|-- HelloServiceImpl
HelloServiceGrpc ..> HelloServiceImplBase : 包含生成基类
HelloServiceGrpc ..> 客户端Stub : 创建
HelloClient --> 客户端Stub : 调用
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
原书出处
参考来源
- 位置:《架构探险:轻量级微服务架构(下册)》第16章《4.2 使用RPC实现同步调用》(源文件:_epub-src/OEBPS/Text/part0009_split_002.html)
- 结论依据:原文说明 `.proto` 定义服务/消息并生成 Stub,接着服务端实现生成基类,客户端依据同一 API 构造 Stub 与请求;部署兼容性是该生成链路的实践边界。
- 原始内容:我们在grpc-hello-api项目中编写的hello.proto文件是一份服务定义描述,通过调用Maven来执行gRPC命令,从而生成Stub代码库,在这份Stub代码库中拥有一套API接口,我们可在服务端中实现该接口,从而完成接口的相关实现。