网站开发如何处理兼容性问题,建设网站的主要流程有哪些内容,廊坊视频优化效果,哪个市文化和旅游网站做的好一年前学过对应的知识#xff0c;终究是太潦草了#xff0c;这几天网上学习了一下#xff0c;重新写一下笔记。这里是protobuf和golang的结合
一、protobuf
protobuf实际上是一种类似json和gob之类的数据格式#xff0c;也是grpc的御用格式吧#xff08;有自己的优势终究是太潦草了这几天网上学习了一下重新写一下笔记。这里是protobuf和golang的结合
一、protobuf
protobuf实际上是一种类似json和gob之类的数据格式也是grpc的御用格式吧有自己的优势这里我就不写了其有着自己的定义方式结合对应的指令可以实现转化成对应语言的操作。
二、写一个复杂一点的例子
先把我写的例子整体粘过来然后再做具体的分析
syntaxproto3;//顶格声明protobuf版本默认是protobuf2
// 注意一下语句后面要加;否则不识别
package user;//定义一下protobuf的包名包名影响什么后续会写
import role.proto;//这里编辑器报错不用管应该是插件不能识别的问题
import parent.proto;
import google/protobuf/any.proto;//引入any类型
import google/protobuf/timestamp.proto;//引入时间戳类型
/*
import public some path
这个public关键词用于控制这个包的依赖是否可以传递例子如下a.proto:
import b.proto
import public c.protoindex.proto:
import a.proto
那么这个index文件当中除了能使用a文件中定义的变量还能使用c文件当中的遍历但是b文件就不能使用*/
option go_package../grpc;grpc;//规定生成文件的输出文件同时规定对应文件package的名称
//这里指定的 out_path 并不是绝对路径只是相对路径或者说只是路径的一部分和 protoc 的 --go_out 拼接后才是完整的路径。所以我的侧率就是不写go_out// 这边我们写一个User结构体
//结构体的名称我们采取的是官网上的格式注意和golang默认格式区分
// 具体的protobuf基础类型和对应语言之间对应表参见https://protobuf.dev/programming-guides/proto3/#specifying-field-rulesmessage TestUser{// 保留字段和保留数字,这个用法我不是很懂我看的资料显示如下/*如果一个字段不再需要如果删除或者注释掉则其他人在修改时会再次使用这些字段编号那么旧的引用程序就可能出现一些错误所以使用保留字段保留已弃用的字段编号或字段名 我个人觉得这应该涉及到可拓展性的问题难道更改的时候不会去重新生成对应的文件吗*/reserved hh;reserved 99 to 100;string name1;uint64 id2;optional float height3;//默认字段都是必填optional表示可选double money4;bool merried5;role.Role role6;//这个就是role包引入的枚举类型枚举定义在message内部就是独占枚举google.protobuf.Any other_msg7;//any类型oneof child_name{string son_name8;string daughter_name9;//暂时看起来不同于枚举oneof控制的事不同字段只能选一个}repeated string hobby10;//可重复字段应该会生成一个切片//内嵌字段注意tag只是在同一个message内不能重复内嵌的字段不算// 内嵌的字段是能单独拿出来用的比如在另一个字段中可以使用TestUser.GameCharacter// 注意这里的行为只是定义要使用可以如下这样写//repeated GameCharacter game_character 100;message GameCharacter{string name1;uint64 character_id2;}// 创建一个mapmapstring,parent.Parent parents11;// 创建一个时间戳类型google.protobuf.Timestamp birthday12;
}
1、前两个声明
syntaxproto3;//顶格声明protobuf版本默认是protobuf2
第一个是版本声明
package user;//定义一下protobuf的包名
包名的声明后面引入外部文件的时候会用大
2、四个import
前两个import引入了本报之外的其他两个文件这两个应用的文件内容如下
//role.proto
syntaxproto3;
package role;
option go_package../grpc;grpc;
enum Role{NORMAL_USER0;VIP_USER1;BOSS3;
};
//parent.proto
syntaxproto3;
package parent;
option go_package../grpc;grpc;
message Parent{string name1;uint32 age2;
}
这两个引用在下面的TestUser之中的role字段和map中被使用,主要是我用来测试外部引入的。
后面两个import则是引入了官网定义的两个类型Any和Timestamp也在下面的TestUser结构中使用
import google/protobuf/any.proto;//引入any类型
import google/protobuf/timestamp.proto;//引入时间戳类型
3、import public
引入前面可以加入public关键词具体用法可以看这段
import public some path
这个public关键词用于控制这个包的依赖是否可以传递例子如下//a.proto:
import b.proto
import public c.proto//index.proto:
import a.proto
那么这个index文件当中除了能使用a文件中定义的变量还能使用c文件当中的遍历但是b文件就不能使用
4、go_package
这个控制转化后的go文件的生成地址和生成go文件的package名比如我这里的写法就是
option go_package../grpc;grpc;//规定生成文件的输出文件同时规定对应文件package的名称 生成的文件放到上级的grpc文件夹中package是grpc两个之间以“”这格符号隔开需要注意这个生成文件的存放路径需要和protoc指令中的“--go_out“值相拼接我为了不出错都是只写go_package--go_out的内容我是不写的
5、具体的TestUser字段
这里需要注意一下大小写的问题message类似于结构体他的名称是开头双大写而其里面的字段则是小写用“_”连接。
一下基础的类型比如string等等可以查看对应的protobuf基础类型和对应语言之间对应表参见https://protobuf.dev/programming-guides/proto3/#specifying-field-rules。
这里还展示了其他操作
optional可选关键字
enum这里是外部引入的role.Role类型
anygoogle.protobuf.Any也是外部引入的
oneof字段二选一不同于枚举这里的例子就是孩子的名字要么是男孩名字要么是女孩名字
repeated多次关键词比如例子里的hobby字段实际上会形成一个数组/切片实际上字段名称写成hobbies比较好
map类型这里我们生成的是一个string,parent.Parent的键值对其中parent.Parent是外部引入
时间戳类型google.protobuf.Timestamp也是一个外部引入
6、内嵌message和enum
朋友们应该注意到了我在TestUser之中还声明了一个GameCharacter注意只是申明要在TestUser使用还要显式挂载也能声明一个枚举有需要的时候可以在外部使用
三、生成一下protobuf
首先要安装一下protoc-gen-go生成工具来使用protoc指令
go install google.golang.org/protobuf/cmd/protoc-gen-golatest
控制台使用如下指令查看是否安装成功
protoc --version
其次在项目中引入相关包
go get -u google.golang.org/protobuf
注意区分这次学习只生成protobuf并不生成grpc的客户端和服务端也就是这次只会生成对应的结构体
进入protobuf原始文件所在文件夹控制台使用如下指令生成:
protoc --go_out. *.proto
protoc指令其实有--proto_path和--go_out两个参数第一个参数告知protobuf文件所在文件夹但是由于路径我这边怎么写都不对所以我直接进入了protobuf所在文件夹这样就不写这个参数了。
--go_out.这个写法就是让文件中go_package选项决定输出文件何在。
*.proto表示处理所有文件当然你也可以指定具体文件名中间用空号隔开。
最后就会在grpc文件夹之中生成parent.pb.go/user.pd.go/role.pd.go三个文件具体文件的里的实现可以自己去看有些写法还是很有意思的。
加下来会加上grpc包除了protobuf文件之外还会有对应的客户端
