Protocol Buffer(簡稱Protobuf或PB)是由Google推出的一種數據交換格式,與傳統的XML和JSON不同的是,它是一種二進制格式,免去了文本格式轉換的各種困擾,并且轉換效率也是非常快,由于它的跨平臺、跨編程語言的特點,讓它越來越普及,尤其是網絡數據交換方面日趨成為一種主流.
PB目前托管在GitHub,鏈接地址:https://github.com/google/protobuf,源碼的主要功能可以分為兩部分:
PB基礎庫:完成對象->數據的序列化、數據->對象的反序列化這兩個轉換過程的支持;
PB編譯器:源碼生成器,將PB格式定義文件.proto(PB數據格式的一種定義文件)轉換為對象源碼(支持C++,JAVA,Python等格式).
截止目前PB的最新版本為3.0.0-beta-1(alpha-4),已經加入了對Objective-C的支持(其它之前低版本中也已經有OC擴展支持),以下的示例便以該版本為例.
###1.編譯源碼,生成PB編譯器###
編譯源碼主要的目的就是在本地生成PB的編譯器,下載好protobuf-objectivec-3.0.0-alpha-4.tar.gz文件,執行以下的命令進行編譯:
tar -xzvf protobuf-objectivec-3.0.0-alpha-4.tar.gz
cd protobuf-3.0.0-alpha-4
./configure
make
make check
sudo make install
如果編譯順利的話,便可以使用protoc命令了,以后便可以用這個命令將.proto文件轉換為不同語言的源代碼文件.
###2.為工程添加PB依賴庫###
需要在項目中使用ProtocolBuffer,需要將依賴庫添加到項目中來,剛才下載的源碼objectivec目錄中已經包含一個可編譯libProtocolBuffers.a靜態庫的工程,直接引入工程即可,當然ProtocolBuffer項目也支持cocoapods的方式引入,在你的Podfile中添加:
platform :ios, '7.1'
pod "Protobuf", "~> 3.0.0-alpha-4"
###3.使用PB編譯器編譯.proto文件###
為了驗證我們的ProtocolBuffer環境已經搭建好了,以下就來小試牛刀,創建類似以下的test.proto文件:
message Person
{
required string name = 1; //姓名
required int32 sex = 2;? //性別
required int32 age = 3;? //年齡
}
然后通過以下的命令生成生成Model的源代碼文件:
protoc --objc_out=./ ./test.proto
在當前目錄便可以看到Test.pbobjc.h和Test.pbobjc.m這兩個文件了(需要注意的是生成的代碼是MRC的,如果引入ARC工程中記得添加-fno-objc-arc的標簽).
###4.在項目中使用PB完成序列化&反序列化###
將上個步驟中生成的源代碼添加到工程之中,你就可以直接使用他們了,使用起來非常的方便,示例如下:
// 創建對象
Person *person = [Person new];
person.name = @"TanHao";
person.sex = 1;
person.age = 28;
// 序列化為Data
NSData *data = [person data];
// 反序列化為對象
Person *person2 = [Person parseFromData:data error:NULL];
NSLog(@"name:%@ sex:%d age:%d",person2.name,person2.sex,person2.age);