JSON-Pointer-Token escapen

Was die Umwandlung ändert

Escapen Sie einen Eigenschaftsnamen als JSON-Pointer-Abschnitt. Ersetzt zuerst Tilde durch ~0 und dann Schrägstrich durch ~1.

Beispiel mit Eingabe und Ausgabe

Beginnen Sie mit der Eingabe auf dieser Seite: name/a~b. Das Werkzeug erzeugt: name~1a~0b. Testen Sie zuerst das Beispiel, um beide Darstellungen zu vergleichen. Ersetzen Sie es danach durch eigene Daten. Das Ergebnis ist Text für Editor, Testfall oder Anfrage, sobald Sie geprüft haben, ob das Ziel genau diese Form erwartet.

Formatregeln und Grenzen

Ein JSON Pointer besteht aus Referenz-Token, die durch wörtliche Schrägstriche getrennt sind. Diese Seite wandelt ein einzelnes Token um, keinen ganzen Pointer und kein URL-Fragment. RFC 6901 reserviert zwei Zeichen innerhalb der Token: Tilde wird als ~0 und Schrägstrich als ~1 geschrieben. Beim Dekodieren muss ~1 vor ~0 verarbeitet werden; so wird ~01 zu ~1 und nicht zu einem Schrägstrich. Andere Tilde-Folgen sind ungültig und werden abgewiesen. Für einen ganzen Pointer escapen Sie jeden Eigenschaftsnamen getrennt und verbinden Token mit einem führenden Schrägstrich. Ein leeres Token bezeichnet einen leeren Eigenschaftsnamen und ist nicht dasselbe wie ein fehlendes Token. Allgemeine URL-Kodierung ist kein Ersatz: Prozent-Escapes gehören zur URI-Fragmentdarstellung und bilden eine andere Ebene.

Ergebnis prüfen

Lassen Sie das Original beim Prüfen neben dem umgewandelten Text stehen. Vergleichen Sie zuerst einen kleinen bekannten Fall, möglichst mit Satzzeichen, einem Nicht-ASCII-Zeichen, einem wiederholten Wert oder einem relevanten leeren Feld. Lesbare Ausgabe beweist nicht, dass das Zielprogramm dasselbe Schema oder dieselben Konventionen akzeptiert. Beim Austausch zwischen Anwendungen sollten Sie den Zielparser ausführen und nach dem Import einige Datensätze kontrollieren. Wichtige Quelldateien gehören unter Versionskontrolle, damit Änderungen umkehrbar bleiben. Die Verarbeitung findet in Ihrem Browser statt; diese Seite sendet eingefügten Inhalt nicht an einen Konvertierungsserver. Browser-Speicher und Zwischenablage erfordern auf gemeinsam genutzten Geräten dennoch normale Vorsicht.

Quelle und Ergebnis erfüllen verschiedene Zwecke, auch wenn sie ähnlich aussehen. Die obige Methode beschreibt die unterstützte Teilmenge und nicht jede Erweiterung des Formats. Testen Sie bei einem strengen Zielsystem zuerst einen kleinen bekannten Fall, bevor Sie viele Datensätze ändern. Nach einem Validierungsfehler prüfen Sie Quelle und erste gemeldete Stelle; eine Korrektur nur der Ausgabe kann die Ursache verdecken.

Zur Prüfung eines Pointer-Tokens escapen Sie einen Eigenschaftsnamen und dekodieren die Ausgabe wieder; der Text muss einschließlich Tilden und Schrägstrichen genau übereinstimmen. Beim Zusammensetzen eines ganzen JSON Pointers stehen Schrägstriche zwischen bereits escapten Token. Der führende Schrägstrich gehört zum Pfad, nicht zum hier eingegebenen Token. Testen Sie die besondere Eingabe ~1 getrennt, weil die Dekodierreihenfolge wichtig ist.