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