ProtoBuf: 是一套完整的 IDL(接口描述语言),出自Google,基于 C++ 进行的实现,开发人员可以根据 ProtoBuf 的语言规范生成多种编程语言(Golang、Python、Java 等)的接口代码,本篇只讲述 Golang 的基础操作。据说 ProtoBuf 所生成的二进制文件在存储效率上比 XML 高 3~10 倍,并且处理性能高 1~2 个数量级,这也是选择 ProtoBuf 作为序列化方案的一个重要因素之一。
安装:
- 安装 protoc :Protoc下载地址,可以根据自己的系统下载相应的 protoc,windows 用户统一下载 win32 版本。
- 配置 protoc 到系统的环境变量中,执行如下命令查看是否安装成功:
$ protoc --version
如果正常打印 libprotoc 的版本信息就表明 protoc 安装成功
- 安装 ProtoBuf 相关的 golang 依赖库
$ go get -u github.com/golang/protobuf/{protoc-gen-go,proto}
使用
-
创建 Demo golang工程
-
在 example 包中编写 person.proto
syntax = "proto3"; package example; message person { // aa 会生成 Aa 命名的结构体 int32 id = 1; string name = 2; } message all_person { // aa_bb 会生成 AaBb 的驼峰命名的结构体 repeated person Per = 1; }
进入 Demo 工程的 example 目录,使用 protoc 编译 person.proto
$ protoc --go_out=. person.proto
就会生成 person.pb.go 文件
- 在 golang 工程中使用 protobuf 进行序列化与反序列化
main.go:package main import ( "github.com/golang/protobuf/proto" "Demo/example" "log" ) func main() { // 为 AllPerson 填充数据 p1 := example.Person{ Id:*proto.Int32(1), Name:*proto.String("xieyanke"), } p2 := example.Person{ Id:2, Name:"gopher", } all_p := example.AllPerson{ Per:[]*example.Person{&p1, &p2}, } // 对数据进行序列化 data, err := proto.Marshal(&all_p) if err != nil { log.Fatalln("Mashal data error:", err) } // 对已经序列化的数据进行反序列化 var target example.AllPerson err = proto.Unmarshal(data, &target) if err != nil{ log.Fatalln("UnMashal data error:", err) } println(target.Per[0].Name) // 打印第一个 person Name 的值进行反序列化验证 }