Vier Datenmodelle im Vergleich: Warum JSON, YAML, TOML und XML niemals 1:1 abbilden

Die Konfiguration, die keinen Roundtrip durchführte – eine Datei, die in drei Formate konvertiert wurde, und die zurückgegebenen Felder waren unterschiedlich

Ein gewöhnliches Objekt, das sichere Zahlen, Zeichenfolgen, boolesche Werte, Arrays und verschachtelte Objekte enthält, kann die Tests JSON-bis-YAML-bis-JSON und JSON-bis-TOML-bis-JSON überstehen. Fügen Sie eine Null vor TOML, eine Datums-/Uhrzeitangabe aus TOML, gemischten XML-Inhalt oder einen YAML-Kommentar sowie einige Wert- oder Quellinformationsänderungen hinzu.

Die nützliche Frage ist nicht, ob die Konvertierung allgemein verlustbehaftet ist. Es kommt darauf an, welche Eingabeklasse und welche Richtung die benötigten Eigenschaften beibehält. Die Warnungen und Ablehnungen von ToolAcre machen diese Matrix sichtbar, anstatt jedes Paar auf ein Marketingversprechen zu reduzieren.

Eine repräsentative Konfiguration kann einige Paare durchlaufen, jedoch nicht jede unterstützte Form

JSON stellt Null, Boolesche Werte, Zahlen, Zeichenfolgen, Arrays und Objekte in diesem Parser bereit. Es gibt keine Kommentare, keinen Datetime-Typ oder keine Shared-Reference-Syntax. JavaScript analysiert Zahlen, wenn sich IEEE-754 verdoppelt, sodass eine bereits nicht in Anführungszeichen gesetzte Ganzzahl außerhalb des sicheren Bereichs möglicherweise an Präzision verliert, bevor ein anderer Autor sie sieht.

Objektschlüssel sind Zeichenfolgen und eine optionale Sortierung ändert ihre Darstellung. Arrays bleiben geordnet. Beim strikten Parsen werden Kommentare, nachgestellte Kommas und nicht endliche numerische Token zurückgewiesen, wodurch eine kompakte Basislinie für die anderen Leser geschaffen wird.

JSONs Wertmodell, wie es von dieser JavaScript-Implementierung verwendet wird

ToolAcre akzeptiert YAML über eingeschränkte JSON- oder Core-Schemas. Anker und Aliase werden aufgelöst, Kommentare verschwinden, Streams werden zu Arrays, doppelte Schlüssel behalten den letzten Wert mit einer Warnung und rekursive oder explosive Aliase werden abgelehnt.

Benutzerdefinierte Tags, Binär-, Zeitstempel-, Set- und Sprachobjektkonstruktoren werden abgelehnt. Core Infinity und NaN werden in Zielformaten mit Warnungen zu Null. Dies ist absichtlich eine Teilmenge des umfassenderen Tag-Systems von YAML und kein Anspruch auf vollständige YAML-Objektunterstützung.

Das eingeschränkte YAML-Modell, das ToolAcre akzeptiert

TOML beginnt mit einer Tabelle und unterstützt Zeichenfolgen, vorzeichenbehaftete Ganzzahlen, Gleitkommazahlen, boolesche Werte, Arrays, Tabellen und vier zeitliche Arten. Es hat keine Null. ToolAcre konvertiert Datums- und Uhrzeitangaben in quellenorientierte Zeichenfolgen und große Ganzzahlen in Dezimalzeichenfolgen, ohne Ziffern zu verlieren.

Beim Schreiben von TOML werden Null-Objektschlüssel weggelassen und Null-Array-Einträge werden zu leeren Zeichenfolgen. Root-Arrays und Skalare werden abgelehnt. Kommentare und die Auswahl des Autors zwischen Überschriften, Punkttasten und Inline-Tabellen werden nicht über einen einfachen Wert zurückgegeben.

TOMLs Stammtabelle, Zeitwerte und Nullgrenze

