Google Protobuf安装与使用
google protobuf是一个灵活的、高效的用于序列化数据的协议。相比较XML和JSON格式,protobuf更小、更快、更便捷。google protobuf是跨语言的,并且自带了一个编译器(protoc),只需要用它进行编译,可以编译成Java、python、C++、C#、Go等代码,然后就可以直接使用,不需要再写其他代码,自带有解析的代码。更详细的介绍见: Protocol Buffers
protobuf安装
1、下载protobuf代码
2、安装protobuf
tar -xvf protobuf
cd protobuf
./configure --prefix=/usr/local/protobuf
make
make check
make install
至此安装完成^_^,下面是配置:
(1) vim /etc/profile,添加
.proto文件
.proto文件是protobuf一个重要的文件,它定义了需要序列化数据的结构。使用protobuf的3个步骤是:
1 在.proto文件中定义消息格式
2 用protobuf编译器编译.proto文件
3 用C++/Java等对应的protobuf API来写或者读消息
程序示例(C++版)
该程序示例的大致功能是,定义一个Persion结构体和存放Persion的AddressBook,然后一个写程序向一个文件写入该结构体信息,另一个程序从文件中读出该信息并打印到输出中。
1 address.proto文件
package tutorial; message Persion { required string name = 1; required int32 age = 2; } message AddressBook { repeated Persion persion = 1; }
编译.proto文件,执行命令: protoc -I=$SRC_DIR --cpp_out=$DST_DIR $SRC_DIR/addressbook.proto,示例中执行命令protoc --cpp_out=/tmp addressbook.proto ,会在/tmp中生成文件addressbook.pb.h和addressbook.pb.cc。
2 write.cpp文件,向文件中写入AddressBook信息,该文件是二进制的
1 #include <iostream> 2 #include <fstream> 3 #include <string> 4 #include "addressbook.pb.h" 5 6 using namespace std; 7 8 void PromptForAddress(tutorial::Persion *persion) { 9 cout << "Enter persion name:" << endl; 10 string name; 11 cin >> name; 12 persion->set_name(name); 13 14 int age; 15 cin >> age; 16 persion->set_age(age); 17 } 18 19 int main(int argc, char **argv) { 20 //GOOGLE_PROTOBUF_VERIFY_VERSION; 21 22 if (argc != 2) { 23 cerr << "Usage: " << argv[0] << " ADDRESS_BOOL_FILE" << endl; 24 return -1; 25 } 26 27 tutorial::AddressBook address_book; 28 29 { 30 fstream input(argv[1], ios::in | ios::binary); 31 if (!input) { 32 cout << argv[1] << ": File not found. Creating a new file." << endl; 33 } 34 else if (!address_book.ParseFromIstream(&input)) { 35 cerr << "Filed to parse address book." << endl; 36 return -1; 37 } 38 } 39 40 // Add an address 41 PromptForAddress(address_book.add_persion()); 42 43 { 44 fstream output(argv[1], ios::out | ios::trunc | ios::binary); 45 if (!address_book.SerializeToOstream(&output)) { 46 cerr << "Failed to write address book." << endl; 47 return -1; 48 } 49 } 50 51 // Optional: Delete all global objects allocated by libprotobuf. 52 //google::protobuf::ShutdownProtobufLibrary(); 53 54 return 0; 55 }
编译write.cpp文件,g++ addressbook.pb.cc write.cpp -o write `pkg-config --cflags --libs protobuf` (注意,这里的`符号在键盘数字1键左边,也就是和~是同一个按键)。
3 read.cpp文件,从文件中读出AddressBook信息并打印
1 #include <iostream> 2 #include <fstream> 3 #include <string> 4 #include "addressbook.pb.h" 5 6 using namespace std; 7 8 void ListPeople(const tutorial::AddressBook& address_book) { 9 for (int i = 0; i < address_book.persion_size(); i++) { 10 const tutorial::Persion& persion = address_book.persion(i); 11 12 cout << persion.name() << " " << persion.age() << endl; 13 } 14 } 15 16 int main(int argc, char **argv) { 17 //GOOGLE_PROTOBUF_VERIFY_VERSION; 18 19 if (argc != 2) { 20 cerr << "Usage: " << argv[0] << " ADDRESS_BOOL_FILE" << endl; 21 return -1; 22 } 23 24 tutorial::AddressBook address_book; 25 26 { 27 fstream input(argv[1], ios::in | ios::binary); 28 if (!address_book.ParseFromIstream(&input)) { 29 cerr << "Filed to parse address book." << endl; 30 return -1; 31 } 32 input.close(); 33 } 34 35 ListPeople(address_book); 36 37 // Optional: Delete all global objects allocated by libprotobuf. 38 //google::protobuf::ShutdownProtobufLibrary(); 39 40 return 0; 41 }
编译read.cpp文件,g++ addressbook.pb.cc read.cpp -o read `pkg-config --cflags --libs protobuf`
4 执行程序