Android:Google出品的序列化神器Protocol Buffer使用攻略
前言
- 習慣用
Json、XML
資料儲存格式的你們,相信大多都沒聽過Protocol Buffer
Protocol Buffer
其實 是Google
出品的一種輕量 & 高效的結構化資料儲存格式,效能比Json、XML
真的強!太!多!
由於
Google
出品,我相信Protocol Buffer
已經具備足夠的吸引力- 今天,我將詳細介紹
Protocol Buffer
在Android
平臺 的具體使用
閱讀本文前請先閱讀:快來看看Google出品的Protocol Buffer,別隻會用Json和XML了
目錄
1. 定義
Protocol Buffer
目前有兩個版本:proto2
和proto3
- 因為
proto3
還是beta 版,所以本次講解是proto2
2. 作用
通過將 結構化的資料 進行 序列化(**序列化**),從而實現 **資料儲存 / RPC 資料交換**的功能
- 序列化: 將 資料結構或物件 轉換成 二進位制串 的過程
- 反序列化:將在序列化過程中所生成的二進位制串 轉換成 資料結構或者物件 的過程
3. 特點
- 對比於 常見的
XML、Json
資料儲存格式,Protocol Buffer
有如下特點:
4. 應用場景
傳輸資料量大 & 網路環境不穩定 的資料儲存、RPC 資料交換 的需求場景
如 即時IM (QQ、微信)的需求場景
總結
在 傳輸資料量較大的需求場景下,Protocol Buffer
比XML、Json
更小、更快、使用 & 維護更簡單!
5. 使用流程
- 使用
Protocol Buffer
的流程如下:
- 今天主要講解
Protocol Buffer
在Android
平臺 的具體使用
6. 應用例項(Android平臺)
- 具體步驟如下:
步驟1:將生成的 程式碼檔案 放入到專案中
- 對於
Android(Java)平臺
,即將編譯.proto
檔案生成的Java
包檔案 整個複製到Android
專案中 - 放置路徑:
app/src/main/java的
資料夾裡
步驟2:在 Gradle
新增 Protocol Buffer
版本依賴
compile 'com.google.protobuf:protobuf-java:2.6.1'
// 注:protobuf-java的版本 一定要和 安裝protocobuffer的版本 一致
步驟3:具體在Android專案中使用
3.1 訊息物件類介紹
通過.proto檔案
轉換的 Java
原始碼 = Protocol Buffer
類 + 訊息物件類(含Builder
內部類)
訊息物件類 是
Protocol Buffer
類的內部類
由於最常用的都是 訊息物件類 和其內部類Builder
類 的方法&成員變數,所以此處主要講解這兩者。
3.1.1 訊息物件類(Message
類)
- 訊息物件類 類通過 二進位制陣列 寫 和 讀 訊息型別
- 使用方法包括:
<-- 方式1:直接序列化和反序列化 訊息 -->
protocolBuffer.toByteArray();
// 序列化訊息 並 返回一個包含它的原始位元組的位元組陣列
protocolBuffer.parseFrom(byte[] data);
// 從一個位元組陣列 反序列化(解析) 訊息
<-- 方式2:通過輸入/ 輸出流(如網路輸出流) 序列化和反序列化訊息 -->
protocolBuffer.writeTo(OutputStream output);
output.toByteArray();
// 將訊息寫入 輸出流 ,然後再 序列化訊息
protocolBuffer.parseFrom(InputStream input);
// 從一個 輸入流 讀取並 反序列化(解析)訊息
// 只含包含欄位的getters方法
// required string name = 1;
public boolean hasName();// 如果欄位被設定,則返回true
public java.lang.String getName();
// required int32 id = 2;
public boolean hasId();
public int getId();
// optional string email = 3;
public boolean hasEmail();
public String getEmail();
// repeated .tutorial.Person.PhoneNumber phone = 4;
// 重複(repeated)欄位有一些額外方法
public List<PhoneNumber> getPhoneList();
public int getPhoneCount();
// 列表大小的速記
// 作用:通過索引獲取和設定列表的特定元素的getters和setters
常用的如上,更多請看官方文件
3.1.2 Builder
類
作用:建立 訊息構造器 & 設定/ 獲取訊息物件的欄位值 & 建立 訊息類 例項
屬於 訊息物件類 的內部類
a. 建立 訊息構造器
Demo.Person.Builder person = Person.newBuilder();
b. 設定/ 獲取 訊息物件的欄位值 具體方法如下:
// 標準的JavaBeans風格:含getters和setters
// required string name = 1;
public boolean hasName();// 如果欄位被設定,則返回true
public java.lang.String getName();
public Builder setName(String value);
public Builder clearName(); // 將欄位設定回它的空狀態
// required int32 id = 2;
public boolean hasId();
public int getId();
public Builder setId(int value);
public Builder clearId();
// optional string email = 3;
public boolean hasEmail();
public String getEmail();
public Builder setEmail(String value);
public Builder clearEmail();
// repeated .tutorial.Person.PhoneNumber phone = 4;
// 重複(repeated)欄位有一些額外方法
public List<PhoneNumber> getPhoneList();
public int getPhoneCount();
// 列表大小的速記
// 作用:通過索引獲取和設定列表的特定元素的getters和setters
public PhoneNumber getPhone(int index);
public Builder setPhone(int index, PhoneNumber value);
public Builder addPhone(PhoneNumber value);
// 將新元素新增到列表的末尾
public Builder addAllPhone(Iterable<PhoneNumber> value);
// 將一個裝滿元素的整個容器新增到列表中
public Builder clearPhone();
public Builder isInitialized()
// 檢查所有 required 欄位 是否都已經被設定
public Builder toString() :
// 返回一個人類可讀的訊息表示(用於除錯)
public Builder mergeFrom(Message other)
// 將 其他內容 合併到這個訊息中,覆寫單數的欄位,附接重複的。
public Builder clear()
// 清空所有的元素為空狀態。
3.2 具體使用
使用步驟如下:
步驟1:通過 訊息類的內部類Builder
類 構造 訊息構造器
步驟2:通過 訊息構造器 設定 訊息欄位的值
步驟3:通過 訊息構造器 建立 訊息類 物件
步驟4:序列化 / 反序列化 訊息具體使用如下:(註釋非常清晰)
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// 步驟1:通過 訊息類的內部類Builder類 構造 訊息類的訊息構造器
Demo.Person.Builder personBuilder = Demo.Person.newBuilder();
// 步驟2:設定你想要設定的欄位為你選擇的值
personBuilder.setName("Carson");// 在定義.proto檔案時,該欄位的欄位修飾符是required,所以必須賦值
personBuilder.setId(123);// 在定義.proto檔案時,該欄位的欄位修飾符是required,所以必須賦值
personBuilder.setEmail("[email protected]"); // 在定義.proto檔案時,該欄位的欄位修飾符是optional,所以可賦值 / 不賦值(不賦值時將使用預設值)
Demo.Person.PhoneNumber.Builder phoneNumber = Demo.Person.PhoneNumber.newBuilder();
phoneNumber.setType( Demo.Person.PhoneType.HOME);// 直接採用列舉型別裡的值進行賦值
phoneNumber.setNumber("0157-23443276");
// PhoneNumber訊息是巢狀在Person訊息裡,可以理解為內部類
// 所以建立物件時要通過外部類來建立
// 步驟3:通過 訊息構造器 建立 訊息類 物件
Demo.Person person = personBuilder.build();
// 步驟4:序列化和反序列化訊息(兩種方式)
/*方式1:直接 序列化 和 反序列化 訊息 */
// a.序列化
byte[] byteArray1 = person.toByteArray();
// 把 person訊息類物件 序列化為 byte[]位元組陣列
System.out.println(Arrays.toString(byteArray1));
// 檢視序列化後的位元組流
// b.反序列化
try {
Demo.Person person_Request = Demo.Person.parseFrom(byteArray1);
// 當接收到位元組陣列byte[] 反序列化為 person訊息類物件
System.out.println(person_Request.getName());
System.out.println(person_Request.getId());
System.out.println(person_Request.getEmail());
// 輸出反序列化後的訊息
} catch (IOException e) {
e.printStackTrace();
}
/*方式2:通過輸入/ 輸出流(如網路輸出流) 序列化和反序列化訊息 */
// a.序列化
ByteArrayOutputStream output = new ByteArrayOutputStream();
try {
person.writeTo(output);
// 將訊息序列化 並寫入 輸出流(此處用 ByteArrayOutputStream 代替)
} catch (IOException e) {
e.printStackTrace();
}
byte[] byteArray = output.toByteArray();
// 通過 輸出流 轉化成二進位制位元組流
// b. 反序列化
ByteArrayInputStream input = new ByteArrayInputStream(byteArray);
// 通過 輸入流 接收訊息流(此處用 ByteArrayInputStream 代替)
try {
Demo.Person person_Request = Demo.Person.parseFrom(input);
// 通過輸入流 反序列化 訊息
System.out.println(person_Request.getName());
System.out.println(person_Request.getId());
System.out.println(person_Request.getEmail());
// 輸出訊息
} catch (IOException e) {
e.printStackTrace();
}
}
}
Demo 地址
高階功能
貼心的Google還提供將
Protocol Buff
編碼方式 轉化為 其他編碼方式,如Json
、XML
等等即將
Protocol Buff
物件 轉化為其他編碼方式的資料儲存物件下面展示的是 將
Protocol Buff
物件 轉化為Json
物件
// 步驟1:在Gradle加入依賴
compile 'com.googlecode.protobuf-java-format:protobuf-java-format:1.4'
// 步驟2:將`Protocol Buff` 物件 序列化 為 `Json`物件
JsonFormat jsonFormat = new JsonFormat();
String person2json = jsonFormat.printToString(mProtoBuffer);
至此, 關於Protocol Buffer
的使用講解完畢。
7. 總結
請幫頂 / 評論點贊!因為你的鼓勵是我寫作的最大動力!
相關推薦
Android:Google出品的序列化神器Protocol Buffer使用攻略
前言 習慣用 Json、XML 資料儲存格式的你們,相信大多都沒聽過Protocol Buffer Protocol Buffer 其實 是 Google出品的一種輕量 & 高效的結構化資料儲存格式,效能比 Json、XML 真的強!太!多!
Android 進階6:兩種序列化方式 Serializable 和 Parcelable
什麼是序列化 我們總是說著或者聽說著“序列化”,它的定義是什麼呢? 序列化 (Serialization)將物件的狀態資訊轉換為可以儲存或傳輸的形式的過程。在序列化期間,物件將其當前狀態寫入到臨時或永續性儲存區。以後,可以通過從儲存區中讀取或反序列化物
Android:關於專案元件化/模組化的設計
隨著技術越來越成熟,這兩年,元件化開發與外掛化開發的熱度一度高漲。對於元件化,有的人也喜歡稱之為模組化開發,我也比較喜歡稱之為模組化開發。使用模組化開發也已經有一段時間了,特此總結一下模組化開發的心得,防止以後忘記。 什麼是模組化開發 對於模組化開發的概念,有的人可
Atitit 程式設計 序列化技術點 概念原理v2 1. 序列化: 1 2. 序列化的目的 1 2.1. 為了傳輸 或者儲存 1 3. 應用場合 1 3.1. Form提交url 1 3.2. For
Atitit 程式設計 序列化技術點 概念原理v2 1. 序列化: 1 2. 序列化的目的 1 2.1. 為了傳輸 或者儲存 1 3. 應用場合 1 3.1. Form提交url 1 3.2. Form提交為 json物件,適合後端物件解析 1
Rest Framework:二、序列化元件
一、序列化元件 序列化元件的使用 -Serializer -1 重新命名:用source:xx = serializers.Ch
Android:關於專案模組化的設計
隨著技術越來越成熟,這兩年,元件化開發與外掛化開發的熱度一度高漲。對於元件化,有的人也喜歡稱之為模組化開發,我也比較喜歡稱之為模組化開發。使用模組化開發也已經有一段時間了,特此總結一下模組化開發的心得,防止以後忘記。 什麼是模組化開發 對於模組化開發的概念,
新手學python(3):yield與序列化
1 Yield生成器 Yield是我在其他語言中沒有見過的一個屬性,算是python的一大特色,用好之後可以使程式碼更簡潔。考慮一個簡單的例子,檔案的遍歷。要遍歷一個目錄下的所有檔案需要遞迴的操作。如果我們只是單純的列印檔名,我們可以在遞迴的過程中完成,每當發
關於android傳遞物件Parcelable序列化的問題
package com.example.parceldemo; import java.util.ArrayList; import java.util.List; import android.app.Activity; import android.content.Intent; import an
完全理解Gson(3):Gson反序列化
本文延續前一篇文章,繼續介紹簡單基本的Gson用法。這篇文章我們將介紹如何將複雜的JSON物件解析為Java物件,其中Java物件的結構可以與JSON物件不一致。我們還會看到如何使用Gson反序列化器(JsonDeserializer Java文件)將JSON物件對映
android java.io.NotSerializableException序列化異常
今天被這個異常坑了好幾個小時。首先把我的需求說下。。今天要開發一個底部Tabbar。但是Tabbar的資料和數量都是在服務端傳過來,然後我們在通過資料繪製Tabbar, 繪製完後需要把這段資訊儲存序列化儲存在本地。以免下次網路不好的時候,我們而已直接在本地拿資料來繪製T
MFC介面程式設計基礎(17):文件序列化
上一篇:MFC介面程式設計基礎(16):文件、檢視、框架 下一篇:MFC介面程式設計基礎(18):文件檢視結構應用程式例子(Ex_DocView) 序列化定義 MFC文件-檢視結構中,序列化機制可以實現記憶體中
JavaScript:表單序列化後的資料轉換成json格式
表單序列化可以比較方便的拿到form表單中的資料,但是序列化後的資料是一段url字串.這邊利用方法轉化成json資料格式: var DataDeal = { //將從form中通過
排坑:kotlin物件序列化過程引數丟失
問題現象與背景: 這個bug出現在引入kotlin程式碼的過程中。我們的專案採用的是spring boot框架,為前端提供業務介面。通過周密調研,我們計劃在一個子模組中應用kotlin來進行業務開發。springboot與kotlin的結合方式不再本文累述。 開發過程中發
Android中兩種序列化方式的比較Serializable和Parcelable
Serializable和Parcelable介面可以完成物件的序列化過程, 序列化 (Serialization)將物件的狀態資訊轉換為可以儲存或傳輸的形式的過程。在序列化期間,物件將其當前狀態寫入到臨時或永續性儲存區。以後,可以通過從儲存區中讀取或反序列化物件的狀態
應用程式框架設計(3):RuntimeClass與序列化
#define __typeid(Class) (&Class::x_theRuntimeClass)#define DECLARE_CLASS(Class) const SRuntimeClass *Class::GetRuntimeClass() const; staticconst
Android 實現Parcelable介面序列化物件
關於物件序列化的方法,在Android中常用到的一般有兩種,一種是可以通過實現Serializable介面,這也是java語言中常用的序列化方法,別外一種就是實現Parcelable介面,這是android所特有的。這兩個介面,實現Serializab
(二)遠端服務:Java 物件序列化和反序列化
在遠端方法呼叫 RMI 學習的過程中,涉及到一個概念,序列化,本文進行詳述。 Java 物件的序列化和反序列化 的兩種應用場景 有時候需要將 Java 物件儲存永久儲存,比如儲存到檔
幹貨:微信營銷引流方法全攻略
同時 線下 網站發布 有一個 nag 消費 ffffff 分享圖片 傳統 很多人問我有沒有快速加粉絲的方法,經過幾天的總結整理,整理出如下多種微信營銷免費快速加粉秘籍,希望對大家有幫助,請切記,無論那一種方法只要你執行力好都會起到很好的效果。方法不在於多,而在於極致,一定要
學大偉業:資訊學競賽如何學習及準備攻略!
參加資訊學競賽的考生,需要具備五大學習能力,第一是觀察、分析問題的能力;二是數學建模的能力;三是靈活運用演算法的能力;四是編寫程式碼並且除錯的能力;五是檢測程式是否正確的能力。 除此之外,除錯能力比程式設計能力更重要。很多學生之所以參加資訊學競賽但拿不了獎,很大部分原因就在於除錯環節出了
小米4 Android 6.0 版本 Root 並安裝 Xposed 框架攻略
本人自 Android 開發入坑一週年以來,向來對Root裝置不太感冒。我對Root的裝置的態度和對蘋果的越獄差不多。大學期間有個舍友越獄了自己的 iPhone,據說從此可以下載許多的收費應用和遊戲,所以越獄給我的映像就是破解軟體的收費限制,Root也差不多