Google Protocol Buffer搭建及示例 - 推酷

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);