Go => Protobuf in Go

Wprowadzenie

Protobuf lub Bufor protokołów koduje i dekoduje dane, dzięki czemu różne aplikacje lub moduły napisane w różnych językach mogą szybko i niezawodnie wymieniać dużą liczbę komunikatów bez przeciążania kanału komunikacyjnego. W przypadku protobuf wydajność jest wprost proporcjonalna do liczby wysyłanych wiadomości. Kompresuje wiadomość, aby wysłać w serializowanym formacie binarnym, udostępniając narzędzia do kodowania wiadomości u źródła i dekodowania jej w miejscu docelowym.

Uwagi

Istnieją dwa etapy korzystania z protobuf .

Najpierw musisz skompilować definicje buforów protokołu
Zaimportuj powyższe definicje wraz z biblioteką wsparcia do swojego programu.

Wsparcie gRPC

Jeśli plik proto określa usługi RPC, protoc-gen-go może zostać poinstruowany, aby wygenerować kod zgodny z gRPC ( http://www.grpc.io/) . Aby to zrobić, przekaż parametr plugins do protoc-gen-go; zwykłym sposobem jest wstawienie go do argumentu --go_out w celu protoc:

protoc --go_out=plugins=grpc:. *.proto

Korzystanie z Protobuf z Go

Wiadomość, którą chcesz serializować i wysłać, którą możesz dołączyć do pliku test.proto , zawierającą

package example;

enum FOO { X = 17; };

message Test {
  required string label = 1;
  optional int32 type = 2 [default=77];
  repeated int64 reps = 3;
  optional group OptionalGroup = 4 {
    required string RequiredField = 5;
  }
}

Aby skompilować definicję bufora protokołu, uruchom protoc z parametrem --go_out ustawionym na katalog, w którym chcesz wyprowadzić kod Go.

protoc --go_out=. *.proto

Aby utworzyć i przetestować obiekt testowy z przykładowego pakietu,

package main

import (
    "log"

    "github.com/golang/protobuf/proto"
    "path/to/example"
)

func main() {
    test := &example.Test {
        Label: proto.String("hello"),
        Type:  proto.Int32(17),
        Reps:  []int64{1, 2, 3},
        Optionalgroup: &example.Test_OptionalGroup {
            RequiredField: proto.String("good bye"),
        },
    }
    data, err := proto.Marshal(test)
    if err != nil {
        log.Fatal("marshaling error: ", err)
    }
    newTest := &example.Test{}
    err = proto.Unmarshal(data, newTest)
    if err != nil {
        log.Fatal("unmarshaling error: ", err)
    }
    // Now test and newTest contain the same data.
    if test.GetLabel() != newTest.GetLabel() {
        log.Fatalf("data mismatch %q != %q", test.GetLabel(), newTest.GetLabel())
    }
    // etc.
}

Aby przekazać dodatkowe parametry do wtyczki, użyj listy parametrów oddzielonych przecinkami oddzielonych od katalogu wyjściowego dwukropkiem:

protoc --go_out=plugins=grpc,import_path=mypackage:. *.proto

Modified text is an extract of the original Stack Overflow Documentation

Licencjonowany na podstawie CC BY-SA 3.0

Nie związany z Stack Overflow

Go
Protobuf in Go

Szukaj…

Wprowadzenie

Uwagi

Korzystanie z Protobuf z Go