查看: 220|回复: 0

微服务—gRPC之Protobuf语法

[复制链接]

NoiseFloor

发表于 2022-7-13 18:29 | 显示全部楼层 |阅读模式

1. Protobuf语法

1.1.1. 基本规范

message SongServerRequest { required string song_name = 1; }

enum Foo { FIRST_VALUE = 1; SECOND_VALUE = 2; }

1.1.2. 字段规则

.proto	C++	Java	Python	Go	Ruby	C#
double	double	double	float	float64	Float	double
float	float	float	float	float32	Float	float
int32	int32	int	int	int32	Fixnum or Bignum	int
int64	int64	long	ing/long[3]	int64	Bignum	long
uint32	uint32	int[1]	int/long[3]	uint32	Fixnum or Bignum	uint
uint64	uint64	long[1]	int/long[3]	uint64	Bignum	ulong
sint32	int32	int	intj	int32	Fixnum or Bignum	int
sint64	int64	long	int/long[3]	int64	Bignum	long
fixed32	uint32	int[1]	int	uint32	Fixnum or Bignum	uint
fixed64	uint64	long[1]	int/long[3]	uint64	Bignum	ulong
sfixed32	int32	int	int	int32	Fixnum or Bignum	int
sfixed64	int64	long	int/long[3]	int64	Bignum	long
bool	bool	boolean	boolean	bool	TrueClass/FalseClass	bool
string	string	String	str/unicode[4]	string	String(UTF-8)	string
bytes	string	ByteString	str	[]byte	String(ASCII-8BIT)	ByteString

+ N 表示打包的字节并不是固定。而是根据数据的大小或者长度 + 关于 fixed32 和int32的区别。fixed32的打包效率比int32的效率高，但是使用的空间一般比int32多。因此一个属于时间效率高，一个属于空间效率高

1.1.3. service如何定义

service SearchService { rpc Search (SearchRequest) returns (SearchResponse) {} }

1.1.4. Message如何定义

syntax = "proto3"; message SearchRequest { string query = 1; // 查询字符串 int32 page_number = 2; // 页码 int32 result_per_page = 3; // 每页条数 }

1.1.5. 添加更多Message类型

syntax = "proto3"; // SearchRequest 搜索请求 message SearchRequest { string query = 1; // 查询字符串 int32 page_number = 2; // 页码 int32 result_per_page = 3; // 每页条数 } // SearchResponse 搜索响应 message SearchResponse { ... }1.1.6. 如何使用其他Message

message SearchResponse { repeated Result results = 1; } message Result { string url = 1; string title = 2; repeated string snippets = 3; }1.1.7. Message嵌套的使用

message SearchResponse { message Result { string url = 1; string title = 2; repeated string snippets = 3; } repeated Result results = 1; }

message Outer { // Level 0 message MiddleAA { // Level 1 message Inner { // Level 2 int64 ival = 1; bool booly = 2; } } message MiddleBB { // Level 1 message Inner { // Level 2 int32 ival = 1; bool booly = 2; } } } message Outer { // Level 0 message MiddleAA { // Level 1 message Inner { // Level 2 int64 ival = 1; bool booly = 2; } } message MiddleBB { // Level 1 message Inner { // Level 2 int32 ival = 1; bool booly = 2; } } }1.1.8. proto3的Map类型

map<key_type, value_type> map_field = N; message Project {...} map<string, Project> projects = 1;

1.1.9. .proto文件编译

1.1.10. import导入定义

1.1.11. 包的使用

syntax = "proto3";package foo.bar;message Open {...}

message Foo { ... foo.bar.Open open = 1; ...}

https://huchao.blog.csdn.net/article/details/124220802?spm=1001.2014.3001.5502

使用道具举报