技术标签: 分布式缓存实现 python rpc golang GO语言
Protobuf是一种由Google开发的二进制序列化数据格式,它可以用于在不同的计算机系统之间传输结构化数据。有很多其他的数据交换格式,比如JSON、XML等,那么Protobuf与他们相比有什么好处呢?主要体现在下面几点:
本文将介绍如何在Go中使用Protobuf,包括安装、如何定义Protobuf消息、生成Go代码、序列化和反序列化消息、在网络中使用Protobuf以及版本控制和兼容性。
安装 Protocol Buffers(protobuf)可以分为两个部分:
protoc 编译器可以 将.proto 文件编译成多种编程语言的代码,例如 C++、Java、Python、Go 等,是protobuf的核心组件。
可以从 Protocol Buffers 的 GitHub 上找到最新的编译器版本:https://github.com/protocolbuffers/protobuf/releases
在下载页面中找到合适的系统的版本下载随后将bin目录添加到环境变量即可。
以下以Windows x64为例。
PATH
环境变量中。protoc --version
,如果输出版本,说明安装成功。接下来还需要安装 Go 的 protobuf 库。这个库可以使用protoc编译器生成GO代码,可以使用以下命令完成安装:
go get -u github.com/golang/protobuf/protoc-gen-go
注意,protoc-gen-go 将自动安装到 $GOPATH/bin
目录下,也需要将这个目录加入到环境变量中。
消息类型定义在.proto
包中,我们这里创建个person.proto 文件
,将以下的经典的示例写法写入:
syntax = "proto3";
option go_package = "/person";
package example;
message Person {
string name = 1;
int32 age = 2;
repeated string hobbies = 3;
}
syntax = "proto3"
:用于指定.proto
文件的版本,这里使用的是 Protocol Buffers 3 版本。package example:指定消息类型所在的包名,这里包名是
example`。option go_package = "/person";
用于指定生成的 Go 代码的包名(package name)及导入路径(import path)。message Person { ... }
:定义一个名为 Person
的消息类型。string name = 1
:定义一个名为 name
的字符串类型字段,该字段的标签号为 1
。int32 age = 2
:定义一个名为 age
的整型字段,该字段的标签号为 2
。repeated string hobbies = 3
:定义一个名为 hobbies
的字符串数组类型字段,该字段的标签号为 3
。repeated
关键字表示该字段是一个数组类型。这个.proto
文件中定义了一个名为 Person
的消息类型,包含了 name
、age
和 hobbies
三个字段。name
和 age
都是普通的单值类型字段,hobbies
是一个字符串数组类型字段。在这个文件中,每个字段都有一个唯一的标签号,用于标识这个字段在二进制编码中的位置和类型。
在此文件的目录下,运行protoc --go_out=. *.proto
命令,即可生成GO代码。
运行后,我们可以看到该目录下多出了一个person文件夹,里面包含 Go 文件 person.pb.go
。这个文件内部定义了一个结构体 Person,以及相关的方法:
type Person struct {
state protoimpl.MessageState
sizeCache protoimpl.SizeCache
unknownFields protoimpl.UnknownFields
Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
Age int32 `protobuf:"varint,2,opt,name=age,proto3" json:"age,omitempty"`
Hobbies []string `protobuf:"bytes,3,rep,name=hobbies,proto3" json:"hobbies,omitempty"`
}
除了结构体外,还有很多方法,这些方法提供了对 Protocol Buffers 消息进行编码、解码和操作的基础设施,有以下几个主要的方法。
func (*Person) Reset()
: 将 Person
消息重置为默认值。func (*Person) String() string
: 返回一个字符串,包含 Person
消息的文本表示形式。func (*Person) ProtoMessage()
: 使 Person
结构体实现 proto.Message
接口,这是在序列化和反序列化 Protobuf 消息时所需的。func (*Person) Descriptor() ([]byte, []int)
: 返回关于 Person
消息类型的描述符信息。func (*Person) GetName() string
: 返回 Person
消息中 Name
字段的值。func (*Person) GetAge() int32
: 返回 Person
消息中 Age
字段的值。写一个简单的测试吧!
func main() {
p:=&person.Person{Name: "yzy",Age: 23,Hobbies: []string{"music","sport"}}
fmt.Println("string",p.String())
fmt.Println("the data:",p.Name,p.Age,p.Hobbies)
fmt.Println("-----------")
fmt.Println("reset the person")
fmt.Println("-----------")
p.Reset()
fmt.Println("string",p.String())
fmt.Println("the data:",p.Name,p.Age,p.Hobbies)
}
运行后可以看到,get、string、reset都正常运行。
序列化和反序列化函数在github.com/golang/protobuf/proto
包中,这个包刚刚我们已经通过go get获取过了,所以可以直接使用,以下是一个序列化和非序列化的使用示例,并且比较了序列化前和经过序列化后的数据是否一致。
func TestPersonSerialization(t *testing.T) {
// 创建一个 Person 消息实例并设置其字段
p:=&Person{Name: "yzy",Age: 23,Hobbies: []string{"music","sport"}}
// 将消息序列化为二进制格式
data, err := proto.Marshal(p)
if err != nil {
t.Fatal("marshaling error: ", err)
}
// 反序列化消息
p2 := &Person{}
err = proto.Unmarshal(data, p2)
if err != nil {
t.Fatal("unmarshaling error: ", err)
}
// 比较原始消息和反序列化后的消息
if p.String()!=p2.String() {
t.Fatalf("original message %v != unmarshaled message %v", p, p2)
}
}
字段类型部分参考Go Protobuf 简明教程 .
proto类型 | go类型 | 备注 | proto类型 | go类型 | 备注 |
---|---|---|---|---|---|
double | float64 | float | float32 | ||
int32 | int32 | int64 | int64 | ||
uint32 | uint32 | uint64 | uint64 | ||
sint32 | int32 | 适合负数 | sint64 | int64 | 适合负数 |
fixed32 | uint32 | 固长编码,适合大于2^28的值 | fixed64 | uint64 | 固长编码,适合大于2^56的值 |
sfixed32 | int32 | 固长编码 | sfixed64 | int64 | 固长编码 |
bool | bool | string | string | UTF8 编码,长度不超过 2^32 | |
bytes | []byte | 任意字节序列,长度不超过 2^32 |
标量类型如果没有被赋值,则不会被序列化,解析时,会赋予默认值。
枚举类型适用于提供一组预定义的值,选择其中一个。例如我们将性别定义为枚举类型。
message Student {
string name = 1;
enum Gender {
FEMALE = 0;
MALE = 1;
}
Gender gender = 2;
repeated int32 scores = 3;
}
allow_alias
选项。message EnumAllowAlias {
enum Status {
option allow_alias = true;
UNKOWN = 0;
STARTED = 1;
RUNNING = 1;
}
}
Result
是另一个消息类型,在 SearchReponse 作为一个消息字段类型使用。
message SearchResponse {
repeated Result results = 1;
}
message Result {
string url = 1;
string title = 2;
repeated string snippets = 3;
}
嵌套写也是支持的:
message SearchResponse {
message Result {
string url = 1;
string title = 2;
repeated string snippets = 3;
}
repeated Result results = 1;
}
如果定义在其他文件中,可以导入其他消息类型来使用:
import "myproject/other_protos.proto";
Any 可以表示不在 .proto 中定义任意的内置类型。
import "google/protobuf/any.proto";
message ErrorStatus {
string message = 1;
repeated google.protobuf.Any details = 2;
}
message SampleMessage {
oneof test_oneof {
string name = 4;
SubMessage sub_message = 9;
}
}
message MapRequest {
map<string, int32> points = 1;
}
目前为止,就可以实现在服务端和客户端,通过同一个.proto文件生成.go文件,随后通过此.go文件,使用序列化后的二进制格式进行传输,并可进行数据的反序列化,比使用传统的json格式有更高的效率。
probuf还可以用于定义RPC的接口,往后的文章会对这一作用进行描述。
文章浏览阅读2w次,点赞7次,收藏51次。四个步骤1.创建C++ Win32项目动态库dll 2.在Win32项目动态库中添加 外部依赖项 lib头文件和lib库3.导出C接口4.c#调用c++动态库开始你的表演...①创建一个空白的解决方案,在解决方案中添加 Visual C++ , Win32 项目空白解决方案的创建:添加Visual C++ , Win32 项目这......_c#调用lib
文章浏览阅读4.6k次。苹方字体是苹果系统上的黑体,挺好看的。注重颜值的网站都会使用,例如知乎:font-family: -apple-system, BlinkMacSystemFont, Helvetica Neue, PingFang SC, Microsoft YaHei, Source Han Sans SC, Noto Sans CJK SC, W..._ubuntu pingfang
文章浏览阅读159次。表单表单概述表单标签表单域按钮控件demo表单标签表单标签基本语法结构<form action="处理数据程序的url地址“ method=”get|post“ name="表单名称”></form><!--action,当提交表单时,向何处发送表单中的数据,地址可以是相对地址也可以是绝对地址--><!--method将表单中的数据传送给服务器处理,get方式直接显示在url地址中,数据可以被缓存,且长度有限制;而post方式数据隐藏传输,_html表单的处理程序有那些
文章浏览阅读1.2k次。使用说明:开启Google的登陆二步验证(即Google Authenticator服务)后用户登陆时需要输入额外由手机客户端生成的一次性密码。实现Google Authenticator功能需要服务器端和客户端的支持。服务器端负责密钥的生成、验证一次性密码是否正确。客户端记录密钥后生成一次性密码。下载谷歌验证类库文件放到项目合适位置(我这边放在项目Vender下面)https://github.com/PHPGangsta/GoogleAuthenticatorPHP代码示例://引入谷_php otp 验证器
文章浏览阅读4.3k次,点赞5次,收藏11次。matplotlib.plot画图横坐标混乱及间隔处理_matplotlib更改横轴间距
文章浏览阅读2.2k次。①Storage driver 处理各镜像层及容器层的处理细节,实现了多层数据的堆叠,为用户 提供了多层数据合并后的统一视图②所有 Storage driver 都使用可堆叠图像层和写时复制(CoW)策略③docker info 命令可查看当系统上的 storage driver主要用于测试目的,不建议用于生成环境。_docker 保存容器
文章浏览阅读834次,点赞27次,收藏13次。网络拓扑结构是指计算机网络中各组件(如计算机、服务器、打印机、路由器、交换机等设备)及其连接线路在物理布局或逻辑构型上的排列形式。这种布局不仅描述了设备间的实际物理连接方式,也决定了数据在网络中流动的路径和方式。不同的网络拓扑结构影响着网络的性能、可靠性、可扩展性及管理维护的难易程度。_网络拓扑csdn
文章浏览阅读1.8k次,点赞5次,收藏8次。IOS系统Date的坑要创建一个指定时间的new Date对象时,通常的做法是:new Date("2020-09-21 11:11:00")这行代码在 PC 端和安卓端都是正常的,而在 iOS 端则会提示 Invalid Date 无效日期。在IOS年月日中间的横岗许换成斜杠,也就是new Date("2020/09/21 11:11:00")通常为了兼容IOS的这个坑,需要做一些额外的特殊处理,笔者在开发的时候经常会忘了兼容IOS系统。所以就想试着重写Date函数,一劳永逸,避免每次ne_date.prototype 将所有 ios
文章浏览阅读5.3k次。方法一:用PLSQL Developer工具。 1 在PLSQL Developer的sql window里输入select * from test for update; 2 按F8执行 3 打开锁, 再按一下加号. 鼠标点到第一列的列头,使全列成选中状态,然后粘贴,最后commit提交即可。(前提..._excel导入pl/sql
文章浏览阅读83次。Git常用命令速查手册1、初始化仓库git init2、将文件添加到仓库git add 文件名 # 将工作区的某个文件添加到暂存区 git add -u # 添加所有被tracked文件中被修改或删除的文件信息到暂存区,不处理untracked的文件git add -A # 添加所有被tracked文件中被修改或删除的文件信息到暂存区,包括untracked的文件...
文章浏览阅读202次。分享119个ASP.NET源码总有一个是你想要的_千博二手车源码v2023 build 1120
文章浏览阅读1.8k次。版权声明:转载请注明出处 http://blog.csdn.net/irean_lau。目录(?)[+]1、缺省构造函数。2、缺省拷贝构造函数。3、 缺省析构函数。4、缺省赋值运算符。5、缺省取址运算符。6、 缺省取址运算符 const。[cpp] view plain copy_空类默认产生哪些类成员函数