讓我們從一個(gè)非常簡(jiǎn)單的例子開始。假設(shè)您想要定義“搜索請(qǐng)求”的消息格式。每個(gè)請(qǐng)求包含一個(gè)查詢字符串、您對(duì)查詢結(jié)果感興趣的頁數(shù)以及每頁上有多少個(gè)查詢結(jié)果。
可以采用如下的方式來定義消息類型的.proto文件了:
syntax = "proto3"; // 聲明使用 proto3 語法
message SearchRequest {
string query = 1; // 每個(gè)字段都要指定數(shù)據(jù)類型
int32 page_number = 2; // 這里的數(shù)字2 是標(biāo)識(shí)符,最小的標(biāo)識(shí)號(hào)可以從1開始,最大到2^29 - 1, or 536,870,911。不可以使用其中的[19000-19999]
int32 result_per_page = 3; // 這里是注釋,使用 //
}
(1)第一行指定了你正在使用 proto3 語法:如果不指定,編譯器會(huì)使用 proto2。這個(gè)指定語法必須是文件的非空非注釋的第一行。
(2)SearchRequest消息格式有三個(gè)字段,在消息中承載的數(shù)據(jù)分別對(duì)應(yīng)于每一個(gè)字段。其中每個(gè)字段都有一個(gè)名字和一種類型。
(3)向.proto文件添加注釋,可以使用C/C++/java風(fēng)格的雙斜杠(//) 語法格式。
(4)在消息體中,每個(gè)字段都有唯一的一個(gè)數(shù)字標(biāo)識(shí)符。這些標(biāo)識(shí)符用來在消息的二進(jìn)制格式中識(shí)別各個(gè)字段,一旦開始使用就不能再改變。
知識(shí)點(diǎn)擴(kuò)展:
Protobuf 不是一個(gè)自描述的協(xié)議,序列化后的二進(jìn)制消息中應(yīng)該沒有必要的類型信息。所以采取往消息體中增加額外信息的方式來輔助確定消息類型。
- 使用枚舉MsgType定義消息類型,每種消息對(duì)應(yīng)一種消息類型
- 所有的消息都有一個(gè)消息類型字段,注意此字段的編號(hào)保持確定
- 定義輔助消息BaseMsg,只包含一個(gè)消息類型字段,用于輔助反序列化
到此這篇關(guān)于python Protobuf定義消息類型知識(shí)點(diǎn)講解的文章就介紹到這了,更多相關(guān)python Protobuf定義消息類型內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
您可能感興趣的文章:- Python使用protobuf序列化和反序列化的實(shí)現(xiàn)
- python開發(fā)一個(gè)解析protobuf文件的簡(jiǎn)單編譯器
- 如何在mac環(huán)境中用python處理protobuf
- python如何通過protobuf實(shí)現(xiàn)rpc
- python使用protobufde的過程解析