3. IANA Considerations (IANA 考量)

3.1. Registration of Media Type application/jsonpath (媒体类型 application/jsonpath 的注册)

IANA 已注册下列 media type [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" registry (注册表) 中创建新的 "Function Extensions" subregistry (子注册项). "Function Extensions" subregistry 的策略为 "Expert Review (专家审阅)" ([RFC8126] 第 4.5 节).

专家被告知应节约分配暗示具有普遍适用语义的 function extension 名称, 将其保留给可能广泛使用且能充分利用其简洁性的函数. 专家亦被告知应指导注册者提供 specification (规范, [RFC8126] 第 4.6 节), 但可例外, 例如注册时尚无规范但很可能随后发布. 若专家获知某 function extension 已部署使用, 亦可自行发起注册, 若认为可避免潜在未来冲突.

Subregistry 中每条目必须包含:

Function Name (函数名): 小写 ASCII [RFC0020] 字符串, 以字母开头, 之后可含字母, 数字与下划线 ([a-z][_a-z0-9]*). Subregistry 中不得有其他条目使用相同函数名.

Brief description (简要描述): 简要说明

Parameters (参数): 零个或多个声明类型的逗号分隔列表, 对应该 function extension 的每个预期实参

Result (结果): 该 function extension 结果的声明类型

Change Controller (变更控制方): 见 [RFC8126] 第 2.3 节.

Reference (参考): 提供该 function extension 描述的参考文档

此 subregistry 的初始条目见表 19; "Change Controller" 列均为 "IETF", "Reference" 列均为 "Section 2.4 of RFC 9535":

Function Name	Brief Description	Parameters	Result
length	string, array 或 object 的长度	ValueType	ValueType
count	nodelist 的大小	NodesType	ValueType
match	正则表达式全匹配	ValueType, ValueType	LogicalType
search	正则表达式子串匹配	ValueType, ValueType	LogicalType
value	nodelist 中单个节点的值	NodesType	ValueType

表 19: Function Extensions Subregistry 初始条目