qpid-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From g...@apache.org
Subject svn commit: r1332672 - in /qpid/trunk/qpid/specs: amqp.xsl apache-filters.xml
Date Tue, 01 May 2012 14:25:26 GMT
Author: gsim
Date: Tue May  1 14:25:25 2012
New Revision: 1332672

URL: http://svn.apache.org/viewvc?rev=1332672&view=rev
Log:
Added proposed set of initial 1.0 filter definitions

Added:
    qpid/trunk/qpid/specs/amqp.xsl
    qpid/trunk/qpid/specs/apache-filters.xml

Added: qpid/trunk/qpid/specs/amqp.xsl
URL: http://svn.apache.org/viewvc/qpid/trunk/qpid/specs/amqp.xsl?rev=1332672&view=auto
==============================================================================
--- qpid/trunk/qpid/specs/amqp.xsl (added)
+++ qpid/trunk/qpid/specs/amqp.xsl Tue May  1 14:25:25 2012
@@ -0,0 +1,534 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ -
+ - Licensed to the Apache Software Foundation (ASF) under one
+ - or more contributor license agreements.  See the NOTICE file
+ - distributed with this work for additional information
+ - regarding copyright ownership.  The ASF licenses this file
+ - to you under the Apache License, Version 2.0 (the
+ - "License"); you may not use this file except in compliance
+ - with the License.  You may obtain a copy of the License at
+ - 
+ -   http://www.apache.org/licenses/LICENSE-2.0
+ - 
+ - Unless required by applicable law or agreed to in writing,
+ - software distributed under the License is distributed on an
+ - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ - KIND, either express or implied.  See the License for the
+ - specific language governing permissions and limitations
+ - under the License.
+ -
+ -->
+
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+<xsl:output indent="no"/>
+    <xsl:template match="node()[name()='amqp']">
+
+<html>
+    <head>
+        <title>AMQP <xsl:call-template name="initCap"><xsl:with-param name="input" select="@name"/></xsl:call-template></title>
+        <style type="text/css">
+            body {
+            margin: 2em;
+            padding: 1em;
+            font-family: "DejaVu LGC Sans", "Bitstream Vera Sans", arial, helvetica, sans-serif;
+            }
+            
+            h2 {
+            font-size: 1.25em;
+            color: #339;
+            }
+            
+            h2 a {
+            color: #339;
+            }
+            
+            h3 {
+            font-size: 1em;
+            position: relative;
+            left: -0.5em;
+            }
+            
+            h4 {
+            font-size: 1em;
+            position: relative;
+            left: -0.5em;
+            }
+            
+            h1 a, h3 a, h4 a {
+            color: #000;
+            }
+            
+            a {
+            text-decoration: none;
+            color: #66f;
+            }
+            
+            a.anchor {
+            color: #000;
+            }
+            
+            a.toc {
+            float: right;
+            }
+            
+            table {
+            border-collapse: collapse;
+            margin: 1em 1em;
+            }
+            
+            dt {
+            font-weight: bold;
+            }
+            
+            dt:after {
+            content: ":";
+            }
+            
+            div.toc {
+            border: 1px solid #ccc;
+            padding: 1em;
+            }
+            
+            table.toc {
+            margin: 0;
+            }
+            
+            table.pre {
+            background: #eee;
+            border: 1px solid #ccc;
+            margin-left: auto;
+            margin-right: auto;
+            }
+            
+            table.pre td {
+            font-family: Courier, monospace;
+            white-space: pre;
+            padding: 0em 2em;
+            }
+            
+            table.definition {
+            width: 100%;
+            }
+            
+            table.signature {
+            background: #eee;
+            border: 1px solid #ccc;
+            width: 100%;
+            }
+            
+            table.signature td {
+            font-family: monospace;
+            white-space: pre;
+            padding: 1em;
+            }
+            
+            table.composite {
+            width: 100%;
+            }
+            
+            td.field {
+            padding: 0.5em 2em;
+            }
+            
+            div.section {
+            padding: 0 0 0 1em;
+            }
+            
+            div.doc {
+            padding: 0 0 1em 0;
+            }
+            
+            table.composite div.doc {
+            padding: 0;
+            }
+            
+            table.error {
+            width: 100%;
+            margin: 0;
+            }
+            
+            table.error tr:last-child td {
+            padding: 0 0 0 1em;
+            }
+            
+            .todo:before {
+            content: "TODO: ";
+            font-weight: bold;
+            color: red;
+            }
+            
+            .todo {
+            font-variant: small-caps;
+            font-weight: bold;
+            color: red;
+            }
+        </style>        
+    </head>
+    <body>
+        <h1>AMQP <xsl:call-template name="initCap"><xsl:with-param name="input" select="@name"/></xsl:call-template></h1>
+        
+        <xsl:if test="descendant-or-self::node()[name()='section']"><xsl:call-template name="toc"/></xsl:if>
+        <xsl:apply-templates mode="spec" select="."/>
+    </body>
+</html>
+    </xsl:template>
+
+    <!-- Table of Contents -->
+
+    <xsl:template name="toc">
+        <h2><a name="toc">Table of Contents</a></h2>
+        <div class="toc">
+            <table class="toc" summary="Table of Contents">
+                <xsl:apply-templates mode="toc" select="."/>
+            </table>
+        </div>        
+    </xsl:template>
+
+    <xsl:template mode="toc" match="node()[name()='section']">
+        <xsl:variable name="title"><xsl:choose>
+            <xsl:when test="@title"><xsl:value-of select="@title"/></xsl:when>
+            <xsl:otherwise><xsl:call-template name="initCapWords"><xsl:with-param name="input" select="translate(@name,'-',' ')"/></xsl:call-template></xsl:otherwise>
+        </xsl:choose>
+        </xsl:variable>
+        <xsl:variable name="ref">#section-<xsl:value-of select="@name"/></xsl:variable>
+        <xsl:variable name="section-number"><xsl:value-of select="count(preceding-sibling::node()[name()='section'])+1"/></xsl:variable>
+        <tr><td><xsl:value-of select="$section-number"/><xsl:text> </xsl:text><xsl:element name="a"><xsl:attribute name="href"><xsl:value-of select="$ref"/></xsl:attribute><xsl:value-of select="$title"/></xsl:element></td><td><xsl:value-of select="@label"/></td></tr>
+        <xsl:apply-templates mode="toc" select="node()[name()='type' or name()='definition' or ( name()='doc' and attribute::node()[name()='title']!='')]"/>
+    </xsl:template>
+
+    <xsl:template mode="toc" match="node()[name()='doc' and  attribute::node()[name()='title']]">
+        <xsl:variable name="ref">#doc-<xsl:choose><xsl:when test="@name"><xsl:value-of select="@name"/></xsl:when><xsl:otherwise><xsl:value-of select="generate-id(.)"/></xsl:otherwise></xsl:choose></xsl:variable>
+        <xsl:variable name="section-number"><xsl:apply-templates mode="doc-number" select="."/></xsl:variable>
+        <tr><td><xsl:text>&#160;&#160;&#160;&#160;&#160;&#160;</xsl:text><xsl:value-of select="$section-number"/><xsl:text> </xsl:text><xsl:element name="a"><xsl:attribute name="href"><xsl:value-of select="$ref"/></xsl:attribute><xsl:value-of select="@title"/></xsl:element></td><td><xsl:value-of select="@label"/></td></tr>        
+    </xsl:template>
+    
+    <xsl:template mode="toc" match="node()[name()='type' or name()='definition']">
+        <xsl:variable name="ref">#<xsl:value-of select="name()"/>-<xsl:value-of select="@name"/></xsl:variable>        
+        <xsl:variable name="section-number"><xsl:apply-templates mode="type-number" select="."/></xsl:variable>        
+        <tr><td><xsl:text>&#160;&#160;&#160;&#160;&#160;&#160;</xsl:text><xsl:if test="contains(substring-after($section-number,'.'),'.')"><xsl:text>&#160;&#160;&#160;&#160;&#160;&#160;</xsl:text></xsl:if><xsl:value-of select="$section-number"/><xsl:text> </xsl:text><xsl:element name="a"><xsl:attribute name="href"><xsl:value-of select="$ref"/></xsl:attribute><xsl:call-template name="initCapWords"><xsl:with-param name="input" select="translate(@name,'-',' ')"/></xsl:call-template></xsl:element></td><td><xsl:value-of select="@label"/></td></tr>        
+    </xsl:template>
+    
+    <!-- Sections -->
+    
+    <xsl:template match="node()[name()='section']" mode="spec">
+        <xsl:variable name="title"><xsl:choose>
+            <xsl:when test="@title"><xsl:value-of select="@title"/></xsl:when>
+            <xsl:otherwise><xsl:call-template name="initCapWords"><xsl:with-param name="input" select="translate(@name,'-',' ')"/></xsl:call-template></xsl:otherwise>
+        </xsl:choose>
+        </xsl:variable>        
+        <h2><a class="toc" href="#toc"><xsl:text>&#8592;</xsl:text></a> <xsl:apply-templates mode="section-number" select="."/><xsl:text> </xsl:text><xsl:element name="a"><xsl:attribute name="name">section-<xsl:value-of select="@name"/></xsl:attribute><xsl:value-of select="$title"/></xsl:element></h2>
+        <div class="section">
+            <xsl:apply-templates mode="spec" select="*"/>
+        </div>
+    </xsl:template>
+    
+    <!-- docs -->
+    <xsl:template match="node()[name()='doc']" mode="spec">
+        <xsl:choose>
+          <xsl:when test="ancestor::node()[name() = 'doc']">
+        <xsl:if test="@title">
+            <h4><a class="toc" href="#toc"><xsl:text>&#8592;</xsl:text></a><xsl:element name="a"><xsl:attribute name="name">doc-<xsl:choose><xsl:when test="@name"><xsl:value-of select="@name"/></xsl:when><xsl:otherwise><xsl:value-of select="generate-id(.)"/></xsl:otherwise></xsl:choose></xsl:attribute><xsl:call-template name="initCapWords"><xsl:with-param name="input" select="translate(@title,'-',' ')"></xsl:with-param></xsl:call-template></xsl:element></h4>
+        </xsl:if>
+            <xsl:apply-templates mode="spec" select="*|comment()"/>            
+          </xsl:when>
+          <xsl:otherwise>
+        <xsl:if test="@title">
+            <h3><a class="toc" href="#toc"><xsl:text>&#8592;</xsl:text></a> <xsl:apply-templates mode="doc-number" select="."/><xsl:text> </xsl:text><xsl:element name="a"><xsl:attribute name="name">doc-<xsl:choose><xsl:when test="@name"><xsl:value-of select="@name"/></xsl:when><xsl:otherwise><xsl:value-of select="generate-id(.)"/></xsl:otherwise></xsl:choose></xsl:attribute><xsl:call-template name="initCapWords"><xsl:with-param name="input" select="translate(@title,'-',' ')"></xsl:with-param></xsl:call-template></xsl:element></h3>
+        </xsl:if>
+        <div class="doc">
+            <xsl:apply-templates mode="spec" select="*|comment()"/>            
+        </div>
+          </xsl:otherwise>
+        </xsl:choose>
+    </xsl:template>
+
+    <!-- picture -->
+    
+    <xsl:template match="node()[name()='picture']" mode="spec">
+        <xsl:element name="table"><xsl:attribute name="class">pre</xsl:attribute><xsl:if test="@title"><xsl:attribute name="summary"><xsl:value-of select="@title"/></xsl:attribute></xsl:if>
+            <xsl:if test="@title"><caption><xsl:value-of select="@title"/></caption></xsl:if>
+<tr><td>
+<xsl:apply-templates select="*|text()" mode="spec"/>    
+</td></tr></xsl:element>
+    </xsl:template>
+
+    <!-- xref -->
+<xsl:template match="node()[name()='xref']" mode="spec">
+    <xsl:variable name="ref" select="@name"/>
+    <xsl:choose>
+        <!-- section xref -->
+        <xsl:when test="@type='section' or ancestor-or-self::node()/descendant-or-self::node()[name()='section' and @name=$ref]">
+            <xsl:element name="a"><xsl:attribute name="href">#section-<xsl:value-of select="@name"/></xsl:attribute><xsl:value-of select="@name"/></xsl:element>
+        </xsl:when>
+        <!-- type xref -->
+        <xsl:when test="@type='type'  or ancestor-or-self::node()/descendant-or-self::node()[name()='type' and @name=$ref]">
+            <xsl:element name="a"><xsl:attribute name="href">#type-<xsl:value-of select="@name"/></xsl:attribute><xsl:value-of select="@name"/></xsl:element>
+        </xsl:when>
+        <!-- doc xref -->
+        <xsl:when test="@type='doc'  or ancestor-or-self::node()/descendant-or-self::node()[name()='doc' and @name=$ref]">
+            <xsl:element name="a"><xsl:attribute name="href">#doc-<xsl:value-of select="@name"/></xsl:attribute><xsl:value-of select="@name"/></xsl:element>
+        </xsl:when>
+        <xsl:when test="@type='amqp'">
+            <xsl:element name="a"><xsl:attribute name="href"><xsl:value-of select="@name"/>.xml</xsl:attribute><xsl:call-template name="initCap"><xsl:with-param name="input"><xsl:value-of select="@name"/></xsl:with-param></xsl:call-template></xsl:element>
+        </xsl:when>
+        <xsl:otherwise><xsl:value-of select="@name"/></xsl:otherwise>
+    </xsl:choose>
+    
+           
+    
+</xsl:template>
+
+    <!-- todo -->
+    <xsl:template match="node()[name()='todo']" mode="spec"><span class="todo"><xsl:apply-templates select="*|text()" mode="spec"/></span></xsl:template>
+    
+    <!-- primitive type -->
+    <xsl:template match="node()[name()='type' and @class='primitive']" mode="spec">
+        <h3><a class="toc" href="#toc"><xsl:text>&#8592;</xsl:text></a> <xsl:apply-templates mode="type-number" select="."/><xsl:text> </xsl:text> <xsl:element name="a"><xsl:attribute name="name">type-<xsl:value-of select="@name"/></xsl:attribute><xsl:call-template name="initCap"><xsl:with-param name="input" select="@name"/></xsl:call-template></xsl:element></h3>
+        <xsl:apply-templates select="." mode="type-signature"/>
+        <xsl:element name="table"><xsl:attribute name="class">signature</xsl:attribute><xsl:attribute name="summary"><xsl:value-of select="@label"/></xsl:attribute>
+            <tr><td><b><xsl:value-of select="@name"/></b>: <xsl:value-of select="@label"/></td></tr>        
+        </xsl:element>
+        
+        <b>Encodings:</b>
+        <xsl:element name="table"><xsl:attribute name="class">composite</xsl:attribute><xsl:attribute name="summary"><xsl:value-of select="@label"/></xsl:attribute>
+        <xsl:apply-templates select="node()[name()='encoding']" mode="spec"/>
+        </xsl:element>
+    </xsl:template>        
+    
+    
+    
+    <!-- composite type -->
+    <xsl:template match="node()[name()='type' and @class='composite']" mode="spec">
+        <h3><a class="toc" href="#toc"><xsl:text>&#8592;</xsl:text></a> <xsl:apply-templates mode="type-number" select="."/><xsl:text> </xsl:text> <xsl:element name="a"><xsl:attribute name="name">type-<xsl:value-of select="@name"/></xsl:attribute><xsl:call-template name="initCapWords"><xsl:with-param name="input" select="translate(@name,'-',' ')"></xsl:with-param></xsl:call-template></xsl:element></h3>
+        <xsl:apply-templates select="." mode="type-signature"/>        
+        <xsl:apply-templates select="node()[name()='doc']" mode="spec"/>
+        <xsl:element name="table"><xsl:attribute name="class">composite</xsl:attribute><xsl:attribute name="summary"><xsl:value-of select="@name"/> fields</xsl:attribute>
+        <xsl:for-each select="node()[name()='field']">    
+            <tr><td><b><xsl:value-of select="@name"/></b></td><td><i><xsl:value-of select="@label"/></i></td><td><xsl:choose>
+                <xsl:when test="@mandatory">mandatory</xsl:when>
+                <xsl:otherwise>optional</xsl:otherwise>
+            </xsl:choose><xsl:text> </xsl:text><xsl:call-template name="genTypeXref"><xsl:with-param name="type" select="@type"/></xsl:call-template><xsl:if test="@multiple">[]</xsl:if></td></tr>            
+            <tr><td class="field" colspan="2"><xsl:apply-templates select="node()[name()='doc' or name()='error']" mode="spec"/></td></tr>
+        </xsl:for-each>
+        </xsl:element>
+    </xsl:template>
+    
+    <!-- restricted type -->
+    <xsl:template match="node()[name()='type' and @class='restricted']" mode="spec">
+        <xsl:variable name="name"><xsl:value-of select="@name"/></xsl:variable>
+        <h3><a class="toc" href="#toc"><xsl:text>&#8592;</xsl:text></a> <xsl:apply-templates mode="type-number" select="."/><xsl:text> </xsl:text> <xsl:element name="a"><xsl:attribute name="name">type-<xsl:value-of select="@name"/></xsl:attribute><xsl:call-template name="initCapWords"><xsl:with-param name="input" select="translate(@name,'-',' ')"></xsl:with-param></xsl:call-template></xsl:element></h3>
+        <xsl:apply-templates select="." mode="type-signature"/>
+        <xsl:apply-templates select="node()[name()='doc']" mode="spec"/>
+        <xsl:element name="table"><xsl:attribute name="class">composite</xsl:attribute><xsl:attribute name="summary">possible values</xsl:attribute>
+            <xsl:for-each select="node()[name()='choice']">
+                <tr><td><b><xsl:element name="a"><xsl:attribute name="class">anchor</xsl:attribute><xsl:attribute name="name">choice-<xsl:value-of select="$name"/>-<xsl:value-of select="@name"/></xsl:attribute><xsl:value-of select="@name"/></xsl:element></b></td><td></td><td><xsl:value-of select="@value"/></td></tr>
+            <tr><td class="field" colspan="2"><xsl:apply-templates select="node()[name()='doc' or name()='error']" mode="spec"/></td></tr>
+            </xsl:for-each>
+        </xsl:element>    
+    </xsl:template>
+
+    <!-- type signature -->
+    <xsl:template match="node()[name()='type']" mode="type-signature">
+        <table class="signature" summary="@(label)"><tr>
+<td>&#60;type<xsl:if test="@name"><xsl:text> </xsl:text>name="<xsl:value-of select="@name"/>"</xsl:if><xsl:if test="@class"><xsl:text> </xsl:text>class="<xsl:value-of select="@class"/>"</xsl:if><xsl:if test="@source"><xsl:text> </xsl:text>source="<xsl:value-of select="@source"/>"</xsl:if><xsl:if test="@provides"><xsl:text> </xsl:text>provides="<xsl:value-of select="@provides"/>"</xsl:if><xsl:if test="not( node()[name() = 'field' or name() = 'choice' or name() = 'descriptor'])">/</xsl:if>&#62;<xsl:if test="node()[name() = 'field' or name() = 'choice' or name() = 'descriptor']">
+<xsl:apply-templates select="node()[name()='field' or name()='choice' or name()='descriptor']" mode="type-signature"/><xsl:text>
+&#60;/type&#62;</xsl:text>    
+</xsl:if>
+        </td></tr></table>
+    </xsl:template>
+    
+    <xsl:template match="node()[name()='descriptor']" mode="type-signature">
+<xsl:text>
+    </xsl:text>&#60;descriptor<xsl:if test="@name"><xsl:text> </xsl:text>name="<xsl:value-of select="@name"/>"</xsl:if><xsl:if test="@code"><xsl:text> </xsl:text>code="<xsl:value-of select="@code"/>"</xsl:if><xsl:text>/&#62;</xsl:text>        
+    </xsl:template>
+    
+    <xsl:template match="node()[name()='choice']" mode="type-signature">
+<xsl:text>
+    </xsl:text>&#60;choice<xsl:for-each select="attribute::node()[name() != 'label']"><xsl:text> </xsl:text><xsl:value-of select="name()"/>="<xsl:value-of select="."/>"</xsl:for-each><xsl:text>/&#62;</xsl:text>        
+    </xsl:template>
+    
+    <xsl:template match="node()[name()='field']" mode="type-signature">
+<xsl:text>
+    </xsl:text>&#60;field<xsl:for-each select="attribute::node()[name() != 'label']"><xsl:text> </xsl:text><xsl:value-of select="name()"/>="<xsl:value-of select="."/>"</xsl:for-each><xsl:if test="not( node()[name()='error'] )"><xsl:text>/</xsl:text></xsl:if>&#62;<xsl:if test="node()[name()='error']">
+<xsl:apply-templates mode="type-signature" select="node()[name()='error']"/><xsl:text>
+    &#60;/field&#62;</xsl:text></xsl:if>        
+    </xsl:template>
+
+    <xsl:template match="node()[name()='error']" mode="type-signature">
+<xsl:text>
+        </xsl:text>&#60;error<xsl:for-each select="attribute::node()[name() != 'label']"><xsl:text> </xsl:text><xsl:value-of select="name()"/>="<xsl:value-of select="."/>"</xsl:for-each><xsl:text>/&#62;</xsl:text>        
+    </xsl:template>
+    
+
+    <!-- encoding -->    
+    <xsl:template match="node()[name()='encoding']" mode="spec">
+        <tr><td><b><xsl:value-of select="@name"/></b></td><td><i><xsl:value-of select="@label"/></i></td><td>code <xsl:value-of select="@code"/>: <xsl:choose>
+            <xsl:when test="@category='fixed'">fixed-width, <xsl:value-of select="@width"/> byte value</xsl:when>
+            <xsl:otherwise>variable-width, <xsl:value-of select="@width"/> byte size</xsl:otherwise>
+        </xsl:choose></td></tr>
+        <tr><td class="field" colspan="3"><xsl:apply-templates select="node()[name()='doc']" mode="spec"/></td></tr>
+        
+    </xsl:template>    
+    
+
+    <!-- TypeListTable comment -->
+    <xsl:template match="comment()[self::comment()='TypeListTable']" mode="spec">
+        <table class="" summary="Primitive Types">
+            <xsl:for-each select="//descendant-or-self::node()[name()='type']">
+                <tr><td><xsl:element name="a"><xsl:attribute name="href">#type-<xsl:value-of select="@name"/></xsl:attribute><xsl:value-of select="@name"/></xsl:element></td><td><xsl:value-of select="@label"/></td></tr>
+            </xsl:for-each>
+        </table>
+    </xsl:template>
+
+    <!-- EncodingListTable comment -->
+    <xsl:template match="comment()[self::comment()='EncodingListTable']" mode="spec">
+        <table class="" summary="Primitive Type Encodings">
+            <tr><th>Type</th><th>Encoding</th><th>Code</th><th>Category</th><th>Description</th></tr>
+            <xsl:for-each select="//descendant-or-self::node()[name()='type']">
+                <xsl:variable name="type" select="@name"/>
+                <xsl:for-each select="node()[name()='encoding']">
+                    <tr>
+                        <td><xsl:element name="a"><xsl:attribute name="href">#type-<xsl:value-of select="$type"/></xsl:attribute><xsl:value-of select="$type"/></xsl:element></td>
+                        <td><xsl:value-of select="@name"/></td>
+                        <td><xsl:value-of select="@code"/></td>
+                        <td><xsl:value-of select="@category"/>/<xsl:value-of select="@width"/></td>
+                        <td><xsl:value-of select="@label"/></td>
+                    </tr>
+                </xsl:for-each>                
+            </xsl:for-each>
+        </table>
+    </xsl:template>
+    
+
+    <!-- text -->
+
+    <xsl:template match="text()" mode="spec"><xsl:value-of select="."/></xsl:template>
+
+    <!-- error -->
+    
+    <xsl:template match="node()[name()='error']" mode="spec">
+        <table class="error" summary="">
+            <tr>
+                <td><b><xsl:value-of select="@name"/> error:</b> </td>
+                
+                <td align="right"><xsl:element name="a"><xsl:attribute name="href"><xsl:call-template name="genErrorXref"><xsl:with-param name="type" select="@value"/></xsl:call-template></xsl:attribute><xsl:value-of select="@value"/></xsl:element></td>
+            </tr>
+            <tr><td colspan="2"><xsl:apply-templates select="node()[name()='doc']" mode="spec"/></td></tr>
+        </table>        
+    </xsl:template>
+    
+    <!-- definition -->
+
+    <xsl:template mode="spec" match="node()[name()='definition']">
+        <h3><a class="toc" href="#toc"><xsl:text>&#8592;</xsl:text></a> <xsl:apply-templates mode="type-number" select="."/><xsl:text> </xsl:text> <xsl:element name="a"><xsl:attribute name="name">definition-<xsl:value-of select="@name"/></xsl:attribute><xsl:call-template name="initCap"><xsl:with-param name="input" select="@name"/></xsl:call-template></xsl:element></h3>
+        
+        <xsl:element name="table"><xsl:attribute name="class">signature</xsl:attribute><xsl:attribute name="summary"><xsl:value-of select="@label"/></xsl:attribute>
+            <tr>
+                <td><xsl:value-of select="@name"/>: <xsl:value-of select="@label"/></td>
+                <td align="right"><xsl:value-of select="@value"/></td>
+            </tr>
+        </xsl:element>
+        <xsl:apply-templates mode="spec" select="node()[name()='doc']"/>
+    </xsl:template>
+
+    <!-- pass through tags -->
+
+    <xsl:template match="node()[name() = 'p']" mode="spec"> 
+        <xsl:element name="p"><xsl:if test="@title"><xsl:attribute name="title"><xsl:value-of select="@title"/></xsl:attribute></xsl:if><xsl:apply-templates mode="spec" select="*|text()"/></xsl:element>                
+    </xsl:template>
+    <xsl:template match="node()[name() = 'i']" mode="spec"> 
+        <xsl:element name="i"><xsl:if test="@title"><xsl:attribute name="title"><xsl:value-of select="@title"/></xsl:attribute></xsl:if><xsl:apply-templates mode="spec" select="*|text()"/></xsl:element>                
+    </xsl:template>
+    <xsl:template match="node()[name() = 'term']" mode="spec"> 
+        <xsl:element name="i"><xsl:if test="@title"><xsl:attribute name="title"><xsl:value-of select="@title"/></xsl:attribute></xsl:if><xsl:apply-templates mode="spec" select="*|text()"/></xsl:element>                
+    </xsl:template>
+    <xsl:template match="node()[name() = 'b']" mode="spec"> 
+        <xsl:element name="b"><xsl:if test="@title"><xsl:attribute name="title"><xsl:value-of select="@title"/></xsl:attribute></xsl:if><xsl:apply-templates mode="spec" select="*|text()"/></xsl:element>                
+    </xsl:template>
+    <xsl:template match="node()[name() = 'ol']" mode="spec"> 
+        <xsl:element name="ol"><xsl:if test="@title"><xsl:attribute name="title"><xsl:value-of select="@title"/></xsl:attribute></xsl:if><xsl:apply-templates mode="spec" select="*|text()"/></xsl:element>                
+    </xsl:template>
+    <xsl:template match="node()[name() = 'ul']" mode="spec"> 
+        <xsl:element name="ul"><xsl:if test="@title"><xsl:attribute name="title"><xsl:value-of select="@title"/></xsl:attribute></xsl:if><xsl:apply-templates mode="spec" select="*|text()"/></xsl:element>                
+    </xsl:template>
+    <xsl:template match="node()[name() = 'li']" mode="spec"> 
+        <xsl:element name="li"><xsl:if test="@title"><xsl:attribute name="title"><xsl:value-of select="@title"/></xsl:attribute></xsl:if><xsl:apply-templates mode="spec" select="*|text()"/></xsl:element>                
+    </xsl:template>
+    <xsl:template match="node()[name() = 'dl']" mode="spec"> 
+        <xsl:element name="dl"><xsl:if test="@title"><xsl:attribute name="title"><xsl:value-of select="@title"/></xsl:attribute></xsl:if><xsl:apply-templates mode="spec" select="*|text()"/></xsl:element>                
+    </xsl:template>
+    <xsl:template match="node()[name() = 'dt']" mode="spec"> 
+        <xsl:element name="dt"><xsl:if test="@title"><xsl:attribute name="title"><xsl:value-of select="@title"/></xsl:attribute></xsl:if><xsl:apply-templates mode="spec" select="*|text()"/></xsl:element>                
+    </xsl:template>
+    <xsl:template match="node()[name() = 'dd']" mode="spec"> 
+        <xsl:element name="dd"><xsl:if test="@title"><xsl:attribute name="title"><xsl:value-of select="@title"/></xsl:attribute></xsl:if><xsl:apply-templates mode="spec" select="*|text()"/></xsl:element>                
+    </xsl:template>
+    
+    
+
+    <!-- Document specific utilities -->
+
+    <xsl:template mode="section-number" match="node()[name()='section']"><xsl:value-of select="count(preceding-sibling::node()[name()='section'])+1"/></xsl:template>
+    <xsl:template mode="doc-number" match="node()[name()='doc']"><xsl:apply-templates mode="section-number" select="ancestor::node()[name()='section']"/>.<xsl:value-of select="1+count(preceding-sibling::node()[name()='doc' and attribute::title])"/></xsl:template>    
+    <xsl:template mode="type-number" match="node()[name()='type' or name()='definition']">
+        <xsl:choose>
+            <xsl:when test="count(preceding-sibling::node()[name()='doc' and attribute::title])>0">
+                <xsl:variable name="doc-node" select="preceding-sibling::node()[name()='doc' and attribute::title]"/>
+                <xsl:variable name="offset" select="count($doc-node/preceding-sibling::node()[name()='type' or name()='definition'])"></xsl:variable>
+                <xsl:apply-templates mode="section-number" select="ancestor::node()[name()='section']"/>.<xsl:value-of select="count(preceding-sibling::node()[name()='doc' and attribute::title])"/>.<xsl:value-of select="1+count(preceding-sibling::node()[name()='type' or name()='definition'])-$offset"/>
+            </xsl:when>
+            <xsl:otherwise>
+                <xsl:apply-templates mode="section-number" select="ancestor::node()[name()='section']"/>.<xsl:value-of select="1+count(preceding-sibling::node()[name()='type' or name()='definition'])"/>
+            </xsl:otherwise>
+        </xsl:choose>
+    </xsl:template>
+    <xsl:template name="genTypeXref">
+        <xsl:param name="type"/>
+        <xsl:choose>
+            <xsl:when test="$type='*'">*</xsl:when>
+            <xsl:otherwise><xsl:element name="a"><xsl:attribute name="href"><xsl:choose>                
+                <xsl:when test="/ancestor-or-self::node()/descendant-or-self::node()[name()='type' and @name=$type]">#type-<xsl:value-of select="$type"/></xsl:when>
+            <xsl:otherwise>
+                <xsl:for-each select="document('index.xml')/descendant-or-self::node()[name()='xref' and @type='amqp']">
+                    <xsl:variable name="docname"><xsl:value-of select="@name"/>.xml</xsl:variable>
+                    <xsl:if test="document($docname)/descendant-or-self::node()[name()='type' and @name=$type]"><xsl:value-of select="$docname"/>#type-<xsl:value-of select="$type"/></xsl:if>
+                </xsl:for-each>
+            </xsl:otherwise>
+            </xsl:choose></xsl:attribute><xsl:value-of select="$type"/></xsl:element>
+            </xsl:otherwise>
+        </xsl:choose>        
+    </xsl:template>
+    
+    <xsl:template name="genErrorXref">
+        <xsl:param name="type"/>
+        <xsl:choose>
+            <xsl:when test="/ancestor-or-self::node()/descendant-or-self::node()[name()='type' and @provides='error']/node()[name()='choice' and @name=$type]">#choice-<xsl:value-of select="/ancestor-or-self::node()/descendant-or-self::node()[name()='type' and @provides='error' and child::node()[name()='choice' and @name=$type]]/@name"/>-<xsl:value-of select="$type"/></xsl:when>
+            <xsl:otherwise>
+                <xsl:for-each select="document('index.xml')/descendant-or-self::node()[name()='xref' and @type='amqp']">
+                    <xsl:variable name="docname"><xsl:value-of select="@name"/>.xml</xsl:variable>
+                    <xsl:if test="document($docname)/descendant-or-self::node()[name()='type' and @provides='error']/node()[name()='choice' and @name=$type]">
+                        #choice-<xsl:value-of select="document($docname)/descendant-or-self::node()[name()='type' and @provides='error' and child::node()[name()='choice' and @name=$type]]/@name"/>-<xsl:value-of select="$type"/>                        
+                    </xsl:if>
+                </xsl:for-each>
+            </xsl:otherwise>
+        </xsl:choose>            
+    </xsl:template>
+    <!-- General Utilities -->
+    
+    <xsl:template name="toUpper"><xsl:param name="input"/><xsl:value-of select="translate($input,'abcdefghijklmnopqrstuvwxyz','ABCDEFGHIJKLMNOPQRSTUVWXYZ')"></xsl:value-of></xsl:template>
+    <xsl:template name="toLower"><xsl:param name="input"/><xsl:value-of select="translate($input,'ABCDEFGHIJKLMNOPQRSTUVWXYZ','abcdefghijklmnopqrstuvwxyz')"></xsl:value-of></xsl:template>
+    <xsl:template name="initCap"><xsl:param name="input"/><xsl:call-template name="toUpper"><xsl:with-param name="input" select="substring($input,1,1)"/></xsl:call-template><xsl:value-of select="substring($input,2)"/></xsl:template>
+    <xsl:template name="initCapWords">
+        <xsl:param name="input"/>
+        <xsl:choose>
+            <xsl:when test="contains($input,' ')">
+                <xsl:call-template name="initCap"><xsl:with-param name="input" select="substring-before($input, ' ')"/></xsl:call-template><xsl:text> </xsl:text><xsl:call-template name="initCapWords"><xsl:with-param name="input" select="substring-after($input, ' ')"/></xsl:call-template>
+            </xsl:when>
+            <xsl:otherwise>
+                <xsl:call-template name="initCap"><xsl:with-param name="input" select="$input"/></xsl:call-template>
+            </xsl:otherwise>
+        </xsl:choose>
+    </xsl:template>
+    
+</xsl:stylesheet>

