XEP-0144 - 版本历史

Admin: /* 服务查询 */

2013-07-26T06:26:53Z

服务查询

Admin: /* 建议名册条目修改 */

2013-07-26T06:25:37Z

建议名册条目修改

Admin: /* 建议名册条目删除 */

2013-07-26T06:25:10Z

建议名册条目删除

Admin: /* 绪论 */

2013-07-26T06:24:28Z

绪论

2013年7月25日 (四) 09:32 Admin

2013-07-25T09:32:43Z

Admin: /* 附录H:修订历史 */

2013-07-25T09:32:29Z

附录H:修订历史

Admin: /* 附录G:备注 */

2013-07-25T09:29:37Z

附录G:备注

Admin: /* 附录B:作者信息 */

2013-07-25T09:14:33Z

附录B:作者信息

Admin: /* XML Schema */

2013-07-25T09:13:55Z

XML Schema

显示差异

Admin: /* XML Schema */

2013-07-25T09:09:06Z

XML Schema

@@ 第143行： / 第143行： @@
 ==服务查询==
-为了确定是否一个接收实体支持这里定义的协议, 发送实体应该使用[[XEP-0030|服务查询]] [[XEP-0144#附录G:备注|6]] 但可以依赖[[XEP-0115|实体能力]] [[XEP-0144#附录G:备注|7]]定义的服务查询的"profile". 如果一个实体支持名册条目交换, 它必须(遵循如[[XEP-0144#声明支持|声明支持]]所述的适当的安全事项)在它对对 disco#info 查询的应答中包含 <feature var='http://jabber.org/protocol/rosterx'/>. 于是一个发送实体能查询是否一个接收实体支持这里定义的协议，通过发送一个如下格式的IQ请求:
+为了确定是否一个接收实体支持这里定义的协议, 发送实体应该使用[[XEP-0030|服务查询]] [[XEP-0144#附录G:备注|6]] 但可以依赖[[XEP-0115|实体能力]] [[XEP-0144#附录G:备注|7]]定义的服务查询的"profile". 如果一个实体支持名册条目交换, 它必须(遵循如[[XEP-0144#声明支持|声明支持]]所述的适当的安全事项)在它对对 disco#info 查询的应答中包含 <feature var='http://jabber.org/protocol/rosterx'/> . 于是一个发送实体能查询是否一个接收实体支持这里定义的协议，通过发送一个如下格式的IQ请求:
 '''例子 4. 发送实体查询支持'''
@@ 第171行： / 第171行： @@
    </query>
 </iq>
 </source>
 ==推荐的节类型==

@@ 第110行： / 第110行： @@
 ===建议名册条目修改===
-为了程序化地建议接收实体应该从它的名册中修改一个或多个条目, 发送实体必须发送一个包含由'http://jabber.org/protocol/rosterx'命名空间限定的<x/>元素的<message/>或<iq/>节; 相应的该<x/>元素必须包含一个或多个<item/>子元素, 每个都应该拥有一个值为"modify"的'action'属性, 必须拥有一个'jid'属性来指定被修改的条目的JabberID, 可以拥有一个'name'属性来指定一个用于该条目的自然语言名称或昵称, 并且可以包含一个或多个<group/>元素来指定存放该条目的名册组. 如果一个<message/>节被发送了, 它可以包含一个<body/>元素但不应该(SHOULD NOT)包含任何子元素. 这里是例子:
+为了程序化地建议接收实体应该从它的名册中修改一个或多个条目, 发送实体必须发送一个包含由 'http://jabber.org/protocol/rosterx' 命名空间限定的<x/>元素的<message/>或<iq/>节; 相应的该<x/>元素必须包含一个或多个<item/>子元素, 每个都应该拥有一个值为"modify"的'action'属性, 必须拥有一个'jid'属性来指定被修改的条目的JabberID, 可以拥有一个'name'属性来指定一个用于该条目的自然语言名称或昵称, 并且可以包含一个或多个<group/>元素来指定存放该条目的名册组. 如果一个<message/>节被发送了, 它可以包含一个<body/>元素但不应该(SHOULD NOT)包含任何子元素. 这里是例子:
 '''例子 3. 建议修改'''

@@ 第79行： / 第79行： @@
 ===建议名册条目删除===
-为了程序化地建议接收实体应该从它的名册删除一个或多个条目, 发送实体必须发送一个包含由'http://jabber.org/protocol/rosterx'命名空间限定的<x/>元素的<message/>或<iq/>节; 相应的该<x/>元素必须包含一个或多个<item/>子元素, 每个必须拥有一个值为"delete"的'action'属性, 必须拥有一个'jid'属性来指定要被删除的条目的JabberID, 可以拥有一个'name'属性来为该条目指定一个自然语言名称或昵称, 并且可以包含一个或多个<group/>元素来为该条目指定名册组. 如果一个<message/>节被发送了, 它可以包含一个<body/>元素但不应该(SHOULD NOT)包含任何子元素. 这是一个例子:
+为了程序化地建议接收实体应该从它的名册删除一个或多个条目, 发送实体必须发送一个包含由 'http://jabber.org/protocol/rosterx' 命名空间限定的<x/>元素的<message/>或<iq/>节; 相应的该<x/>元素必须包含一个或多个<item/>子元素, 每个必须拥有一个值为"delete"的'action'属性, 必须拥有一个'jid'属性来指定要被删除的条目的JabberID, 可以拥有一个'name'属性来为该条目指定一个自然语言名称或昵称, 并且可以包含一个或多个<group/>元素来为该条目指定名册组. 如果一个<message/>节被发送了, 它可以包含一个<body/>元素但不应该(SHOULD NOT)包含任何子元素. 这是一个例子:
 '''例子 2. Suggesting Deletion'''

@@ 第28行： / 第28行： @@
 ==绪论==
-Jabber协议早有一种方法，将名册条目从一个实体发送到另一个，使用'jabber:x:roster'命名空间。因为这个协议扩展对[http://tools.ietf.org/html/rfc2779 RFC 2779] [[XEP-0144#附录G:备注|1]]不是必需的，它被移出了[[RFC6121|XMPP IM]] [[XEP-0144#附录G:备注|2]], 并且出于历史原因记录在[http://xmpp.org/extensions/xep-0093.html Roster Item Exchange] [[XEP-0144#附录G:备注|3]]中。 无论如何，那次在[http://mail.jabber.org/mailman/listinfo/standards/  Standards SIG] [[XEP-0144#附录G:备注|4]]中的讨论展现出使用名册条目交换有助于解决"共享组"（例如，在用于一个组织的预定义名册组）方面的问题以及名册同步（例如，保持一个Jabber名册和位于外部IM服务上的一个联系人列表同步）方面的问题。这些领域的问题，要求一种比XEP-0093中记录的方法更加精密些的名册条目交换，特别是指示一个名册项目是否要被添加，删除或修改的能力。因此，本文重定义了名册条目交换以一种向后兼容现有实现的方式来提供此功能，虽然使用了一个现代的命名空间的URI 'http://jabber.org/protocol/rosterx'，而不是旧的'Jabber：x：roster'名字空间名字。更多的规范将定义如何使用这里定义的协议来解决共享组和名册同步的问题.
+Jabber协议早有一种方法，将名册条目从一个实体发送到另一个，使用'jabber:x:roster'命名空间。因为这个协议扩展对[http://tools.ietf.org/html/rfc2779 RFC 2779] [[XEP-0144#附录G:备注|1]]不是必需的，它被移出了[[RFC6121|XMPP IM]] [[XEP-0144#附录G:备注|2]], 并且出于历史原因记录在[http://xmpp.org/extensions/xep-0093.html Roster Item Exchange] [[XEP-0144#附录G:备注|3]]中。 无论如何，那次在[http://mail.jabber.org/mailman/listinfo/standards/  Standards SIG] [[XEP-0144#附录G:备注|4]]中的讨论展现出使用名册条目交换有助于解决"共享组"（例如，在用于一个组织的预定义名册组）方面的问题以及名册同步（例如，保持一个Jabber名册和位于外部IM服务上的一个联系人列表同步）方面的问题。这些领域的问题，要求一种比XEP-0093中记录的方法更加精密些的名册条目交换，特别是指示一个名册项目是否要被添加，删除或修改的能力。因此，本文重定义了名册条目交换以一种向后兼容现有实现的方式来提供此功能，虽然使用了一个现代的命名空间的URI 'http://jabber.org/protocol/rosterx' ，而不是旧的 'Jabber：x：roster' 名字空间名字。更多的规范将定义如何使用这里定义的协议来解决共享组和名册同步的问题.
 ==需求==

@@ 第1行： / 第1行： @@
 [[Category:XMPP扩展]]
-[[Category:翻译中]]
+[[Category:已翻译]]
 '''本文的英文原文来自[http://www.xmpp.org/extensions/xep-0144.html XEP-0144]'''

@@ 第386行： / 第386行： @@
 注意: 本协议的旧版本可能在 http://xmpp.org/extensions/attic/ 还可用
-:'''Version 1.6 (2007-02-15)'''
+:'''Version 1.0 (2005-08-26)'''
-::Added two notes to maintain consistency with XEP-0191.
+::Per a vote of the Jabber Council, advanced status to Draft. (psa)
-::(psa)
-:'''Version 1.5 (2006-11-27)'''
+:'''Version 0.6 (2005-07-28)'''
-::Modified message stanza handling (server should return <service-unavailable/> error) and added implementation note to maintain consistency with XEP-0191.
+::Incorporated Council feedback: specified that a body MAY be included when sending a message stanza; changed prohibition on mixing of additions, deletions, and modifications from SHOULD NOT to MUST NOT; clarified status of bots as sending entities. (psa)
-::(psa)
-:'''Version 1.4 (2006-10-04)'''
+:'''Version 0.5 (2005-07-26)'''
-::Copied Section 10 of RFC 3921.
+::Reverted roster item deletion changes. (psa)
-::(psa)
-:'''Version 1.3 (2004-07-26)'''
+:'''Version 0.4 (2005-07-21)'''
-::Formally retracted this proposal in favor of XMPP IM.
+::Simplified processing of roster item deletions. (psa)
-::(psa)
-:'''Version 1.2 (2003-03-12)'''
+:'''Version 0.3 (2004-10-27)'''
-::Changed status to Deprecated since this protocol is now included in the XMPP IM Internet-Draft.
+::Clarified the nature of sending entities (users, gateways, and group services); specified "directory/group" service discovery identity for shared group services. (psa)
-::(psa)
-:'''Version 1.1 (2002-11-17)'''
+:'''Version 0.2 (2004-10-04)'''
-::Added remarks about default handling, and where list processing should take place.
+::Further defined the nature of trusted entities. (psa)
-::(pgm)
-:'''Version 1.0 (2002-10-22)'''
+:'''Version 0.1 (2004-09-29)'''
-::Changed status to Draft.
+::Initial version. (psa)
-::(psa)
-:'''Version 0.4 (2002-10-03)'''
+:'''Version 0.0.2 (2004-09-22)'''
-::Elaborated on various JID possibilities.
+::To address Council feedback, added text about service discovery and choice of stanza type (message or IQ). (psa)
-::(pgm)
-:'''Version 0.3 (2002-07-31)'''
+:'''Version 0.0.1 (2004-09-16)'''
-::Added info describing current session issues
+::Forked XEP-0093 by adding the action attribute, defining requirements and use cases, specifying processing rules, and detailing security considerations. (psa)
-::(pgm)
-−
-:'''Version 0.2 (2002-07-30)'''
-−
-::Added whitelists, subscription filtering, and multiple list capabilities. Changed block to deny.
-::(pgm)
-−
-:'''Version 0.1 (2002-01-18)'''
-−
-::Initial version.
-::(pgm)
 --------------------------------------------
 结束

@@ 第352行： / 第352行： @@
 ===附录G:备注===
-# XEP-0191: 简单通讯屏蔽 <http://xmpp.org/extensions/xep-0191.html>.
+. RFC 2779: 一个用于出席信息和即时消息的模型 <http://tools.ietf.org/html/rfc2779>.
-# RFC 3921: 可扩展的消息和出席信息协议 (XMPP): 即时消息和出席信息 <http://tools.ietf.org/html/rfc3921>.
-# RFC 2779: 一个用于出席信息和即时消息的模型 <http://tools.ietf.org/html/rfc2779>.
+. RFC 6121: 可扩展的消息和出席信息协议 (XMPP): 即时消息和出席信息 <http://tools.ietf.org/html/rfc6121>.
-# 一个实现不能(MUST NOT)从一个用户的某一个资源屏蔽另一个资源, 即使该用户定义了一个在那种行为下会得到其他结果的规则.
-# 当包含了一个<presence-out/>元素, 该服务器可能也屏蔽类出席信息的通知, 类似在[http://xmpp.org/extensions/xep-0163.html 个人事件协议]] [[XEP-0016#附录G:备注|6]] 中使用的那些.
+. XEP-0093: 名册条目交换 <http://xmpp.org/extensions/xep-0093.html>.
-# XEP-0163: 个人事件协议 <http://xmpp.org/extensions/xep-0163.html>.
-# RFC 6120: 可扩展的消息和出席信息协议 (XMPP): 核心 <http://tools.ietf.org/html/rfc6120>.
+. 标准SIG是一个代表特别兴趣的组，致力于XMPP扩展协议开发. 这个标准SIG的讨论组是XMPP协议扩展讨论的主要场所, 同时用于XMPP扩展和XMPP注册项的声明. 要订阅这个列表或查看该列表的归档文件, 请访问 <http://mail.jabber.org/mailman/listinfo/standards/>.
-# 直到本文的版本1.5(所以也在RFC 6121中), 都是推荐安静地忽略消息节, 这很不幸地会导致关于消息节的递送"黑洞".
-# XEP-0030: 服务发现 <http://xmpp.org/extensions/xep-0030.html>.
+. 'action'属性的缺省值是"add"; 所以, 如果'action'属性未被包含或接收应用不理解该'action'属性, 该接收实体必须把该条目的值视为"add".
-# XEP-0055: Jabber搜索 <http://xmpp.org/extensions/xep-0055.html>.
-# 互联网号码分配机构(IANA)是为互联网协议分配唯一性的参数值的中间协调者, 类似端口号码和 URI schemes. 更多信息参见 <http://www.iana.org/>.
+. XEP-0030: 服务查询 <http://xmpp.org/extensions/xep-0030.html>.
-# XMPP注册处维护一个保留的协议命名空间的列表和在XMPP标准基金会批准的XMPP扩展协议的上下文中使用的参数的注册项的列表. 更多信息见 <http://xmpp.org/registrar/>.
 ===附录H:修订历史===

←上一版本		2013年7月25日 (四) 09:14的版本
第339行：		第339行：

	===附录B:作者信息===		===附录B:作者信息===
−
−	~~'''Peter Millard'''~~
−
−	~~见 [[XEP-0016#作者备注\|作者备注]]~~

	'''Peter Saint-Andre'''		'''Peter Saint-Andre'''

←上一版本		2013年7月25日 (四) 09:09的版本
第258行：		第258行：
	==XML Schema==		==XML Schema==

		+	<source lang="xml">
		+	<?xml version='1.0' encoding='UTF-8'?>

		+	<xs:schema
		+	xmlns:xs='http://www.w3.org/2001/XMLSchema'
		+	targetNamespace='http://jabber.org/protocol/rosterx'
		+	xmlns='http://jabber.org/protocol/rosterx'
		+	elementFormDefault='qualified'>

−	<?xml version='1.0' encoding='UTF-8'?> <xs:schema xmlns:xs='http://www.w3.org/2001/XMLSchema' targetNamespace='http://jabber.org/protocol/rosterx' xmlns='http://jabber.org/protocol/rosterx' elementFormDefault='qualified'> <xs:annotation> <xs:documentation> The protocol documented by this schema is defined in XEP-0144: http://www.xmpp.org/extensions/xep-0144.html </xs:documentation> </xs:annotation> <xs:element name='x'> <xs:complexType> <xs:sequence> <xs:element ref='item' minOccurs='1' maxOccurs='unbounded'/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name='item'> <xs:complexType> <xs:sequence> <xs:element name='group' type='xs:string' minOccurs='0' maxOccurs='unbounded'/> </xs:sequence> <xs:attribute name='action' use='optional'/> <xs:simpleType> <xs:restriction base='xs:NCName' default='add'> <xs:enumeration value='add'/> <xs:enumeration value='delete'/> <xs:enumeration value='modify'/> </xs:restriction> </xs:simpleType> </xs:attribute> <xs:attribute name='jid' type='xs:string' use='required'/> <xs:attribute name='name' type='xs:string' use='optional'/> </xs:complexType> </xs:element> </xs:schema> < ？ XML版本= '1 .0 '编码= ' -8 ' ？ > < XS的：架构xmlns ： XS的= ' http://www.w3.org/2001/xmlschema ' targetnamespace = ' http://jabber.org /协议/ rosterx ' xmlns = ' http://jabber.org/protocol/rosterx ' elementformdefault = '合格“ > <xs:annotation> <xs:documentation>议定书所记录的此架构的定义是在xep - 0144 ： HTTP的： / / www.xmpp.org/extensions/xep-0144.html < / XS的：文件> < / XS的：注释> <xs:element name='x'> <xs:complextype> <xs:sequence> < XS的：元素号= '项目' minoccurs = '1 ' maxoccurs = '无界' / > < / XS的：序> < / XS的： complextype > < / XS的：元素> <xs:element name='item'> < XS的： complextype > <xs:sequence> <xs:element name='group' type='xs:string' minoccurs='0' maxoccurs='unbounded'/> < / XS的：序> < XS的：属性名称= '行动'使用= '可选' / > <xs:simpletype> <xs:restriction base='xs:ncname' default='add'> <xs:enumeration value='add'/> < XS的：列举值= '删除' / > <xs:enumeration value='modify'/> < / XS的：限制> < / XS的： simpletype > < / XS的：属性> < XS的：属性名称= ' jid '型= ' XS的：字符串'使用= '所需的' / > <xs:attribute name='name' type='xs:string' use='optional'/> < / XS的： complextype > < / XS的：元素> < / XS的：架构>	+	<xs:annotation>
		+	<xs:documentation>
		+	The protocol documented by this schema is defined in
		+	XEP-0144: http://www.xmpp.org/extensions/xep-0144.html
		+	</xs:documentation>
		+	</xs:annotation>

		+	<xs:element name='x'>
		+	<xs:complexType>
		+	<xs:sequence>
		+	<xs:element ref='item' minOccurs='1' maxOccurs='unbounded'/>
		+	</xs:sequence>
		+	</xs:complexType>
		+	</xs:element>
		+
		+	<xs:element name='item'>
		+	<xs:complexType>
		+	<xs:sequence>
		+	<xs:element name='group' type='xs:string' minOccurs='0' maxOccurs='unbounded'/>
		+	</xs:sequence>
		+	<xs:attribute name='action' use='optional' default='add'>
		+	<xs:simpleType>
		+	<xs:restriction base='xs:NCName'>
		+	<xs:enumeration value='add'/>
		+	<xs:enumeration value='delete'/>
		+	<xs:enumeration value='modify'/>
		+	</xs:restriction>
		+	</xs:simpleType>
		+	</xs:attribute>
		+	<xs:attribute name='jid' type='xs:string' use='required'/>
		+	<xs:attribute name='name' type='xs:string' use='optional'/>
		+	</xs:complexType>
		+	</xs:element>
		+
		+	</xs:schema>
		+	</source>