python Protobuf定義消息類型知識點講解

讓我們從一個非常簡單的例子開始。假設您想要定義“搜索請求”的消息格式。每個請求包含一個查詢字符串、您對查詢結果感興趣的頁數以及每頁上有多少個查詢結果。

可以采用如下的方式來定義消息類型的.proto文件瞭:

syntax = "proto3"; // 聲明使用 proto3 語法
message SearchRequest {
string query = 1; // 每個字段都要指定數據類型
int32 page_number = 2; // 這裡的數字2 是標識符,最小的標識號可以從1開始,最大到2^29 - 1, or 536,870,911。不可以使用其中的[19000-19999]
int32 result_per_page = 3; // 這裡是註釋,使用 //
}

(1)第一行指定瞭你正在使用 proto3 語法:如果不指定,編譯器會使用 proto2。這個指定語法必須是文件的非空非註釋的第一行。

(2)SearchRequest消息格式有三個字段,在消息中承載的數據分別對應於每一個字段。其中每個字段都有一個名字和一種類型。

(3)向.proto文件添加註釋,可以使用C/C++/java風格的雙斜杠(//) 語法格式。

(4)在消息體中,每個字段都有唯一的一個數字標識符。這些標識符用來在消息的二進制格式中識別各個字段,一旦開始使用就不能再改變。

知識點擴展:

Protobuf 不是一個自描述的協議,序列化後的二進制消息中應該沒有必要的類型信息。所以采取往消息體中增加額外信息的方式來輔助確定消息類型。

  1. 使用枚舉MsgType定義消息類型,每種消息對應一種消息類型
  2. 所有的消息都有一個消息類型字段,註意此字段的編號保持確定
  3. 定義輔助消息BaseMsg,隻包含一個消息類型字段,用於輔助反序列化

到此這篇關於python Protobuf定義消息類型知識點講解的文章就介紹到這瞭,更多相關python Protobuf定義消息類型內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet!

推薦閱讀: