You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@camel.apache.org by bu...@apache.org on 2013/06/04 17:22:26 UTC
svn commit: r864363 [1/2] - in /websites/production/camel/content:
book-component-appendix.html book-in-one-page.html cache/main.pageCache
camel-2120-release.html netty.html
Author: buildbot
Date: Tue Jun 4 15:22:11 2013
New Revision: 864363
Log:
Production update by buildbot for camel
Modified:
websites/production/camel/content/book-component-appendix.html
websites/production/camel/content/book-in-one-page.html
websites/production/camel/content/cache/main.pageCache
websites/production/camel/content/camel-2120-release.html
websites/production/camel/content/netty.html
Modified: websites/production/camel/content/book-component-appendix.html
==============================================================================
--- websites/production/camel/content/book-component-appendix.html (original)
+++ websites/production/camel/content/book-component-appendix.html Tue Jun 4 15:22:11 2013
@@ -12444,7 +12444,7 @@ netty:tcp:<span class="code-comment">//l
<h3><a shape="rect" name="BookComponentAppendix-Options"></a>Options</h3>
<div class="confluenceTableSmall"><div class="table-wrap">
-<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"> Name </th><th colspan="1" rowspan="1" class="confluenceTh"> Default Value </th><th colspan="1" rowspan="1" class="confluenceTh"> Description </th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>keepAlive</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Setting to ensure socket is not closed due to inactivity </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>tcpNoDelay</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Setting to improve TCP protocol performance </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>backlog</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.9.6/2.10.4/2.11:</b> Allows to co
nfigure a backlog for netty consumer (server). Note the backlog is just a best effort depending on the OS. Setting this option to a value such as <tt>200</tt>, <tt>500</tt> or <tt>1000</tt>, tells the TCP stack how long the "accept" queue can be. If this option is not configured, then the backlog depends on OS setting. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>broadcast</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Setting to choose Multicast over UDP </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>connectTimeout</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>10000</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Time to wait for a socket connection to be available. Value is in millis. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>reuseAddress</tt> </td><td colspan="1" rowspan="1" class="confluence
Td"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Setting to facilitate socket multiplexing </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>sync</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Setting to set endpoint as one-way or request-response </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>synchronous</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10:</b> Whether <a shape="rect" href="asynchronous-routing-engine.html" title="Asynchronous Routing Engine">Asynchronous Routing Engine</a> is not in use. <tt>false</tt> then the <a shape="rect" href="asynchronous-routing-engine.html" title="Asynchronous Routing Engine">Asynchronous Routing Engine</a> is used, <tt>true</tt> to force processing synchronous. </td></tr><tr><td colspan="1" rowspa
n="1" class="confluenceTd"> <tt>ssl</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Setting to specify whether SSL encryption is applied to this endpoint </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>sendBufferSize</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>65536 bytes</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> The TCP/UDP buffer sizes to be used during outbound communication. Size is bytes. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>receiveBufferSize</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>65536 bytes</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> The TCP/UDP buffer sizes to be used during inbound communication. Size is bytes. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>option.XXX</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>null</
tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.11/2.10.4:</b> Allows to configure additional netty options using "option." as prefix. For example "option.child.keepAlive=false" to set the netty option "child.keepAlive=false". See the Netty documentation for possible options that can be used. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>corePoolSize</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>10</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> The number of allocated threads at component startup. Defaults to 10. <b>Note:</b> This option is removed from Camel 2.9.2 onwards. As we rely on Nettys default settings. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>maxPoolSize</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>100</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> The maximum number of threads that may be allocated to this endpoint. Defaults to 100.
<b>Note:</b> This option is removed from Camel 2.9.2 onwards. As we rely on Nettys default settings. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>disconnect</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Whether or not to disconnect(close) from Netty Channel right after use. Can be used for both consumer and producer. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>lazyChannelCreation</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Channels can be lazily created to avoid exceptions, if the remote server is not up and running when the Camel producer is started. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>transferExchange</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
Only used for TCP. You can transfer the exchange over the wire instead of just the body. The following fields are transferred: In body, Out body, fault body, In headers, Out headers, fault headers, exchange properties, exchange exception. This requires that the objects are serializable. Camel will exclude any non-serializable objects and log it at WARN level. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>disconnectOnNoReply</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> If sync is enabled then this option dictates NettyConsumer if it should disconnect where there is no reply to send back. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>noReplyLogLevel</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>WARN</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> If sync is enabled this option dictates NettyConsumer which logging level t
o use when logging a there is no reply to send back. Values are: <tt>FATAL, ERROR, INFO, DEBUG, OFF</tt>. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>allowDefaultCodec</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.4:</b> The netty component installs a default codec if both, encoder/deocder is null and textline is false. Setting allowDefaultCodec to false prevents the netty component from installing a default codec as the first element in the filter chain. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>textline</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.4:</b> Only used for TCP. If no codec is specified, you can use this flag to indicate a text line based codec; if not specified or the value is false, then Object Serialization is assumed over
TCP. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>delimiter</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>LINE</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.4:</b> The delimiter to use for the textline codec. Possible values are <tt>LINE</tt> and <tt>NULL</tt>. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>decoderMaxLineLength</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>1024</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.4:</b> The max line length to use for the textline codec. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>autoAppendDelimiter</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.4:</b> Whether or not to auto append missing end delimiter when sending using the textline codec. </td></tr><tr><td colspan="1" rowspan="1" class=
"confluenceTd"> <tt>encoding</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.4:</b> The encoding (a charset name) to use for the textline codec. If not provided, Camel will use the JVM default Charset. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>workerCount</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.9:</b> When netty works on nio mode, it uses default workerCount parameter from Netty, which is cpu_core_threads*2. User can use this operation to override the default workerCount from Netty </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>sslContextParametersRef</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.9:</b> Reference to a <tt>org.apache.camel.util.jsse
.SSLContextParameters</tt> in the <a shape="rect" href="registry.html" title="Registry">Registry</a>.  This reference overrides any configured SSLContextParameters at the component level.  See <a shape="rect" href="#BookComponentAppendix-UsingtheJSSEConfigurationUtility">Using the JSSE Configuration Utility</a>. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>receiveBufferSizePredictor</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.9:</b> Configures the buffer size predictor. See details at Jetty documentation and this <a shape="rect" class="external-link" href="http://lists.jboss.org/pipermail/netty-users/2010-January/001958.html" rel="nofollow">mail thread</a>. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>needClientAuth</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"><tt>false</tt> </td><td colspan="1" rowspan="1" clas
s="confluenceTd"> <b>Camel 2.11:</b> Configures whether the server needs client authentication when using SSL. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>orderedThreadPoolExecutor</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10.2:</b> Whether to use ordered thread pool, to ensure events are processed orderly on the same channel. See details at the netty javadoc of <tt>org.jboss.netty.handler.execution.OrderedMemoryAwareThreadPoolExecutor</tt> for more details. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>maximumPoolSize</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>16</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10.2:</b> The core pool size for the ordered thread pool, if its in use. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>producerPoolEnabled</tt> </td><td colspan
="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10.4/Camel 2.11:</b> Producer only. Whether producer pool is enabled or not. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>producerPoolMaxActive</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-1</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10.3:</b> Producer only. Sets the cap on the number of objects that can be allocated by the pool (checked out to clients, or idle awaiting checkout) at a given time. Use a negative value for no limit. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>producerPoolMinIdle</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>0</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10.3:</b> Producer only. Sets the minimum number of instances allowed in the producer pool before the evictor thread (if active) spawns new
objects. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>producerPoolMaxIdle</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>100</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10.3:</b> Producer only. Sets the cap on the number of "idle" instances in the pool. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>producerPoolMinEvictableIdle</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>30000</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10.3:</b> Producer only. Sets the minimum amount of time (value in millis) an object may sit idle in the pool before it is eligible for eviction by the idle object evictor. </td></tr></tbody></table>
+<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"> Name </th><th colspan="1" rowspan="1" class="confluenceTh"> Default Value </th><th colspan="1" rowspan="1" class="confluenceTh"> Description </th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>keepAlive</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Setting to ensure socket is not closed due to inactivity </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>tcpNoDelay</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Setting to improve TCP protocol performance </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>backlog</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.9.6/2.10.4/2.11:</b> Allows to co
nfigure a backlog for netty consumer (server). Note the backlog is just a best effort depending on the OS. Setting this option to a value such as <tt>200</tt>, <tt>500</tt> or <tt>1000</tt>, tells the TCP stack how long the "accept" queue can be. If this option is not configured, then the backlog depends on OS setting. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>broadcast</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Setting to choose Multicast over UDP </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>connectTimeout</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>10000</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Time to wait for a socket connection to be available. Value is in millis. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>reuseAddress</tt> </td><td colspan="1" rowspan="1" class="confluence
Td"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Setting to facilitate socket multiplexing </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>sync</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Setting to set endpoint as one-way or request-response </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>synchronous</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10:</b> Whether <a shape="rect" href="asynchronous-routing-engine.html" title="Asynchronous Routing Engine">Asynchronous Routing Engine</a> is not in use. <tt>false</tt> then the <a shape="rect" href="asynchronous-routing-engine.html" title="Asynchronous Routing Engine">Asynchronous Routing Engine</a> is used, <tt>true</tt> to force processing synchronous. </td></tr><tr><td colspan="1" rowspa
n="1" class="confluenceTd"> <tt>ssl</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Setting to specify whether SSL encryption is applied to this endpoint </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>sendBufferSize</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>65536 bytes</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> The TCP/UDP buffer sizes to be used during outbound communication. Size is bytes. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>receiveBufferSize</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>65536 bytes</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> The TCP/UDP buffer sizes to be used during inbound communication. Size is bytes. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>option.XXX</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>null</
tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.11/2.10.4:</b> Allows to configure additional netty options using "option." as prefix. For example "option.child.keepAlive=false" to set the netty option "child.keepAlive=false". See the Netty documentation for possible options that can be used. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>corePoolSize</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>10</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> The number of allocated threads at component startup. Defaults to 10. <b>Note:</b> This option is removed from Camel 2.9.2 onwards. As we rely on Nettys default settings. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>maxPoolSize</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>100</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> The maximum number of threads that may be allocated to this endpoint. Defaults to 100.
<b>Note:</b> This option is removed from Camel 2.9.2 onwards. As we rely on Nettys default settings. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>disconnect</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Whether or not to disconnect(close) from Netty Channel right after use. Can be used for both consumer and producer. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>lazyChannelCreation</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Channels can be lazily created to avoid exceptions, if the remote server is not up and running when the Camel producer is started. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>transferExchange</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
Only used for TCP. You can transfer the exchange over the wire instead of just the body. The following fields are transferred: In body, Out body, fault body, In headers, Out headers, fault headers, exchange properties, exchange exception. This requires that the objects are serializable. Camel will exclude any non-serializable objects and log it at WARN level. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>disconnectOnNoReply</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> If sync is enabled then this option dictates NettyConsumer if it should disconnect where there is no reply to send back. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>noReplyLogLevel</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>WARN</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> If sync is enabled this option dictates NettyConsumer which logging level t
o use when logging a there is no reply to send back. Values are: <tt>FATAL, ERROR, INFO, DEBUG, OFF</tt>. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>serverExceptionCaughtLogLevel</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>WARN</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.11.1:</b> If the server (NettyConsumer) catches an exception then its logged using this logging level. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>serverClosedChannelExceptionCaughtLogLevel</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>DEBUG</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.11.1:</b> If the server (NettyConsumer) catches an <tt>java.nio.channels.ClosedChannelException</tt> then its logged using this logging level. This is used to avoid logging the closed channel exceptions, as clients can disconnect abruptly and then cause a flod of closed exceptions in the N
etty server. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>allowDefaultCodec</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.4:</b> The netty component installs a default codec if both, encoder/deocder is null and textline is false. Setting allowDefaultCodec to false prevents the netty component from installing a default codec as the first element in the filter chain. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>textline</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.4:</b> Only used for TCP. If no codec is specified, you can use this flag to indicate a text line based codec; if not specified or the value is false, then Object Serialization is assumed over TCP. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>delimiter</tt> </td>
<td colspan="1" rowspan="1" class="confluenceTd"> <tt>LINE</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.4:</b> The delimiter to use for the textline codec. Possible values are <tt>LINE</tt> and <tt>NULL</tt>. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>decoderMaxLineLength</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>1024</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.4:</b> The max line length to use for the textline codec. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>autoAppendDelimiter</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.4:</b> Whether or not to auto append missing end delimiter when sending using the textline codec. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>encoding</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>
null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.4:</b> The encoding (a charset name) to use for the textline codec. If not provided, Camel will use the JVM default Charset. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>workerCount</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.9:</b> When netty works on nio mode, it uses default workerCount parameter from Netty, which is cpu_core_threads*2. User can use this operation to override the default workerCount from Netty </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>sslContextParametersRef</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.9:</b> Reference to a <tt>org.apache.camel.util.jsse.SSLContextParameters</tt> in the <a shape="rect" href="registry.html" title="Registry">Regis
try</a>.  This reference overrides any configured SSLContextParameters at the component level.  See <a shape="rect" href="#BookComponentAppendix-UsingtheJSSEConfigurationUtility">Using the JSSE Configuration Utility</a>. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>receiveBufferSizePredictor</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.9:</b> Configures the buffer size predictor. See details at Jetty documentation and this <a shape="rect" class="external-link" href="http://lists.jboss.org/pipermail/netty-users/2010-January/001958.html" rel="nofollow">mail thread</a>. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>requestTimeout</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>0</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.11.1:</b> Allows to use a timeout for the Netty producer when calli
ng a remote server. By default no timeout is in use. The value is in milli seconds, so eg <tt>30000</tt> is 30 seconds. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>needClientAuth</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"><tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.11:</b> Configures whether the server needs client authentication when using SSL. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>orderedThreadPoolExecutor</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10.2:</b> Whether to use ordered thread pool, to ensure events are processed orderly on the same channel. See details at the netty javadoc of <tt>org.jboss.netty.handler.execution.OrderedMemoryAwareThreadPoolExecutor</tt> for more details. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>maximumPoolSize</tt> <
/td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>16</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10.2:</b> The core pool size for the ordered thread pool, if its in use. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>producerPoolEnabled</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10.4/Camel 2.11:</b> Producer only. Whether producer pool is enabled or not. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>producerPoolMaxActive</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-1</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10.3:</b> Producer only. Sets the cap on the number of objects that can be allocated by the pool (checked out to clients, or idle awaiting checkout) at a given time. Use a negative value for no limit. </td></tr><tr><td colspan="1" rowspan="1" class="c
onfluenceTd"> <tt>producerPoolMinIdle</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>0</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10.3:</b> Producer only. Sets the minimum number of instances allowed in the producer pool before the evictor thread (if active) spawns new objects. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>producerPoolMaxIdle</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>100</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10.3:</b> Producer only. Sets the cap on the number of "idle" instances in the pool. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>producerPoolMinEvictableIdle</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>30000</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10.3:</b> Producer only. Sets the minimum amount of time (value in millis) an object may sit idle in the pool befor
e it is eligible for eviction by the idle object evictor. </td></tr></tbody></table>
</div>
</div>
Modified: websites/production/camel/content/book-in-one-page.html
==============================================================================
--- websites/production/camel/content/book-in-one-page.html (original)
+++ websites/production/camel/content/book-in-one-page.html Tue Jun 4 15:22:11 2013
@@ -33515,7 +33515,7 @@ netty:tcp:<span class="code-comment">//l
<h3><a shape="rect" name="BookInOnePage-Options"></a>Options</h3>
<div class="confluenceTableSmall"><div class="table-wrap">
-<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"> Name </th><th colspan="1" rowspan="1" class="confluenceTh"> Default Value </th><th colspan="1" rowspan="1" class="confluenceTh"> Description </th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>keepAlive</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Setting to ensure socket is not closed due to inactivity </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>tcpNoDelay</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Setting to improve TCP protocol performance </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>backlog</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.9.6/2.10.4/2.11:</b> Allows to co
nfigure a backlog for netty consumer (server). Note the backlog is just a best effort depending on the OS. Setting this option to a value such as <tt>200</tt>, <tt>500</tt> or <tt>1000</tt>, tells the TCP stack how long the "accept" queue can be. If this option is not configured, then the backlog depends on OS setting. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>broadcast</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Setting to choose Multicast over UDP </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>connectTimeout</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>10000</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Time to wait for a socket connection to be available. Value is in millis. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>reuseAddress</tt> </td><td colspan="1" rowspan="1" class="confluence
Td"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Setting to facilitate socket multiplexing </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>sync</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Setting to set endpoint as one-way or request-response </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>synchronous</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10:</b> Whether <a shape="rect" href="asynchronous-routing-engine.html" title="Asynchronous Routing Engine">Asynchronous Routing Engine</a> is not in use. <tt>false</tt> then the <a shape="rect" href="asynchronous-routing-engine.html" title="Asynchronous Routing Engine">Asynchronous Routing Engine</a> is used, <tt>true</tt> to force processing synchronous. </td></tr><tr><td colspan="1" rowspa
n="1" class="confluenceTd"> <tt>ssl</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Setting to specify whether SSL encryption is applied to this endpoint </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>sendBufferSize</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>65536 bytes</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> The TCP/UDP buffer sizes to be used during outbound communication. Size is bytes. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>receiveBufferSize</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>65536 bytes</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> The TCP/UDP buffer sizes to be used during inbound communication. Size is bytes. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>option.XXX</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>null</
tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.11/2.10.4:</b> Allows to configure additional netty options using "option." as prefix. For example "option.child.keepAlive=false" to set the netty option "child.keepAlive=false". See the Netty documentation for possible options that can be used. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>corePoolSize</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>10</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> The number of allocated threads at component startup. Defaults to 10. <b>Note:</b> This option is removed from Camel 2.9.2 onwards. As we rely on Nettys default settings. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>maxPoolSize</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>100</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> The maximum number of threads that may be allocated to this endpoint. Defaults to 100.
<b>Note:</b> This option is removed from Camel 2.9.2 onwards. As we rely on Nettys default settings. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>disconnect</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Whether or not to disconnect(close) from Netty Channel right after use. Can be used for both consumer and producer. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>lazyChannelCreation</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Channels can be lazily created to avoid exceptions, if the remote server is not up and running when the Camel producer is started. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>transferExchange</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
Only used for TCP. You can transfer the exchange over the wire instead of just the body. The following fields are transferred: In body, Out body, fault body, In headers, Out headers, fault headers, exchange properties, exchange exception. This requires that the objects are serializable. Camel will exclude any non-serializable objects and log it at WARN level. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>disconnectOnNoReply</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> If sync is enabled then this option dictates NettyConsumer if it should disconnect where there is no reply to send back. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>noReplyLogLevel</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>WARN</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> If sync is enabled this option dictates NettyConsumer which logging level t
o use when logging a there is no reply to send back. Values are: <tt>FATAL, ERROR, INFO, DEBUG, OFF</tt>. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>allowDefaultCodec</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.4:</b> The netty component installs a default codec if both, encoder/deocder is null and textline is false. Setting allowDefaultCodec to false prevents the netty component from installing a default codec as the first element in the filter chain. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>textline</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.4:</b> Only used for TCP. If no codec is specified, you can use this flag to indicate a text line based codec; if not specified or the value is false, then Object Serialization is assumed over
TCP. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>delimiter</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>LINE</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.4:</b> The delimiter to use for the textline codec. Possible values are <tt>LINE</tt> and <tt>NULL</tt>. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>decoderMaxLineLength</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>1024</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.4:</b> The max line length to use for the textline codec. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>autoAppendDelimiter</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.4:</b> Whether or not to auto append missing end delimiter when sending using the textline codec. </td></tr><tr><td colspan="1" rowspan="1" class=
"confluenceTd"> <tt>encoding</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.4:</b> The encoding (a charset name) to use for the textline codec. If not provided, Camel will use the JVM default Charset. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>workerCount</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.9:</b> When netty works on nio mode, it uses default workerCount parameter from Netty, which is cpu_core_threads*2. User can use this operation to override the default workerCount from Netty </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>sslContextParametersRef</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.9:</b> Reference to a <tt>org.apache.camel.util.jsse
.SSLContextParameters</tt> in the <a shape="rect" href="registry.html" title="Registry">Registry</a>.  This reference overrides any configured SSLContextParameters at the component level.  See <a shape="rect" href="#BookInOnePage-UsingtheJSSEConfigurationUtility">Using the JSSE Configuration Utility</a>. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>receiveBufferSizePredictor</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.9:</b> Configures the buffer size predictor. See details at Jetty documentation and this <a shape="rect" class="external-link" href="http://lists.jboss.org/pipermail/netty-users/2010-January/001958.html" rel="nofollow">mail thread</a>. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>needClientAuth</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"><tt>false</tt> </td><td colspan="1" rowspan="1" class="confl
uenceTd"> <b>Camel 2.11:</b> Configures whether the server needs client authentication when using SSL. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>orderedThreadPoolExecutor</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10.2:</b> Whether to use ordered thread pool, to ensure events are processed orderly on the same channel. See details at the netty javadoc of <tt>org.jboss.netty.handler.execution.OrderedMemoryAwareThreadPoolExecutor</tt> for more details. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>maximumPoolSize</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>16</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10.2:</b> The core pool size for the ordered thread pool, if its in use. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>producerPoolEnabled</tt> </td><td colspan="1" row
span="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10.4/Camel 2.11:</b> Producer only. Whether producer pool is enabled or not. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>producerPoolMaxActive</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-1</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10.3:</b> Producer only. Sets the cap on the number of objects that can be allocated by the pool (checked out to clients, or idle awaiting checkout) at a given time. Use a negative value for no limit. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>producerPoolMinIdle</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>0</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10.3:</b> Producer only. Sets the minimum number of instances allowed in the producer pool before the evictor thread (if active) spawns new objects
. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>producerPoolMaxIdle</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>100</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10.3:</b> Producer only. Sets the cap on the number of "idle" instances in the pool. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>producerPoolMinEvictableIdle</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>30000</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10.3:</b> Producer only. Sets the minimum amount of time (value in millis) an object may sit idle in the pool before it is eligible for eviction by the idle object evictor. </td></tr></tbody></table>
+<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"> Name </th><th colspan="1" rowspan="1" class="confluenceTh"> Default Value </th><th colspan="1" rowspan="1" class="confluenceTh"> Description </th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>keepAlive</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Setting to ensure socket is not closed due to inactivity </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>tcpNoDelay</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Setting to improve TCP protocol performance </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>backlog</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.9.6/2.10.4/2.11:</b> Allows to co
nfigure a backlog for netty consumer (server). Note the backlog is just a best effort depending on the OS. Setting this option to a value such as <tt>200</tt>, <tt>500</tt> or <tt>1000</tt>, tells the TCP stack how long the "accept" queue can be. If this option is not configured, then the backlog depends on OS setting. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>broadcast</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Setting to choose Multicast over UDP </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>connectTimeout</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>10000</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Time to wait for a socket connection to be available. Value is in millis. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>reuseAddress</tt> </td><td colspan="1" rowspan="1" class="confluence
Td"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Setting to facilitate socket multiplexing </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>sync</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Setting to set endpoint as one-way or request-response </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>synchronous</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10:</b> Whether <a shape="rect" href="asynchronous-routing-engine.html" title="Asynchronous Routing Engine">Asynchronous Routing Engine</a> is not in use. <tt>false</tt> then the <a shape="rect" href="asynchronous-routing-engine.html" title="Asynchronous Routing Engine">Asynchronous Routing Engine</a> is used, <tt>true</tt> to force processing synchronous. </td></tr><tr><td colspan="1" rowspa
n="1" class="confluenceTd"> <tt>ssl</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Setting to specify whether SSL encryption is applied to this endpoint </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>sendBufferSize</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>65536 bytes</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> The TCP/UDP buffer sizes to be used during outbound communication. Size is bytes. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>receiveBufferSize</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>65536 bytes</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> The TCP/UDP buffer sizes to be used during inbound communication. Size is bytes. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>option.XXX</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>null</
tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.11/2.10.4:</b> Allows to configure additional netty options using "option." as prefix. For example "option.child.keepAlive=false" to set the netty option "child.keepAlive=false". See the Netty documentation for possible options that can be used. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>corePoolSize</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>10</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> The number of allocated threads at component startup. Defaults to 10. <b>Note:</b> This option is removed from Camel 2.9.2 onwards. As we rely on Nettys default settings. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>maxPoolSize</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>100</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> The maximum number of threads that may be allocated to this endpoint. Defaults to 100.
<b>Note:</b> This option is removed from Camel 2.9.2 onwards. As we rely on Nettys default settings. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>disconnect</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Whether or not to disconnect(close) from Netty Channel right after use. Can be used for both consumer and producer. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>lazyChannelCreation</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Channels can be lazily created to avoid exceptions, if the remote server is not up and running when the Camel producer is started. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>transferExchange</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
Only used for TCP. You can transfer the exchange over the wire instead of just the body. The following fields are transferred: In body, Out body, fault body, In headers, Out headers, fault headers, exchange properties, exchange exception. This requires that the objects are serializable. Camel will exclude any non-serializable objects and log it at WARN level. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>disconnectOnNoReply</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> If sync is enabled then this option dictates NettyConsumer if it should disconnect where there is no reply to send back. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>noReplyLogLevel</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>WARN</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> If sync is enabled this option dictates NettyConsumer which logging level t
o use when logging a there is no reply to send back. Values are: <tt>FATAL, ERROR, INFO, DEBUG, OFF</tt>. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>serverExceptionCaughtLogLevel</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>WARN</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.11.1:</b> If the server (NettyConsumer) catches an exception then its logged using this logging level. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>serverClosedChannelExceptionCaughtLogLevel</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>DEBUG</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.11.1:</b> If the server (NettyConsumer) catches an <tt>java.nio.channels.ClosedChannelException</tt> then its logged using this logging level. This is used to avoid logging the closed channel exceptions, as clients can disconnect abruptly and then cause a flod of closed exceptions in the N
etty server. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>allowDefaultCodec</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.4:</b> The netty component installs a default codec if both, encoder/deocder is null and textline is false. Setting allowDefaultCodec to false prevents the netty component from installing a default codec as the first element in the filter chain. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>textline</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.4:</b> Only used for TCP. If no codec is specified, you can use this flag to indicate a text line based codec; if not specified or the value is false, then Object Serialization is assumed over TCP. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>delimiter</tt> </td>
<td colspan="1" rowspan="1" class="confluenceTd"> <tt>LINE</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.4:</b> The delimiter to use for the textline codec. Possible values are <tt>LINE</tt> and <tt>NULL</tt>. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>decoderMaxLineLength</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>1024</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.4:</b> The max line length to use for the textline codec. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>autoAppendDelimiter</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.4:</b> Whether or not to auto append missing end delimiter when sending using the textline codec. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>encoding</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>
null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.4:</b> The encoding (a charset name) to use for the textline codec. If not provided, Camel will use the JVM default Charset. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>workerCount</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.9:</b> When netty works on nio mode, it uses default workerCount parameter from Netty, which is cpu_core_threads*2. User can use this operation to override the default workerCount from Netty </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>sslContextParametersRef</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.9:</b> Reference to a <tt>org.apache.camel.util.jsse.SSLContextParameters</tt> in the <a shape="rect" href="registry.html" title="Registry">Regis
try</a>.  This reference overrides any configured SSLContextParameters at the component level.  See <a shape="rect" href="#BookInOnePage-UsingtheJSSEConfigurationUtility">Using the JSSE Configuration Utility</a>. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>receiveBufferSizePredictor</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.9:</b> Configures the buffer size predictor. See details at Jetty documentation and this <a shape="rect" class="external-link" href="http://lists.jboss.org/pipermail/netty-users/2010-January/001958.html" rel="nofollow">mail thread</a>. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>requestTimeout</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>0</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.11.1:</b> Allows to use a timeout for the Netty producer when calling a rem
ote server. By default no timeout is in use. The value is in milli seconds, so eg <tt>30000</tt> is 30 seconds. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>needClientAuth</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"><tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.11:</b> Configures whether the server needs client authentication when using SSL. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>orderedThreadPoolExecutor</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10.2:</b> Whether to use ordered thread pool, to ensure events are processed orderly on the same channel. See details at the netty javadoc of <tt>org.jboss.netty.handler.execution.OrderedMemoryAwareThreadPoolExecutor</tt> for more details. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>maximumPoolSize</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>16</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10.2:</b> The core pool size for the ordered thread pool, if its in use. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>producerPoolEnabled</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10.4/Camel 2.11:</b> Producer only. Whether producer pool is enabled or not. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>producerPoolMaxActive</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-1</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10.3:</b> Producer only. Sets the cap on the number of objects that can be allocated by the pool (checked out to clients, or idle awaiting checkout) at a given time. Use a negative value for no limit. </td></tr><tr><td colspan="1" rowspan="1" class="confluenc
eTd"> <tt>producerPoolMinIdle</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>0</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10.3:</b> Producer only. Sets the minimum number of instances allowed in the producer pool before the evictor thread (if active) spawns new objects. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>producerPoolMaxIdle</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>100</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10.3:</b> Producer only. Sets the cap on the number of "idle" instances in the pool. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>producerPoolMinEvictableIdle</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>30000</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10.3:</b> Producer only. Sets the minimum amount of time (value in millis) an object may sit idle in the pool before it is
eligible for eviction by the idle object evictor. </td></tr></tbody></table>
</div>
</div>
Modified: websites/production/camel/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/camel/content/camel-2120-release.html
==============================================================================
--- websites/production/camel/content/camel-2120-release.html (original)
+++ websites/production/camel/content/camel-2120-release.html Tue Jun 4 15:22:11 2013
@@ -84,7 +84,7 @@
<p>Welcome to the 2.12.0 release which approx XXX issues resolved (new features, improvements and bug fixes such as...)</p>
-<ul><li><a shape="rect" href="endpoint-annotations.html" title="Endpoint Annotations">Endpoint Annotations</a> along with automatically created HTML documentation for the endpoint parameters; this makes it easier for component developers to add a few refactoring-safe annotations to their Endpoint or Consumer implementations and, (along with javadoc comments on the field or setter method), get nice user documentation on how to use the endpoint for free.</li><li><a shape="rect" href="componentconfiguration.html" title="ComponentConfiguration">ComponentConfiguration</a> API provides a handy API for tools developers to introspect on a Component to find all the possible parameters, their types and any extra annotations (like Bean Validation Annotations) to be able to create/edit endpoints or URI strings so that tools can generate nicer UIs for configuring endpoints than just letting folks edit Strings.</li><li><a shape="rect" href="endpointcompleter.html" title="EndpointCompleter
">EndpointCompleter</a> API provides a hook so that command line tools (like <a shape="rect" class="external-link" href="http://karaf.apache.org/manual/latest-2.3.x/users-guide/using-console.html">Karaf's shell</a>), IDEs and web tools can get (bash tab like) auto-completion on endpoint paths (such as file or directory names, message queue names, database table names) when creating or using new endpoints</li><li>Reduced stack-frames in use during routing, that also makes Camel's stack traces being logged much less verbose. This also allows people to easier debug the internals of Camel as less <tt>AsyncCallback</tt> callbacks are in use during routing.</li><li>Easy to use <a shape="rect" href="message-history.html" title="Message History">Message History</a> out of the box. And included message history as "route stack-trace" when exceptions logged by <a shape="rect" href="error-handler.html" title="Error Handler">Error Handler</a> to make it easier for end users to spot where
the exception occurred.</li><li><a shape="rect" href="spring-web-services.html" title="Spring Web Services">Spring Web Services</a> now supports setting/receiving SOAP headers more easily using a header on the Camel <a shape="rect" href="message.html" title="Message">Message</a>.</li><li>Evaluating <a shape="rect" href="groovy.html" title="Groovy">Groovy</a> expressions is faster as we cache the compiled scripts.</li><li>Added <tt>base64</tt> option to <a shape="rect" href="shiro-security.html" title="Shiro Security">Shiro Security</a> to allow transferring security token over <a shape="rect" href="jms.html" title="JMS">JMS</a> and other transports as base64 encoded representation.</li><li>Made it easier to use <a shape="rect" href="shiro-security.html" title="Shiro Security">Shiro Security</a> as the credentials can be provided in headers, when sending a message to a secured route.</li><li><a shape="rect" href="bindy.html" title="Bindy">Bindy</a> now supports enums.</li><l
i>Added new <a shape="rect" href="backlogdebugger.html" title="BacklogDebugger">BacklogDebugger</a> to perform live debugging of messages during routing. The <a shape="rect" href="backlogdebugger.html" title="BacklogDebugger">BacklogDebugger</a> has JMX API allows tooling to control the debugger.</li><li>While using the <a shape="rect" class="external-link" href="http://xircles.codehaus.org/projects/jackson" rel="nofollow">Jackson library</a> through the <a shape="rect" href="json.html" title="JSON">JSON</a> Dataformat there's now a <tt>jsonView</tt> attribute you could make use of directly inside the <a shape="rect" href="dsl.html" title="DSL">DSL</a> itself.</li><li><a shape="rect" href="smpp.html" title="SMPP">SMPP</a> now supports optional parameters in all commands where they are possible.</li><li><a shape="rect" href="jdbc.html" title="JDBC">JDBC</a> now supports named parameters.</li><li>Added timeout support for <a shape="rect" href="direct.html" title="Direct">Direc
t</a> producers to wait for consumer to become active.</li><li>Added <tt>stats</tt> action to <a shape="rect" href="controlbus.html" title="ControlBus">ControlBus</a> to easily get performance statics in a single XML message.</li></ul>
+<ul><li><a shape="rect" href="endpoint-annotations.html" title="Endpoint Annotations">Endpoint Annotations</a> along with automatically created HTML documentation for the endpoint parameters; this makes it easier for component developers to add a few refactoring-safe annotations to their Endpoint or Consumer implementations and, (along with javadoc comments on the field or setter method), get nice user documentation on how to use the endpoint for free.</li><li><a shape="rect" href="componentconfiguration.html" title="ComponentConfiguration">ComponentConfiguration</a> API provides a handy API for tools developers to introspect on a Component to find all the possible parameters, their types and any extra annotations (like Bean Validation Annotations) to be able to create/edit endpoints or URI strings so that tools can generate nicer UIs for configuring endpoints than just letting folks edit Strings.</li><li><a shape="rect" href="endpointcompleter.html" title="EndpointCompleter
">EndpointCompleter</a> API provides a hook so that command line tools (like <a shape="rect" class="external-link" href="http://karaf.apache.org/manual/latest-2.3.x/users-guide/using-console.html">Karaf's shell</a>), IDEs and web tools can get (bash tab like) auto-completion on endpoint paths (such as file or directory names, message queue names, database table names) when creating or using new endpoints</li><li>Reduced stack-frames in use during routing, that also makes Camel's stack traces being logged much less verbose. This also allows people to easier debug the internals of Camel as less <tt>AsyncCallback</tt> callbacks are in use during routing.</li><li>Easy to use <a shape="rect" href="message-history.html" title="Message History">Message History</a> out of the box. And included message history as "route stack-trace" when exceptions logged by <a shape="rect" href="error-handler.html" title="Error Handler">Error Handler</a> to make it easier for end users to spot where
the exception occurred.</li><li><a shape="rect" href="spring-web-services.html" title="Spring Web Services">Spring Web Services</a> now supports setting/receiving SOAP headers more easily using a header on the Camel <a shape="rect" href="message.html" title="Message">Message</a>.</li><li>Evaluating <a shape="rect" href="groovy.html" title="Groovy">Groovy</a> expressions is faster as we cache the compiled scripts.</li><li>Added <tt>base64</tt> option to <a shape="rect" href="shiro-security.html" title="Shiro Security">Shiro Security</a> to allow transferring security token over <a shape="rect" href="jms.html" title="JMS">JMS</a> and other transports as base64 encoded representation.</li><li>Made it easier to use <a shape="rect" href="shiro-security.html" title="Shiro Security">Shiro Security</a> as the credentials can be provided in headers, when sending a message to a secured route.</li><li><a shape="rect" href="bindy.html" title="Bindy">Bindy</a> now supports enums.</li><l
i>Added new <a shape="rect" href="backlogdebugger.html" title="BacklogDebugger">BacklogDebugger</a> to perform live debugging of messages during routing. The <a shape="rect" href="backlogdebugger.html" title="BacklogDebugger">BacklogDebugger</a> has JMX API allows tooling to control the debugger.</li><li>While using the <a shape="rect" class="external-link" href="http://xircles.codehaus.org/projects/jackson" rel="nofollow">Jackson library</a> through the <a shape="rect" href="json.html" title="JSON">JSON</a> Dataformat there's now a <tt>jsonView</tt> attribute you could make use of directly inside the <a shape="rect" href="dsl.html" title="DSL">DSL</a> itself.</li><li><a shape="rect" href="smpp.html" title="SMPP">SMPP</a> now supports optional parameters in all commands where they are possible.</li><li><a shape="rect" href="jdbc.html" title="JDBC">JDBC</a> now supports named parameters.</li><li>Added timeout support for <a shape="rect" href="direct.html" title="Direct">Direc
t</a> producers to wait for consumer to become active.</li><li>Added <tt>stats</tt> action to <a shape="rect" href="controlbus.html" title="ControlBus">ControlBus</a> to easily get performance statics in a single XML message.</li><li>Added support for request timeout on <a shape="rect" href="netty.html" title="Netty">Netty</a> producer, and to configure logging level on <a shape="rect" href="netty.html" title="Netty">Netty</a> consumer to be less noisy for ChannelClosedException which can flood the logs when client disconnects abruptly.</li></ul>
<h3><a shape="rect" name="Camel2.12.0Release-FixedIssues"></a>Fixed Issues</h3>