Protocol Buffer

# go version
go version go1.12.4 linux/amd64

# mkdir /opt/proto
# curl https://github.com/protocolbuffers/protobuf/releases/download/v3.9.1/protoc-3.9.1-linux-x86_64.zip 
# mv protoc-3.9.1-linux-x86_64.zip /opt/proto
# cd /opt/proto
# unzip protoc-3.9.1-linux-x86_64.zip

.
├── bin
│   └── protoc
├── include
│   └── google
│       └── protobuf
│           ├── any.proto
│           ├── api.proto
│           ├── compiler
│           │   └── plugin.proto
│           ├── descriptor.proto
│           ├── duration.proto
│           ├── empty.proto
│           ├── field_mask.proto
│           ├── source_context.proto
│           ├── struct.proto
│           ├── timestamp.proto
│           ├── type.proto
│           └── wrappers.proto
└── readme.txt

# go get -u github.com/golang/protobuf/protoc-gen-go

syntax = "proto3";
package person;

message Person {
    string name = 1;
    int32 id =2 ;
    string email = 5;
                                    
    enum PhoneType {
        MOBILE = 0;
        HOME = 1;
        WORK = 2;                                 
    }

    message PhoneNumber {
        string number = 1;
        PhoneType type = 2;
    }
                                    
    repeated PhoneNumber phone = 4;
}

# protoc --cpp_out=./ person.proto
# ls 
person.pb.cc  person.pb.h  person.proto

# mkdir person
# protoc --go_out=person person.proto 

# tree 
├── person
│   └── person.pb.go
└── person.proto

// 이 파일은 수정하면 안된다. 
// Code generated by protoc-gen-go. DO NOT EDIT.
// source: person.proto

// 프로토콜 버퍼의 package 이름이 go package 이름이 됐다. 
package person

import (
    fmt "fmt"
    proto "github.com/golang/protobuf/proto"
    math "math"
)

// 생략 ......

// message Person이 go 스트럭처로 컴파일 됐다.
// 프로토콜 버퍼의 필드 유형은 go 언어에 대응되는 적당한 필드로 변환된 걸 확인 할 수 있다.
// 프로토콜 버퍼의 정보들은 구조체 태그로 표현되고 있다. 
type Person struct {
    Name                 string                `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
    Id                   int32                 `protobuf:"varint,2,opt,name=id,proto3" json:"id,omitempty"`
    Email                string                `protobuf:"bytes,5,opt,name=email,proto3" json:"email,omitempty"`
    Phone                []*Person_PhoneNumber `protobuf:"bytes,4,rep,name=phone,proto3" json:"phone,omitempty"`
    XXX_NoUnkeyedLiteral struct{}              `json:"-"`
    XXX_unrecognized     []byte                `json:"-"`
    XXX_sizecache        int32                 `json:"-"`
}

// Reset, String 등 메서드를 자동으로 만들었다.
func (m *Person) Reset()         { *m = Person{} }
func (m *Person) String() string { return proto.CompactTextString(m) }
func (*Person) ProtoMessage()    {}
func (*Person) Descriptor() ([]byte, []int) {
    return fileDescriptor_4c9e10cf24b1156d, []int{0}
}

// 프로토콜 버퍼의 Name, Id, Email 필드를 가져오기 위한 메서드도 만들어졌다.
func (m *Person) GetName() string {
    if m != nil && m.Name != nil {
        return *m.Name
    }
    return ""
}

func (m *Person) GetId() int32 {
    if m != nil && m.Id != nil {
        return *m.Id
    }
    return 0
}

func (m *Person) GetEmail() string {
    if m != nil && m.Email != nil {
        return *m.Email
    }
    return ""
}

package main

import (
    proto "github.com/golang/protobuf/proto"
    pb "github.com/yundream/test/person"
    "io/ioutil"
    "log"
)

func main() {
    phone := []*pb.Person_PhoneNumber{
        &pb.Person_PhoneNumber{Number: "0100000xxxx", Type: pb.Person_MOBILE},
        &pb.Person_PhoneNumber{Number: "0101111zzzz", Type: pb.Person_HOME},
    }
    addressBook := &pb.Person{
        Name:  "yundream",
        Id:    1234,
        Email: "yundream@gmail.com",
        Phone: phone,
    }
    out, err := proto.Marshal(addressBook)
    if err != nil {
        log.Fatalln(err)
    }
    if err := ioutil.WriteFile("test.data", out, 0644); err != nil {
        log.Fatalln(err)
    }
}

package main
                                
import (
    "fmt"
    "github.com/golang/protobuf/proto"
    pb "github.com/yundream/test/person"
    "io/ioutil"
    "log"
)

func main() {
    in, err := ioutil.ReadFile("test.data")
    if err != nil {
        log.Fatalln(err)
    }
    book := &pb.Person{}
    if err := proto.Unmarshal(in, book); err != nil {
        log.Fatalln(err)
    }
    fmt.Println(book.GetId())
    fmt.Println(book.GetName())
}

# go run read.go 
1234
yundream