grpc服务的定义和服务的种类

目录

服务的定义

服务的种类

---

服务的定义

与许多RPC系统一样，gRPC基于定义服务、指定可以通过其参数和返回类型远程调用的方法的思想。默认情况下，gRPC使用protocol buffers作为接口定义语言(IDL)来描述服务接口和有效负载消息的结构。如果需要，也可以使用其他替代方案。

服务的种类

gRPC允许你定义四种服务方法:

一元rpc，客户端向服务器发送单个请求并得到单个响应，就像普通的函数调用一样。

rpc SayHello(HelloRequest) returns (HelloResponse);

服务器流的rpc，客户端向服务器发送请求并获取一个流来读取返回的消息序列。客户端从返回的流中读取消息，直到没有更多的消息为止。gRPC保证单个RPC调用中的消息顺序。

rpc LotsOfReplies(HelloRequest) returns (stream HelloResponse);

客户端流rpc，客户端写入一系列消息并将它们发送到服务器，同样使用提供的流。一旦客户机完成了消息的编写，它就等待服务器读取消息并返回响应。同样，gRPC保证了单独RPC调用中的消息顺序。

rpc LotsOfGreetings(stream HelloRequest) returns (HelloResponse);

双向流rpc，其中双方使用读写流发送消息序列。两个流独立运作,因此客户端和服务器可以读和写在他们喜欢的任何顺序:例如,服务器可以等待收到所有客户端消息之前写的反应,也可以交替阅读一条消息然后写一个消息,或其他一些读写的结合。每个流中的消息顺序被保留。

rpc BidiHello(stream HelloRequest) returns (stream HelloResponse);