Die Nutzdaten in drei Ebenen aufteilen
Bei binaeren Nachrichten wird die Textumhuellung oft mit dem Datenformat verwechselt. Dokumentieren Sie Quelle, Nachrichtengrenzen und erwarteten Empfaenger: Strukturierte Werte werden serialisiert, daraus entstehen Bytes, und diese Bytes werden mitunter als Base64, ASCII85, Base91 oder escaped Hex-Text uebertragen. Halten Sie jede Ebene getrennt fest und bearbeiten Sie sichtbaren Text nicht wie JSON oder UTF-8, solange das Innenformat nicht bestaetigt ist.
Ein wiederholbares Referenzbeispiel sollte normalen und nicht ASCII-Text, Dezimalzahlen, Nullwerte, Nullbytes, verschachtelte Objekte und Arrays enthalten. Notieren Sie die Ausgangslaenge und einige hexadezimale Kontrollstellen, damit sich spaeter ein Serialisierungsfehler von einem Transportfehler unterscheiden laesst.
Erst die Transporthuelle entfernen
Nennt das Protokoll die aeussere Darstellung, liefert der passende Konverter die urspruenglichen Bytes. Bei unklarer Herkunft bewahren Sie Belege auf und pruefen Kandidaten vollstaendig; eine erfolgreich dekodierte Base64-Zeichenkette beweist nicht, dass innen JSON liegt. Sie kann Protobuf, CBOR oder einen anwendungsspezifischen Frame enthalten.
Waehlen Sie Avro, BSON, CBOR, Ion, MessagePack, Protobuf, Smile oder UBJSON erst nach Pruefung der Bytes, der Senderdokumentation, des Content-Type, des Schemas oder des Empfaengercodes. Bei schema-basierten Formaten sind Version, Feldnummern und Standardwerte Teil des Vertrags und nicht optionale Notizen.
Bedeutung und Bytegrenzen pruefen
Wandeln Sie das Referenzbeispiel in das Zielformat und wieder in eine pruefbare Darstellung zurueck. Vergleichen Sie zuerst Semantik: Felder, Typen, Zahlengenauigkeit, Unicode, Nullwerte, Array-Reihenfolge und Verschachtelung. Pruefen Sie danach Laenge, Nullbytes, Binaerfelder und Kontrollfragmente. Wenn ein Format mehrere gleichwertige Kodierungen erlaubt, definieren Sie einen kanonischen Vergleich statt unbegruendete Bytegleichheit zu verlangen.
Verpacken Sie anschliessend nur bei Bedarf fuer den Kanal und dekodieren Sie das Ergebnis sofort. Die letzte Kontrolle trennt eine falsche Serialisierungswahl von einem Transportfehler und liefert eine reproduzierbare Diagnosekette.
Abnahme und typische Fehler
Ein fehlerfreier Konverterlauf ist keine Abnahme. Der Zielverbraucher oder ein kompatibler Dekoder muss die Ausgabe lesen; bewahren Sie Beispiel, Schemaversion, Format, Umhuellung, Laenge und Vergleichsergebnis auf. Hauefige Fehler sind Base64 als Innenformat zu behandeln, Protobuf-Feldnummern zu verlieren, Bytes erneut als Text zu kodieren oder eine unnoetige zweite Transporthuelle aufzusetzen.
Bei einer Ablehnung gehen Sie zur letzten bestaetigten Ebene zurueck, pruefen Umhuellung, Schema und Kompatibilitaet und reduzieren dann auf ein minimales reproduzierbares Beispiel. Eine klare Dreiebenen-Dokumentation ist verlaesslicher als zufaelliges Ausprobieren von Konvertern.