Added: qpid/trunk/qpid/specs/apache-filters.xml
URL: http://svn.apache.org/viewvc/qpid/trunk/qpid/specs/apache-filters.xml?rev=1332672&view=auto
==============================================================================
--- qpid/trunk/qpid/specs/apache-filters.xml (added)
+++ qpid/trunk/qpid/specs/apache-filters.xml Tue May  1 14:25:25 2012
@@ -0,0 +1,224 @@
+<!--
+
+   Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.
+-->
+<!DOCTYPE amqp SYSTEM "amqp.dtd">
+<?xml-stylesheet type="text/xsl" href="amqp.xsl"?>
+
+<amqp name="apache-filters" label="Apache Proposed AMQP 1-0 Filters">
+  <section name="legacy-amqp" title="Legacy AMQP Exchange Binding Support">
+    <doc>
+      <p>
+        Versions of AMQP prior to 1.0 prescribed a model of Exchanges and Queues, where Queues were
+        bound to Exchanges with a binding key whose meaning depended upon the type of the Exchange.
+        In order to allow a consistent mechanism for addressing legacy AMQP Exchanges over AMQP 1.0
+        the following filter types are defined. Use of an Exchange as an address for a Source thus
+        can be seen as equivalent to constructing exclusive queues bound to an Exchange in legacy 
+        AMQP versions.
+      </p>
+      <p>
+        Containers which support the filters that are defined in this section should advertise the
+        capability <term>APACHE.ORG:LEGACY_AMQP_EXCHANGE_FILTERS</term> in their connection
+        capabilities when sending the open performative, and MUST provide this capability on
+        sources supporting these filter types.
+      </p>
+    </doc>
+ 	<type class="restricted" name="legacy-amqp-direct-binding" source="string" provides="filter">
+ 		<descriptor name="apache.org:legacy-amqp-direct-binding:string" 
+                    code="0x0000468C:0x00000000"/>
+        <doc>
+          <p>
+            The legacy-amqp-direct-binding filter consists of a described string value. The filter
+            matches a message if and only if the described string value exactly matches the subject
+            field of the Properties section of the message being evaluated. If the message has no
+            Properties section, or if the subject field of the Properties section is not set, then
+            the legacy-amqp-direct-binding filter does not match.
+          </p>
+        </doc>
+ 	</type>
+
+ 	<type class="restricted" name="legacy-amqp-topic-binding" source="string" provides="filter">
+ 		<descriptor name="apache.org:legacy-amqp-topic-binding:string"
+                    code="0x0000468C:0x00000001"/>
+        <doc>
+          <p>
+            The legacy-amqp-topic-binding filter consists of a described string value. The value
+            value described by the type is interpreted as a pattern to match against the subject
+            field of the Properties section of the message being evaluated.
+          </p>
+          <ul>
+            <li>The pattern is formed using zero or more tokens, with each token delimited by the 
+                "." character. The tokens "#" and "*" have special meanings.</li>
+            <li>The token consisting of the single character "*" matches a single word in the 
+                subject field.</li>
+            <li>The token consisting of the single character "#" matches zero or more words in the
+                subject field.</li>
+          </ul>
+          <p>
+            Thus the filter value "*.stock.#" would match the subjects "usd.stock" and 
+            "eur.stock.db" but not "stock.nasdaq".
+          </p>
+          <p>
+            If the message has no Properties section, or if the subject field of the Properties
+            section is not set, then the legacy-amqp-topic-binding filter matches only if the value
+            of the filter is a single "#".
+          </p>
+        </doc>
+ 	</type>
+
+ 	<type class="restricted" name="legacy-amqp-headers-binding" source="map" provides="filter"> 
+ 		<descriptor name="apache.org:legacy-amqp-headers-binding:map" code="0x0000468C:0x00000002"/>
+        <doc>
+          <p>
+            The legacy-amqp-headers-binding filter consists of a described map value. The map
+            value described by the type is interpreted as a pattern to match against the 
+            application-properties section of the message being evaluated. The map has the same
+            restriction as the application-properties section, namely that the keys of this are
+            restricted to be of type string (which excludes the possibility of a null key) and the
+            values are restricted to be of simple types only, that is, excluding map, list, and 
+            array types.
+          </p>
+          <p>
+            The key "x-match" in the described map has special meaning. This key MUST map to the
+            symbolic value "any" or the symbolic value "all" within the described map. All other
+            keys which begin "x-" MUST be ignored by the source when evaluating. If the value for
+            "x-match" is "all" then all other valid key-value pairs in the map MUST match with an
+            entry with the same key in the application-properties section. If the value for 
+            "x-match" is "any" then the filter will accept the message if at least one key-value 
+            pair matches the equivalent key value pair in the application-properties section.
+          </p>
+          <p>
+            A key-value pair in the filter's map matches a key-value pair in the 
+            application-properties section if the keys are identical (including the same type), or
+            if the value in the filter map for the key is null.
+          </p>
+        </doc>
+ 	</type>
+  </section>
+  <section name="jms" title="Java Message Service Support"> 
+
+    <doc>
+      <p>
+        The Java Message Service defines two types of filtering of messages: firstly the ability to
+        exclude from a subscription messages sent by the same connection, secondly a more general
+        filtering syntax known as "selectors" based on an SQL like syntax.
+      </p>
+      <p>
+        AMQP filter extensions through which these two types of
+        filtering may be achieved are defined below. Their use, though
+        motivated by support for JMS, is not restricted to JMS.
+      </p>
+    </doc>
+
+	<type class="composite" name="no-local-filter" source="list" provides="filter">
+		<descriptor name="apache.org:no-local-filter:list" code="0x0000468C:0x00000003"/>
+        <doc>
+          <p>
+            A message will be accepted by the simple-no-local-filter if and only if the message
+            was originally sent to the container of the source on a separate connection from that
+            which is currently receiving from the source.
+          </p>
+          <p>
+            Containers which support this filter should advertise the
+            capability <term>APACHE.ORG:NO_LOCAL</term> in their
+            connection capabilities when sending the open
+            performative, and MUST provide this capability on sources
+            supporting these filter types.
+          </p>
+        </doc>
+	</type>
+
+	<type class="restricted" name="selector-filter" provides="filter" source="string">
+		<descriptor name="apache.org:selector-filter:string" code="0x0000468C:0x00000004"/>
+        <doc>
+          <p>
+            The Java Message Service "selector" defines an SQL like syntax for filtering messages.
+            The selector filters based on the values of "headers" and "properties". The defined
+            JMS headers can be mapped to equivalent fields within the AMQP message sections:
+          </p>
+<picture title="Mapping JMS Headers to AMQP fields">
+JMS Header Name   | AMQP 1.0 Field
+==================|====================================================
+JMSCorrelationID  | correlation-id field of properties section
+JMSDeliveryMode   | durable field of header section
+JMSDestination    | to field of the properties section
+JMSExpiration     | absolute-expiry-time of properties section
+JMSMessageID      | message-id of properties section
+JMSPriority       | priority field of header section
+JMSRedelivered    | delivery-count > 0 in header section
+JMSReplyTo        | reply-to in properties section
+JMSTimestamp      | creation-time of properties section
+JMSType           | annotation jms-type in message-annotations section
+</picture>
+        <p>
+          When encoding the selector string on the wire, these JMS
+          header names should be translated to amqp.<i>field_name</i>
+          where <i>field_name</i> is the appropriate AMQP 1.0 field
+          named in the table above, with the hyphen replaced by an
+          underscore. For example, the selector: "JMSCorrelationID =
+          ’abc’ AND color = ’blue’ AND weight > 2500" would be
+          transferred over the wire as: "amqp.correlation_id = ’abc’
+          AND color = ’blue’ AND weight > 2500"
+        </p>
+        <p>
+          The "properties" of the JMS message are equivalent to the AMQP application-properties
+          section. Thus a reference to a property Foo in a message selector would be evaluated
+          as the value associated with the key "Foo" (if present) in the application-properties
+          section.
+        </p>
+        <p>
+          The operands of the JMS selector are defined in terms of the types available within JMS,
+          When evaluated against the application properties section, the values within that section
+          MUST be evaluated according to the following type mapping.
+        </p>
+<picture title="Mapping AMQP types to JMS types">
+AMQP Type         | JMS Selector Type
+==================|===================
+null              | null
+boolean           | boolean
+ubyte             | short
+ushort            | int
+uint              | long
+ulong             | long
+byte              | byte
+short             | short
+int               | int
+long              | long
+float             | float
+double            | double
+decimal32         | double
+decimal64         | double
+decimal128        | double
+char              | char
+timestamp         | long
+uuid              | byte[16]
+binary            | byte[]
+string            | String
+symbol            | String
+</picture>
+          <p>
+            Containers which support this filter should advertise the
+            capability <term>APACHE.ORG:SELECTOR</term> in their
+            connection capabilities when sending the open
+            performative, and MUST provide this capability on sources
+            supporting these filter types.
+          </p>
+        </doc>
+	</type>
+  </section>
+</amqp>



---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@qpid.apache.org
For additional commands, e-mail: commits-help@qpid.apache.org


Mime
View raw message