activemq-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r941572 - in /websites/production/activemq/content: cache/main.pageCache stomp.html
Date Thu, 26 Feb 2015 17:21:34 GMT
Author: buildbot
Date: Thu Feb 26 17:21:34 2015
New Revision: 941572

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 Feb 26 17:21:34 2015
@@ -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 &amp;
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 &gt
 ; <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>
+</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 &amp;
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 &gt
 ; <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 <strong>prior
to v5.7.0</strong>.<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">



Mime
View raw message