protobuf初识
文章引用自
protobuf初识
protobuf是一种高效的数据格式,平台无关、语言无关、可扩展,可用于 RPC 系统和持续数据存储系统。
protobuf
protobuf介绍
Protobuf
是Protocol Buffer
的简称,它是Google公司于2008年开源的一种高效的平台无关、语言无关、可扩展的数据格式,目前Protobuf作为接口规范的描述语言,可以作为Go语言RPC接口的基础工具。
protobuf使用
protobuf
是一个与语言无关的一个数据协议,所以我们需要先编写IDL文件然后借助专用工具生成指定语言的代码,从而实现数据的序列化与反序列化过程。
大致开发流程如下: 1. IDL编写 2. 生成指定语言的代码 3. 序列化和反序列化
protobuf语法
编译器安装
ptotoc
protobuf
协议编译器是用c++编写的,根据自己的操作系统下载对应版本的protoc
编译器:https://github.com/protocolbuffers/protobuf/releases,解压后拷贝到GOPATH/bin
目录下。
protoc-gen-go
安装生成Go语言代码的工具
go get -u github.com/golang/protobuf/protoc-gen-go
.proto Type | Notes | C++ Type | Java Type | Python Type[2] | Go Type | Ruby Type | C# Type | PHP Type |
---|---|---|---|---|---|---|---|---|
double | double | double | float | float64 | Float | double | float | |
float | float | float | float | float32 | Float | float | float | |
int32 | 使用变长编码,对于负值的效率很低,如果你的域有可能有负值,请使用sint64替代 | int32 | int | int | int32 | Fixnum 或者 Bignum(根据需要) | int | integer |
uint32 | 使用变长编码 | uint32 | int | int/long | uint32 | Fixnum 或者 Bignum(根据需要) | uint | integer |
uint64 | 使用变长编码 | uint64 | long | int/long | uint64 | Bignum | ulong | integer/string |
sint32 | 使用变长编码,这些编码在负值时比int32高效的多 | int32 | int | int | int32 | Fixnum 或者 Bignum(根据需要) | int | integer |
sint64 | 使用变长编码,有符号的整型值。编码时比通常的int64高效。 | int64 | long | int/long | int64 | Bignum | long | integer/string |
fixed32 | 总是4个字节,如果数值总是比总是比228大的话,这个类型会比uint32高效。 | uint32 | int | int | uint32 | Fixnum 或者 Bignum(根据需要) | uint | integer |
fixed64 | 总是8个字节,如果数值总是比总是比256大的话,这个类型会比uint64高效。 | uint64 | long | int/long | uint64 | Bignum | ulong | integer/string |
sfixed32 | 总是4个字节 | int32 | int | int | int32 | Fixnum 或者 Bignum(根据需要) | int | integer |
sfixed64 | 总是8个字节 | int64 | long | int/long | int64 | Bignum | long | integer/string |
bool | bool | boolean | bool | bool | TrueClass/FalseClass | bool | boolean | |
string | 一个字符串必须是UTF-8编码或者7-bit ASCII编码的文本。 | string | String | str/unicode | string | String (UTF-8) | string | string |
bytes | 可能包含任意顺序的字节数据。 | string | ByteString | str | []byte | String (ASCII-8BIT) | ByteString | string |
编写IDL代码
在protobuf_demo/address
目录下新建一个名为person.proto
的文件具体内容如下:
// 指定使用protobuf版本 // 此处使用v3版本 syntax = "proto3"; // 包名,通过protoc生成go文件 package address; // 性别类型 // 枚举类型第一个字段必须为0 enum GenderType { SECRET = 0; FEMALE = 1; MALE = 2; } // 人 message Person { int64 id = 1; string name = 2; GenderType gender = 3; string number = 4; } // 联系簿 message ContactBook { repeated Person persons = 1;// repeater 表示字段可重复 转为go则为切片 }// 指定使用protobuf版本
生成go语言代码
在protobuf_demo/address
目录下执行以下命令。
address $ protoc --go_out=. ./person.proto
此时在当前目录下会生成一个person.pb.go
文件,我们的Go语言代码里就是使用这个文件。 在protobuf_demo/main.go
文件中:
package main import ( "fmt" "io/ioutil" "github.com/golang/protobuf/proto" "github.com/Q1mi/studygo/code_demo/protobuf_demo/address" ) // protobuf demo func main() { var cb address.ContactBook p1 := address.Person{ Name: "小王子", Gender: address.GenderType_MALE, Number: "7878778", } fmt.Println(p1) cb.Persons = append(cb.Persons, &p1) // 序列化 data, err := proto.Marshal(&p1) if err != nil { fmt.Printf("marshal failed,err:%v\n", err) return } ioutil.WriteFile("./proto.dat", data, 0644) data2, err := ioutil.ReadFile("./proto.dat") if err != nil { fmt.Printf("read file failed, err:%v\n", err) return } var p2 address.Person proto.Unmarshal(data2, &p2) fmt.Println(p2) }
Songzhibin