golang 使用 protobuf 的教程
1、下载protobuf的编译器protoc
地址：
1 |
https://github.com/google/protobuf/releases |
window：
下载: protoc-3.3.0-win32.zip
解压，把bin目录下的protoc.exe复制到GOPATH/bin下，GOPATH/bin加入环境变量。
当然也可放在其他目录，需加入环境变量，能让系统找到protoc.exe
linux：
下载：protoc-3.3.0-linux-x86_64.zip 或 protoc-3.3.0-linux-x86_32.zip
解压，把bin目录下的protoc复制到GOPATH/bin下，GOPATH/bin加入环境变量。
如果喜欢编译安装的，也可下载源码自行安装，最后将可执行文件加入环境变量。
2、获取protobuf的编译器插件protoc-gen-go
进入GOPATH目录
运行
1 |
> go get -u github.com/golang/protobuf/protoc-gen-go |
如果成功，会在GOPATH/bin下生成protoc-gen-go.exe文件
3、创建一个test.proto文件
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
|
//指定版本//注意proto3与proto2的写法有些不同syntax = "proto3";//包名，通过protoc生成时go文件时package test;//手机类型//枚举类型第一个字段必须为0enum PhoneType { HOME = 0; WORK = 1;}//手机message Phone { PhoneType type = 1; string number = 2;}//人message Person { //后面的数字表示标识号 int32 id = 1; string name = 2; //repeated表示可重复 //可以有多个手机 repeated Phone phones = 3;}//联系簿message ContactBook { repeated Person persons = 1;} |
4、运行如下命令
1 |
> protoc --go_out=. *.proto |
会生成一个test.pb.go的文件，具体的文件内容我就不截图了。
5、在go语言中使用protobuf
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
|
package main;
import (
"github.com/golang/protobuf/proto"
"protobuf/test"
"io/ioutil"
"os"
"fmt"
)func write() {
p1 := &test.Person{
Id: 1,
Name: "小张",
Phones: []*test.Phone{
{test.PhoneType_HOME, "111111111"},
{test.PhoneType_WORK, "222222222"},
},
};
p2 := &test.Person{
Id: 2,
Name: "小王",
Phones: []*test.Phone{
{test.PhoneType_HOME, "333333333"},
{test.PhoneType_WORK, "444444444"},
},
};
//创建地址簿
book := &test.ContactBook{};
book.Persons = append(book.Persons, p1);
book.Persons = append(book.Persons, p2);
//编码数据
data, _ := proto.Marshal(book);
//把数据写入文件
ioutil.WriteFile("./test.txt", data, os.ModePerm);
}func read() {
//读取文件数据
data, _ := ioutil.ReadFile("./test.txt");
book := &test.ContactBook{};
//解码数据
proto.Unmarshal(data, book);
for _, v := range book.Persons {
fmt.Println(v.Id, v.Name);
for _, vv := range v.Phones {
fmt.Println(vv.Type, vv.Number);
}
}
}func main() {
write();
read();
} |