翻译:Go 中 Protocol Buffer 教程

2019独角兽企业重金招聘Python工程师标准>>>

Go 中 Protocol Buffer 教程

欢迎程序员们!在这个教程里面,我们将学习如何使用protocol Buffers数据格式在你的go应用里面. 我们将详细讲述这种数据格式, 以及为什么这种数据格式优于传统的数据格式例如xml甚至JSON. 在我们写更多复杂的例子之前,我们将从一个简单的例子开始编写运行.

在这章教的最后,你会对protoco Buffe有一个基础的了解,并且你将可以顺利的写出你自己更好的系统.

视频教程

https://www.youtube.com/embed/NoDRq6Twkts?ecver=2

Protocol Buffer数据类型

Protocol buffers是基础的数据格式, 和JSON,XML非常的相似, 都是用于存储结构化的数据,都支持很多不同的语言使用并进行序列化和反序列化.

这种数据格式最大的优点就是它相比xml甚至JSON的大小要小很多. 这种格式是由Google开发的.Goggole是非常有名的公司,它的规模如此之大,他们做的每一件事情都产生深渊的影响.

假设有一个人, 我们想用三个独立的数据表示他:

<person>
  <name>Elliot</name>
  <age>24</age>
</person>

我们可以使用更小的数据格式JSON表示他:

{
  "name": "Elliot",
  "age": 24
}

如果我们使用protocol buffer数据格式表示如下:

[10 6 69 108 108 105 111 116 16 24]

如果你仔细观察上面一行的编码输出, 你可以看到从数组下标为二的位置开始,ellio就拼出来了.e=69,l=108等. 后面的字节表示我现在24岁了.

但是这个编码内容比我们看到的要多的多. 我仍然在尝试研究更多信息.如果你愿意,我建议可以查看更多Google关于protocol Buffer编码的文档： Protocol Buffer Encoding

虽然JSON和Protocol Buffer的大小几乎相同.但是随着数据增大大于"入门"例子的数据,Json和protocol buffer使用的空间差距就变大了.

一个简单的例子

& go get github.com/golang/protobuf
$ go get github.com/golang/protobuf/proto

上面下载一些必须的包,用于运行简单的例子.

($) export PATH=$PATH:$GOPATH/bin

进行上面的设置之后,你就可以在终端使用protoc这个命令了. 下面我们就可以定义protobuf的格式了,在这个例子里,我们将尝试使用相同的person这个对象,我们用这个突出不同数据格式之间的区别.

首先我们要指出要使用的协议类型, 在这个例子里面我们使用proto3. 然后我把它作为main包的一部分.

最后我们定义我们想要的数据结构. 这个包含了Person的消息结构,其中包含了name 和 age两个字段.

syntax="proto3";

package main;

message Person {
      string name = 1;
      int32 age = 2;
}

然后我们使用protoc命令编译这个文件.

And we can then compile this using the protoc binary:

最终我们准备好写我们GO代码的所有东西. 我们从定义一个Person开始,并将这个对象编译成protobuf对象.

为了了解它是如何存储的,我们使用fmt.Println(data)打印存储protobuf对象的编码数据.

package main

import (
    "fmt"
    "log"

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

func main() {

    elliot := &Person{
        Name: "Elliot",
        Age:  24,
    }

    data, err := proto.Marshal(elliot)
    if err != nil {
        log.Fatal("marshaling error: ", err)
    }

  // printing out our raw protobuf object
    fmt.Println(data)

  // let's go the other way and unmarshal
  // our byte array into an object we can modify
  // and use
    newElliot := &Person{}
    err = proto.Unmarshal(data, newElliot)
    if err != nil {
        log.Fatal("unmarshaling error: ", err)
  }

  // print out our `newElliot` object
  // for good measure
  fmt.Println(newElliot.GetAge())
    fmt.Println(newElliot.GetName())

}

在运行之前,我们需要将`test.pb.go'编译通过以保证正常工作:

➜  src go run main.go test.pb.go
[10 6 69 108 108 105 111 116 16 24]
name:"Elliot" age:24

嵌套字段

好了,我们实现了一个非常简单的例子并运行了它,但是在实际中,我们经常遇到在messag的格式里面有嵌套的字段,并且可能会修改一些它们的值.

现在我们开始看看如何使用嵌套字段. 我们继续使用 Person这个消息格式,我们将添加一个社交媒体的追随者的字段.

我们用标准的字段以及自定义的SocialFollowers消息字段组成Person这个消息格式,像下面这样:

syntax="proto3";

package main;

message SocialFollowers {
  int32 youtube = 1;
  int32 twitter = 2;
}

message Person {
      string name = 1;
      int32 age = 2;
    SocialFollowers socialFollowers = 3;
}

再一次,我们使用protoc这个命令生成我们想要的东西.

($) protoc --go_out=. *.proto

然后我们再回到我们的Go程序,我们可以用SocialFollowers补充我们的elliot对象:

package main

import (
    "fmt"
    "log"

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

func main() {

    elliot := Person{
        Name: "Elliot",
        Age:  24,
        SocialFollowers: &SocialFollowers{
            Youtube: 2500,
            Twitter: 1400,
        },
    }

    data, err := proto.Marshal(&elliot)
    if err != nil {
        log.Fatal("marshaling error: ", err)
    }

    // let's go the other way and unmarshal
    // our protocol buffer into an object we can modify
    // and use
    newElliot := &Person{}
    err = proto.Unmarshal(data, newElliot)
    if err != nil {
        log.Fatal("unmarshaling error: ", err)
    }

    // print out our `newElliot` object
    // for good measure
    fmt.Println(newElliot.GetName())
    fmt.Println(newElliot.GetAge())
    fmt.Println(newElliot.SocialFollowers.GetTwitter())
    fmt.Println(newElliot.SocialFollowers.GetYoutube())

}

我们来最后一次运行它,我们看到了所有我们希望输出的内容:

➜  src go run main.go test.pb.go
Elliot
24
1400
2500

总结

在这个教程里面, 我们了解了如何基于Go应用程序使用protocol buffer建立数据结构并运行,

希望这个教程对您有用。

---

via: https://tutorialedge.net/golang/go-protocol-buffer-tutorial/

作者：tutorialedge.net 译者：amei 校对：校对者ID

本文由 GCTT 原创编译， Go 中文网 荣誉推出

转载于:https://my.oschina.net/u/1013544/blog/3031974