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 Name | Brief Description | Parameters | Result |
|---|---|---|---|
| length | longueur de chaîne, | ValueType | ValueType |
| tableau ou objet | |||
| count | taille de la nodelist | NodesType | ValueType |
| match | expression régulière | ValueType, | LogicalType |
| correspondance totale | ValueType | ||
| search | expression régulière | ValueType, | LogicalType |
| correspondance sous-chaîne | ValueType | ||
| value | valeur du seul | NodesType | ValueType |
| nœud de la nodelist |
Tableau 19 : Entrées initiales du sous-registre Function Extensions