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 Wed Dec 16 14:22:06
2015
@@ -3719,11 +3719,11 @@ The tutorial has been designed in two pa
While not actual tutorials you might find working through the source of the
various <a shape="rect" href="examples.html">Examples</a> useful.</li></ul>
<h2 id="BookInOnePage-TutorialonSpringRemotingwithJMS">Tutorial on Spring
Remoting with JMS</h2><p> </p><div class="confluence-information-macro
confluence-information-macro-information"><p class="title">Thanks</p><span
class="aui-icon aui-icon-small aui-iconfont-info
confluence-information-macro-icon"></span><div
class="confluence-information-macro-body"><p>This tutorial was kindly donated
to Apache Camel by Martin Gilday.</p></div></div><h2
id="BookInOnePage-Preface">Preface</h2><p>This tutorial aims to guide the
reader through the stages of creating a project which uses Camel to facilitate
the routing of messages from a JMS queue to a <a shape="rect"
class="external-link" href="http://www.springramework.org"
rel="nofollow">Spring</a> service. The route works in a synchronous fashion
returning a response to the client.</p><p><style type="text/css">/*<![CDATA[*/
-div.rbtoc1449472819824 {padding: 0px;}
-div.rbtoc1449472819824 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1449472819824 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1450275594859 {padding: 0px;}
+div.rbtoc1450275594859 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1450275594859 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1449472819824">
+/*]]>*/</style></p><div class="toc-macro rbtoc1450275594859">
<ul class="toc-indentation"><li><a shape="rect"
href="#BookInOnePage-TutorialonSpringRemotingwithJMS">Tutorial on Spring
Remoting with JMS</a></li><li><a shape="rect"
href="#BookInOnePage-Preface">Preface</a></li><li><a shape="rect"
href="#BookInOnePage-Prerequisites">Prerequisites</a></li><li><a shape="rect"
href="#BookInOnePage-Distribution">Distribution</a></li><li><a shape="rect"
href="#BookInOnePage-About">About</a></li><li><a shape="rect"
href="#BookInOnePage-CreatetheCamelProject">Create the Camel Project</a>
<ul class="toc-indentation"><li><a shape="rect"
href="#BookInOnePage-UpdatethePOMwithDependencies">Update the POM with
Dependencies</a></li></ul>
</li><li><a shape="rect" href="#BookInOnePage-WritingtheServer">Writing the
Server</a>
@@ -5828,11 +5828,11 @@ So we completed the last piece in the pi
<p>This example has been removed from <strong>Camel 2.9</strong> onwards.
Apache Axis 1.4 is a very old and unsupported framework. We encourage users to
use <a shape="rect" href="cxf.html">CXF</a> instead of Axis.</p></div></div>
<style type="text/css">/*<![CDATA[*/
-div.rbtoc1449472821114 {padding: 0px;}
-div.rbtoc1449472821114 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1449472821114 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1450275596054 {padding: 0px;}
+div.rbtoc1450275596054 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1450275596054 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style><div class="toc-macro rbtoc1449472821114">
+/*]]>*/</style><div class="toc-macro rbtoc1450275596054">
<ul class="toc-indentation"><li><a shape="rect"
href="#BookInOnePage-TutorialusingAxis1.4withApacheCamel">Tutorial using Axis
1.4 with Apache Camel</a>
<ul class="toc-indentation"><li><a shape="rect"
href="#BookInOnePage-Prerequisites">Prerequisites</a></li><li><a shape="rect"
href="#BookInOnePage-Distribution">Distribution</a></li><li><a shape="rect"
href="#BookInOnePage-Introduction">Introduction</a></li><li><a shape="rect"
href="#BookInOnePage-SettinguptheprojecttorunAxis">Setting up the project to
run Axis</a>
<ul class="toc-indentation"><li><a shape="rect"
href="#BookInOnePage-Maven2">Maven 2</a></li><li><a shape="rect"
href="#BookInOnePage-wsdl">wsdl</a></li><li><a shape="rect"
href="#BookInOnePage-ConfiguringAxis">Configuring Axis</a></li><li><a
shape="rect" href="#BookInOnePage-RunningtheExample">Running the
Example</a></li></ul>
@@ -14261,23 +14261,25 @@ from("seda:a").throttle(3).tim
</div></div><h4 id="BookInOnePage-Camel2.8onwards">Camel 2.8 onwards</h4><p>In
Camel 2.8 onwards you must set the maximum period as an <a shape="rect"
href="expression.html">Expression</a> as shown below where we use a <a
shape="rect" href="constant.html">Constant</a> expression:</p><div class="code
panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="brush: xml; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[
<route>
- <from uri="seda:a"/>
- <!-- throttle 3 messages per 10 sec -->
- <throttle timePeriodMillis="10000">
- <constant>3</constant>
- <to uri="mock:result"/>
- </throttle>
+ <from uri="seda:a"/>
+ <!-- throttle 3 messages per 10 sec -->
+ <throttle timePeriodMillis="10000">
+ <constant>3</constant>
+ <to uri="log:result"/>
+ <to uri="mock:result"/>
+ </throttle>
</route>
]]></script>
</div></div><h3
id="BookInOnePage-Dynamicallychangingmaximumrequestsperperiod">Dynamically
changing maximum requests per period</h3><p><strong>Available as of Camel
2.8</strong> <br clear="none"> Since we use an <a shape="rect"
href="expression.html">Expression</a> you can adjust this value at runtime, for
example you can provide a header with the value. At runtime Camel evaluates the
expression and converts the result to a <code>java.lang.Long</code> type. In
the example below we use a header from the message to determine the maximum
requests per period. If the header is absent, then the <a shape="rect"
href="throttler.html">Throttler</a> uses the old value. So that allows you to
only provide a header if the value is to be changed:</p><div class="code panel
pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="brush: xml; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[
<route>
- <from uri="direct:expressionHeader"/>
- <throttle timePeriodMillis="500">
- <!-- use a header to determine how many messages to throttle per
0.5 sec -->
- <header>throttleValue</header>
- <to uri="mock:result"/>
- </throttle>
+ <from uri="direct:expressionHeader"/>
+ <throttle timePeriodMillis="500">
+ <!-- use a header to determine how many messages to throttle per 0.5
sec -->
+ <header>throttleValue</header>
+ <to uri="log:result"/>
+ <to uri="mock:result"/>
+ </throttle>
</route>
]]></script>
</div></div><h3 id="BookInOnePage-Asynchronousdelaying">Asynchronous
delaying</h3><p><strong>Available as of Camel 2.4</strong></p><p>You can let
the <a shape="rect" href="throttler.html">Throttler</a> use non blocking
asynchronous delaying, which means Camel will use a scheduler to schedule a
task to be executed in the future. The task will then continue routing. This
allows the caller thread to not block and be able to service other messages,
etc.</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeContent panelContent pdl">
@@ -16528,7 +16530,7 @@ AMQPConnectionDetails amqpConnection() {
<ul><li><a shape="rect" href="configuring-camel.html">Configuring
Camel</a></li><li><a shape="rect"
href="component.html">Component</a></li><li><a shape="rect"
href="endpoint.html">Endpoint</a></li><li><a shape="rect"
href="getting-started.html">Getting Started</a></li></ul> <h2
id="BookInOnePage-SQSComponent">SQS Component</h2><p><strong>Available as of
Camel 2.6</strong></p><p>The sqs component supports sending and receiving
messages to <a shape="rect" class="external-link"
href="http://aws.amazon.com/sqs" rel="nofollow">Amazon's SQS</a>
service.</p><div class="confluence-information-macro
confluence-information-macro-information"><p
class="title">Prerequisites</p><span class="aui-icon aui-icon-small
aui-iconfont-info confluence-information-macro-icon"></span><div
class="confluence-information-macro-body"><p>You must have a valid Amazon Web
Services developer account, and be signed up to use Amazon SQS. More
information are available at <a shape="rect" class="external-link" href="
http://aws.amazon.com/sqs" rel="nofollow">Amazon SQS</a>.</p></div></div><h3
id="BookInOnePage-URIFormat">URI Format</h3><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[aws-sqs://queue-name[?options]
]]></script>
-</div></div><p>The queue will be created if they don't already exists.<br
clear="none"> You can append query options to the URI in the following format,
?options=value&option2=value&...</p><h3
id="BookInOnePage-URIOptions">URI Options</h3><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p>Name</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Default Value</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Context</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>amazonSQSClient</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Shared</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Reference to a
<code>com.amazonaws.services.sqs.AmazonSQS</code> in the <a shape="rect"
href="registry.html">Registry</a>.<
/p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>accessKey</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>null</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Shared</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Amazon AWS Access Key</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>secretKey</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Shared</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Amazon AWS Secret Key</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>amazonSQSEndpoint</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Shared</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>The region with which the AWS-SQS client wants to work
with. Only works if Camel creates the
AWS-SQS client, i.e., if you explicitly set amazonSQSClient, then this setting
will have no effect. You would have to set it on the client you create
directly</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>attributeNames</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>null</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Consumer</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>A list of attributes to set in the
<code>com.amazonaws.services.sqs.model.ReceiveMessageRequest</code>.</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd">concurrentConsumers</td><td
colspan="1" rowspan="1" class="confluenceTd">1</td><td colspan="1" rowspan="1"
class="confluenceTd">Consumer</td><td colspan="1" rowspan="1"
class="confluenceTd">(<strong>as of 2.15.0</strong>) Allows you to use multiple
threads to poll the sqs queue to increase throughput</td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>defaultVis
ibilityTimeout</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>null</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Shared</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>The visibility timeout (in seconds) to set in the
<code>com.amazonaws.services.sqs.model.CreateQueueRequest</code>.</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>deleteAfterRead</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>true</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Consumer</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Delete message from SQS after
it has been read (and processed by the route)</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>deleteIfFiltered</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>true</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Consumer</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>
<strong>Camel 2.12.2,2.13.0</strong> Whether or not to send the DeleteMessage
to the SQS queue if an exchange fails to get through a filter. If 'false' and
exchange does not make it through a Camel filter upstream in the route, then
don't send DeleteMessage.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>maxMessagesPerPoll</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>null</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Consumer</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>The maximum number of messages which can be received in
one poll to set in the
<code>com.amazonaws.services.sqs.model.ReceiveMessageRequest</code>.</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>visibilityTimeout</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Shared</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The
duration (in seconds) that the received messages are hidden from subsequent
retrieve requests after being retrieved by a ReceiveMessage request to set in
the <code>com.amazonaws.services.sqs.model.SetQueueAttributesRequest</code>.
This only make sense if its different from
<code>defaultVisibilityTimeout</code>. It changes the queue visibility timeout
attribute permanently.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>messageVisibilityTimeout</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Consumer</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel 2.8:</strong> The duration
(in seconds) that the received messages are hidden from subsequent retrieve
requests after being retrieved by a ReceiveMessage request to set in the
<code>com.amazonaws.services.sqs.model.ReceiveMessageRequest</code>. It does
<strong>NOT</strong> change the queue visibility tim
eout attribute permanently.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>extendMessageVisibility</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Consumer</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel 2.10:</strong> If enabled
then a scheduled background task will keep extending the message visibility on
SQS. This is needed if it taks a long time to process the message. If set to
true <code>defaultVisibilityTimeout</code> must be set. See details at <a
shape="rect" class="external-link"
href="http://docs.amazonwebservices.com/AWSSimpleQueueService/latest/APIReference/Query_QueryChangeMessageVisibility.html"
rel="nofollow">Amazon docs</a>.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>maximumMessageSize</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>null</code></p></td><td colspan="1" rowspan="1"
class=
"confluenceTd"><p>Shared</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.8:</strong> The maximumMessageSize (in
bytes) an SQS message can contain for this queue, to set in the
<code>com.amazonaws.services.sqs.model.SetQueueAttributesRequest</code>.</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>messageRetentionPeriod</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Shared</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.8:</strong> The messageRetentionPeriod
(in seconds) a message will be retained by SQS for this queue, to set in the
<code>com.amazonaws.services.sqs.model.SetQueueAttributesRequest</code>.</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>policy</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Shar
ed</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><strong>Camel
2.8:</strong> The policy for this queue to set in the
<code>com.amazonaws.services.sqs.model.SetQueueAttributesRequest</code>.</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>delaySeconds</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Producer</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><strong>Camel 2.9.3:</strong>
Delay sending messages for a number of seconds.</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>waitTimeSeconds</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>0</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Producer</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><strong>Camel 2.11:</strong>
Duration in seconds (0 to 20) that the ReceiveMessage action call will wait
until a message is in the queue
to include in the response.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>receiveMessageWaitTimeSeconds</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>0</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Shared</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.11:</strong> If you do not specify
WaitTimeSeconds in the request, the queue attribute
ReceiveMessageWaitTimeSeconds is used to determine how long to
wait.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>queueOwnerAWSAccountId</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Shared</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.12:</strong> Specify the queue owner
aws account id when you need to connect the queue with different account
owner.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<p>region</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>null</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Shared</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.12.3:</strong> Specify the queue region
which could be used with <code>queueOwnerAWSAccountId</code> to build the
service URL.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>redrivePolicy</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><code>null</code></td><td colspan="1" rowspan="1"
class="confluenceTd">Shared</td><td colspan="1" rowspan="1"
class="confluenceTd"><strong>Camel 2.15</strong>: Specify the policy that send
message to DeadLetter queue. See detail at <a shape="rect"
class="external-link"
href="http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sqs-queues-redrivepolicy.html"
rel="nofollow">Amazon docs</a>.</td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>proxyHost</p></td>
<td colspan="1" rowspan="1" class="confluenceTd"><code>null</code></td><td
colspan="1" rowspan="1" class="confluenceTd">Shared</td><td colspan="1"
rowspan="1" class="confluenceTd"><strong>Camel 2.16</strong>: Specify a proxy
host to be used inside the client definition.</td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>proxyPort</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><code>null</code></td><td colspan="1"
rowspan="1" class="confluenceTd">Shared</td><td colspan="1" rowspan="1"
class="confluenceTd"><strong>Camel 2.16</strong>: Specify a proxy port to be
used inside the client definition.</td></tr></tbody></table></div><div
class="confluence-information-macro
confluence-information-macro-information"><p class="title">Required SQS
component options</p><span class="aui-icon aui-icon-small aui-iconfont-info
confluence-information-macro-icon"></span><div
class="confluence-information-macro-body"><p>You have to provide the
amazonSQSClient in the <a shape="rec
t" href="registry.html">Registry</a> or your accessKey and secretKey to access
the <a shape="rect" class="external-link" href="http://aws.amazon.com/sqs"
rel="nofollow">Amazon's SQS</a>.</p></div></div><h3
id="BookInOnePage-BatchConsumer">Batch Consumer</h3><p>This component
implements the <a shape="rect" href="batch-consumer.html">Batch
Consumer</a>.</p><p>This allows you for instance to know how many messages
exists in this batch and for instance let the <a shape="rect"
href="aggregator.html">Aggregator</a> aggregate this number of messages.</p><h3
id="BookInOnePage-Usage.2">Usage</h3><h4
id="BookInOnePage-MessageheaderssetbytheSQSproducer">Message headers set by the
SQS producer</h4><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><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><code>CamelAwsSqsMD5OfBody</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>String</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>The MD5 checksum of the Amazon
SQS message.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>CamelAwsSqsMessageId</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>String</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>The Amazon SQS message
ID.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>CamelAwsSqsDelaySeconds</code></p></td><td
colspan="1" rowspan="1"
class="confluenceTd"><p><code>Integer</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Since <strong>Camel 2.11</strong>, the
delay seconds that the Amazon SQS message can be see by
others.</p></td></tr></tbody></table></div><h4
id="BookInOnePage-MessageheaderssetbytheSQSconsumer">Message headers set by the
SQS consume
r</h4><div class="table-wrap"><table class="confluenceTable"><tbody><tr><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><code>CamelAwsSqsMD5OfBody</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>String</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>The MD5 checksum of the Amazon
SQS message.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>CamelAwsSqsMessageId</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>String</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>The Amazon SQS message
ID.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>CamelAwsSqsReceiptHandle</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code
>String</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>The
>Amazon SQS message receipt handle.</p></td></tr><tr><td colspan="1"
>rowspan="1"
>class="confluenceTd"><p><code>CamelAwsSqsAttributes</code></p></td><td
>colspan="1" rowspan="1" class="confluenceTd"><p><code>Map<String,
>String></code></p></td><td colspan="1" rowspan="1"
>class="confluenceTd"><p>The Amazon SQS message
>attributes.</p></td></tr></tbody></table></div><h4
>id="BookInOnePage-AdvancedAmazonSQSconfiguration">Advanced AmazonSQS
>configuration</h4><p>If your Camel Application is running behind a firewall
>or if you need to have more control over the AmazonSQS instance
>configuration, you can create your own instance:</p><div class="code panel
>pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+</div></div><p>The queue will be created if they don't already exists.<br
clear="none"> You can append query options to the URI in the following format,
?options=value&option2=value&...</p><h3
id="BookInOnePage-URIOptions">URI Options</h3><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p>Name</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Default Value</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Context</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>amazonSQSClient</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Shared</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Reference to a
<code>com.amazonaws.services.sqs.AmazonSQS</code> in the <a shape="rect"
href="registry.html">Registry</a>.<
/p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>accessKey</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>null</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Shared</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Amazon AWS Access Key</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>secretKey</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Shared</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Amazon AWS Secret Key</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>amazonSQSEndpoint</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Shared</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>The region with which the AWS-SQS client wants to work
with. Only works if Camel creates the
AWS-SQS client, i.e., if you explicitly set amazonSQSClient, then this setting
will have no effect. You would have to set it on the client you create
directly</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>attributeNames</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>null</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Consumer</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>A list of attributes to set in the
<code>com.amazonaws.services.sqs.model.ReceiveMessageRequest</code>.</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>concurrentConsumers</p></td><td colspan="1" rowspan="1"
class="confluenceTd">1</td><td colspan="1" rowspan="1"
class="confluenceTd">Consumer</td><td colspan="1" rowspan="1"
class="confluenceTd">(<strong>as of 2.15.0</strong>) Allows you to use multiple
threads to poll the sqs queue to increase throughput</td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>def
aultVisibilityTimeout</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>null</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Shared</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>The visibility timeout (in seconds) to set in the
<code>com.amazonaws.services.sqs.model.CreateQueueRequest</code>.</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>deleteAfterRead</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>true</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Consumer</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Delete message from SQS after
it has been read (and processed by the route)</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>deleteIfFiltered</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>true</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Consumer</p></td><td colspan="1"
rowspan="1" class="confluence
Td"><p><strong>Camel 2.12.2,2.13.0</strong> Whether or not to send the
DeleteMessage to the SQS queue if an exchange fails to get through a filter. If
'false' and exchange does not make it through a Camel filter upstream in the
route, then don't send DeleteMessage.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>maxMessagesPerPoll</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Consumer</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The maximum number of messages which can be
received in one poll to set in the
<code>com.amazonaws.services.sqs.model.ReceiveMessageRequest</code>.</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>visibilityTimeout</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Shared</p></td><td colspan="1"
rowspan="1" class="confluenceTd"
><p>The duration (in seconds) that the received messages are hidden from
>subsequent retrieve requests after being retrieved by a ReceiveMessage
>request. This only make sense if its different from
><code>defaultVisibilityTimeout</code>.</p></td></tr><tr><td colspan="1"
>rowspan="1" class="confluenceTd"><p>extendMessageVisibility</p></td><td
>colspan="1" rowspan="1"
>class="confluenceTd"><p><code>false</code></p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p>Consumer</p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p><strong>Camel 2.10:</strong> If enabled a
>scheduled background task will keep extending the message visibility on SQS.
>This is needed if it takes a long time to process the message. If set to
>true<code> visibilityTimeout</code> must be set. See details at <a
>shape="rect" class="external-link"
>href="http://docs.amazonwebservices.com/AWSSimpleQueueService/latest/APIReference/Query_QueryChangeMessageVisibility.html"
> rel="nofollow">Amazon docs</a>.</p></td></tr
><tr><td colspan="1" rowspan="1"
>class="confluenceTd"><p>maximumMessageSize</p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p>Shared</p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p><strong>Camel 2.8:</strong> The
>maximumMessageSize (in bytes) an SQS message can contain for this queue, to
>set in the
><code>com.amazonaws.services.sqs.model.SetQueueAttributesRequest</code>.</p></td></tr><tr><td
> colspan="1" rowspan="1"
>class="confluenceTd"><p>messageRetentionPeriod</p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p>Shared</p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p><strong>Camel 2.8:</strong> The
>messageRetentionPeriod (in seconds) a message will be retained by SQS for
>this queue, to set in the
><code>com.amazonaws.services.sqs.model.SetQueueAttributesRequest</code>.</p></td></tr><tr><td
> c
olspan="1" rowspan="1" class="confluenceTd"><p>policy</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Shared</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.8:</strong> The policy for this queue
to set in the
<code>com.amazonaws.services.sqs.model.SetQueueAttributesRequest</code>.</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>delaySeconds</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Producer</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><strong>Camel 2.9.3:</strong>
Delay sending messages for a number of seconds.</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>waitTimeSeconds</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>0</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Producer</
p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><strong>Camel
2.11:</strong> Duration in seconds (0 to 20) that the ReceiveMessage action
call will wait until a message is in the queue to include in the
response.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>receiveMessageWaitTimeSeconds</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>0</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Shared</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.11:</strong> If you do not specify
WaitTimeSeconds in the request, the queue attribute
ReceiveMessageWaitTimeSeconds is used to determine how long to
wait.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>queueOwnerAWSAccountId</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Shared</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><st
rong>Camel 2.12:</strong> Specify the queue owner aws account id when you need
to connect the queue with different account owner.</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>region</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Shared</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.12.3:</strong> Specify the queue region
which could be used with <code>queueOwnerAWSAccountId</code> to build the
service URL.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>redrivePolicy</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><code>null</code></td><td colspan="1" rowspan="1"
class="confluenceTd">Shared</td><td colspan="1" rowspan="1"
class="confluenceTd"><strong>Camel 2.15</strong>: Specify the policy that send
message to DeadLetter queue. See detail at <a shape="rect"
class="external-link" href="http://docs.aws.amazon.com/
AWSCloudFormation/latest/UserGuide/aws-properties-sqs-queues-redrivepolicy.html"
rel="nofollow">Amazon docs</a>.</td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>proxyHost</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><code>null</code></td><td colspan="1" rowspan="1"
class="confluenceTd">Shared</td><td colspan="1" rowspan="1"
class="confluenceTd"><strong>Camel 2.16</strong>: Specify a proxy host to be
used inside the client definition.</td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>proxyPort</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><code>null</code></td><td colspan="1" rowspan="1"
class="confluenceTd">Shared</td><td colspan="1" rowspan="1"
class="confluenceTd"><strong>Camel 2.16</strong>: Specify a proxy port to be
used inside the client definition.</td></tr></tbody></table></div><div
class="confluence-information-macro
confluence-information-macro-information"><p class="title">Required SQS
component options</p><span class
="aui-icon aui-icon-small aui-iconfont-info
confluence-information-macro-icon"></span><div
class="confluence-information-macro-body"><p>You have to provide the
amazonSQSClient in the <a shape="rect" href="registry.html">Registry</a> or
your accessKey and secretKey to access the <a shape="rect"
class="external-link" href="http://aws.amazon.com/sqs" rel="nofollow">Amazon's
SQS</a>.</p></div></div><h3 id="BookInOnePage-BatchConsumer">Batch
Consumer</h3><p>This component implements the <a shape="rect"
href="batch-consumer.html">Batch Consumer</a>.</p><p>This allows you for
instance to know how many messages exists in this batch and for instance let
the <a shape="rect" href="aggregator.html">Aggregator</a> aggregate this number
of messages.</p><h3 id="BookInOnePage-Usage.2">Usage</h3><h4
id="BookInOnePage-MessageheaderssetbytheSQSproducer">Message headers set by the
SQS producer</h4><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confl
uenceTh"><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><code>CamelAwsSqsMD5OfBody</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>String</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>The MD5 checksum of the Amazon
SQS message.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>CamelAwsSqsMessageId</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>String</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>The Amazon SQS message
ID.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>CamelAwsSqsDelaySeconds</code></p></td><td
colspan="1" rowspan="1"
class="confluenceTd"><p><code>Integer</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Since <strong>Camel 2.11</strong>, th
e delay seconds that the Amazon SQS message can be see by
others.</p></td></tr></tbody></table></div><h4
id="BookInOnePage-MessageheaderssetbytheSQSconsumer">Message headers set by the
SQS consumer</h4><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><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><code>CamelAwsSqsMD5OfBody</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>String</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>The MD5 checksum of the Amazon
SQS message.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>CamelAwsSqsMessageId</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>String</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>The
Amazon SQS message ID.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>CamelAwsSqsReceiptHandle</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>String</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>The Amazon SQS message receipt
handle.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>CamelAwsSqsAttributes</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>Map<String,
String></code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>The Amazon SQS message
attributes.</p></td></tr></tbody></table></div><h4
id="BookInOnePage-AdvancedAmazonSQSconfiguration">Advanced AmazonSQS
configuration</h4><p>If your Camel Application is running behind a firewall or
if you need to have more control over the AmazonSQS instance configuration, you
can create your own instance:</p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelConte
nt pdl">
<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[AWSCredentials awsCredentials = new
BasicAWSCredentials("myAccessKey", "mySecretKey");
ClientConfiguration clientConfiguration = new ClientConfiguration();
@@ -17370,11 +17372,11 @@ template.send("direct:alias-verify&
]]></script>
</div></div><p></p><h3 id="BookInOnePage-SeeAlso.28">See Also</h3>
<ul><li><a shape="rect" href="configuring-camel.html">Configuring
Camel</a></li><li><a shape="rect"
href="component.html">Component</a></li><li><a shape="rect"
href="endpoint.html">Endpoint</a></li><li><a shape="rect"
href="getting-started.html">Getting Started</a></li></ul><ul><li><a
shape="rect" href="crypto.html">Crypto</a> Crypto is also available as a <a
shape="rect" href="data-format.html">Data Format</a></li></ul> <h2
id="BookInOnePage-CXFComponent">CXF Component</h2><div
class="confluence-information-macro confluence-information-macro-note"><span
class="aui-icon aui-icon-small aui-iconfont-warning
confluence-information-macro-icon"></span><div
class="confluence-information-macro-body"><p>When using CXF as a consumer, the
<a shape="rect" href="cxf-bean-component.html">CXF Bean Component</a> allows
you to factor out how message payloads are received from their processing as a
RESTful or SOAP web service. This has the potential of using a multitude of
transports to consume web
services. The bean component's configuration is also simpler and provides the
fastest method to implement web services using Camel and
CXF.</p></div></div><div class="confluence-information-macro
confluence-information-macro-tip"><span class="aui-icon aui-icon-small
aui-iconfont-approve confluence-information-macro-icon"></span><div
class="confluence-information-macro-body"><p>When using CXF in streaming modes
(see DataFormat option), then also read about <a shape="rect"
href="stream-caching.html">Stream caching</a>.</p></div></div><p>The
<strong>cxf:</strong> component provides integration with <a shape="rect"
href="http://cxf.apache.org">Apache CXF</a> for connecting to JAX-WS services
hosted in CXF.</p><p><style type="text/css">/*<![CDATA[*/
-div.rbtoc1449472873437 {padding: 0px;}
-div.rbtoc1449472873437 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1449472873437 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1450275618556 {padding: 0px;}
+div.rbtoc1450275618556 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1450275618556 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1449472873437">
+/*]]>*/</style></p><div class="toc-macro rbtoc1450275618556">
<ul class="toc-indentation"><li><a shape="rect"
href="#BookInOnePage-CXFComponent">CXF Component</a>
<ul class="toc-indentation"><li><a shape="rect"
href="#BookInOnePage-URIformat">URI format</a></li><li><a shape="rect"
href="#BookInOnePage-Options">Options</a>
<ul class="toc-indentation"><li><a shape="rect"
href="#BookInOnePage-Thedescriptionsofthedataformats">The descriptions of the
dataformats</a>
@@ -24705,7 +24707,9 @@ greeting=Bye
<!-- blueprint property placeholders, that will use etc/stuff.cfg as the
properties file -->
<cm:property-placeholder persistent-id="stuff"
update-strategy="reload">
<cm:default-properties>
- <cm:property name="destination"
value="to-be-replaced" />
+ <cm:property name="greeting" value="Hello" />
+ <cm:property name="echo" value="Hey" />
+ <cm:property name="destination"
value="mock:original" />
</cm:default-properties>
</cm:property-placeholder>
@@ -24732,8 +24736,8 @@ greeting=Bye
</div></div>And in the unit test class we do as follows:<div class="code panel
pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[
/**
- * This example will load a Blueprint .cfdg file, and also override its
property placeholders from this unit test
- * source code directly.
+ * This example will load a Blueprint .cfg file (which will initialize
configadmin), and also override its property
+ * placeholders from this unit test source code directly (the change will
reload blueprint container).
*/
public class ConfigAdminLoadConfigurationFileAndOverrideTest extends
CamelBlueprintTestSupport {
@@ -24760,7 +24764,11 @@ public class ConfigAdminLoadConfiguratio
@Test
public void testConfigAdmin() throws Exception {
- // regular unit test method
+ // mock:original comes from
<cm:default-properties>/<cm:property name="destination"
value="mock:original" />
+ getMockEndpoint("mock:original").setExpectedMessageCount(0);
+ // mock:result comes from loadConfigAdminConfigurationFile()
+ getMockEndpoint("mock:result").setExpectedMessageCount(0);
+ // mock:extra comes from useOverridePropertiesWithConfigAdmin()
getMockEndpoint("mock:extra").expectedBodiesReceived("Bye
World", "Yay Bye WorldYay Bye World");
template.sendBody("direct:start", "World");
Modified: websites/production/camel/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/camel/content/camel-2170-release.html
==============================================================================
--- websites/production/camel/content/camel-2170-release.html (original)
+++ websites/production/camel/content/camel-2170-release.html Wed Dec 16
14:22:06 2015
@@ -85,7 +85,7 @@
<tbody>
<tr>
<td valign="top" width="100%">
-<div class="wiki-content maincontent"><h1
id="Camel2.17.0Release-Camel2.17.0release(currentlyinprogress)">Camel 2.17.0
release (currently in progress)</h1><div
style="padding-right:20px;float:left;margin-left:-20px;"><p><span
class="confluence-embedded-file-wrapper"><img class="confluence-embedded-image
confluence-external-resource"
src="http://camel.apache.org/download.data/camel-box-v1.0-150x200.png"
data-image-src="http://camel.apache.org/download.data/camel-box-v1.0-150x200.png"></span></p></div><div
style="min-height:200px"> </div><h2
id="Camel2.17.0Release-NewandNoteworthy">New and Noteworthy</h2><p>Welcome to
the x.y.z release which approx XXX issues resolved (new features, improvements
and bug fixes such as...)</p><ul><li>highlighted issue fixed</li><li>Upgraded
camel-hbase to Hadoop 2.x and HBase 1.1.x</li><li><a shape="rect"
href="tools.html">Camel commands</a> for <a shape="rect"
href="spring-boot.html">Spring Boot</a></li><li>Many improvements
to Camel
0;<a shape="rect" href="kura.html">Kura</a></li><li>Added transacted option
to <a shape="rect" href="sql-component.html">SQL Component</a> when used
as a consumer in a transacted route.</li><li>Added support for UPDATE operation
to <a shape="rect"
href="elasticsearch.html">ElasticSearch</a>.</li><li>Allow to reuse existing
configured Elasticsearch Client on the <a shape="rect"
href="elasticsearch.html">ElasticSearch</a> component, instead of creating a
client per endpoint. </li><li>The <code>include</code>
and <code>exclude</code> options on <a shape="rect"
href="file2.html">File2</a> and <a shape="rect" href="ftp.html">FTP</a>
endpoints is now case in-sensitive out of the box.</li><li>Resource based
component such as <a shape="rect" href="xslt.html">XSLT</a>, <a
shape="rect" href="velocity.html">Velocity</a> etc can load the resource
file from the <a shape="rect" href="registry.html">Registry</a> by
using <code>ref:</
code> as prefix.</li><li><span>Upgraded camel-amqp to the latest
qpid-jms-client (also AMQP < 1.0 is not supported
anymore).</span></li><li><span>Many improvements to Camel <a shape="rect"
href="amqp.html">AMQP</a> component.</span></li><li><span>The <a
shape="rect" href="metrics-component.html">Metrics Component</a> allows to
capture <a shape="rect" href="message-history.html">Message History</a>
performance statistics with
the <code>MetricsMessageHistoryFactory </code></span></li><li>Reduced
the number of mbeans enlisted in the services tree, to only include mbeans that
has value to be managed.</li><li>The <a shape="rect"
href="elasticsearch.html">Elasticsearch Component</a> now supports
MultiGet operation</li><li>The <a shape="rect"
href="throttler.html">Throttler</a> has been improved to be more performant and
use a rolling window for time periods which gives a better
flow.</li><li>The <code>setHeader</code> and <code>setExchangePr
operty</code> allows to use a dynamic header key using the <a
shape="rect" href="simple.html">Simple</a> language if the name of the key
is a <a shape="rect" href="simple.html">Simple</a> language
expression.</li></ul><p>Fixed these issues</p><ul><li>The <a shape="rect"
href="swagger-java.html">Swagger Java</a> now parses nested types in the POJO
model that has been annotated with the swagger api annotations to use in the
schema api model</li><li>Fixed <a shape="rect" href="rest-dsl.html">Rest
DSL</a> with apiContextPath fail to start if there are 2 ore more rest's
in use.</li><li>Paho component name is not limited to 4 characters
anymore.</li><li>Fixed <a shape="rect" href="spring-boot.html">Spring
Boot</a> not starting Camel routes if running in Spring Cloud.</li><li>Fixed an
issue with <a shape="rect" href="swagger-java.html">Swagger Java</a> using
api-docs could lead to api-doc route being added multiple times</li></ul><h3
id="Camel2.
17.0Release-New">New <a shape="rect"
href="enterprise-integration-patterns.html">Enterprise Integration
Patterns</a></h3><h3 id="Camel2.17.0Release-New.1">New <a shape="rect"
href="components.html">Components</a></h3><ul><li>camel-kubernetes - Integrates
Camel with Kubernetes</li><li>camel-aws - AWS kineses streams component
added</li></ul><h3 id="Camel2.17.0Release-NewDSL">New DSL</h3><h3
id="Camel2.17.0Release-NewAnnotations">New Annotations</h3><h3
id="Camel2.17.0Release-NewDataFormats">New <a shape="rect"
href="data-format.html">Data Formats</a></h3><ul><li><a shape="rect"
href="mime-multipart.html">MIME-Multipart</a> - mime based data
format.</li></ul><h3 id="Camel2.17.0Release-New.2">New <a shape="rect"
href="languages.html">Languages</a></h3><h3 id="Camel2.17.0Release-New.3">New
<a shape="rect"
href="examples.html">Examples</a></h3><ul><li>camel-example-spring-boot-metrics
- showing a Camel spring-boot application that report metrics to Graphite.
Requires Graphite running on
your network.</li></ul><h3 id="Camel2.17.0Release-New.4">New <a shape="rect"
href="tutorials.html">Tutorials</a></h3><h2
id="Camel2.17.0Release-APIbreaking">API breaking</h2><h2
id="Camel2.17.0Release-KnownIssues">Known Issues</h2><h2
id="Camel2.17.0Release-Dependencyupgrades">Dependency
upgrades</h2><ul><li>EHCache from 2.10.0 to 2.10.1</li><li>Mvel from
2.2.6.Final to 2.2.7.Final</li><li>Spring 4.1.x to 4.2.x</li><li>Spring-Boot
1.2.x to 1.3.x</li><li>Spring Integration 2.x to 4.x</li><li>slf4j-api 1.6.x to
1.7.x</li></ul><h2
id="Camel2.17.0Release-Importantchangestoconsiderwhenupgrading">Important
changes to consider when upgrading</h2><ul><li>Removed camel-hbase as Karaf
feature as it did not really work well in OSGi</li><li>camel-infinispan
requires Java 8.</li><li>Support for Spring 4.0.x is deprecated.</li><li>Moved
some Camel tooling related dependencies (such as maven/plexus) from the Camel
Parent BOM to the tooling BOM (to have them separated).</li><li>camel-amqp do
not su
pport 0.9 anymore. </li><li>camel-spring-integration feature has been
removed from the Camel karaf.</li></ul><h2
id="Camel2.17.0Release-GettingtheDistributions">Getting the
Distributions</h2><h3 id="Camel2.17.0Release-BinaryDistributions">Binary
Distributions</h3><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Download Link</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>PGP Signature file of download</p></th></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>Windows
Distribution</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a
shape="rect" class="external-link"
href="http://www.apache.org/dyn/closer.cgi/camel/apache-camel/x.y.x/apache-camel-x.y.x.zip">apache-camel-x.y.x.zip</a></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect"
class="external-link" href="http://www.apache.org/
dist/camel/apache-camel/x.y.x/apache-camel-x.y.x.zip.asc">apache-camel-x.y.x.zip.asc</a></p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>Unix/Linux/Cygwin
Distribution</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a
shape="rect" class="external-link"
href="http://www.apache.org/dyn/closer.cgi/camel/apache-camel/x.y.x/apache-camel-x.y.x.tar.gz">apache-camel-x.y.x.tar.gz</a></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect"
class="external-link"
href="http://www.apache.org/dist/camel/apache-camel/x.y.x/apache-camel-x.y.x.tar.gz.asc">apache-camel-x.y.x.tar.gz.asc</a></p></td></tr></tbody></table></div><div
class="confluence-information-macro
confluence-information-macro-information"><p class="title">The above URLs use
redirection</p><span class="aui-icon aui-icon-small aui-iconfont-info
confluence-information-macro-icon"></span><div
class="confluence-information-macro-body"><p>The above URLs use the Apache
Mirror system to r
edirect you to a suitable mirror for your download. Some users have
experienced issues with some versions of browsers (e.g. some Safari browsers).
If the download doesn't seem to work for you from the above URL then try using
<a shape="rect" class="external-link"
href="http://www.mozilla.com/en-US/firefox/"
rel="nofollow">FireFox</a></p></div></div><h3
id="Camel2.17.0Release-SourceDistributions">Source Distributions</h3><div
class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1"
rowspan="1" class="confluenceTh"><p>Description</p></th><th colspan="1"
rowspan="1" class="confluenceTh"><p>Download Link</p></th><th colspan="1"
rowspan="1" class="confluenceTh"><p>PGP Signature file of
download</p></th></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>Source for Windows</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><a shape="rect" class="external-link"
href="http://www.apache.org/dyn/closer.cgi/camel/apache-camel/x.y.x/apache-camel-x.y.x-src.z
ip">apache-camel-x.y.x-src.zip</a></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><a shape="rect" class="external-link"
href="http://www.apache.org/dist/camel/apache-camel/x.y.x/apache-camel-x.y.x-src.zip.asc">apache-camel-x.y.x-src.zip.asc</a></p></td></tr></tbody></table></div><div
class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>Source for Unix/Linux/Cygwin</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect"
class="external-link"
href="http://www.apache.org/dyn/closer.cgi/camel/apache-camel/x.y.x/apache-camel-x.y.x-src.tar.gz">apache-camel-x.y.x-src.tar.gz</a></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect"
class="external-link"
href="http://www.apache.org/dist/camel/apache-camel/x.y.x/apache-camel-x.y.x-src.tar.gz.asc">apache-camel-x.y.x-src.tar.gz.asc</a></p></td></tr></tbody></table></div><h3
id="Camel2.17.0Release-GettingtheBinariesusingMaven2">Gett
ing the Binaries using Maven 2</h3><p>To use this release in your maven
project, the proper dependency configuration that you should use in your <a
shape="rect" class="external-link"
href="http://maven.apache.org/guides/introduction/introduction-to-the-pom.html">Maven
POM</a> is:</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeContent panelContent pdl">
+<div class="wiki-content maincontent"><h1
id="Camel2.17.0Release-Camel2.17.0release(currentlyinprogress)">Camel 2.17.0
release (currently in progress)</h1><div
style="padding-right:20px;float:left;margin-left:-20px;"><p><span
class="confluence-embedded-file-wrapper"><img class="confluence-embedded-image
confluence-external-resource"
src="http://camel.apache.org/download.data/camel-box-v1.0-150x200.png"
data-image-src="http://camel.apache.org/download.data/camel-box-v1.0-150x200.png"></span></p></div><div
style="min-height:200px"> </div><h2
id="Camel2.17.0Release-NewandNoteworthy">New and Noteworthy</h2><p>Welcome to
the x.y.z release which approx XXX issues resolved (new features, improvements
and bug fixes such as...)</p><ul><li>highlighted issue fixed</li><li>Upgraded
camel-hbase to Hadoop 2.x and HBase 1.1.x</li><li><a shape="rect"
href="tools.html">Camel commands</a> for <a shape="rect"
href="spring-boot.html">Spring Boot</a></li><li>Many improvements
to Camel
0;<a shape="rect" href="kura.html">Kura</a></li><li>Added transacted option
to <a shape="rect" href="sql-component.html">SQL Component</a> when used
as a consumer in a transacted route.</li><li>Added support for UPDATE operation
to <a shape="rect"
href="elasticsearch.html">ElasticSearch</a>.</li><li>Allow to reuse existing
configured Elasticsearch Client on the <a shape="rect"
href="elasticsearch.html">ElasticSearch</a> component, instead of creating a
client per endpoint. </li><li>The <code>include</code>
and <code>exclude</code> options on <a shape="rect"
href="file2.html">File2</a> and <a shape="rect" href="ftp.html">FTP</a>
endpoints is now case in-sensitive out of the box.</li><li>Resource based
component such as <a shape="rect" href="xslt.html">XSLT</a>, <a
shape="rect" href="velocity.html">Velocity</a> etc can load the resource
file from the <a shape="rect" href="registry.html">Registry</a> by
using <code>ref:</
code> as prefix.</li><li><span>Upgraded camel-amqp to the latest
qpid-jms-client (also AMQP < 1.0 is not supported
anymore).</span></li><li><span>Many improvements to Camel <a shape="rect"
href="amqp.html">AMQP</a> component.</span></li><li><span>The <a
shape="rect" href="metrics-component.html">Metrics Component</a> allows to
capture <a shape="rect" href="message-history.html">Message History</a>
performance statistics with
the <code>MetricsMessageHistoryFactory </code></span></li><li>Reduced
the number of mbeans enlisted in the services tree, to only include mbeans that
has value to be managed.</li><li>The <a shape="rect"
href="elasticsearch.html">Elasticsearch Component</a> now supports
MultiGet operation</li><li>The <a shape="rect"
href="throttler.html">Throttler</a> has been improved to be more performant and
use a rolling window for time periods which gives a better
flow.</li><li>The <code>setHeader</code> and <code>setExchangePr
operty</code> allows to use a dynamic header key using the <a
shape="rect" href="simple.html">Simple</a> language if the name of the key
is a <a shape="rect" href="simple.html">Simple</a> language
expression.</li></ul><p>Fixed these issues</p><ul><li>The <a shape="rect"
href="swagger-java.html">Swagger Java</a> now parses nested types in the POJO
model that has been annotated with the swagger api annotations to use in the
schema api model</li><li>Fixed <a shape="rect" href="rest-dsl.html">Rest
DSL</a> with apiContextPath fail to start if there are 2 ore more rest's
in use.</li><li>Paho component name is not limited to 4 characters
anymore.</li><li>Fixed <a shape="rect" href="spring-boot.html">Spring
Boot</a> not starting Camel routes if running in Spring Cloud.</li><li>Fixed an
issue with <a shape="rect" href="swagger-java.html">Swagger Java</a> using
api-docs could lead to api-doc route being added multiple times</li></ul><h3
id="Camel2.
17.0Release-New">New <a shape="rect"
href="enterprise-integration-patterns.html">Enterprise Integration
Patterns</a></h3><h3 id="Camel2.17.0Release-New.1">New <a shape="rect"
href="components.html">Components</a></h3><ul><li>camel-kubernetes - Integrates
Camel with Kubernetes</li><li>camel-aws - AWS kineses streams component
added</li><li>camel-aws - DynamoDB streams component added</li></ul><h3
id="Camel2.17.0Release-NewDSL">New DSL</h3><h3
id="Camel2.17.0Release-NewAnnotations">New Annotations</h3><h3
id="Camel2.17.0Release-NewDataFormats">New <a shape="rect"
href="data-format.html">Data Formats</a></h3><ul><li><a shape="rect"
href="mime-multipart.html">MIME-Multipart</a> - mime based data
format.</li></ul><h3 id="Camel2.17.0Release-New.2">New <a shape="rect"
href="languages.html">Languages</a></h3><h3 id="Camel2.17.0Release-New.3">New
<a shape="rect"
href="examples.html">Examples</a></h3><ul><li>camel-example-spring-boot-metrics
- showing a Camel spring-boot application that repo
rt metrics to Graphite. Requires Graphite running on your
network.</li></ul><h3 id="Camel2.17.0Release-New.4">New <a shape="rect"
href="tutorials.html">Tutorials</a></h3><h2
id="Camel2.17.0Release-APIbreaking">API breaking</h2><h2
id="Camel2.17.0Release-KnownIssues">Known Issues</h2><h2
id="Camel2.17.0Release-Dependencyupgrades">Dependency
upgrades</h2><ul><li>EHCache from 2.10.0 to 2.10.1</li><li>Mvel from
2.2.6.Final to 2.2.7.Final</li><li>Spring 4.1.x to 4.2.x</li><li>Spring-Boot
1.2.x to 1.3.x</li><li>Spring Integration 2.x to 4.x</li><li>slf4j-api 1.6.x to
1.7.x</li></ul><h2
id="Camel2.17.0Release-Importantchangestoconsiderwhenupgrading">Important
changes to consider when upgrading</h2><ul><li>Removed camel-hbase as Karaf
feature as it did not really work well in OSGi</li><li>camel-infinispan
requires Java 8.</li><li>Support for Spring 4.0.x is deprecated.</li><li>Moved
some Camel tooling related dependencies (such as maven/plexus) from the Camel
Parent BOM to the tooling BOM (
to have them separated).</li><li>camel-amqp do not support 0.9
anymore. </li><li>camel-spring-integration feature has been removed from
the Camel karaf.</li></ul><h2
id="Camel2.17.0Release-GettingtheDistributions">Getting the
Distributions</h2><h3 id="Camel2.17.0Release-BinaryDistributions">Binary
Distributions</h3><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Download Link</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>PGP Signature file of download</p></th></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>Windows
Distribution</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a
shape="rect" class="external-link"
href="http://www.apache.org/dyn/closer.cgi/camel/apache-camel/x.y.x/apache-camel-x.y.x.zip">apache-camel-x.y.x.zip</a></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rec
t" class="external-link"
href="http://www.apache.org/dist/camel/apache-camel/x.y.x/apache-camel-x.y.x.zip.asc">apache-camel-x.y.x.zip.asc</a></p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>Unix/Linux/Cygwin
Distribution</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a
shape="rect" class="external-link"
href="http://www.apache.org/dyn/closer.cgi/camel/apache-camel/x.y.x/apache-camel-x.y.x.tar.gz">apache-camel-x.y.x.tar.gz</a></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect"
class="external-link"
href="http://www.apache.org/dist/camel/apache-camel/x.y.x/apache-camel-x.y.x.tar.gz.asc">apache-camel-x.y.x.tar.gz.asc</a></p></td></tr></tbody></table></div><div
class="confluence-information-macro
confluence-information-macro-information"><p class="title">The above URLs use
redirection</p><span class="aui-icon aui-icon-small aui-iconfont-info
confluence-information-macro-icon"></span><div
class="confluence-information-macro-body
"><p>The above URLs use the Apache Mirror system to redirect you to a suitable
mirror for your download. Some users have experienced issues with some versions
of browsers (e.g. some Safari browsers). If the download doesn't seem to work
for you from the above URL then try using <a shape="rect" class="external-link"
href="http://www.mozilla.com/en-US/firefox/"
rel="nofollow">FireFox</a></p></div></div><h3
id="Camel2.17.0Release-SourceDistributions">Source Distributions</h3><div
class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1"
rowspan="1" class="confluenceTh"><p>Description</p></th><th colspan="1"
rowspan="1" class="confluenceTh"><p>Download Link</p></th><th colspan="1"
rowspan="1" class="confluenceTh"><p>PGP Signature file of
download</p></th></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>Source for Windows</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><a shape="rect" class="external-link"
href="http://www.apache.org/dyn/closer.
cgi/camel/apache-camel/x.y.x/apache-camel-x.y.x-src.zip">apache-camel-x.y.x-src.zip</a></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect"
class="external-link"
href="http://www.apache.org/dist/camel/apache-camel/x.y.x/apache-camel-x.y.x-src.zip.asc">apache-camel-x.y.x-src.zip.asc</a></p></td></tr></tbody></table></div><div
class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>Source for Unix/Linux/Cygwin</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect"
class="external-link"
href="http://www.apache.org/dyn/closer.cgi/camel/apache-camel/x.y.x/apache-camel-x.y.x-src.tar.gz">apache-camel-x.y.x-src.tar.gz</a></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect"
class="external-link"
href="http://www.apache.org/dist/camel/apache-camel/x.y.x/apache-camel-x.y.x-src.tar.gz.asc">apache-camel-x.y.x-src.tar.gz.asc</a></p></td></tr></tbody></table></div><h3
id="C
amel2.17.0Release-GettingtheBinariesusingMaven2">Getting the Binaries using
Maven 2</h3><p>To use this release in your maven project, the proper dependency
configuration that you should use in your <a shape="rect" class="external-link"
href="http://maven.apache.org/guides/introduction/introduction-to-the-pom.html">Maven
POM</a> is:</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeContent panelContent pdl">
<script class="brush: xml; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-core</artifactId>