Author: buildbot
Date: Tue Nov 5 14:22:40 2013
New Revision: 885515
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 Tue Nov 5 14:22:40 2013
@@ -32,16 +32,6 @@
</style>
<![endif]-->
- <link
href='http://activemq.apache.org/styles/highlighter/styles/shCore.css'
rel='stylesheet' type='text/css' />
- <link
href='http://activemq.apache.org/styles/highlighter/styles/shThemeEclipse.css'
rel='stylesheet' type='text/css' />
- <script
src='http://activemq.apache.org/styles/highlighter/scripts/shCore.js'
type='text/javascript'></script>
- <script
src='http://activemq.apache.org/styles/highlighter/scripts/shBrushJava.js'
type='text/javascript'></script>
- <script
src='http://activemq.apache.org/styles/highlighter/scripts/shBrushXml.js'
type='text/javascript'></script>
-
- <script type="text/javascript">
- SyntaxHighlighter.defaults['toolbar'] = false;
- SyntaxHighlighter.all();
- </script>
<title>
Apache ActiveMQ ™ -- Stomp
@@ -143,6 +133,26 @@ activemq xbean:foo.xml
<ul><li>For more details on using SSL with ActiveMQ see the following article
(<a shape="rect" class="external-link"
href="http://activemq.apache.org/how-do-i-use-ssl.html";>How do I use
SSL</a>).</li><li>Example of using Stomp over SSL on the client side could be
found in the <a shape="rect" class="external-link"
href="http://stomp.fusesource.org/documentation/php/book.html#SSL";
rel="nofollow">PHP Stomp client example </a>.</li></ul>
+<h3><a shape="rect" name="Stomp-Heartbeatgraceperiods"></a>Heart-beat grace
periods</h3>
+
+<p>STOMP supports the <a shape="rect" class="external-link"
href="http://stomp.github.io/stomp-specification-1.2.html#Heart-beating";
rel="nofollow">notion of heart beats</a> to be able to detect the health of the
underlying TCP connection. </p>
+
+<p>ActiveMQ implements this heart beating functionality, however before
<b>5.9.0</b>, the heart-beat timeouts were strict; i.e., the were enforced
without any kind of grace period.</p>
+
+<p>The STOMP spec does does state that the client/receiver should be tolerant
of timing inaccuracies, so in version <b>5.9.0</b> we've added the following
parameter:</p>
+
+<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
+<script class="theme: Default; brush: xml; gutter: false"
type="syntaxhighlighter"><![CDATA[
+tcp://host:port?transport.hbGracePeriodMultiplier=1.5
+]]></script>
+</div></div>
+
+<p>This setting will allow the client to use a grace period when checking
heart beats from the server.</p>
+
+<ul><li>Please check the <a shape="rect" class="external-link"
href="http://stomp.github.io/stomp-specification-1.2.html#Heart-beating";
rel="nofollow">STOMP specification</a> for the details on
heart-beating</li><li>The JIRA that implemented this: <a shape="rect"
class="external-link"
href="https://issues.apache.org/jira/browse/AMQ-4674";>ActiveMQ 5.x does not
support the notion of a grace-period for heart beats as supported by the STOMP
protocol</a></li></ul>
+
+
+
<h3><a shape="rect" name="Stomp-WorkingwithDestinationswithStomp"></a>Working
with Destinations with Stomp</h3>
<p>Note that the prefix in stomp <b>/queue/</b> or <b>/topic/</b> is removed
from the string before passing it to ActiveMQ as a JMS destination. Also note
that the default separator in MOM systems is . (DOT). So <b>FOO.BAR</b> is the
normal syntax of a MOM queue - the Stomp equivalent would be
<b>/queue/FOO.BAR</b></p>
