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: [email protected]
For additional commands, e-mail: [email protected]