XML wird als Baum mit `@`-Attributen, gewöhnlichen untergeordneten Schlüsseln, `#text`, `#cdata`, Arrays mit wiederholten Geschwistern und literalen Namespace-Präfixen projiziert. Kommentare, Erklärungen und Verarbeitungshinweise entfallen. Die Position gemischter Texte geht verloren, und eins gegen viele kann nicht ermittelt werden, bevor Wiederholungen auftreten.

Werte werden als Zeichenfolgen gelesen, es sei denn, Rückschluss ist ausgewählt. Von JSON geschriebener Nullwert wird zu einem leeren Element und kann bei der Rückgabe nicht von einer leeren Zeichenfolge unterschieden werden. Jeder DOCTYPE wird abgelehnt und ungültige Namen stoppen die Serialisierung, anstatt neu geschrieben zu werden.

ToolAcres XML-Projektion: Elemente, Attribute, Text und Literalpräfixe

Versand in neun Richtungen: JSON nach YAML, XML, TOML und CSV; YAML bis JSON und TOML; TOML bis JSON und YAML; XML bis JSON. JSON-förmige gewöhnliche Werte schneiden zwischen JSON und YAML am besten ab. TOML führt Datums- und Nullgrenzen ein. XML erfordert Namens- und Knotenkategoriekonventionen.

CSV ist ein flacher Ausreißer und wird nur ausgegeben. Arrays oder ausgewählte Objekte werden zu Zeilen, verschachtelte Pfade werden zu gepunkteten Spalten abgeflacht, Nullen werden mit leerem Text zusammengeführt und formelähnliche Zeichenfolgen werden neutralisiert. CSV-to-JSON, XML-to-TOML und andere fehlende Paare werden abgelehnt und nicht abgeleitet.

Kompatibilitätsmatrix für die neun ausgelieferten Richtungen, mit CSV nur als Ausgabe

Binärformate und Schemasprachen liegen außerhalb des Geltungsbereichs. Ein Schema kann die Listenkardinalität wiederherstellen oder Geschäftsformen validieren, während binäre Codierungen Typen und Framing auf Byteebene einführen, die hier nicht dargestellt werden. Der Konverter beansprucht diese Fähigkeiten niemals.

Auch die Syntaxkonvertierung beweist nicht die Gültigkeit der Anwendung. Eine saubere Kubernetes-förmige Bestellnachricht YAML, XML oder eine Projektdatei TOML kann dennoch gegen den Zielvertrag verstoßen. Verwenden Sie den Domänenvalidator, nachdem Sie die Syntaxzuordnung überprüft haben.

Takeaway: Wählen Sie das Modell und dann die Syntax aus – und wie Sie mit dem Syntaxkonverter-Bedienfeld eine Konvertierung testen können, bevor Sie sich dazu verpflichten

Wählen Sie das Datenmodell aus, bevor Sie dessen Interpunktion auswählen. Wenn Kommentare und Aliase wichtig sind, kann ein JSON-Hop sie nicht beibehalten. Wenn Null wichtig ist, wird es durch die Ausgabe von TOML geändert. Wenn es auf geordnete gemischte Inhalte ankommt, reicht eine einfache JSON-Projektion nicht aus. Wenn das Ziel eine Tabelle ist, erfordert verschachteltes JSON eine explizite Reduzierungskonvention.

Verwenden Sie ToolAcre, um ein repräsentatives Dokument zu testen und jede Warnung zu lesen. Das Ergebnis ist ein Beweis für ein konkretes Paar und eine Eingabe, nicht die Erlaubnis, alle Konvertierungen verlustfrei oder jeden unterstützten Parser als vollständig aufzurufen.

Erstellen Sie das repräsentative Dokument aus den Grenzen, die für Ihren Dienst wichtig sind: null, leerer Text, ein großer Bezeichner, eine datumsähnliche Zeichenfolge, ein wiederholter Datensatz, ein Kommentar oder Alias, wenn YAML beteiligt ist, und gemischter Text, wenn XML beteiligt ist. Vergleichen Sie normalisierte Werte nach jedem unterstützten Hop und behalten Sie Warnungen mit dem Ergebnis bei. Diese Matrix wird zu einem Entscheidungsartefakt für das gewählte Modell und nicht zu einer vagen Präferenz für eine vertraute Syntax.