3. IANA Considerations (IANA に関する考慮事項)
3. IANA Considerations (IANA に関する考慮事項)
3.1 Registration of Media Type application/jsonpath (メディアタイプ application/jsonpath の登録)
IANA は次のメディアタイプ [RFC6838] を登録しました:
Type name (型名): application
Subtype name (サブタイプ名): jsonpath
Required parameters (必須パラメータ): N/A
Optional parameters (任意パラメータ): N/A
Encoding considerations (エンコーディング上の考慮): binary (UTF-8)
Security considerations (セキュリティ上の考慮): RFC 9535 の Security Considerations 節を参照.
Interoperability considerations (相互運用上の考慮): N/A
Published specification (公開仕様): RFC 9535
Applications that use this media type (本メディアタイプを用いるアプリケーション): JSON データ内でクエリを伝達する必要があるアプリケーション
Fragment identifier considerations (フラグメント識別子の考慮): N/A
Additional information (追加情報):
Deprecated alias names for this type (本タイプの廃止予定別名): N/A Magic number(s): N/A File extension(s): N/A Macintosh file type code(s): N/A
Person & email address to contact for further information (追加情報の連絡先): [email protected]
Intended usage (意図された用途): COMMON
Restrictions on usage (利用上の制限): N/A
Author (著者): JSONPath WG
Change controller (変更管理者): IETF
3.2 Function Extensions Subregistry (関数拡張サブレジストリ)
本仕様に従い, IANA は新規 "JSONPath" レジストリ内に "Function Extensions" サブレジストリを作成しました. "Function Extensions" サブレジストリのポリシーは "Expert Review" です ([RFC8126] 第4.5節).
エキスパートには, 一般的に適用可能な意味を想起させる関数拡張名の割当てを倹約し, 広く使われ簡潔さの恩恵が大きい関数向けに留めるよう指示されています. エキスパートは登録者に仕様書の提供を指示します ([RFC8126] 第4.6節) が, 例えば登録時点では仕様がないが近いうちに得られる見込みがある場合など例外を認めてもよいです. エキスパートが展開済みで使用されている関数拡張を把握した場合, 将来の衝突を避ける登録として有益と判断すれば, 自ら登録を開始してもよいです.
サブレジストリの各エントリには次を含めなければなりません:
Function Name (関数名): 文字で始まり, その後に文字, 数字, アンダースコアを含みうる小文字 ASCII [RFC0020] 文字列 ([a-z][_a-z0-9]*). サブレジストリの他エントリと同じ関数名を持ってはなりません.
Brief description (簡潔な説明): 簡潔な説明
Parameters (パラメータ): ゼロ個以上の宣言型のカンマ区切りリスト, 本関数拡張が期待する各引数に対応
Result (結果): 本関数拡張の結果の宣言型
Change Controller (変更管理者): [RFC8126] 第2.3節を参照.
Reference (参照): 関数拡張の説明を提供する参照文書
本サブレジストリの初期エントリを表19に示します. "Change Controller" 列はすべて "IETF", "Reference" 列はすべて "Section 2.4 of RFC 9535" です:
| Function Name | Brief Description | Parameters | Result |
|---|---|---|---|
| length | string, | ValueType | ValueType |
| array, or object の長さ | |||
| count | nodelist のサイズ | NodesType | ValueType |
| match | regular expression | ValueType, | LogicalType |
| full match | ValueType | ||
| search | regular expression | ValueType, | LogicalType |
| substring match | ValueType | ||
| value | nodelist 内の単一 | NodesType | ValueType |
| ノードの値 |
表19: Function Extensions サブレジストリの初期エントリ