返回主题:RPC框架调用链与机制

知识卡片

结构图卡 · 2850.e.1.a

接口定义生成两侧存根

理解等级:中级

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接口,我们可在服务端中实现该接口,从而完成接口的相关实现。