深入理解Golang中的Protocol Buffers及其应用

 更新时间:2024年11月07日 10:20:06   作者:亦世凡华、  
本篇文章将深入探讨 Go 语言中使用 Protobuf 的基础知识、常见应用以及最佳实践,希望能帮大家了解如何在项目中高效利用 Protobuf

初识Protobuf

Protocol Buffers简称protobuf,是一个无关语言,无关平台的用于序列化结构化数据的工具,于2008年被Google开源的一种数据描述语言,也可以叫做接口规范的描述语言,相较于json体积更小,传输更快,常定义在.proto文件中,在特定语言进行编译时进行动态编译,所以即使你客户与服务端使用不同的语言,只要修改proto文件则会在两端同时生效:

protobuf优势:使用二进制格式进行数据编码,相比于文本格式(如 JSON 或 XML),它能显著减少数据的体积,这使得在网络传输中数据更加紧凑,带宽占用更少,尤其在处理大规模数据时,能够提升性能,当然还有编解码效率和多语言支持等等的优势:

Protobuf原理介绍

protobuf是一种二进制格式编码,实现序列化的结构化数据信息需要通过message来定义一个类似struct的数据集合,每一条protocol buffer消息都是一个小的逻辑记录,包含了一系列的name-value键值对,文件都是以 .proto 为后缀 ,如下是一个基础的.proto文件示例:

message Person {
  required string name = 1;
  required int32 id = 2;
  optional string email = 3;
 
  enum PhoneType {
    MOBILE = 0;
    HOME = 1;
    WORK = 2;
  }
 
  message PhoneNumber {
    required string number = 1;
    optional PhoneType type = 2 [default = HOME];
  }
 
  repeated PhoneNumber phone = 4;
}

每一条消息类型都有一个或多个编号唯一的field,并且每一个field都具有名称和类型,以如下简单的messgae进行举例说明一下每个字段的含义是什么:

// repeated: 字段tag,表示复合类型
// Result: 字段数据类型,可以自定义
// results: 字段的命名
// 1: 字段的编号
message SearchResponse {
    repeated Result results = 1;
}

Go语言环境搭建

protoc:是一个protobuf编译器用于将protobuf)描述文件.proto 文件转换成各编程语言源代码的工具,这个编译器根据 .proto 文件中定义的数据结构,自动生成序列化和反序列化的代码,便于开发者在不同的编程语言中使用protobuf进行数据交换,如下图所示

通过protobuf编辑器的作用,我们就可以将.proto 文件构造生成右侧的go语言的package:

接下来我们开始下载protoc这个编辑器,来到官方网址:地址,这里注意根据自身电脑系统情况下载不同的源码包,这里我就以window系统进行举例,这里我们安装如下最新版本:

下载之后将压缩包解压到本地非C盘目录下,解压后的文件内包含如下三个文件:

include:头文件或库文件;bin:包含protoc编译器;readme.txt安装教程

了解即可:接下来把解压后⽂件中的bin目录配置到系统环境变量的Path中去:

然后win+r打开cmd终端输入protoc--version命令出现如下界面,有版本号说明我们安装配置成功:

主要操作:接下来我们只需要将该解压文件bin目录下的 protoc.exe 文件放置到我们配置go语言的GOBIN目录下即可,如下可以看到我们的默认GOBIN目录:

接下来还需要安装两个go语言的插件工具:protoc-gen-go和protoc-gen-go-grpc它们用于生成 go语言代码,分别用于处理protobuf消息和实现grpc服务,这里我们只需要cmd执行如下安装命令即可:

// 如果下载失败(网络延迟断开),可以考虑先开启代理,在执行如下两个插件安装
go env -w GOPROXY=https://goproxy.cn,direct
 
// 安装protoc-gen-go
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
// 安装 grpc
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest

网速不好直接开启代理,出现如下界面说明我们安装成功:

然后我们来到我们的GOBIN目录下可以看到我们的工具都以及安装完成了:

终端执行如下命令可以看到我们的安装版本:

Protobuf基本使用

定义protobuf文件:一般我们定义应该protobuf文件采用的写法如下所示,以下是对参数讲解:

1)syntax:表示采用proto3的语法,零值初始化

2)package:指明当前是main包

3)option:protobuf的一些选项参数,这里指定要生成的go语言package路径

4)message:关键字定义一个新的String类型

syntax = "proto3";
 
package helloworld;
option go_package = "./";
 
// 定义请求消息
message HelloRequest {
  string name = 1;
}

然后我们终端执行如下命令,可以看到我们的protobuf被编译成功了:

编译protobuf文件:根据上图对protobuf文件进行编译我们知道,还需要输入对应指令,这里进行如下解释,比如我们要编译如下文件:

到此这篇关于深入理解Golang中的Protocol Buffers及其应用的文章就介绍到这了,更多相关Go Protocol内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Go语言中占位符格式化符号的实现

    Go语言中占位符格式化符号的实现

    本文介绍了Go语言中常用格式化占位符,包括结构体、布尔、整数、浮点数、字符串、切片及指针类型,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2025-10-10
  • Go语言创建、初始化数组的常见方式汇总

    Go语言创建、初始化数组的常见方式汇总

    这篇文章主要介绍了Go语言创建、初始化数组的常见方式,实例汇总了Go语言操作数组的常见技巧,具有一定参考借鉴价值,需要的朋友可以参考下
    2015-02-02
  • Go语言中的数据库操作大全从SQL到ORM

    Go语言中的数据库操作大全从SQL到ORM

    本文将详细介绍Go语言中的数据库操作,从基础的SQL操作到高级的ORM框架,帮助你构建更加高效、可靠的数据库应用,感兴趣的朋友一起看看吧
    2026-04-04
  • go语言单例模式(Singleton)实例分析

    go语言单例模式(Singleton)实例分析

    这篇文章主要介绍了go语言单例模式(Singleton),实例分析了单例模式的原理与Go语言的实现技巧,需要的朋友可以参考下
    2015-03-03
  • Go语言基础模板设计模式示例详解

    Go语言基础模板设计模式示例详解

    这篇文章主要为大家介绍了Go语言基础设计模式之模板模式的示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步
    2021-11-11
  • Go语言双向链表list.List的实现示例

    Go语言双向链表list.List的实现示例

    Go语言中的list.List是包提供的双向链表实现,具有高效的插入和删除操作能力,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2025-09-09
  • 浅谈golang的json.Unmarshal的坑

    浅谈golang的json.Unmarshal的坑

    本文主要介绍了浅谈golang的json.Unmarshal的坑,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-01-01
  • 使用Go语言写一个Http Server的实现

    使用Go语言写一个Http Server的实现

    本文主要介绍了使用Go语言写一个Http Server的实现,文中通过示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-04-04
  • golang 内存对齐的实现

    golang 内存对齐的实现

    在代码编译阶段,编译器会对数据的存储布局进行对齐优化,本文主要介绍了golang 内存对齐的实现,具有一定的参考价值,感兴趣的可以了解一下
    2024-08-08
  • 创建第一个Go语言程序Hello,Go!

    创建第一个Go语言程序Hello,Go!

    这篇文章主要介绍了创建第一个Go语言程序Hello,Go!本文详细的给出项目创建、代码编写的过程,同时讲解了GOPATH、Go install等内容,需要的朋友可以参考下
    2014-10-10

最新评论