3. IANA Considerations (IANA-Überlegungen)

3.1. Registration of Media Type application/jsonpath (Registrierung des Medientyps application/jsonpath)

IANA hat den folgenden Medientyp registriert [RFC6838]:

Typname (Type name): application

Untertypname (Subtype name): jsonpath

Erforderliche Parameter (Required parameters): k. A. (N/A)

Optionale Parameter (Optional parameters): k. A. (N/A)

Kodierungsüberlegungen (Encoding considerations): binär (UTF-8)

Sicherheitsüberlegungen (Security considerations): Siehe den Abschnitt Security Considerations von RFC 9535.

Interoperabilitätsüberlegungen (Interoperability considerations): k. A. (N/A)

Veröffentlichte Spezifikation (Published specification): RFC 9535

Anwendungen, die diesen Medientyp nutzen (Applications that use this media type): Anwendungen, die Abfragen in JSON-Daten übermitteln müssen

Fragment-Identifier-Überlegungen (Fragment identifier considerations): k. A. (N/A)

Zusätzliche Informationen (Additional information):

Veraltete Aliasnamen für diesen Typ (Deprecated alias names for this type): k. A. (N/A) Magic number(s): k. A. (N/A) Dateierweiterung(en) (File extension(s)): k. A. (N/A) Macintosh-Dateityp-Code(s) (Macintosh file type code(s)): k. A. (N/A)

Person und E-Mail für weitere Informationen (Person & email address to contact for further information): [email protected]

Beabsichtigte Nutzung (Intended usage): COMMON

Nutzungseinschränkungen (Restrictions on usage): k. A. (N/A)

Autor (Author): JSONPath WG

Änderungskontrolle (Change controller): IETF

3.2. Function Extensions Subregistry (Unterregister Function Extensions)

Gemäß dieser Spezifikation hat IANA ein neues Unterregister „Function Extensions“ in einem neuen Register „JSONPath“ angelegt. Das Unterregister „Function Extensions“ hat die Richtlinie „Expert Review“ (Abschnitt 4.5 von [RFC8126]).

Die Experten werden angewiesen, sparsam mit Funktionserweiterungsnamen umzugehen, die auf allgemein anwendbare Semantik hindeuten, und sie für Funktionen vorzuhalten, die voraussichtlich breite Nutzung finden und von ihrer Kürze profitieren können. Der Experte wird außerdem angewiesen, den Registranten zur Bereitstellung einer Spezifikation (Abschnitt 4.6 von [RFC8126]) zu verweisen, kann jedoch Ausnahmen machen, z. B. wenn zum Zeitpunkt der Registrierung keine Spezifikation verfügbar ist, aber wahrscheinlich nachfolgt. Wird der Experte auf im Einsatz befindliche Funktionserweiterungen aufmerksam, kann er auch eigenständig eine Registrierung einleiten, wenn er der Ansicht ist, dass eine solche Registrierung künftige Kollisionen vermeiden kann.

Jeder Eintrag im Unterregister MUSS Folgendes enthalten:

Function Name: Eine aus Kleinbuchstaben bestehende ASCII-[RFC0020]-Zeichenkette, die mit einem Buchstaben beginnt und danach Buchstaben, Ziffern und Unterstriche enthalten kann ([a-z][_a-z0-9]*). Kein anderer Eintrag im Unterregister darf denselben Funktionsnamen haben.

Brief description: Eine kurze Beschreibung

Parameters: Eine kommagetrennte Liste von null oder mehr deklarierten Typen, je einer für jedes erwartete Argument dieser Funktionserweiterung

Result: Der deklarierte Typ des Ergebnisses dieser Funktionserweiterung

Change Controller: Siehe Abschnitt 2.3 von [RFC8126].

Reference: Ein Referenzdokument mit Beschreibung der Funktionserweiterung

Die anfänglichen Einträge in diesem Unterregister sind in Tabelle 19 aufgeführt; die Einträge in der Spalte „Change Controller“ haben alle den Wert „IETF“, die in der Spalte „Reference“ alle den Wert „Section 2.4 of RFC 9535“:

Function Name	Brief Description	Parameters	Result
length	Länge von Zeichenkette,	ValueType	ValueType
	Array oder Objekt
count	Größe der Knotenliste	NodesType	ValueType
match	regulärer Ausdruck	ValueType,	LogicalType
	Volltreffer	ValueType
search	regulärer Ausdruck	ValueType,	LogicalType
	Teilzeichenketten-Match	ValueType
value	Wert des einzelnen	NodesType	ValueType
	Knotens in der Knotenliste

Tabelle 19: Anfangseinträge im Unterregister Function Extensions