xeps/xep-0064.xml

79 行
2.4 KiB
XML

<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE xep SYSTEM 'xep.dtd' [
<!ENTITY % ents SYSTEM "xep.ent">
%ents;
]>
<?xml-stylesheet type='text/xsl' href='xep.xsl'?>
<xep>
<header>
<title>XPath Filtering</title>
<abstract>A module that provides an XPath matching condition for packet filtering.</abstract>
&LEGALNOTICE;
<number>0064</number>
<status>Deferred</status>
<type>Informational</type>
<sig>Standards</sig>
<dependencies><spec>XEP-0062</spec></dependencies>
<supersedes/>
<supersededby/>
<shortname>Not yet assigned</shortname>
<author>
<firstname>Robert</firstname>
<surname>Norris</surname>
<email>rob@cataclysm.cx</email>
<jid>rob@cataclysm.cx</jid>
</author>
<revision>
<version>0.2</version>
<date>2003-09-30</date>
<initials>psa</initials>
<remark>At the request of the author, changed the status of this document to Deferred pending development of an implementation; also changed the type to Informational.</remark>
</revision>
<revision>
<version>0.1</version>
<date>2002-12-05</date>
<initials>rn</initials>
<remark>Initial version.</remark>
</revision>
</header>
<section1 topic='Introduction'>
<p>This document defines a module for &xep0062; that provides an XPath matching condition for packet filtering.</p>
<p>This module operates in the "http://jabber.org/protocol/filter/xpath" namespace.</p>
</section1>
<section1 topic='Conditions'>
<p>This module defines the fullowing conditions:</p>
<ul>
<li>&lt;xpath/> - true if the XPath expression contained in the CDATA of this element, when applied to the packet, returns one or more nodes.</li>
</ul>
<example caption='Matches all messages with that have a subject element'><![CDATA[
<xpath xmlns='http://jabber.org/protocol/filter/xpath'>/message/subject</xpath>
]]></example>
<example caption='Matches all presence packets that have an x:delay stamp'><![CDATA[
<xpath xmlns='http://jabber.org/protocol/filter/xpath'>/presence/x[namespace-uri()=='jabber:x:delay']</xpath>
]]></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 document requires no interaction with the IANA.</p>
</section1>
<section1 topic='JANA Considerations'>
<p>No namespaces or parameters need to be registered with JANA as a result of this document.</p>
</section1>
</xep>