golang-protobuf快速上手指南

豆瓣奶茶 · · 6846 次点击 · · 开始浏览    
这是一个创建于 的文章,其中的信息可能已经有所发展或是发生改变。

什么是protobuf

Google Protocol Buffer( 简称 Protobuf) 是 Google 公司内部的混合语言数据标准。

Protocol Buffers 是一种轻便高效的结构化数据存储格式,可以用于结构化数据串行化,或者说序列化。它很适合做数据存储或 RPC 数据交换格式。可用于通讯协议、数据存储等领域的语言无关、平台无关、可扩展的序列化结构数据格式。

如何安装protobuf

# 获取源码包
wget https://github.com/google/protobuf/archive/v3.5.0.tar.gz

# 解压缩并进入源码目录
tar -zxvf v3.5.0.tar.gz
cd protobuf-3.5.0

# 生成configure文件
./autogen.sh

# 编译安装
./configure
make
make check
make install

在执行./autogen.sh过程中可能会因缺乏automake依赖库而报错:autoreconf: failed to run aclocal: No such file or directory,要解决此错误,在linux系统可以通过sudo yum install automake或者sudo apt-get install automake安装automake,在macos系统可以通过brew install automake安装automake。

  • 检测protobuf是否已成功安装
    命令行执行protoc --version。windows系统需要将protoc.exe文件所在的目录添加到环境变量。

如何使用protobuf

protobuf支持跨语言使用,很多主流的开发语言都有protobuf支持库,我们用golang来演示如何使用protobuf进行数据序列化。

  • 在golang中安装protobuf相关的库
go get -u github.com/golang/protobuf/{protoc-gen-go,proto}
  • 编写.proto文件
    $GOPATH/src/test/protobuf/pb/user.proto
    package pb;

    message user {
     int32 id = 1;
     string name = 2;
    }

    message multi_user {
     repeated user users = 1;
    }
  • 基于.proto文件生成数据操作代码
    protoc --go_out=. user.proto
    执行命令完成,在与user.proto文件同级的目录下生成了一个user.pb.go文件

  • 数据序列化演示
    $GOPATH/src/test/protobuf/main.go

   package main

    import (
     "log"
     "test/protobuf/pb"

     "github.com/golang/protobuf/proto"
    )

    func main() {
     user1 := pb.User{
     Id:   *proto.Int32(1),
     Name: *proto.String("Mike"),
     }

     user2 := pb.User{
     Id:   2,
     Name: "John",
     }

     users := pb.MultiUser{
     Users: []*pb.User{&user1, &user2},
     }

     // 序列化数据
     data, err := proto.Marshal(&users)
     if err != nil {
     log.Fatalln("Marshal data error: ", err)
     }
     println(users.Users[0].GetName()) // output: Mike

     // 对已序列化的数据进行反序列化
     var target pb.MultiUser
     err = proto.Unmarshal(data, &target)
     if err != nil {
     log.Fatalln("Unmarshal data error: ", err)
     }
     println(target.GetUsers()[1].Name) // output: John

    }

相关扩展

sublime插件:Protobuf Syntax Hightlighting

参考资料


有疑问加站长微信联系

本文来自:简书

感谢作者:豆瓣奶茶

查看原文:golang-protobuf快速上手指南

入群交流(和以上内容无关):加入Go大咖交流群,或添加微信:liuxiaoyan-s 备注:入群;或加QQ群:812540095

6846 次点击  
加入收藏 微博
2 回复  |  直到 2019-08-05 16:02:36
暂无回复
添加一条新回复 (您需要 登录 后才能回复 没有账号 ?)
  • 请尽量让自己的回复能够对别人有帮助
  • 支持 Markdown 格式, **粗体**、~~删除线~~、`单行代码`
  • 支持 @ 本站用户;支持表情(输入 : 提示),见 Emoji cheat sheet
  • 图片支持拖拽、截图粘贴等方式上传