Author: buildbot
Date: Thu Mar 13 15:22:07 2014
New Revision: 901451
Log:
Production update by buildbot for activemq
Modified:
websites/production/activemq/content/cache/main.pageCache
websites/production/activemq/content/stomp.html
Modified: websites/production/activemq/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/activemq/content/stomp.html
==============================================================================
--- websites/production/activemq/content/stomp.html (original)
+++ websites/production/activemq/content/stomp.html Thu Mar 13 15:22:07 2014
@@ -234,7 +234,7 @@ connection.disconnect();
</div></div><p>This example is distributed with the ActiveMQ distribution. You
can run it from the <code>example</code> folder with</p><div class="code panel
pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[ant stomp
]]></script>
-</div></div><h3 id="Stomp-StompextensionsforJMSmessagesemantics">Stomp
extensions for JMS message semantics</h3><p>Note that Stomp is designed to be
as simple as possible - so any scripting language / platform can message any
other with minimal effort.</p><p>Stomp allows pluggable headers on each request
such as sending & receiving messages. ActiveMQ has several extensions to
the Stomp protocol, so that JMS semantics can be supported by Stomp clients. An
OpenWire JMS producer can send messages to a Stomp consumer, and a Stomp
producer can send messages to an OpenWire JMS consumer. And Stomp to Stomp
configurations, can use the richer JMS message control.</p><p>Stomp supports
the following standard JMS properties on SENT messages:</p><div
class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1"
rowspan="1" class="confluenceTh"><p>Stomp header</p></th><th colspan="1"
rowspan="1" class="confluenceTh"><p>JMS header</p></th><th colspan="1"
rowspan="1" class="confl
uenceTh"><p>Description</p></th></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>correlation-id</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>JMSCorrelationID</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Good consumers will add this header to any responses
they send</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>expires</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>JMSExpiration</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Expiration time of the message</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>persistent</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>JMSDeliveryMode</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Whether or not the message is
persistent</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>priority</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>JMSPriority</p></td><td colspan="1" rowspan="1" clas
s="confluenceTd"><p>Priority on the message</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>reply-to</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>JMSReplyTo</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Destination you should send replies
to</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>type</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>JMSType</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Type of the message</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>JMSXGroupID</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>JMSXGroupID</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Specifies the <a shape="rect"
href="message-groups.html">Message Groups</a></p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>JMSXGroupSeq</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>JMSXGroupSeq</p></td><td colspan="1"
rowspan="1" cla
ss="confluenceTd"><p>Optional header that specifies the sequence number in the
<a shape="rect" href="message-groups.html">Message
Groups</a></p></td></tr></tbody></table></div><h3
id="Stomp-ActiveMQextensionstoStomp">ActiveMQ extensions to Stomp</h3><p>You
can add custom headers to Stomp commands to configure the ActiveMQ protocol.
Here are some examples:</p><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p>Verb</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Header</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Type</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>CONNECT</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>client-id</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>string</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Specifies the JMS Client ID which i
s used in combination with the activemq.subcriptionName to denote a durable
subscriber.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>SUBSCRIBE</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>selector</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>string</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Specifies a JMS Selector using SQL 92 syntax as
specified in the JMS 1.1 specificiation. This allows a filter to be applied to
each message as part of the subscription.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>SUBSCRIBE</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>activemq.dispatchAsync</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>boolean</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Should messages be dispatched synchronously
or asynchronously from the producer thread for non-durable topics in the
broker? For fast consumers set this to <strong>false</stro
ng>. For slow consumers set it to <strong>true</strong> so that dispatching
will not block fast consumers.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>SUBSCRIBE</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>activemq.exclusive</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>boolean</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>I would like to be an <a shape="rect"
href="exclusive-consumer.html">Exclusive Consumer</a> on the
queue.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>SUBSCRIBE</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>activemq.maximumPendingMessageLimit</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>int</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>For <a shape="rect"
href="slow-consumer-handling.html">Slow Consumer Handling</a> on non-durable
topics by dropping old messages - we can set a maximum-pending limit, such that
once a slow consumer b
acks up to this high water mark we begin to discard old
messages.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>SUBSCRIBE</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>activemq.noLocal</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>boolean</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Specifies whether or not locally sent messages should
be ignored for subscriptions. Set to <strong>true</strong> to filter out
locally sent messages.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>SUBSCRIBE</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>activemq.prefetchSize</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>int</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Specifies the maximum number of pending messages that
will be dispatched to the client. Once this maximum is reached no more messages
are dispatched until the client acknowledges a message. Set to <strong>1</stro
ng> for very fair distribution of messages across consumers where processing
messages can be slow.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>SUBSCRIBE</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>activemq.priority</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>byte</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Sets the priority of the consumer so that dispatching
can be weighted in priority order.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>SUBSCRIBE</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>activemq.retroactive</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>boolean</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>For non-durable topics make this subscription <a
shape="rect"
href="retroactive-consumer.html">retroactive</a>.</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>SUBSCRIBE</p></td><td
colspan="1" rowspan="1" class="confl
uenceTd"><p>activemq.subscriptionName</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>string</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>For durable topic subscriptions you must specify the
same clientId on the connection and subcriptionName on the subscribe.<br
clear="none" class="atl-forced-newline"> <em><strong>Note the
spelling</strong></em>: subcriptionName NOT subscriptionName. This is not
intuitive, but it is how it is implemented in ActiveMQ 4.x. For the 5.0 release
of ActiveMQ, both subcriptionName and
<strong><em>subscriptionName</em></strong> will be supported
<strong>(subcriptionName removed as of
v5.6.0)</strong></p></td></tr></tbody></table></div></div>
+</div></div><h3 id="Stomp-StompextensionsforJMSmessagesemantics">Stomp
extensions for JMS message semantics</h3><p>Note that Stomp is designed to be
as simple as possible - so any scripting language / platform can message any
other with minimal effort.</p><p>Stomp allows pluggable headers on each request
such as sending & receiving messages. ActiveMQ has several extensions to
the Stomp protocol, so that JMS semantics can be supported by Stomp clients. An
OpenWire JMS producer can send messages to a Stomp consumer, and a Stomp
producer can send messages to an OpenWire JMS consumer. And Stomp to Stomp
configurations, can use the richer JMS message control.</p><p>Stomp supports
the following standard JMS properties on SENT messages:</p><div
class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1"
rowspan="1" class="confluenceTh"><p>Stomp header</p></th><th colspan="1"
rowspan="1" class="confluenceTh"><p>JMS header</p></th><th colspan="1"
rowspan="1" class="confl
uenceTh"><p>Description</p></th></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>correlation-id</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>JMSCorrelationID</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Good consumers will add this header to any responses
they send</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>expires</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>JMSExpiration</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Expiration time of the message</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>persistent</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>JMSDeliveryMode</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Whether or not the message is
persistent</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>priority</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>JMSPriority</p></td><td colspan="1" rowspan="1" clas
s="confluenceTd"><p>Priority on the message</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>reply-to</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>JMSReplyTo</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Destination you should send replies
to</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>type</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>JMSType</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Type of the message</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>JMSXGroupID</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>JMSXGroupID</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Specifies the <a shape="rect"
href="message-groups.html">Message Groups</a></p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>JMSXGroupSeq</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>JMSXGroupSeq</p></td><td colspan="1"
rowspan="1" cla
ss="confluenceTd"><p>Optional header that specifies the sequence number in the
<a shape="rect" href="message-groups.html">Message
Groups</a></p></td></tr></tbody></table></div><h3
id="Stomp-ActiveMQextensionstoStomp">ActiveMQ extensions to Stomp</h3><p>You
can add custom headers to Stomp commands to configure the ActiveMQ protocol.
Here are some examples:</p><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p>Verb</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Header</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Type</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>CONNECT</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>client-id</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>string</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Specifies the JMS Client ID which i
s used in combination with the activemq.subcriptionName to denote a durable
subscriber.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>SUBSCRIBE</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>selector</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>string</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Specifies a JMS Selector using SQL 92 syntax as
specified in the JMS 1.1 specificiation. This allows a filter to be applied to
each message as part of the subscription.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>SUBSCRIBE</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>activemq.dispatchAsync</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>boolean</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Should messages be dispatched synchronously
or asynchronously from the producer thread for non-durable topics in the
broker? For fast consumers set this to <strong>false</stro
ng>. For slow consumers set it to <strong>true</strong> so that dispatching
will not block fast consumers.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>SUBSCRIBE</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>activemq.exclusive</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>boolean</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>I would like to be an <a shape="rect"
href="exclusive-consumer.html">Exclusive Consumer</a> on the
queue.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>SUBSCRIBE</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>activemq.maximumPendingMessageLimit</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>int</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>For <a shape="rect"
href="slow-consumer-handling.html">Slow Consumer Handling</a> on non-durable
topics by dropping old messages - we can set a maximum-pending limit, such that
once a slow consumer b
acks up to this high water mark we begin to discard old
messages.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>SUBSCRIBE</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>activemq.noLocal</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>boolean</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Specifies whether or not locally sent messages should
be ignored for subscriptions. Set to <strong>true</strong> to filter out
locally sent messages.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>SUBSCRIBE</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>activemq.prefetchSize</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>int</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Specifies the maximum number of pending messages that
will be dispatched to the client. Once this maximum is reached no more messages
are dispatched until the client acknowledges a message. Set to a low value >
; <strong>1</strong> for fair distribution of messages across consumers when
processing messages can be slow. STOMP does not support a value of
0.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>SUBSCRIBE</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>activemq.priority</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>byte</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Sets the priority of the consumer so that dispatching
can be weighted in priority order.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>SUBSCRIBE</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>activemq.retroactive</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>boolean</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>For non-durable topics make this subscription <a
shape="rect"
href="retroactive-consumer.html">retroactive</a>.</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>SUBSCRIBE<
/p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>activemq.subscriptionName</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>string</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>For durable topic subscriptions you must specify the
same clientId on the connection and subcriptionName on the subscribe.<br
clear="none" class="atl-forced-newline"> <em><strong>Note the
spelling</strong></em>: subcriptionName NOT subscriptionName. This is not
intuitive, but it is how it is implemented in ActiveMQ 4.x. For the 5.0 release
of ActiveMQ, both subcriptionName and
<strong><em>subscriptionName</em></strong> will be supported
<strong>(subcriptionName removed as of
v5.6.0)</strong></p></td></tr></tbody></table></div></div>
</td>
<td valign="top">
<div class="navigation">
