You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@activemq.apache.org by bu...@apache.org on 2017/09/11 16:23:27 UTC
svn commit: r1018005 - in /websites/production/activemq/content:
cache/main.pageCache configuring-wire-formats.html
Author: buildbot
Date: Mon Sep 11 16:23:27 2017
New Revision: 1018005
Log:
Production update by buildbot for activemq
Modified:
websites/production/activemq/content/cache/main.pageCache
websites/production/activemq/content/configuring-wire-formats.html
Modified: websites/production/activemq/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/activemq/content/configuring-wire-formats.html
==============================================================================
--- websites/production/activemq/content/configuring-wire-formats.html (original)
+++ websites/production/activemq/content/configuring-wire-formats.html Mon Sep 11 16:23:27 2017
@@ -71,7 +71,7 @@
<tbody>
<tr>
<td valign="top" width="100%">
-<div class="wiki-content maincontent"><h3 id="ConfiguringWireFormats-TheOpenWireWireFormat">The OpenWire Wire Format</h3><p>OpenWire is the default wire format used by ActiveMQ.  It provides a highly efficient binary format for high speed messaging.  OpenWire options can be configured on a JMS client's connection URI or on a broker's transport bind URI.</p><div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Parameter Name</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Default Value</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>cacheEnabled</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><code>true</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Should commonly repeated values be cached so that less marshaling occurs?</p></td></tr><tr><td colspan="1" rowspan="
1" class="confluenceTd"><p><code>cacheSize</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><code>1024</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>When <strong><code>cacheEnabled=true</code></strong> then this parameter is used to specify the number of values to be cached.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>maxInactivityDuration</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><code>30000</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>The maximum <a shape="rect" href="activemq-inactivitymonitor.html">inactivity</a> duration (before which the socket is considered dead) in milliseconds. On some platforms it can take a long time for a socket to die. Therefore allow the broker to kill connections when they have been inactive for the configured period of time.</p><p>Used by some transports to enable a keep alive heart beat feature.</p><p>Inactivity monitoring is dis
abled when set to a value <strong><code><= 0</code></strong>.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><code>maxInactivityDurationInitalDelay</code></td><td colspan="1" rowspan="1" class="confluenceTd"><p><code>10000</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>The initial delay before starting <a shape="rect" href="activemq-inactivitymonitor.html">inactivity</a> checks.</p><p>Yes, the word <strong><code>'Inital'</code></strong> is supposed to be misspelled like that.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><pre><code>maxFrameSize</code></pre></td><td colspan="1" rowspan="1" class="confluenceTd"><pre><code>MAX_LONG</code></pre></td><td colspan="1" rowspan="1" class="confluenceTd"><pre>Maximum allowed frame size. Can help help prevent OOM DOS attacks.</pre></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><code>sizePrefixDisabled</code></td><td colspan="1" rowspan="1" class="confluenceTd"><p
><code>false</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Should the size of the packet be prefixed before each packet is marshaled?</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>stackTraceEnabled</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><code>true</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Should the stack trace of exception that occur on the broker be sent to the client?</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>tcpNoDelayEnabled</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><code>true</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Does not affect the wire format, but provides a hint to the peer that TCP nodelay should be enabled on the communications Socket.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>tightEncodingEnabled</code></p></td><td colspan="1" rowspan="1" class="conflu
enceTd"><p><code>true</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Should wire size be optimized over CPU usage?</p></td></tr></tbody></table></div><div class="confluence-information-macro confluence-information-macro-warning"><p class="title">Use the Correct Prefix!</p><span class="aui-icon aui-icon-small aui-iconfont-error confluence-information-macro-icon"></span><div class="confluence-information-macro-body"><p>Wire format options must have the prefix <strong><code>wireFormat.</code></strong> to take effect, e.g., <strong><code>wireFormat.maxInactivityDuration=10000</code></strong>. Options missing this prefix will be ignored.</p></div></div><h4 id="ConfiguringWireFormats-ExampleConfigurations">Example Configurations</h4><p><strong>Java:</strong></p><pre>ActiveMQConnectionFactory cf = </pre><pre> new ActiveMQConnectionFactory("tcp://localhost:61616?wireFormat.cacheEnabled=false&wireFormat.tightEncodingEnabled=false");</pre><p><strong>Sprin
g:</strong></p><pre><bean class="org.apache.activemq.ActiveMQConnectionFactory">
+<div class="wiki-content maincontent"><h3 id="ConfiguringWireFormats-TheOpenWireWireFormat">The OpenWire Wire Format</h3><p>OpenWire is the default wire format used by ActiveMQ.  It provides a highly efficient binary format for high speed messaging.  OpenWire options can be configured on a JMS client's connection URI or on a broker's transport bind URI.</p><div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Parameter Name</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Default Value</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><code>cacheEnabled</code></td><td colspan="1" rowspan="1" class="confluenceTd"><code>true</code></td><td colspan="1" rowspan="1" class="confluenceTd">Should commonly repeated values be cached so that less marshaling occurs?</td></tr><tr><td colspan="1" rowspan="1" class="confluenceT
d"><code>cacheSize</code></td><td colspan="1" rowspan="1" class="confluenceTd"><code>1024</code></td><td colspan="1" rowspan="1" class="confluenceTd">When <strong><code>cacheEnabled=true</code></strong> then this parameter is used to specify the number of values to be cached.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><code>maxInactivityDuration</code></td><td colspan="1" rowspan="1" class="confluenceTd"><code>30000</code></td><td colspan="1" rowspan="1" class="confluenceTd">The maximum <a shape="rect" href="activemq-inactivitymonitor.html">inactivity</a> duration (before which the socket is considered dead) in milliseconds. On some platforms it can take a long time for a socket to die. Therefore allow the broker to kill connections when they have been inactive for the configured period of time.Used by some transports to enable a keep alive heart beat feature.Inactivity monitoring is disabled when set to a value <strong><code><= 0</code></strong>.</td></tr
><tr><td colspan="1" rowspan="1" class="confluenceTd"><code>maxInactivityDurationInitalDelay</code></td><td colspan="1" rowspan="1" class="confluenceTd"><code>10000</code></td><td colspan="1" rowspan="1" class="confluenceTd">The initial delay before starting <a shape="rect" href="activemq-inactivitymonitor.html">inactivity</a> checks.Yes, the word <strong><code>'Inital'</code></strong> is supposed to be misspelled like that.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><pre><code>maxFrameSize</code></pre></td><td colspan="1" rowspan="1" class="confluenceTd"><pre><code>MAX_LONG</code></pre></td><td colspan="1" rowspan="1" class="confluenceTd"><pre>Maximum allowed frame size. Can help help prevent OOM DOS attacks.</pre></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><code>sizePrefixDisabled</code></td><td colspan="1" rowspan="1" class="confluenceTd"><code>false</code></td><td colspan="1" rowspan="1" class="confluenceTd">Should the size of the packe
t be prefixed before each packet is marshaled?</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><code>stackTraceEnabled</code></td><td colspan="1" rowspan="1" class="confluenceTd"><code>true</code></td><td colspan="1" rowspan="1" class="confluenceTd">Should the stack trace of exception that occur on the broker be sent to the client?</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><code>tcpNoDelayEnabled</code></td><td colspan="1" rowspan="1" class="confluenceTd"><code>true</code></td><td colspan="1" rowspan="1" class="confluenceTd">Does not affect the wire format, but provides a hint to the peer that TCP nodelay should be enabled on the communications Socket.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><code>tightEncodingEnabled</code></td><td colspan="1" rowspan="1" class="confluenceTd"><code>true</code></td><td colspan="1" rowspan="1" class="confluenceTd">Should wire size be optimized over CPU usage?</td></tr></tbody></table></div><div
class="confluence-information-macro confluence-information-macro-warning"><p class="title">Use the Correct Prefix!</p><span class="aui-icon aui-icon-small aui-iconfont-error confluence-information-macro-icon"></span><div class="confluence-information-macro-body"><p>Wire format options must have the prefix <strong><code>wireFormat.</code></strong> to take effect, e.g., <strong><code>wireFormat.maxInactivityDuration=10000</code></strong>. Options missing this prefix will be ignored.</p></div></div><h4 id="ConfiguringWireFormats-ExampleConfigurations">Example Configurations</h4><p><strong>Java:</strong></p><pre>ActiveMQConnectionFactory cf = </pre><pre> new ActiveMQConnectionFactory("tcp://localhost:61616?wireFormat.cacheEnabled=false&wireFormat.tightEncodingEnabled=false");</pre><p><strong>Spring:</strong></p><pre><bean class="org.apache.activemq.ActiveMQConnectionFactory">
<property name="brokerURL" value="failover:(tcp://localhost:61616?jms.optimizeAcknowledge=false&wireFormat.maxInactivityDuration=30000)"/>
<!-- ...other options... -->
</bean></pre><p><strong><br clear="none"></strong></p><p> </p></div>