gRPC — Four Stream Types

Speed:

Ready — Click play to start the demo

gRPC runs on HTTP/2, so beyond plain unary RPC it supports three streaming RPC patterns. The four modes differ only in how many request/response messages each side sends.

Unary · 一元gRPC

💻Client请求×1

🖥Server响应×1

一次请求 → 一次响应。等价于普通函数调用，最常见的 RPC 形态。

Server Streaming · 服务端流gRPC

💻Client请求×1

🖥Server响应×3

一个请求 → 多条响应流。适合订阅推送、大结果集分页。

Client Streaming · 客户端流gRPC

💻Client请求×3

🖥Server响应×1

多条请求流 → 一条响应。适合文件上传、批量上报。

Bidi Streaming · 双向流gRPC

💻Client请求×3

🖥Server响应×3

请求流 ↔ 响应流并发，双向全双工。适合聊天、实时协作。

四种模式对照：区别只在「请求/响应的数量」组合。proto 里对应 rpc Foo(A) returns (B) 四种签名：Unary、returns (stream B)、(stream A)、(stream A) returns (stream B)。