python消息机制（python Protobuf定义消息类型）

本文教程操作环境：windows7系统             、Python 3.9.1             ，DELL G3电脑             。

让我们从一个非常简单的例子开始 
 
  
 
  
 
  
 
  
 
  
 
  
 。假设您想要定义“搜索请求  
  
  
  
  
  
  ”的消息格式












。每个请求包含一个查询字符串 
 
  
 
  
 
  
 
  
 
  
 
  
 、您对查询结果感兴趣的页数以及每页上有多少个查询结果
  
  
  
  
  
  
 。

可以采用如下的方式来定义消息类型的.proto文件了：

syntax="proto3";//声明使用proto3语法 messageSearchRequest{ stringquery=1;//每个字段都要指定数据类型 int32page_number=2;//这里的数字2是标识符 
 
  
 
  
 
  
 
  
 
  
 
  
 ，最小的标识号可以从1开始












，到2^29-1,or536,870,911 
  
  
  
  
  
  。不可以使用其中的[19000－19999] int32result_per_page=3;//这里是注释
  
  
  
  
  
  
 ，使用// }

（1）第一行指定了你正在使用 proto3 语法：如果不指定 
  
  
  
  
  
  ，编译器会使用 proto2 


 


 


 


 


 


 

。这个指定语法必须是文件的非空非注释的第一行
 
 
 
 
 
 
。

（2）SearchRequest消息格式有三个字段 


 


 


 


 


 


 

，在消息中承载的数据分别对应于每一个字段  
   
   
   
   
   
   。其中每个字段都有一个名字和一种类型 

 

 

 

 

 

 
。

（3）向.proto文件添加注释
 
 
 
 
 
 
，可以使用C/C++/java风格的双斜杠(//) 语法格式

 

 

 

 

 

 

。

（4）在消息体中  
   
   
   
   
   
   ，每个字段都有唯一的一个数字标识符             。这些标识符用来在消息的二进制格式中识别各个字段 

 

 

 

 

 

 
，一旦开始使用就不能再改变 
 

 
 

 
 

 
 

 
 

 
 

 
 。