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
的文件具体内容如下:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 | // 指定使用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
文件中:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 | 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) } |
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】博客园社区专享云产品让利特惠,阿里云新客6.5折上折
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 一个奇形怪状的面试题:Bean中的CHM要不要加volatile?
· [.NET]调用本地 Deepseek 模型
· 一个费力不讨好的项目,让我损失了近一半的绩效!
· .NET Core 托管堆内存泄露/CPU异常的常见思路
· PostgreSQL 和 SQL Server 在统计信息维护中的关键差异
· DeepSeek “源神”启动!「GitHub 热点速览」
· 我与微信审核的“相爱相杀”看个人小程序副业
· 微软正式发布.NET 10 Preview 1:开启下一代开发框架新篇章
· 如何使用 Uni-app 实现视频聊天(源码,支持安卓、iOS)
· C# 集成 DeepSeek 模型实现 AI 私有化(本地部署与 API 调用教程)