როგორ დავგეგმოთ Protocol Buffers?

პროტოკოლის ბუფერების (protobuf) დათვალიერებისთვის შეგიძლიათ გამოიყენოთ რამდენიმე მიდგომა:

1. ტექსტური ფორმატით გამოტანა: protobuf ობიექტს შეიძლება გამოიტანოთ ტექსტურ ფორმატში, რაც უფრო ადვილია წაკითხვა და ანალიზი, ვიდრე ბინარული წარმოდგენა.

   import (
   	"fmt"
   
   	"google.golang.org/protobuf/encoding/protojson"
   	"google.golang.org/protobuf/proto"
   )
   
   // ვივარაუდოთ, რომ "myProtoMessage" არის protobuf შეტყობინების მაგალითი
   func printProtoAsText(msg proto.Message) {
   	// protojson-ის გამოყენება JSON ფორმატისთვის, რომელიც ადამიანისთვის გასაგებია
   	marshalOptions := protojson.MarshalOptions{
   		Indent: "  ", // გადახრილი დასამატებლად უკეთ წაკითხვისთვის
   	}
   	text, err := marshalOptions.Marshal(msg)
   	if err != nil {
   		fmt.Printf("შეცდომა JSON-ში მარშალზე: %v\n", err)
   		return
   	}
   	fmt.Println(string(text))
   
   	// ალტერნატიული, prototext-ის გამოყენება (ნაკლებად გავრცელებული პირდაპირი ადამიანური წაკითხვისთვის)
   	// text, err := prototext.Marshal(msg)
   	// if err != nil {
   	// 	fmt.Printf("შეცდომა ტექსტში მარშალზე: %v\n", err)
   	// 	return
   	// }
   	// fmt.Println(string(text))
   }
   

2. ბინარული წარმოდგენა: protobuf-ის ნედლ ბიტებს ნახვა შეიძლება დაეხმაროს გაგებას, როგორ არის მონაცემები შეფუთული, განსაკუთრებით სერილიზაციის/დესერილიზაციის პრობლემების დროს:

   import (
   	"fmt"
   
   	"google.golang.org/protobuf/proto"
   )
   
   func printProtoAsBinary(msg proto.Message) {
   	data, err := proto.Marshal(msg)
   	if err != nil {
   		fmt.Printf("შეცდომა ბინარულ მარშალზე: %v\n", err)
   		return
   	}
   	fmt.Printf("ბინარული მონაცემები: %x\n", data) // ჰექსადეციმალით გამოტანა
   }
   

3. ინსპექტირების ინსტრუმენტები ბინარულ protobuf-ებისთვის: არსებობს utility-ები, რომლებიც ანალოგიურად შეუძლიათ ბინარული ფაილის პარსვა და მისი შინაარსის გამოტანა უფრო წასაკითხად ფორმატში, მაგალითად, protoc-ი გარკვეული პლაგინებით ან მესამე მხარის ინსტრუმენტებით:

   მაგალითი protoc-ის გამოყენების (საჭიროა protoc-ის ინსტალაცია და .proto ფაილის განსაზღვრა):

   # ვივარაუდოთ, რომ გაქვთ ბინარული ფაილი სახელად 'my_message.bin' და `.proto` ფაილი 'my_message.proto'
   protoc --decode=your_package.YourMessageType my_message.proto < my_message.bin
   

   (შეცვალეთ your_package.YourMessageType თქვენი .proto ფაილიდან რეალურ შეტყობინების ტიპით)

4. ლოგირება: დაამატეთ ლოგირება კოდში სერილიზაციის/დესერილიზაციის წინ და შემდეგ protobuf შეტყობინებების, რათა გაიგოთ შეტყობინების შინაარსი კონკრეტულ დროს პროგრამის შესრულებისას.

5. დეველოპერი: გამოიყენეთ სტანდარტული დეველოპერი Golang-ის (delve) კოდის ნაბიჯ-ნაბიჯ შესრულებისა და protobuf შეტყობინებების ველის მნიშვნელობების ინსპექტირებისათვის:

   // მაგალითი `delve`-ით: აქ დააყენეთ ბრეიკპოინტი
   message, err := proto.Marshal(myProtoData)
   if err != nil {
       // შეცდომის დამუშავება
   }
   // ინსპექტირება 'message' ცვლადის `delve`-ში