Protocol Buffers（簡稱protobuf）是谷歌的一項技術，用於將結構化的資料序列化、反序列化，經常用於網路傳輸。

這貨實際上類似於XML生成和解析，但protobuf的效率高於XML，不過protobuf生成的是位元組碼，可讀性比XML差。類似的還有json、Java的Serializable等。

protobuf支援各種語言。本文以Java為例，簡單介紹protobuf如何使用。其他語言使用方法類似。

首先需要下載：

----------------------------------------------------------------------------------

選擇對應的版本下載

----------------------------------------------------------------------------------

解壓後有兩個檔案：protobuf-java-2.5.0.jar和protoc.exe。

protobuf-java-2.5.0.jar即protobuf所需要的jar包，如果用maven的話可以無視這個檔案；

protoc.exe是protobuf程式碼生成工具。

第一步：定義資料結構

首先要定義protobuf的資料結構，這裡要寫一個.proto檔案。這個檔案有點類似於定義一個類。例如定義一個Person，儲存檔案PersonMsg.proto（注意檔名和裡面的message名不要一樣）。

1. message Person {  
2.     // ID（必需）  
3.     required int32 id = 1;  
4.     // 姓名（必需）  
5.     required string name = 2;  
6.     // email（可選）  
7.     optional string email = 3;  
8.     // 朋友（集合）  
9.     repeated string friends = 4;  
10. }  

上面的例子中定義了一個非常簡單的資料結構，當然還可以定義更復雜的結構，這裡不再討論，具體可以看官方文件。

第二步：protoc.exe生成Java程式碼

使用檔案protoc.exe，cmd命令列執行：

protoc.exe --java_out=E:\java PersonMsg.proto

輸入檔案是PersonMsg.proto，也就是定義資料結構的檔案；輸出資料夾是E:\java，將java檔案生成在E:\java中。執行命令成功後會生成PersonMsg.java：

在Eclipse中建立一個專案，將java檔案拷貝到專案中。專案中需要引入protobuf-java-2.5.0.jar包。如果是maven專案則加入：

1. <dependency>
2.     <groupId>com.google.protobuf</groupId>
3.     <artifactId>protobuf-java</artifactId>
4.     <version>2.5.0</version>
5. </dependency>

一般來說，序列化和反序列化是分開的。例如網路傳輸，由一方將資料序列化後傳送給另一方來接收並解析，序列化傳送和接收反序列化並不在一起。但是下面為了例子簡單將二者寫在同一程式中。

1. import java.io.ByteArrayInputStream;  
2. import java.io.ByteArrayOutputStream;  
3. import java.io.IOException;  
4. import java.util.List;  
5. publicclass Main {  
6.     publicstaticvoid main(String[] args) throws IOException {  
7.         // 按照定義的資料結構，建立一個Person
8.         PersonMsg.Person.Builder personBuilder = PersonMsg.Person.newBuilder();  
9.         personBuilder.setId(1);  
10.         personBuilder.setName("叉叉哥");  
11.         personBuilder.setEmail("[email protected]");  
12.         personBuilder.addFriends("Friend A");  
13.         personBuilder.addFriends("Friend B");  
14.         PersonMsg.Person xxg = personBuilder.build();  
15.         // 將資料寫到輸出流，如網路輸出流，這裡就用ByteArrayOutputStream來代替
16.         ByteArrayOutputStream output = new ByteArrayOutputStream();  
17.         xxg.writeTo(output);  
18.         // -------------- 分割線：上面是傳送方，將資料序列化後傳送 ---------------
19.         byte[] byteArray = output.toByteArray();  
20.         // -------------- 分割線：下面是接收方，將資料接收後反序列化 ---------------
21.         // 接收到流並讀取，如網路輸入流，這裡用ByteArrayInputStream來代替
22.         ByteArrayInputStream input = new ByteArrayInputStream(byteArray);  
23.         // 反序列化
24.         PersonMsg.Person xxg2 = PersonMsg.Person.parseFrom(input);  
25.         System.out.println("ID:" + xxg2.getId());  
26.         System.out.println("name:" + xxg2.getName());  
27.         System.out.println("email:" + xxg2.getEmail());  
28.         System.out.println("friend:");  
29.         List<String> friends = xxg2.getFriendsList();  
30.         for(String friend : friends) {  
31.             System.out.println(friend);  
32.         }  
33.     }  
34. }