查看源代码

[[Category:XMPP扩展]]
[[Category:翻译中]]

'''本文的英文原文来自[http://www.xmpp.org/extensions/xep-0147.html XEP-0147]'''

'''XEP-0147: XMPP URI Scheme查询组件'''

{|
!摘要:
|本文定义了一个查询组件的注册项用于XMPP IRIs/URIs的上下文，也指定了注册项的值的首次提交步骤.

|-
!作者:
|Peter Saint-Andre
|-
!版权:
|© 1999 - 2012 XMPP标准化基金会(XSF). 参见[[XEP-0147#法律通告|法律通告]].
|-
!状态:
|活跃
|-
!类型:
|信息
|-
!版本:
|1.2
|-
!最后更新日期:
|2006-09-13
|}

-----
注意: 这个信息性的协议定义了一个已经被XMPP评议会 和/或 XSF董事会批准的最佳实践或协议范本. 该协议被鼓励实现并且这一最佳实践或或协议范本适于部署到生产环境.
-----

==简介==

[http://tools.ietf.org/html/rfc5122 RFC 5122] [[XEP-0147#附录G:备注|1]] 定义了一个统一资源标识符(URI)方案用于把用可扩展的消息和出席信息协议(参见 [[RFC6120|XMPP核心]] [[XEP-0147#附录G:备注|3]])来通讯的实体的地址格式化成 URIs 和互联网资源标识符(IRIs) [[XEP-0147#附录G:备注|2]]. 这些标识符使得非类似数据库和web浏览器的本地应用能对XMPP实体进行鉴定和与之交互.

无论如何, RFC 5122 故意在查询组件留下开放式的潜在值, 未对查询提供一个常用"操作"列表(例如, 发送小西或加入聊天室), 并且未指定推荐的"键-值" 对来用于这类操作作的上下文. 所以, 本文定义了这类操作的注册项和 键－值 对(由 [http://xmpp.org/registrar/ XMPP注册项] [[XEP-0147#备注|4]]) 维护并为那个注册项指定一组初始值.

本文组织如下:

:* 注册项定义于 [[XEP-0147#XMPP IRI/URI查询类型注册项|XMPP IRI/URI查询类型注册项]] 章节.
:* 操作和 键-值 对一组初始值在 [[XEP-0147#查询操作|查询操作]] 章节中描述.
:* 该注册项相应的初始提交定义于[[XEP-0147#注册项|初始注册项]]章节.
:* 提交额外值到注册项的过程定义于[[XEP-0147#注册过程|注册过程]]章节.

注意: XMPP URI scheme 的格式, 包括查询组件的格式, 完全被指定并正式地被定义是在 '''RFC 5122''' ; 本文未以任何方式修改 xmpp URI scheme 并假定读者对 '''RFC 5122''' 各方面很熟悉.

==术语==

本文从 [http://tools.ietf.org/html/rfc3986 RFC 3986] [[XEP-0147#附录G:备注|5]], [http://tools.ietf.org/html/rfc3987 RFC 3987] [[XEP-0147#附录G:备注|6]], 和 '''RFC 5122''' 继承术语.

==查询操作==

通过XMPP IRI/URI和XMPP实体的交互来触发的操作的范围，接本上和XMPP扩展的范围一样广泛. 本文不专注于详尽地定义所有这类潜在的操作. 然而, 以下操作可能一般人都会感兴趣的:

:# 发送一条消息.
:# 添加或删除一个名册条目.
:# 订阅或取消订阅一个实体的出席信息.
:# 确定一个实体的[[XEP-0030|服务发现]] [[附录G:备注|7]] 信息.
:# 加入一个群聊房间(见[[XEP-0045|多用户聊天]] [[附录G:备注|8]]).
:# 请求对一个实体执行[[XEP-0050|特定的命令]] [[附录G:备注|9]].
:# 接收和一个实体相关的[[XEP-0054|电子名片]] [[附录G:备注|10]] 数据.
:# 订阅或取消订阅一个[[XEP-0060|发布-订阅]] [[附录G:备注|11]] 节点.
:# 通过[[XEP-0077|带内注册]] [[附录G:备注|12]]来注册另一个实体.
:# 发起和另一个实体的文件传输 (见 [[XEP-0096|文件传输]] [[附录G:备注|12]]13]]).

对于每个这类操作, XMPP注册项维护一个推荐的(RECOMMENDED) "查询类型" (这可以被认为是操作的名称或 "动词"; 语法和语义参见 RFC 5122) 以及如果必要的话，可选的(OPTIONAL)用于 键-值 对的键列表.

和RFC 3920及RFC 3921相关的查询类型和 键-值 对定义于此; 和XMPP标准基金会的XEP系列定义的协议相关的查询类型和 键-值 对定义于相应的XMPP扩展协议规范中.

===消息操作===

对于XMPP IRI/URI来说触发特定的接口用来发送一个XMPP消息节可能是最受欢迎的. 对于这个操作，建议的查询类型是"message". 如果没有提供 键－值 对, 和包含了查询类型"message"的 XMPP IRI/URI交互应该触发一个接口允许用户输入一个XMPP消息文本和其他相关的参数(例如, 一个消息标题或 [http://xmpp.org/extensions/xep-0071.html XHTML-IM] [[XEP-0147#附录G:备注|14] 加成).

'''示例1. 基本消息操作'''

<source lang="text">
xmpp:romeo@montague.net?message
</source>

一个查询类型为"message"的查询组件可以指定各种 键－值 对. 以下三个键和[[RFC6121|XMPP IM]] [[XEP-0147#附录G:备注|15]] 中的'jabber:client'命名空间的XML schema定义的<message/>节的子元素相关:

:# subject
:# body
:# thread

另外, 以下三个键和'jabber:client'命名空间的XML schema定义的<message/>节的属性相关('to'属性是不必要的, 因为它由 IRI/URI中包含的XMPP Address提供):

:# from
:# id
:# type

其他键可以在XMPP注册处去注册但是没有在这里定义.

'''示例2. 带键的消息操作: IRI/URI'''

<source lang="text">
xmpp:romeo@montague.net?message;subject=Test%20Message;body=Here%27s%20a%20test%20message
</source>

'''示例3. M带键的操作: 结果节'''

<source lang="xml">

<message to='romeo@montague.net'>
  <subject>Test Message</subject>
  <body>Here&apos;s a test message.</body>
</message>

</source>

===名册管理操作===
====添加名册条目====
====删除名册条目====
===订阅管理操作===
====订阅====
====取消订阅====

==国际化事项==
==安全事项==
==IANA事项==
==XMPP注册项事项==
===XMPP IRI/URI查询类型注册项===
====注册过程====
====注册项====

==附录==
===附录A:文档信息===
===附录B:作者信息===
===附录C:法律通告===
===附录D:和XMPP的关系===
===附录E:讨论地点===
===附录F:需求一致性===
===附录G:备注===
===附录H:修订历史===