Aller au contenu principal

3. IANA Considerations (Considérations IANA)

3. IANA Considerations (Considérations IANA)

3.1. Registration of Media Type application/jsonpath (Enregistrement du type de média application/jsonpath)

IANA a enregistré le type de média suivant [RFC6838] :

Nom de type : application

Nom de sous-type : jsonpath

Paramètres requis : N/A

Paramètres optionnels : N/A

Considérations d'encodage : binaire (UTF-8)

Considérations de sécurité : voir la section Security Considerations du RFC 9535.

Considérations d'interopérabilité : N/A

Spécification publiée : RFC 9535

Applications utilisant ce type de média : applications devant transporter des requêtes dans des données JSON

Considérations sur les identifiants de fragment : N/A

Informations complémentaires :

Noms d'alias dépréciés pour ce type : N/A. Numéro(s) magique(s) : N/A. Extension(s) de fichier : N/A. Code(s) de type de fichier Macintosh : N/A.

Personne et adresse courriel pour plus d'informations : [email protected]

Usage prévu : COMMON

Restrictions d'usage : N/A

Auteur : JSONPath WG

Contrôleur des changements : IETF

3.2. Function Extensions Subregistry (Sous-registre Function Extensions)

Conformément à cette spécification, IANA a créé un nouveau sous-registre « Function Extensions » dans un nouveau registre « JSONPath ». Le sous-registre « Function Extensions » a la politique « Expert Review » (section 4.5 de [RFC8126]).

Les experts sont invités à être parcimonieux dans l'attribution de noms d'extensions de fonction évoquant une sémantique d'application générale, en les réservant pour des fonctions susceptibles d'un usage large et pouvant tirer parti de leur concision. L'expert est aussi invité à orienter le demandeur vers la fourniture d'une spécification (section 4.6 de [RFC8126]) mais peut faire des exceptions, par exemple lorsqu'une spécification n'est pas disponible au moment de l'enregistrement mais est susceptible d'arriver. Si l'expert prend connaissance d'extensions de fonction déployées et utilisées, il peut aussi initier un enregistrement de sa propre initiative s'il estime qu'un tel enregistrement peut éviter des collisions futures.

Chaque entrée du sous-registre doit inclure les éléments suivants :

Function Name : une chaîne ASCII minuscule [RFC0020] commençant par une lettre et pouvant ensuite contenir des lettres, des chiffres et des traits de soulignement ([a-z][_a-z0-9]*). Aucune autre entrée du sous-registre ne peut porter le même nom de fonction.

Brief description : une brève description

Parameters : une liste séparée par des virgules de zéro ou plusieurs types déclarés, un pour chaque argument attendu pour cette extension de fonction

Result : le type déclaré du résultat de cette extension de fonction

Change Controller : voir la section 2.3 de [RFC8126].

Reference : un document de référence décrivant l'extension de fonction

Les entrées initiales de ce sous-registre sont listées au tableau 19 ; les entrées de la colonne « Change Controller » ont toutes la valeur « IETF », et les entrées de la colonne « Reference » ont toutes la valeur « Section 2.4 of RFC 9535 » :

Function NameBrief DescriptionParametersResult
lengthlongueur de chaîne,ValueTypeValueType
tableau ou objet
counttaille de la nodelistNodesTypeValueType
matchexpression régulièreValueType,LogicalType
correspondance totaleValueType
searchexpression régulièreValueType,LogicalType
correspondance sous-chaîneValueType
valuevaleur du seulNodesTypeValueType
nœud de la nodelist

Tableau 19 : Entrées initiales du sous-registre Function Extensions