ProtoBuf中service使用

在 Protocol Buffers 的 proto3 语法中,service 用于定义一个 gRPC 服务。一个 service 包含了一组可以远程调用的 RPC 方法,每个方法有请求类型和响应类型。

基本语法

protobuf 复制代码
syntax = "proto3";

service ServiceName {
    rpc MethodName(RequestType) returns (ResponseType);
}

// service ServiceName:定义服务的名称。
// rpc MethodName:定义 RPC 方法的名称。
// RequestType:请求消息类型。
// ResponseType:响应消息类型。

示例

下面是一个完整的proto3示例文件,定义了一个基于Chord的简单gRPC服务。

protobuf 复制代码
syntax = "proto3";

package protos;


// DHT Common RPCs

message Key {
    string key = 1;
}

message Pair {
    string key = 1;
    string value = 2;
}

message Result {
    string result = 1;
}

message Void {

}

message ControlRequest {
    string control = 1;
}

// Chord RPCs

message  FindSuccessorRequest {
    bytes id = 1;
}

message  Node {
    bytes id = 1;
    string addr = 2;
}

service Chord {
    rpc FindSuccessor (FindSuccessorRequest) returns (Node) {
    }

    rpc Notify (Node) returns (Result) {
    }

    rpc FindPredecessor (Node) returns (Node) {
    }

    rpc Ping (Node) returns (Void){
    }

}

带有流式的RPC的实例

proto3 还支持流式 RPC 方法,包括客户端流、服务端流和双向流:

protobuf 复制代码
syntax = "proto3";

package proto3;

// 请求消息类型
message StreamRequest {
    string data = 1;
}

// 响应消息类型
message StreamResponse {
    string data = 1;
}

// 定义一个带有流式 RPC 的 gRPC 服务
service Streamer {
    // 单向流,从客户端流向服务端
    rpc ClientStream (stream StreamRequest) returns (StreamResponse);
    
    // 单向流,从服务端流向客户端
    rpc ServerStream (StreamRequest) returns (stream StreamResponse);
    
    // 双向流,客户端和服务端都可以发送和接收流
    rpc BidirectionalStream (stream StreamRequest) returns (stream StreamResponse);
}

stream 关键字用于表示流式 RPC。

ClientStream 是客户端流式 RPC,客户端发送流数据,服务端返回单个响应。

ServerStream 是服务端流式 RPC,客户端发送单个请求,服务端返回流数据。

BidirectionalStream 是双向流式 RPC,客户端和服务端都可以发送和接收流数据。

最后给大家推荐一个LinuxC/C++高级架构系统教程的学习资源与课程,可以帮助你有方向、更细致地学习C/C++后端开发,具体内容请见 https://xxetb.xetslk.com/s/1o04uB

相关推荐
黑子Kuroko22 天前
【解决方案】微信小程序如何使用 ProtoBuf 进行 WebSocket 通信
前端·websocket·微信小程序·语音识别·protobuf·语音对话·arraybuff
bbqz0071 个月前
逆向WeChat(七)
数据库·c++·微信·逆向·protobuf·sqlcipher·破解密钥·解码protobuf·wechatdb
GDAL2 个月前
GeoPB: A Protobuf Solution for Efficient Geospatial Data Handling
javascript·protobuf·geopb
盒马盒马2 个月前
Protobuf:基本概念与使用流程
google·protobuf
小冰子X3 个月前
ProtoBuf 详解
c++·protobuf
小欧欧13 个月前
关于Protobuf在使用中的一些注意点
protobuf
看到我请叫我滚去学习Orz3 个月前
【Protobuf】Protobuf 语法介绍
c++·protobuf
czl3893 个月前
gRPC golang开发实践
golang·grpc·protobuf
AskHarries4 个月前
Spring Boot集成protobuf快速入门Demo
java·spring boot·后端·protobuf
技术大白4 个月前
使用fastdds替换原有协议为protobuf
c++·protobuf·fastdds