Protocol buffers是一個用來序列化結構化資料的技術,支援多種語言諸如C++、Java以及Python語言,可以使用該技術來
持久化資料或者序列化成網路傳輸的資料。相比較一些其他的XML技術而言,該技術的一個明顯特點就是更加節省空間的(以二
進位流儲存)、速度更快以及更加靈活。
建立Person.proto檔案
message Person {
optional int64 id=1;
optional string name=2;
optional string sex=3;
optional string tel=4;
}
Person 為定義一個訊息類型為Person
Person共有三個欄位
都為optional(可選的)
int64對應java的long
string對應java的String
在訊息定義中,每個欄位都有唯一的一個標識符,可以理解為索引,用於識別各個欄位
id=1,name=2,sex=3,tel=4,1,2,3,4並不是預設值
預設值可以這樣設定:optional int32 result_per_page = 3 [default = 10];
required:一個格式良好的訊息一定要含有1個這種欄位。表示該值是必須要設定的;
optional:訊息格式中該欄位可以有0個或1個值(不超過1個)
repeated:在一個格式良好的訊息中,這種欄位可以重複任意多次(包括0次)。重複的值的順序會被保留。表示該值可以重複,相當於java中的List
由於一些曆史原因,基本數實值型別的repeated的欄位並沒有被儘可能地高效編碼。在新的代碼中,使用者應該使用特殊選項[packed=true]來保證更高效的編碼
repeated int32 samples = 4 [packed=true];
下載:protoc-2.4.1-win32.zip用於產生java檔案
下載用戶端:protobuf-java-2.4.1.jar,使用者用戶端調用
可以講Person.proto放到你解壓的protoc-2.4.1-win32.zip裡面的protoc.exe同一級目錄
然後cmd cd到該目錄 執行protoc.exe --java_out=./ Person.proto,此時在這個目錄下回產生Person.java檔案
在java用戶端
序列化:
Person.Persona.Builder b = Person.Persona.newBuilder();
b.setId(i);
b.setName("ajun"+1);
b.setSex("男");
b.setTel("6086666");
Person.Persona p = b.build();
byte [] value = p.toByteArray()
還原序列化:
Person.Persona last = Person.Persona.parseFrom(person);
proto type --- java type
.proto類型 |
Java 類型 |
C++類型 |
備忘 |
double |
double |
double |
|
float |
float |
float |
|
int32 |
int |
int32 |
使用可變長編碼方式。編碼負數時不夠高效——如果你的欄位可能含有負數,那麼請使用sint32。 |
int64 |
long |
int64 |
使用可變長編碼方式。編碼負數時不夠高效——如果你的欄位可能含有負數,那麼請使用sint64。 |
uint32 |
int[1] |
uint32 |
Uses variable-length encoding. |
uint64 |
long[1] |
uint64 |
Uses variable-length encoding. |
sint32 |
int |
int32 |
使用可變長編碼方式。有符號的整型值。編碼時比通常的int32高效。 |
sint64 |
long |
int64 |
使用可變長編碼方式。有符號的整型值。編碼時比通常的int64高效。 |
fixed32 |
int[1] |
uint32 |
總是4個位元組。如果數值總是比總是比228大的話,這個類型會比uint32高效。 |
fixed64 |
long[1] |
uint64 |
總是8個位元組。如果數值總是比總是比256大的話,這個類型會比uint64高效。 |
sfixed32 |
int |
int32 |
總是4個位元組。 |
sfixed64 |
long |
int64 |
總是8個位元組。 |
bool |
boolean |
bool |
|
string |
String |
string |
一個字串必須是UTF-8編碼或者7-bit ASCII編碼的文本。 |
bytes |
ByteString |
string |
可能包含任意順序的位元組資料。 |