You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@qpid.apache.org by tr...@apache.org on 2013/09/20 17:31:34 UTC
svn commit: r1525035 - in /qpid/site:
docs/components/dispatch-router/amqp-mapping.html
docs/components/dispatch-router/index.html
input/components/dispatch-router/amqp-mapping.md
input/components/dispatch-router/index.md
Author: tross
Date: Fri Sep 20 15:31:34 2013
New Revision: 1525035
URL: http://svn.apache.org/r1525035
Log:
QPID_5001 - Added a page on the Dispatch-Router/AMQP-mapping details.
Added:
qpid/site/docs/components/dispatch-router/amqp-mapping.html
qpid/site/input/components/dispatch-router/amqp-mapping.md
Modified:
qpid/site/docs/components/dispatch-router/index.html
qpid/site/input/components/dispatch-router/index.md
Added: qpid/site/docs/components/dispatch-router/amqp-mapping.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/components/dispatch-router/amqp-mapping.html?rev=1525035&view=auto
==============================================================================
--- qpid/site/docs/components/dispatch-router/amqp-mapping.html (added)
+++ qpid/site/docs/components/dispatch-router/amqp-mapping.html Fri Sep 20 15:31:34 2013
@@ -0,0 +1,102 @@
+<!DOCTYPE html>
+<!--
+ -
+ - 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.
+ -
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
+ <head>
+ <title>Dispatch AMQP Mapping - Apache Qpid™</title>
+ <meta http-equiv="X-UA-Compatible" content="IE=edge"/>
+ <link rel="stylesheet" href="http://qpid.apache.org/site.css" type="text/css"/>
+ <link rel="stylesheet" href="http://qpid.apache.org/pygments.css" type="text/css"/>
+ <!--[if lte IE 8]>
+ <link rel="stylesheet" href="http://qpid.apache.org/ie.css" type="text/css"/>
+ <![endif]-->
+ <script type="text/javascript" src="http://qpid.apache.org/site.js"></script>
+ </head>
+ <body>
+ <div id="content">
+ <div id="top">
+ <a id="search-link" href="http://qpid.apache.org/search.html"><img width="22" height="16" src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABUAAAAQCAYAAAD52jQlAAABmklEQVQ4y2P4//8/A7UxpkBoAxtPaIMTb2hdKW9I/WLe0Pp2nrC6YO7IKnGyDOUObTAAGnIRiP9j4oZPQJxGkqF8YXWRQE2/oAY84Q1rmMETUpfOF9LQBBQ7jGTBaqIM5YyolgUq/gjWBDRMxK+MF10hX0hdNFwNAReDCaCidVBXbManGGowJCgCK4VxGgoEjDAX8IfWKBLyGlDdSajBfjgN5Q2tUYe68jExkQBMEd1g9SH1rTgN5Q+tc4UaepwYQ/lC6/Khhi7GaShPYIMY1NDPDA0NTARdGtYwD2JoXTGBiKp/DFIIdIU3PgOFohv4gOqegtQCM4QjXkOBOagOlj75QhuE8ETSfKT0+pontK5aMLScH6uhDGlprEDDzkENfsAdUueMrIgrokEKKLcRKg/KIKeRDP8IzsrAYMTMUcE1qgiDwfgtEO8H4tvIBgDVRIGzdFiDC9CCfUjZ+BtvSIMPRt4HuzisoQGo6CVa3v8O1LQJlPMwg6TWEpRpoOGcjbWUgmFw1g2r8+UOr9VncGhgIZjfQ0OZYWwAIBYjaUYze6wAAAAASUVORK5CYII="/></a>
+
+ <ul id="global-navigation">
+ <li><a id="logotype" href="http://qpid.apache.org/index.html">Apache Qpid<sup>™</sup></a></li>
+ <li><a href="http://qpid.apache.org/download.html">Download</a></li>
+ <li><a href="http://qpid.apache.org/documentation.html">Documentation</a></li>
+ <li><a href="http://qpid.apache.org/discussion.html">Discussion</a></li>
+ <li><a href="http://qpid.apache.org/issues.html">Issues</a></li>
+ <li><a href="http://qpid.apache.org/source-code.html">Source Code</a></li>
+ <li><a href="http://qpid.apache.org/resources.html">More Resources</a></li>
+ </ul>
+ </div>
+ <div id="middle">
+ <ul id="path-navigation"><li><a href="http://qpid.apache.org/components/index.html">Components</a></li><li><a href="http://qpid.apache.org/components/dispatch-router/index.html">Dispatch Router</a></li><li>Dispatch AMQP Mapping</li></ul>
+ <h1 id="dispatch-amqp-mapping">Dispatch AMQP Mapping</h1>
+
+<p>Dispatch Router is an AMQP router and as such, it provides extensions,
+codepoints, and semantics for routing over AMQP. This page documents
+the details of Dispatch Router's use of AMQP.</p>
+
+<h2 id="delivery-annotations">Delivery Annotations</h2>
+
+<p>The following Delivery Annotation fields are defined by Dispatch Router:</p>
+
+<table>
+<tbody>
+<tr><td><em>Field</em></td><td><em>Type</em></td><td><em>Description</em></td></tr>
+<tr><td>qdx.ingress</td><td>string</td><td>The identity of the ingress router for a message-routed message. The ingress router is the first router encountered by a transiting message. The router will, if this field is present, leave it unaltered. If the field is not present, the router shall insert the field with its own identity.</td></tr>
+<tr><td>qdx.trace</td><td>list of string</td><td>The list of routers through which this message-routed message has transited. If this field is not present, the router shall do nothing. If the field is present, the router shall append its own identity to the end of the list.</td></tr>
+<tr><td>qdx.to</td><td>string</td><td>To-Override for message-routed messages. If this field is present, the address in this field shall be used for routing in lieu of the <em>to</em> field in the message properties. A router may append, remove, or modify this annotation field depending on the policy in place for routing the message.</td></tr>
+</tbody>
+</table>
+
+<h2 id="sourcetarget-capabilities">Source/Target Capabilities</h2>
+
+<table>
+<tbody>
+<tr><td><em>Capability</em></td><td><em>Description</em></td></tr>
+<tr><td>qdx.router</td><td>This capability is added to sources and targets that are used for inter-router message exchange.</td></tr>
+</tbody>
+</table>
+
+ </div>
+ <div id="bottom">
+ <ul id="apache-navigation">
+ <li><a href="http://www.apache.org/">Apache</a></li>
+ <li><a href="http://www.apache.org/licenses/">License</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Thanks!</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ <li><a href="http://www.apache.org/"><img id="apache-feather" width="48" height="14" src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAC4AAAAOCAYAAABQFS4BAAAFnElEQVRIx83S22ukdx3H8e/v8Pyew5xnsrMJSZNsmm4PW91uL5ZWhIK9EA/Fq8Uiite9EuzVFhbxoqvd7kWLVEWEuioqpQgVtmpFssZtabpR9xCb7uQwmexMspPM5JmZ5/w8v9/v64UtiCi2StX3X/CCz4fMz8w8vN5qLSGihnf7ypkzdw333Eeaq43f/G7xtRb8H0bOnz//+He/9cLjCHpZEfL9ZrN5+9wLL55GUJ/f2W7B3M+WnzZRfqmAukA0jgpVfu1NHF1dGHZ+abbnswVckP8T+Orq6tEwjJ5/9plvlv5wZflO1PriY6dOYcwKX6xWyli/uLUaRf2jdwRUTBGl+kL6PA5HlVGQ2zNVK7T0WlJhr1wW6hcvLizE/zU4IsLS0lKxVjv09dXVP3/5RxcuHNy4dn18/r77LCIKOBFN+XWds4uQcuEOCKOZOr6b8O6E0OV+AGUtVd+I99JS4ks3XWncgctqlv36qe+9dvVDh79Xo9E4ufzH61/b6e5/YnHxEvY7bYPGNs5Wj+s8q4GdY7TkR8gxFGNdATiZKifwyHTXBZnPqZR4EScq9aNQxfPkem8YvVPhxhu/Pch+9YM/LQw+NPgTp0/PVuzydxTwh6M4sk9gLrj51nZxhwWqPdwgeXFYVcQkpdqgRlbmDhI1z3sqsyjPp4GquSMSCIrTUUATJlJSSKMeCePJ7TTr5OTQrBsH7JAY9kDK3n504WK7/ebi2tr+fww/e/bcZ6rj489YljNj2zYUnv6x50VpXRoFFGmFL9QTKR2qtocbdDAI+HhlBkp0QumUkgckI/0q6OPuEHrlHFaTEea
TGHUA3MwzXXB9Gtg69axcaoYBt+NwEN7N/L0idvsr2TtpPrnCHilcOn32lfUPDG82mx/dat366sR4XW9ttUz9k1c/LV5fLylb4DGX0x/OjeuwMh0DoKF9yg/EjhrpHu4MtlgYKFIvTslJo0oTXcGTI5f2ihVdFEBEGGhOJB3latqWrprrBwa3Ez0kDl5lR8jd5oZv0CAd21RsO99ruyet55e8Wy+/9NKK/77g7/78HinlpmmaH9Fan+ldfvVT8Po1VlpL2VVq60IM6TDTzIkOGe44xBEXYOuEbViCeSyRcerhXtBlu26blewxnTcPY44yQLRBgca52KYz6BMTDL1sztM7jU00MiWjxOEP8S5WICK7EtrJgcvg0ULXOZrnmxitdQ+it/3B8LlvfPv37j+E/33r6xvnR8POF8JOozh6e004FzehdluzQbFM0VRxzAUSRJIhwX6GlOdySgJhocH5fhqgb9kqIgAcQgiYAXE2Yv1gQJRCYMjJlEI5yh/GIzo05oNMdUSRTSovPTaMhHvqcBpMUmIWUMkMItRhZ9f1fvrEkz8/9y/hf12heZxz/KTS+nO3b63cG/VvOvLyBoOmr8enLOoveiT3MQfxUkC6JigClDAF1NAKUuFgGSg2c4bUjINODbZPJF3nd9H7RUdFQUgaloVjmYcDs05M1YWBClFUGZs8kqpqxQGDE0oBkHOiewM/VFl87X3B/7Zms/mYUvjZKPIe8lu7VSn2S8mVthGzgCIJCH2jD3yoSBpr4tQYhAQwvydJDYnuGEwxhcxWSPYYp9IXMCdivWMbmACiiRrUkLKyleq+JVBMC6ofFbpUNQEVAEpJGzsuuAMVfWD4e7XbbdtPknsp4oME8R4AOg2g61HgV73RIGdorr1GK+/vbrPEyuxiMyJwgsvkUo+jDgxdtzANU8PeylT+42PS24iQFBixcijkyInh/kqaBcpwWiM4eNAE7gjl5OuqUDsWT0zO7P7b8H/WjRs3
Koh4qFwuZ1mWPYAIJwCwCAA5JKREEPJKqRnKmUcQbSCEESAeAqSISAmBKiKuEIAuALUQ9BglBBExopSuUkpfnp2dvfkX6a5m0ZqSUXAAAAAASUVORK5CYII="/></a></li>
+ </ul>
+
+ <p id="legal">
+ Apache Qpid, Messaging built on AMQP; Copyright © 2013
+ The Apache Software Foundation; Licensed under
+ the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache
+ License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton,
+ Proton, Apache, the Apache feather logo, and the Apache Qpid
+ project logo are trademarks of The Apache Software
+ Foundation; All other marks mentioned may be trademarks or
+ registered trademarks of their respective owners
+ </p>
+ </div>
+ </div>
+ </body>
+</html>
Modified: qpid/site/docs/components/dispatch-router/index.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/components/dispatch-router/index.html?rev=1525035&r1=1525034&r2=1525035&view=diff
==============================================================================
--- qpid/site/docs/components/dispatch-router/index.html (original)
+++ qpid/site/docs/components/dispatch-router/index.html Fri Sep 20 15:31:34 2013
@@ -111,6 +111,12 @@ involving a broker at all.</p>
</div>
+<h2 id="technical-details">Technical Details</h2>
+
+<ul>
+<li><a href="amqp-mapping.html">Usage of AMQP</a></li>
+</ul>
+
<h2 id="issues">Issues</h2>
<p>For more information about finding and reporting bugs, see
Added: qpid/site/input/components/dispatch-router/amqp-mapping.md
URL: http://svn.apache.org/viewvc/qpid/site/input/components/dispatch-router/amqp-mapping.md?rev=1525035&view=auto
==============================================================================
--- qpid/site/input/components/dispatch-router/amqp-mapping.md (added)
+++ qpid/site/input/components/dispatch-router/amqp-mapping.md Fri Sep 20 15:31:34 2013
@@ -0,0 +1,39 @@
+;;
+;; 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.
+;;
+
+# Dispatch AMQP Mapping
+
+Dispatch Router is an AMQP router and as such, it provides extensions,
+codepoints, and semantics for routing over AMQP. This page documents
+the details of Dispatch Router's use of AMQP.
+
+## Delivery Annotations
+
+The following Delivery Annotation fields are defined by Dispatch Router:
+
+ || *Field* || *Type* || *Description* ||
+ || qdx.ingress || string || The identity of the ingress router for a message-routed message. The ingress router is the first router encountered by a transiting message. The router will, if this field is present, leave it unaltered. If the field is not present, the router shall insert the field with its own identity. ||
+ || qdx.trace || list of string || The list of routers through which this message-routed message has transited. If this field is not present, the router shall do nothing. If the field is present, the router shall append its own identity to the end of the list. ||
+ || qdx.to || string || To-Override for message-routed messages. If this field is present, the address in this field shall be used for routing in lieu of the *to* field in the message properties. A router may append, remove, or modify this annotation field depending on the policy in place for routing the message. ||
+
+## Source/Target Capabilities
+
+ || *Capability* || *Description* ||
+ || qdx.router || This capability is added to sources and targets that are used for inter-router message exchange. ||
+
Modified: qpid/site/input/components/dispatch-router/index.md
URL: http://svn.apache.org/viewvc/qpid/site/input/components/dispatch-router/index.md?rev=1525035&r1=1525034&r2=1525035&view=diff
==============================================================================
--- qpid/site/input/components/dispatch-router/index.md (original)
+++ qpid/site/input/components/dispatch-router/index.md Fri Sep 20 15:31:34 2013
@@ -70,15 +70,9 @@ involving a broker at all.
</div>
-;;## Documentation
-;;
-;;*Coming soon*
-;;
-;;This is the documentation for the current released version. You can
-;;find previous versions with our
-;;[past releases](@site-url@/releases/index.html#past-releases).
-;;
-;; - [Deployment and Configuration Guide](@current-dispatch-release-url@/dispatch-deploy/book/index.html)
+## Technical Details
+
+ - [Usage of AMQP](amqp-mapping.html)
## Issues
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@qpid.apache.org
For additional commands, e-mail: commits-help@qpid.apache.org