mirror of
https://github.com/moparisthebest/xeps
synced 2024-11-24 18:22:24 -05:00
2ac91f50c8
git-svn-id: file:///home/ksmith/gitmigration/svn/xmpp/trunk@2 4b5297f7-1745-476d-ba37-a9c6900126ab
136 lines
5.1 KiB
XML
136 lines
5.1 KiB
XML
<?xml version='1.0' encoding='UTF-8'?>
|
|
<!DOCTYPE jep SYSTEM '../jep.dtd' [
|
|
<!ENTITY % ents SYSTEM "../jep.ent">
|
|
%ents;
|
|
]>
|
|
<?xml-stylesheet type='text/xsl' href='../jep.xsl'?>
|
|
<jep>
|
|
<header>
|
|
<title>Roster Item Exchange</title>
|
|
<abstract>This JEP provides canonical documentation of the jabber:x:roster namespace historically used within the Jabber community. NOTE WELL: This JEP has been superseded by JEP-0144.</abstract>
|
|
&LEGALNOTICE;
|
|
<number>0093</number>
|
|
<status>Deprecated</status>
|
|
<type>Historical</type>
|
|
<jig>Standards JIG</jig>
|
|
<dependencies>
|
|
<spec>XMPP Core</spec>
|
|
<spec>XMPP IM</spec>
|
|
</dependencies>
|
|
<supersedes/>
|
|
<supersededby>
|
|
<spec>JEP-0144</spec>
|
|
</supersededby>
|
|
<shortname>x-roster</shortname>
|
|
<schemaloc>
|
|
<url>http://jabber.org/protocol/x-roster/x-roster.xsd</url>
|
|
</schemaloc>
|
|
&stpeter;
|
|
<revision>
|
|
<version>1.2</version>
|
|
<date>2005-08-26</date>
|
|
<initials>psa</initials>
|
|
<remark>Per advancement of JEP-0144 by the Jabber Council, changed status to Deprecated.</remark>
|
|
</revision>
|
|
<revision>
|
|
<version>1.1</version>
|
|
<date>2004-02-24</date>
|
|
<initials>psa</initials>
|
|
<remark>Corrected several small textual errors.</remark>
|
|
</revision>
|
|
<revision>
|
|
<version>1.0</version>
|
|
<date>2003-10-08</date>
|
|
<initials>psa</initials>
|
|
<remark>Per a vote of the Jabber Council, changed status to Active.</remark>
|
|
</revision>
|
|
<revision>
|
|
<version>0.1</version>
|
|
<date>2003-05-22</date>
|
|
<initials>psa</initials>
|
|
<remark>Initial version.</remark>
|
|
</revision>
|
|
</header>
|
|
<section1 topic='Introduction'>
|
|
<p>The Jabber protocols have long included a method for sending roster items to another entity. This method makes use of the 'jabber:x:roster' namespace and has been documented variously in Internet-Drafts and elsewhere. Because this protocol is not required by &rfc2779;, the 'jabber:x:roster' namespace was removed from &xmppim;. This JEP fills the void for canonical documentation.</p>
|
|
<p><em>NOTE WELL: This JEP has been superseded by &jep0144;.</em></p>
|
|
</section1>
|
|
<section1 topic='Definition'>
|
|
<p>The 'jabber:x:roster' namespace (which is not to be confused with the 'jabber:iq:roster' namespace) is used to send roster items from one Jabber entity to another. A roster item is sent by adding to the <message/> element an <x/> child scoped by the 'jabber:x:roster' namespace. This <x/> element MUST contain at least one <item/> child elements (one for each roster item to be sent).</p>
|
|
<p>Each <item/> element may possess the following attributes:</p>
|
|
<ul>
|
|
<li><strong>jid</strong> -- The Jabber Identifier of the contact being sent. This attribute is REQUIRED.</li>
|
|
<li><strong>name</strong> -- A natural-language nickname for the contact. This attribute is OPTIONAL.</li>
|
|
</ul>
|
|
<p>Each <item/> element MAY also contain one or more <group/> children specifying the natural-language name of a user-specified group, for the purpose of categorizing this contact into one or more roster groups.</p>
|
|
</section1>
|
|
<section1 topic='Examples'>
|
|
<example caption='A Roster Item Sent to another Entity'><![CDATA[
|
|
<message to='hamlet@denmark' from='horatio@denmark'>
|
|
<subject>Visitors</subject>
|
|
<body>This message contains roster items.</body>
|
|
<x xmlns='jabber:x:roster'>
|
|
<item jid='rosencrantz@denmark'
|
|
name='Rosencrantz'>
|
|
<group>Visitors</group>
|
|
</item>
|
|
<item jid='guildenstern@denmark'
|
|
name='Guildenstern'>
|
|
<group>Visitors</group>
|
|
</item>
|
|
</x>
|
|
</message>
|
|
]]></example>
|
|
</section1>
|
|
<section1 topic='Security Considerations'>
|
|
<p>There are no security features or concerns related to this proposal.</p>
|
|
</section1>
|
|
<section1 topic='IANA Considerations'>
|
|
<p>This JEP requires no interaction with &IANA;.</p>
|
|
</section1>
|
|
<section1 topic='Jabber Registrar Considerations'>
|
|
<p>The 'jabber:x:roster' namespace is registered in the protocol namespaces registry maintained by the ®ISTRAR;.</p>
|
|
</section1>
|
|
<section1 topic='XML Schema'>
|
|
<code><![CDATA[
|
|
<?xml version='1.0' encoding='UTF-8'?>
|
|
|
|
<xs:schema
|
|
xmlns:xs='http://www.w3.org/2001/XMLSchema'
|
|
targetNamespace='jabber:x:roster'
|
|
xmlns='jabber:x:roster'
|
|
elementFormDefault='qualified'>
|
|
|
|
<xs:annotation>
|
|
<xs:documentation>
|
|
The protocol documented by this schema is defined in
|
|
JEP-0093: http://www.jabber.org/jeps/jep-0093.html
|
|
|
|
NOTE WELL: This protocol has been superseded by JEP-0144
|
|
http://www.jabber.org/jeps/jep-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='jid' type='xs:string' use='required'/>
|
|
<xs:attribute name='name' type='xs:string' use='optional'/>
|
|
</xs:complexType>
|
|
</xs:element>
|
|
|
|
</xs:schema>
|
|
]]></code>
|
|
</section1>
|
|
</jep>
|