Kā veikt Protocol Buffers atkļūdošanu?

Lai diagnosticēt Protocol Buffers (protobuf), var izmantot vairākas pieejas:

1. Izdrukāt teksta formātā: Protobuf objekts var tikt izvadīts teksta formātā, kas ir lasāmāks un vieglāk analizējams nekā binārā attēla formāts.

   import (
   	"fmt"
   
   	"google.golang.org/protobuf/encoding/protojson"
   	"google.golang.org/protobuf/proto"
   )
   
   // Pieņemot, ka "myProtoMessage" ir protobuf ziņojuma instances
   func printProtoAsText(msg proto.Message) {
   	// Izmantojot protojson JSON formātam, kas ir cilvēkam saprotams
   	marshalOptions := protojson.MarshalOptions{
   		Indent: "  ", // Iekšējās atstarpes labākai lasāmībai
   	}
   	text, err := marshalOptions.Marshal(msg)
   	if err != nil {
   		fmt.Printf("Kļūda marshalingā uz JSON: %v\n", err)
   		return
   	}
   	fmt.Println(string(text))
   
   	// Alternatīvi, izmantojot prototext (mazāk bieži lietots tiešai lasīšanai)
   	// text, err := prototext.Marshal(msg)
   	// if err != nil {
   	// 	fmt.Printf("Kļūda marshalingā uz tekstu: %v\n", err)
   	// 	return
   	// }
   	// fmt.Println(string(text))
   }
   

2. Binarā attēla forma: Skatīt neapstrādātos bitus protobuf var palīdzēt saprast, kā dati ir iepakoti, īpaši problēmu ar serializāciju/deserializāciju gadījumā:

   import (
   	"fmt"
   
   	"google.golang.org/protobuf/proto"
   )
   
   func printProtoAsBinary(msg proto.Message) {
   	data, err := proto.Marshal(msg)
   	if err != nil {
   		fmt.Printf("Kļūda marshalingā uz bināro formātu: %v\n", err)
   		return
   	}
   	fmt.Printf("Binarie dati: %x\n", data) // Izvadīt heksadecimālā formātā
   }
   

3. Instrumenti bināro protobuf inspekcijai: Pastāv utilīti, kas var parsēt bināro protobuf failu un izvadīt tā saturu lasāmākā formātā, piemēram, protoc ar noteiktiem spraudņiem vai trešo pušu rīkiem.

   Piemērs, izmantojot protoc (prasa uzstādītu protoc un .proto definīciju):

   # Pieņemot, ka jums ir binārs fails ar nosaukumu 'my_message.bin' un `.proto` fails 'my_message.proto'
   protoc --decode=your_package.YourMessageType my_message.proto < my_message.bin
   

   (Aizvietojiet your_package.YourMessageType ar faktisko jūsu .proto faila ziņojuma tipu)

4. Žurnāla ieraksts: Pievienojiet žurnāla ierakstus pirms un pēc protobuf ziņojumu serializācijas/deserializācijas, tas palīdzēs saprast ziņojuma saturu konkrētā izpildes brīdī.

5. Debuggers: Izmantojiet standarta Golang debuggeri (delve), lai soli pa solim izpildītu kodu un inspektētu protobuf ziņojumu lauku vērtības atmiņā:

   // Piemērs ar delve: šeit iestatiet pārtraukšanas punktu
   message, err := proto.Marshal(myProtoData)
   if err != nil {
       // Kļūdas apstrāde
   }
   // Inspektējiet 'message' mainīgo delve