Author: tross
Date: Fri Sep 20 17:06:51 2013
New Revision: 1525054
URL: http://svn.apache.org/r1525054
Log:
QPID-5001 - Added details about address formats.
Modified:
qpid/site/docs/components/dispatch-router/amqp-mapping.html
qpid/site/docs/components/dispatch-router/index.html
qpid/site/input/components/dispatch-router/amqp-mapping.md
qpid/site/input/components/dispatch-router/index.md
Modified: 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=1525054&r1=1525053&r2=1525054&view=diff
==============================================================================
--- qpid/site/docs/components/dispatch-router/amqp-mapping.html (original)
+++ qpid/site/docs/components/dispatch-router/amqp-mapping.html Fri Sep 20
17:06:51 2013
@@ -68,6 +68,8 @@ the details of Dispatch Router's use of
<h2 id="sourcetarget-capabilities">Source/Target Capabilities</h2>
+<p>The following Capability values are used in Sources and Targets.</p>
+
<table>
<tbody>
<tr><td><em>Capability</em></td><td><em>Description</em></td></tr>
@@ -75,6 +77,33 @@ the details of Dispatch Router's use of
</tbody>
</table>
+<h2 id="addresses-and-address-formats">Addresses and Address Formats</h2>
+
+<p>The following AMQP addresses and address patterns are used within Dispatch
Router.</p>
+
+<h3 id="address-patterns">Address Patterns</h3>
+
+<table>
+<tbody>
+<tr><td><em>Pattern</em></td><td><em>Description</em></td></tr>
+<tr><td>/_local/<addr></td><td>An address that references a locally
attached endpoint. Messages using this address pattern shall not be routed
over more than one link.</td></tr>
+<tr><td><span style="white-space:
nowrap;">/_topo/<area>/<router>/<addr></span></td><td>An
address that references an endpoint attached to a specific router node in the
network topology. Messages with addresses that follow this pattern shall be
routed along the shortest path to the specified router. Note that addresses of
this form are a-priori routable in that the address itself contains enough
information to route the message to its destination.</td></tr>
+<tr><td>/<addr></td><td>A mobile address. An address of this format
represents an endpoint or a set of distinct endpoints that are attached to the
network in arbitrary locations. It is the responsibility of the router network
to determine which router nodes are valid destinations for mobile
addresses.</td></tr>
+</tbody>
+</table>
+
+<h3 id="supported-addresses">Supported Addresses</h3>
+
+<table>
+<tbody>
+<tr><td><em>Address</em></td><td><em>Description</em></td></tr>
+<tr><td>/_local/agent</td><td>The management agent on the attached
router/container. This address would be used by an endpoint that is a
management client/console/tool wishing to access management data from the
attached container.</td></tr>
+<tr><td><span style="white-space:
nowrap;">/_topo/A2/Router.E/agent</span></td><td>The management agent at
Router.E in area A2. This address would be used by a management client wishing
to access management data from a specific container that is reachable within
the network.</td></tr>
+<tr><td>/_local/qdx.router</td><td>The router entity in each of the connected
routers. This address is used by a router to communicate with all of its
neighboring routers.</td></tr>
+<tr><td><span style="white-space:
nowrap;">/_topo/A2/Router.E/qdx.router</span></td><td>The router entity at the
specifically indicated router. This address form is used by a router to
communicate with a specific router that may or may not be a neighbor.</td></tr>
+</tbody>
+</table>
+
</div>
<div id="bottom">
<ul id="apache-navigation">
Modified: qpid/site/docs/components/dispatch-router/index.html
URL:
http://svn.apache.org/viewvc/qpid/site/docs/components/dispatch-router/index.html?rev=1525054&r1=1525053&r2=1525054&view=diff
==============================================================================
--- qpid/site/docs/components/dispatch-router/index.html (original)
+++ qpid/site/docs/components/dispatch-router/index.html Fri Sep 20 17:06:51
2013
@@ -113,10 +113,14 @@ involving a broker at all.</p>
<h2 id="technical-details">Technical Details</h2>
+<div class="two-column">
+
<ul>
<li><a href="amqp-mapping.html">Usage of AMQP</a></li>
</ul>
+</div>
+
<h2 id="issues">Issues</h2>
<p>For more information about finding and reporting bugs, see
Modified: 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=1525054&r1=1525053&r2=1525054&view=diff
==============================================================================
--- qpid/site/input/components/dispatch-router/amqp-mapping.md (original)
+++ qpid/site/input/components/dispatch-router/amqp-mapping.md Fri Sep 20
17:06:51 2013
@@ -23,6 +23,7 @@ Dispatch Router is an AMQP router and as
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:
@@ -32,8 +33,30 @@ The following Delivery Annotation fields
|| 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
+The following Capability values are used in Sources and Targets.
+
|| *Capability* || *Description* ||
|| qdx.router || This capability is added to sources and targets that are
used for inter-router message exchange. ||
+
+## Addresses and Address Formats
+
+The following AMQP addresses and address patterns are used within Dispatch
Router.
+
+### Address Patterns
+
+ || *Pattern* || *Description* ||
+ || /_local/<addr> || An address that references a locally attached
endpoint. Messages using this address pattern shall not be routed over more
than one link. ||
+ || <span style="white-space:
nowrap;">/_topo/<area>/<router>/<addr></span> || An address
that references an endpoint attached to a specific router node in the network
topology. Messages with addresses that follow this pattern shall be routed
along the shortest path to the specified router. Note that addresses of this
form are a-priori routable in that the address itself contains enough
information to route the message to its destination. ||
+ || /<addr> || A mobile address. An address of this format represents
an endpoint or a set of distinct endpoints that are attached to the network in
arbitrary locations. It is the responsibility of the router network to
determine which router nodes are valid destinations for mobile addresses. ||
+
+### Supported Addresses
+
+ || *Address* || *Description* ||
+ || /_local/agent || The management agent on the attached router/container.
This address would be used by an endpoint that is a management
client/console/tool wishing to access management data from the attached
container. ||
+ || <span style="white-space: nowrap;">/_topo/A2/Router.E/agent</span> || The
management agent at Router.E in area A2. This address would be used by a
management client wishing to access management data from a specific container
that is reachable within the network. ||
+ || /_local/qdx.router || The router entity in each of the connected routers.
This address is used by a router to communicate with all of its neighboring
routers. ||
+ || <span style="white-space: nowrap;">/_topo/A2/Router.E/qdx.router</span>
|| The router entity at the specifically indicated router. This address form
is used by a router to communicate with a specific router that may or may not
be a neighbor. ||
Modified: qpid/site/input/components/dispatch-router/index.md
URL:
http://svn.apache.org/viewvc/qpid/site/input/components/dispatch-router/index.md?rev=1525054&r1=1525053&r2=1525054&view=diff
==============================================================================
--- qpid/site/input/components/dispatch-router/index.md (original)
+++ qpid/site/input/components/dispatch-router/index.md Fri Sep 20 17:06:51 2013
@@ -72,8 +72,12 @@ involving a broker at all.
## Technical Details
+<div class="two-column" markdown="1">
+
- [Usage of AMQP](amqp-mapping.html)
+</div>
+
## Issues
For more information about finding and reporting bugs, see
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
