Author: buildbot
Date: Wed Feb 10 09:19:49 2016
New Revision: 980008
Log:
Production update by buildbot for camel
Modified:
websites/production/camel/content/book-dataformat-appendix.html
websites/production/camel/content/book-in-one-page.html
websites/production/camel/content/cache/main.pageCache
websites/production/camel/content/camel-2170-release.html
websites/production/camel/content/json.html
Modified: websites/production/camel/content/book-dataformat-appendix.html
==============================================================================
--- websites/production/camel/content/book-dataformat-appendix.html (original)
+++ websites/production/camel/content/book-dataformat-appendix.html Wed Feb 10
09:19:49 2016
@@ -925,7 +925,12 @@ Invoice invoice = exchange.getIn().getBo
from("direct:inPretty").marshal().json(JsonLibrary.Jackson, true);
Â
from("direct:inPretty").marshal().json(JsonLibrary.Gson,
true);]]></script>
-</div></div><p><span style="line-height: 1.5625;">Please note that as of Camel
2.16 there’re 5 different overloaded <code>json()</code> DSL methods
which support the <code>prettyPrint</code> option in combination with other
settings for <code>JsonLibrary</code>, <code>unmarshalType</code>,
<code>jsonView</code> etc. </span></p><h3
id="BookDataFormatAppendix-DependenciesforXStream"><span style="line-height:
1.5625;">Dependencies for XStream</span></h3><p>To use JSON in your camel
routes you need to add the a dependency on <strong>camel-xstream</strong> which
implements this data format.</p><p>If you use maven you could just add the
following to your pom.xml, substituting the version number for the latest &
greatest release (see <a shape="rect" href="download.html">the download page
for the latest versions</a>).</p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
+</div></div><p><span style="line-height: 1.5625;">Please note that as of Camel
2.16 there’re 5 different overloaded <code>json()</code> DSL methods
which support the <code>prettyPrint</code> option in combination with other
settings for <code>JsonLibrary</code>, <code>unmarshalType</code>,
<code>jsonView</code> etc. </span></p><h3
id="BookDataFormatAppendix-"><span style="line-height:
1.5625;"> </span></h3><h3
id="BookDataFormatAppendix-IntegratingJacksonwithCamel'sTypeConverters">Integrating
Jackson with Camel's TypeConverters</h3><h3
id="BookDataFormatAppendix-.1"><span style="line-height:
1.5625;"> </span></h3><p><strong>Available as of Camel
2.17</strong></p><p><span style="line-height:
1.5625;">The <code>camel-jackson</code> module allows to integrate Jackson
as a <a shape="rect" href="type-converter.html">Type Converter</a> in the
Camel registry. This works in similar ways
that <code>camel-jaxb</code> integrates with the type conve
rter as well. However <code>camel-jackson</code> must be explicit
enabled, which is done by setting some options on
the <code>CamelContext</code> properties, as shown below:</span></p><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[// enable Jackson json type converter
+getContext().getProperties().put("CamelJacksonEnableTypeConverter",
"true");
+// allow Jackson json to convert to pojo types also (by default jackson only
converts to String and other simple types)
+getContext().getProperties().put("CamelJacksonTypeConverterToPojo",
"true");]]></script>
+</div></div><p>The <code>camel-jackson</code> type converter integrates
with JAXB which means you can annotate POJO class with JAXB annotations
that Jackson can leverage. </p><p><span style="line-height: 1.5625;"><br
clear="none"></span></p><h3
id="BookDataFormatAppendix-DependenciesforXStream"><span style="line-height:
1.5625;">Dependencies for XStream</span></h3><p>To use JSON in your camel
routes you need to add the a dependency on <strong>camel-xstream</strong> which
implements this data format.</p><p>If you use maven you could just add the
following to your pom.xml, substituting the version number for the latest &
greatest release (see <a shape="rect" href="download.html">the download page
for the latest versions</a>).</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-xstream</artifactId>
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 Feb 10 09:19:49
2016
@@ -3731,11 +3731,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.rbtoc1455070715372 {padding: 0px;}
-div.rbtoc1455070715372 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1455070715372 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1455095889798 {padding: 0px;}
+div.rbtoc1455095889798 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1455095889798 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1455070715372">
+/*]]>*/</style></p><div class="toc-macro rbtoc1455095889798">
<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>
@@ -5840,11 +5840,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.rbtoc1455070716589 {padding: 0px;}
-div.rbtoc1455070716589 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1455070716589 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1455095891043 {padding: 0px;}
+div.rbtoc1455095891043 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1455095891043 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style><div class="toc-macro rbtoc1455070716589">
+/*]]>*/</style><div class="toc-macro rbtoc1455095891043">
<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>
@@ -9949,7 +9949,12 @@ Invoice invoice = exchange.getIn().getBo
from("direct:inPretty").marshal().json(JsonLibrary.Jackson, true);
Â
from("direct:inPretty").marshal().json(JsonLibrary.Gson,
true);]]></script>
-</div></div><p><span style="line-height: 1.5625;">Please note that as of Camel
2.16 there’re 5 different overloaded <code>json()</code> DSL methods
which support the <code>prettyPrint</code> option in combination with other
settings for <code>JsonLibrary</code>, <code>unmarshalType</code>,
<code>jsonView</code> etc. </span></p><h3
id="BookInOnePage-DependenciesforXStream"><span style="line-height:
1.5625;">Dependencies for XStream</span></h3><p>To use JSON in your camel
routes you need to add the a dependency on <strong>camel-xstream</strong> which
implements this data format.</p><p>If you use maven you could just add the
following to your pom.xml, substituting the version number for the latest &
greatest release (see <a shape="rect" href="download.html">the download page
for the latest versions</a>).</p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
+</div></div><p><span style="line-height: 1.5625;">Please note that as of Camel
2.16 there’re 5 different overloaded <code>json()</code> DSL methods
which support the <code>prettyPrint</code> option in combination with other
settings for <code>JsonLibrary</code>, <code>unmarshalType</code>,
<code>jsonView</code> etc. </span></p><h3 id="BookInOnePage-"><span
style="line-height: 1.5625;"> </span></h3><h3
id="BookInOnePage-IntegratingJacksonwithCamel'sTypeConverters">Integrating
Jackson with Camel's TypeConverters</h3><h3 id="BookInOnePage-.1"><span
style="line-height: 1.5625;"> </span></h3><p><strong>Available as of Camel
2.17</strong></p><p><span style="line-height:
1.5625;">The <code>camel-jackson</code> module allows to integrate Jackson
as a <a shape="rect" href="type-converter.html">Type Converter</a> in the
Camel registry. This works in similar ways
that <code>camel-jaxb</code> integrates with the type converter as
well. However 
<code>camel-jackson</code> must be explicit enabled, which is done by setting
some options on the <code>CamelContext</code> properties, as shown
below:</span></p><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[// enable Jackson json type converter
+getContext().getProperties().put("CamelJacksonEnableTypeConverter",
"true");
+// allow Jackson json to convert to pojo types also (by default jackson only
converts to String and other simple types)
+getContext().getProperties().put("CamelJacksonTypeConverterToPojo",
"true");]]></script>
+</div></div><p>The <code>camel-jackson</code> type converter integrates
with JAXB which means you can annotate POJO class with JAXB annotations
that Jackson can leverage. </p><p><span style="line-height: 1.5625;"><br
clear="none"></span></p><h3 id="BookInOnePage-DependenciesforXStream"><span
style="line-height: 1.5625;">Dependencies for XStream</span></h3><p>To use JSON
in your camel routes you need to add the a dependency on
<strong>camel-xstream</strong> which implements this data format.</p><p>If you
use maven you could just add the following to your pom.xml, substituting the
version number for the latest & greatest release (see <a shape="rect"
href="download.html">the download page for the latest versions</a>).</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-xstream</artifactId>
@@ -17294,11 +17299,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.rbtoc1455070766270 {padding: 0px;}
-div.rbtoc1455070766270 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1455070766270 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1455095898818 {padding: 0px;}
+div.rbtoc1455095898818 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1455095898818 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1455070766270">
+/*]]>*/</style></p><div class="toc-macro rbtoc1455095898818">
<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>
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 Feb 10
09:19:49 2016
@@ -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>The component documentation generated from
the source code has been double checked to be up to date and include all the
options the endpoints supports.</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 <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>
0;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>setExchangeProperty</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><li>Add collate
function to <a shape="rect" href="simple.html">Simple</a> language to make
it easier to split a message body into sub lists of a specified size. The
function is similar to the collate function from Groovy.</li><li>The <a
shape="rect" href="camel-run-maven-goal.html">Camel Run Maven Goal</a> is able
to auto detect if its a OSGi Blueprint or CDI project so end users no longer
have to explicit configure this on the plugin.</li><li><a shape="rect"
href="elasticsearch.html">Camel-Elasticsearch</a> now supports Multiget,
Multisearch and exists operation</li><li><a shape="rect"
href="git.html">Camel-Git</a> no
w supports Cherry-pick operation</li><li>Stopping the <code>Main</code>
class from JMX will now trigger shutdown of the Main class/JVM also, as it does
when hitting ctrl + c.</li><li>Added option to skipFirst to the <a
shape="rect" href="tokenizer.html">Tokenizer</a> language to make it easy to
skip the very first element, when for example splitting a CSV file using
the <a shape="rect" href="splitter.html">Splitter</a>
EIP.</li><li>The <a shape="rect" href="rest-dsl.html">Rest DSL</a> now
supports default values for query parameters</li><li>Exchange and Message only
output id in their toString method to avoid outputting any message details such
as sensitive details from message bodies.</li><li>Camel <a shape="rect"
href="error-handler.html">Error Handler</a> no longer log message body/header
details when logging the <a shape="rect" href="message-history.html">Message
History</a>. This avoids logging any sensitive details from message
bodies.</li><li>Cam
el <a shape="rect" href="exception-clause.html">Exception Clause</a>
and <a shape="rect" href="error-handler.html">Error Handler</a> now
supports using a custom <code>Processor</code> to be invoked right after
an exception was thrown using the new <strong>onExceptionOccurred</strong>
option.</li><li><a shape="rect" href="rabbitmq.html">RabbitMQ</a> consumer more
resilient to auto re-connect in case of connection failures</li><li>The <a
shape="rect" href="http.html">HTTP</a> and <a shape="rect"
href="http4.html">HTTP4</a> producers now support
the <code>disableStreamCache</code> option to allow to use the raw
response stream as the message body instead of wrapping using <a
shape="rect" href="stream-caching.html">Stream caching</a></li><li>The <a
shape="rect" href="cdi.html">Camel CDI</a> component has been improved to
better fit into the CDI programming model, cover a larger set of containers,
and provide these new features:<ul><li>The Camel ev
ents from the <code>org.apache.camel.management.event</code> package (like
<code>CamelContextStartedEvent</code>) can be observed as CDI
events</li><li>The new CDI event Camel endpoint enable <span>CDI events to
be seamlessly consumed from (respectively produced by) Camel consumers
(respectively Camel producers)</span></li><li><span><span>CDI beans annotated
with the </span><code>@Converter</code><span> annotation are
automatically registered as type
converters</span></span></li><li><span><span>The CDI Camel contexts can
be properly customised programmatically in bean constructor
or <code>@PostConstruct</code> lifecycle
callback</span></span></li><li>Camel routes configured in
<code>RouteBuilder</code> beans are added before the corresponding Camel
contexts get started</li><li><span>CDI Camel contexts are now properly adapted
when deployed in OSGi containers and are registered as OSGi
services</span></li><li>Proper support of multiple Camel contexts acr
oss all the features<span><br clear="none"></span></li></ul></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><li>Fixed a
few things missing in the generated swagger model when using <a
shape="rect" href="swagger-java.html">Swagger Java</a></li><li>Fixed
using <code>statement.xxx</code>
options on the <a shape="rect" href="jdbc.html">JDBC</a> consumer would
only be used in first poll.</li><li>Fixed  <a shape="rect"
href="http.html">HTTP</a> and <a shape="rect"
href="http4.html">HTTP4</a> to keep trailing slash if provided in uri when
calling remote HTTP service.</li><li>Fixed <a shape="rect"
href="oncompletion.html">OnCompletion</a> to keep any caught exception stored
as property on the <code>Exchange</code> which allows to access that
information to know if there was an exception during routing.</li><li>Fixed an
issue with <a shape="rect" href="bean.html">Bean</a> component or <a
shape="rect" href="simple.html">Simple</a> language with OGNL method call,
would pick method with java.lang.Object type over a better suited method, when
the method is overloaded.</li><li>Fixed <code>camel-blueprint</code> to
wait for the bundles with the component and data-formats the <a
shape="rect" href="rest-dsl.html">Rest DSL</a>
has been configured to use, are available before starting
Camel.</li><li>Fixed an issue with <a shape="rect"
href="error-handler.html">Error Handler</a> would log any handled(true)
exceptions.</li><li>Fixed a memory leak if adding/removing routes using <a
shape="rect" href="idempotent-consumer.html">Idempotent Consumer</a> where the
repository would not be removed from the JMX registry when routes is
removed.</li><li>Fixed issue with <a shape="rect"
href="spring-boot.html">Spring Boot</a> would eager shutdown some Camel
resources like type converters, which spring-boot should let Camel handle the
lifecycle of these resources.</li><li>Fixed <a shape="rect"
href="idempotent-consumer.html">Idempotent Consumer</a> would not propagate
exception thrown from <code>IdempotentRepository</code> to Camel's <a
shape="rect" href="error-handler.html">Error Handler</a> such
as <code>onException</code><code><br clear="none"></code></li></ul><h3
id="Camel2.17.0Rel
ease-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 kinesis streams component
added</li><li>camel-aws - DynamoDB streams component added</li><li><a
shape="rect" href="ignite.html">camel-ignite</a> - for working with Apache
Ignite.</li><li>camel-mllp - <span style="color: rgb(0,0,0);">for working
with the HL7 MLLP protocol. This is an alternative to <a shape="rect"
href="hl7.html">HL7</a> component.</span></li><li>camel-spark - bridges Apache
Spark computations with Camel endpoints</li><li>camel-sql - Now supports
calling stored procedures using the new <a shape="rect"
href="sql-stored-procedure.html">sql-stored
component</a>.</li><li>camel-braintree - for interacting with Braintree
Payments.</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><li><a shape="rect" href="lzf-data-format.html">LZF Data Format</a>
- LZF 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-cdi-metrics -
illustrates the integration between Camel, Dropwizard Metrics and
CDI.</li><li>camel-example-cdi-properties - <span>illustrates the
integration between Camel, DeltaSpike and CDI for configuration
properties.</span></li><li><span>camel-example-cdi-osgi - a<span> CDI
application using the SJMS component that can be executed inside an OSGi
container using PAX CDI.</span></sp
an></li><li><span>camel-example-cdi-rest-servlet - <span>illustrates the
Camel REST DSL being used in a Web application that uses CDI as dependency
injection framework</span></span></li><li>camel-example-spring-boot-metrics -
showing a Camel spring-boot application that report metrics to Graphite.
Requires Graphite running on your
network.</li><li>camel-example-widget-gadget-cdi - The Widget and Gadget
use-case from the EIP book implemented in Java with CDI dependency
Injection.</li><li>camel-example-widget-gadget-java - The Widget and Gadget
use-case from the EIP book implemented in plain old Java Main without any kind
of <em>application server</em>.</li><li>camel-example-widget-gadget-xml - The
Widget and Gadget use-case from the EIP book implemented in Spring XML without
any Java code or any kind of <em>application server</em>.</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">A
PI breaking</h2><ul><li>As part of the <a shape="rect" href="cdi.html">Camel
CDI</a> component refactoring:<ul><li>The
<code>@ContextName</code> qualifier does not have a default empty value
anymore as it is irrelevant</li><li>The CdiPropertiesComponent class
has been removed, the standard PropertiesComponent can be used
instead</li></ul></li></ul><h2 id="Camel2.17.0Release-KnownIssues">Known
Issues</h2><h2 id="Camel2.17.0Release-Dependencyupgrades">Dependency
upgrades</h2><ul><li>Apache Cassandra from 2.1.8 to 2.2.2</li><li>Apache
Deltaspike from 1.5.1 to 1.5.2</li><li>Apache Gora from 0.6 to
0.6.1</li><li>Apache Jackrabbit from 2.11.0 to 2.11.3</li><li>Apache Kafka from
0.8.2.2 to 0.9.0.0</li><li>Apache Lucene from 4.10.4 to 5.2.1</li><li>Apache
Mina from 2.0.9 to 2.0.10</li><li>Apache OpenEjb from 4.7.2 to
4.7.3</li><li>Apache Solr from 4.10.4 to 5.2.1</li><li>Aws SDK Java to version
1.10.37</li><li>Atmosphere from <span class="blob-code-inner">2.4.0</spa
n> to 2.4.1.4</li><li>Cassandra driver from 2.1.8 to
2.1.9</li><li>Cassandra-unit from 2.1.9.2 to 2.2.2.1</li><li>Cglib from 3.1 to
3.2.0</li><li>Classmate from 1.3.0 to 1.3.1</li><li>Chunk from 3.0.1 to
3.1.2</li><li>Drools from 6.2.0.Final to 6.3.0.Final</li><li>EHCache from
2.10.0 to 2.10.1</li><li>Elasticsearch from 1.7.3 to 2.0.0</li><li>Embedded
Mongodb from 1.50.0 to 1.50.1</li><li>Facebook4j from 2.3.1 to
2.4.1</li><li>GAE from 1.9.26 to 1.9.28</li><li>Google Gson from 2.4 to
2.5</li><li>Hazelcast from 3.5.2 to 3.5.4</li><li>Infinispan from 8.0.1.Final
to 8.1.0.Final</li><li>Jackson from 2.6.3 to 2.6.4</li><li>Jboss Xnio from
3.3.1.Final to 3.3.2.Final</li><li>Jboss Weld from 2.3.0.Final to
2.3.2.Final</li><li>Jbpm from 6.2.0.Final to 6.3.0.Final</li><li>Jgit from
<span class="blob-code-inner">4.1.<span class="x x-first
x-last">0.201509280440</span>-r</span> to <span
class="blob-code-inner">4.1.<span class="x x-first
x-last">1.201511131810</span>-r</span></li><li>Joda-time f
rom 2.8.2 to 2.9.1</li><li>Json-path from 2.0.0 to 2.1.0</li><li>Jt400 from
8.6 to 8.7</li><li>Kie from 6.2.0.Final to 6.3.0.Final</li><li>Maven Exec
plugin from 1.2.1 to 1.4.0</li><li>Mongodb Java driver from 3.0.4 to
3.2.0</li><li>Mvel from 2.2.6.Final to 2.2.7.Final</li><li>Ognl from 3.1 to
3.1.1</li><li>Olingo from 2.0.4 to 2.0.5</li><li>Optaplanner from 6.2.0.Final
to 6.3.0.Final</li><li>Pax-exam from 4.6.0 to 4.8.0</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><li>Undertow from 1.3.3.Final to
1.3.7.Final</li><li>Vertx from 3.1.0 to 3.2.0</li><li>Zookeeper from 3.4.6 to
3.4.7</li></ul><h2
id="Camel2.17.0Release-Importantchangestoconsiderwhenupgrading">Important
changes to consider when upgrading</h2><ul><li><strong>This is the last release
that will support Java 1.7. Releases after this is expected to require Java
1.8+. </strong></li><li>Any custom component that supports suspensi
on in doSuspend/doResume should implement the
new <code>Suspendable</code> marker interface, so Camel knows there is
custom logic for suspension in the component.</li><li>Exchange and Message only
output id in their toString method to avoid outputting any message details such
as sensitive details from message bodies.</li><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. Support for
Spring 3.x is being <strong>removed</strong> in the next release.</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><li>The <a shape="rect"
href="mail.html">Mail</a> component now requires to configure to, cc, and bcc
using lower case keys, eg to=
f...@bar.com, instead of <a shape="rect" class="external-link"
href="mailto:To=f...@bar.com"; rel="nofollow">To=f...@bar.com</a> as
previously.</li><li>The <a shape="rect"
href="file2.html">File</a> consumer no longer probe the file content by
default. See the option <code>probeContentType</code> for more
details.</li><li>If using <a shape="rect"
href="bean.html">Bean</a> or <a shape="rect"
href="class.html">Class</a> component and specifying additional parameters
in the endpoint uri to configure on the bean, then these options should now be
prefixed with bean., eg <code>foo=123</code> is now
<code>bean.foo=123</code>.</li><li>The <a shape="rect"
href="twitter.html">Twitter</a> delay option is changed from seconds to milli
seconds by default, eg 10 should be 10000 to indicate 10 seconds. This is
aligned how other components with delay option
behaves. </li><li>The <a shape="rect" href="hbase.html">hbase</a>
component now re
quire row mapping from the endpoint uri to be prefixed with <code
style="line-height: 1.42857;">row.</code> as prefix.</li><li>Before:
<code>family=info&qualifier=firstName&family2=birthdate&qualifier2=year</code>. After: <code>row.family=info&row.qualifier=firstName&row.family2=birthdate&row.qualifier2=year</code>.</li><li>As
part of the <a shape="rect" href="cdi.html">Camel CDI</a> component
refactoring, <em>DeltaSpike</em> is not used anymore for the sourcing of
the configuration properties. This new version of the component is agnostic to
any configuration sourcing mechanism and delegates that concern to the
application so that it can declare a
custom <code>PropertiesComponent</code> bean whose sourcing is
tailored to its need. <em>DeltaSpike</em> can still be used by the application
by declaring a <code>PropertiesComponent</code> bean configured with
a <code>PropertiesParser</code> relying on <em>DeltaSpi
ke</em>. See the <code>camel-example-cdi-properties</code> example
for more details.</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 redirect yo
u 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="Camel2.17.0Release-GettingtheBinariesusingMaven2">Getting the Bi
naries 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>The component documentation generated from
the source code has been double checked to be up to date and include all the
options the endpoints supports.</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 <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>
0;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>setExchangeProperty</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><li>Add collate
function to <a shape="rect" href="simple.html">Simple</a> language to make
it easier to split a message body into sub lists of a specified size. The
function is similar to the collate function from Groovy.</li><li>The <a
shape="rect" href="camel-run-maven-goal.html">Camel Run Maven Goal</a> is able
to auto detect if its a OSGi Blueprint or CDI project so end users no longer
have to explicit configure this on the plugin.</li><li><a shape="rect"
href="elasticsearch.html">Camel-Elasticsearch</a> now supports Multiget,
Multisearch and exists operation</li><li><a shape="rect"
href="git.html">Camel-Git</a> no
w supports Cherry-pick operation</li><li>Stopping the <code>Main</code>
class from JMX will now trigger shutdown of the Main class/JVM also, as it does
when hitting ctrl + c.</li><li>Added option to skipFirst to the <a
shape="rect" href="tokenizer.html">Tokenizer</a> language to make it easy to
skip the very first element, when for example splitting a CSV file using
the <a shape="rect" href="splitter.html">Splitter</a>
EIP.</li><li>The <a shape="rect" href="rest-dsl.html">Rest DSL</a> now
supports default values for query parameters</li><li>Exchange and Message only
output id in their toString method to avoid outputting any message details such
as sensitive details from message bodies.</li><li>Camel <a shape="rect"
href="error-handler.html">Error Handler</a> no longer log message body/header
details when logging the <a shape="rect" href="message-history.html">Message
History</a>. This avoids logging any sensitive details from message
bodies.</li><li>Cam
el <a shape="rect" href="exception-clause.html">Exception Clause</a>
and <a shape="rect" href="error-handler.html">Error Handler</a> now
supports using a custom <code>Processor</code> to be invoked right after
an exception was thrown using the new <strong>onExceptionOccurred</strong>
option.</li><li><a shape="rect" href="rabbitmq.html">RabbitMQ</a> consumer more
resilient to auto re-connect in case of connection failures</li><li>The <a
shape="rect" href="json.html">JSON</a> <code>camel-jackson</code> can be
used as a type converter to convert json to/from POJO and String/byte[] types,
if enabled.</li><li>The <a shape="rect" href="http.html">HTTP</a>
and <a shape="rect" href="http4.html">HTTP4</a> producers now support
the <code>disableStreamCache</code> option to allow to use the raw
response stream as the message body instead of wrapping using <a
shape="rect" href="stream-caching.html">Stream caching</a></li><li>The <a
shape="rect"
href="cdi.html">Camel CDI</a> component has been improved to better fit into
the CDI programming model, cover a larger set of containers, and provide these
new features:<ul><li>The Camel events from the
<code>org.apache.camel.management.event</code> package (like
<code>CamelContextStartedEvent</code>) can be observed as CDI
events</li><li>The new CDI event Camel endpoint enable <span>CDI events to
be seamlessly consumed from (respectively produced by) Camel consumers
(respectively Camel producers)</span></li><li><span><span>CDI beans annotated
with the </span><code>@Converter</code><span> annotation are
automatically registered as type
converters</span></span></li><li><span><span>The CDI Camel contexts can
be properly customised programmatically in bean constructor
or <code>@PostConstruct</code> lifecycle
callback</span></span></li><li>Camel routes configured in
<code>RouteBuilder</code> beans are added before the corresponding Camel
contexts get starte
d</li><li><span>CDI Camel contexts are now properly adapted when deployed in
OSGi containers and are registered as OSGi services</span></li><li>Proper
support of multiple Camel contexts across all the features<span><br
clear="none"></span></li></ul></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
><li>Fixed a few things missing in the generated swagger model when
>using <a shape="rect" href="swagger-java.html">Swagger
>Java</a></li><li>Fixed using <code>statement.xxx</code> options on
>the <a shape="rect" href="jdbc.html">JDBC</a> consumer would only be
>used in first poll.</li><li>Fixed  <a shape="rect"
>href="http.html">HTTP</a> and <a shape="rect"
>href="http4.html">HTTP4</a> to keep trailing slash if provided in uri
>when calling remote HTTP service.</li><li>Fixed <a shape="rect"
>href="oncompletion.html">OnCompletion</a> to keep any caught exception stored
>as property on the <code>Exchange</code> which allows to access that
>information to know if there was an exception during routing.</li><li>Fixed
>an issue with <a shape="rect" href="bean.html">Bean</a> component
>or <a shape="rect" href="simple.html">Simple</a> language with OGNL
>method call, would pick method with java.lang.Object type over a better
>suited method, when the
method is overloaded.</li><li>Fixed <code>camel-blueprint</code> to wait
for the bundles with the component and data-formats the <a shape="rect"
href="rest-dsl.html">Rest DSL</a> has been configured to use, are available
before starting Camel.</li><li>Fixed an issue with <a shape="rect"
href="error-handler.html">Error Handler</a> would log any handled(true)
exceptions.</li><li>Fixed a memory leak if adding/removing routes using <a
shape="rect" href="idempotent-consumer.html">Idempotent Consumer</a> where the
repository would not be removed from the JMX registry when routes is
removed.</li><li>Fixed issue with <a shape="rect"
href="spring-boot.html">Spring Boot</a> would eager shutdown some Camel
resources like type converters, which spring-boot should let Camel handle the
lifecycle of these resources.</li><li>Fixed <a shape="rect"
href="idempotent-consumer.html">Idempotent Consumer</a> would not propagate
exception thrown from <code>IdempotentRepo
sitory</code> to Camel's <a shape="rect" href="error-handler.html">Error
Handler</a> such as <code>onException</code><code><br
clear="none"></code></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 kinesis streams component
added</li><li>camel-aws - DynamoDB streams component added</li><li><a
shape="rect" href="ignite.html">camel-ignite</a> - for working with Apache
Ignite.</li><li>camel-mllp - <span style="color: rgb(0,0,0);">for working
with the HL7 MLLP protocol. This is an alternative to <a shape="rect"
href="hl7.html">HL7</a> component.</span></li><li>camel-spark - bridges Apache
Spark computations with Camel endpoints</li><li>camel-sql - Now supports
calling stored procedures using the n
ew <a shape="rect" href="sql-stored-procedure.html">sql-stored
component</a>.</li><li>camel-braintree - for interacting with Braintree
Payments.</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><li><a shape="rect" href="lzf-data-format.html">LZF Data Format</a>
- LZF 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-cdi-metrics -
illustrates the integration between Camel, Dropwizard Metrics and
CDI.</li><li>camel-example-cdi-properties - <span>illustrates the
integration between Camel, DeltaSpike and CDI for configur
ation properties.</span></li><li><span>camel-example-cdi-osgi -
a<span> CDI application using the SJMS component that can be executed
inside an OSGi container using PAX
CDI.</span></span></li><li><span>camel-example-cdi-rest-servlet
- <span>illustrates the Camel REST DSL being used in a Web application
that uses CDI as dependency injection
framework</span></span></li><li>camel-example-spring-boot-metrics - showing a
Camel spring-boot application that report metrics to Graphite. Requires
Graphite running on your network.</li><li>camel-example-widget-gadget-cdi - The
Widget and Gadget use-case from the EIP book implemented in Java with CDI
dependency Injection.</li><li>camel-example-widget-gadget-java - The Widget and
Gadget use-case from the EIP book implemented in plain old Java Main without
any kind of <em>application
server</em>.</li><li>camel-example-widget-gadget-xml - The Widget and Gadget
use-case from the EIP book implemented in Spring XML without any Java code or a
ny kind of <em>application server</em>.</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><ul><li>As part of the <a
shape="rect" href="cdi.html">Camel CDI</a> component refactoring:<ul><li>The
<code>@ContextName</code> qualifier does not have a default empty value
anymore as it is irrelevant</li><li>The CdiPropertiesComponent class
has been removed, the standard PropertiesComponent can be used
instead</li></ul></li></ul><h2 id="Camel2.17.0Release-KnownIssues">Known
Issues</h2><h2 id="Camel2.17.0Release-Dependencyupgrades">Dependency
upgrades</h2><ul><li>Apache Cassandra from 2.1.8 to 2.2.2</li><li>Apache
Deltaspike from 1.5.1 to 1.5.2</li><li>Apache Gora from 0.6 to
0.6.1</li><li>Apache Jackrabbit from 2.11.0 to 2.11.3</li><li>Apache Kafka from
0.8.2.2 to 0.9.0.0</li><li>Apache Lucene from 4.10.4 to 5.2.1</li><li>Apache
Mina from 2.0.9 to 2.0.10
</li><li>Apache OpenEjb from 4.7.2 to 4.7.3</li><li>Apache Solr from 4.10.4 to
5.2.1</li><li>Aws SDK Java to version 1.10.37</li><li>Atmosphere from <span
class="blob-code-inner">2.4.0</span> to 2.4.1.4</li><li>Cassandra driver from
2.1.8 to 2.1.9</li><li>Cassandra-unit from 2.1.9.2 to 2.2.2.1</li><li>Cglib
from 3.1 to 3.2.0</li><li>Classmate from 1.3.0 to 1.3.1</li><li>Chunk from
3.0.1 to 3.1.2</li><li>Drools from 6.2.0.Final to 6.3.0.Final</li><li>EHCache
from 2.10.0 to 2.10.1</li><li>Elasticsearch from 1.7.3 to
2.0.0</li><li>Embedded Mongodb from 1.50.0 to 1.50.1</li><li>Facebook4j from
2.3.1 to 2.4.1</li><li>GAE from 1.9.26 to 1.9.28</li><li>Google Gson from 2.4
to 2.5</li><li>Hazelcast from 3.5.2 to 3.5.4</li><li>Infinispan from
8.0.1.Final to 8.1.0.Final</li><li>Jackson from 2.6.3 to 2.6.4</li><li>Jboss
Xnio from 3.3.1.Final to 3.3.2.Final</li><li>Jboss Weld from 2.3.0.Final to
2.3.2.Final</li><li>Jbpm from 6.2.0.Final to 6.3.0.Final</li><li>Jgit from
<span class="blob-code-in
ner">4.1.<span class="x x-first x-last">0.201509280440</span>-r</span> to
<span class="blob-code-inner">4.1.<span class="x x-first
x-last">1.201511131810</span>-r</span></li><li>Joda-time from 2.8.2 to
2.9.1</li><li>Json-path from 2.0.0 to 2.1.0</li><li>Jt400 from 8.6 to
8.7</li><li>Kie from 6.2.0.Final to 6.3.0.Final</li><li>Maven Exec plugin from
1.2.1 to 1.4.0</li><li>Mongodb Java driver from 3.0.4 to 3.2.0</li><li>Mvel
from 2.2.6.Final to 2.2.7.Final</li><li>Ognl from 3.1 to 3.1.1</li><li>Olingo
from 2.0.4 to 2.0.5</li><li>Optaplanner from 6.2.0.Final to
6.3.0.Final</li><li>Pax-exam from 4.6.0 to 4.8.0</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><li>Undertow from 1.3.3.Final to
1.3.7.Final</li><li>Vertx from 3.1.0 to 3.2.0</li><li>Zookeeper from 3.4.6 to
3.4.7</li></ul><h2
id="Camel2.17.0Release-Importantchangestoconsiderwhenupgrading">Important
changes to consider when upgrading</h2>
<ul><li><strong>This is the last release that will support Java 1.7. Releases
after this is expected to require Java 1.8+. </strong></li><li>Any custom
component that supports suspension in doSuspend/doResume should implement the
new <code>Suspendable</code> marker interface, so Camel knows there is
custom logic for suspension in the component.</li><li>Exchange and Message only
output id in their toString method to avoid outputting any message details such
as sensitive details from message bodies.</li><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. Support for
Spring 3.x is being <strong>removed</strong> in the next release.</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-integratio
n feature has been removed from the Camel karaf.</li><li>The <a
shape="rect" href="mail.html">Mail</a> component now requires to configure to,
cc, and bcc using lower case keys, eg to=f...@bar.com, instead of <a
shape="rect" class="external-link" href="mailto:To=f...@bar.com";
rel="nofollow">To=f...@bar.com</a> as previously.</li><li>The <a
shape="rect" href="file2.html">File</a> consumer no longer probe the file
content by default. See the option <code>probeContentType</code> for more
details.</li><li>If using <a shape="rect"
href="bean.html">Bean</a> or <a shape="rect"
href="class.html">Class</a> component and specifying additional parameters
in the endpoint uri to configure on the bean, then these options should now be
prefixed with bean., eg <code>foo=123</code> is now
<code>bean.foo=123</code>.</li><li>The <a shape="rect"
href="twitter.html">Twitter</a> delay option is changed from seconds to milli
seconds by default, eg 1
0 should be 10000 to indicate 10 seconds. This is aligned how other components
with delay option behaves. </li><li>The <a shape="rect"
href="hbase.html">hbase</a> component now require row mapping from the endpoint
uri to be prefixed with <code style="line-height: 1.42857;">row.</code> as
prefix.</li><li>Before:
<code>family=info&qualifier=firstName&family2=birthdate&qualifier2=year</code>. After: <code>row.family=info&row.qualifier=firstName&row.family2=birthdate&row.qualifier2=year</code>.</li><li>As
part of the <a shape="rect" href="cdi.html">Camel CDI</a> component
refactoring, <em>DeltaSpike</em> is not used anymore for the sourcing of
the configuration properties. This new version of the component is agnostic to
any configuration sourcing mechanism and delegates that concern to the
application so that it can declare a
custom <code>PropertiesComponent</code> bean whose sourcing is
tailored to its need. <em>DeltaSpi
ke</em> can still be used by the application by declaring
a <code>PropertiesComponent</code> bean configured with
a <code>PropertiesParser</code> relying on <em>DeltaSpike</em>. See
the <code>camel-example-cdi-properties</code> example for more
details.</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 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-cam
el/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">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>
Modified: websites/production/camel/content/json.html
==============================================================================
--- websites/production/camel/content/json.html (original)
+++ websites/production/camel/content/json.html Wed Feb 10 09:19:49 2016
@@ -322,7 +322,12 @@ Invoice invoice = exchange.getIn().getBo
from("direct:inPretty").marshal().json(JsonLibrary.Jackson, true);
Â
from("direct:inPretty").marshal().json(JsonLibrary.Gson,
true);]]></script>
-</div></div><p><span style="line-height: 1.5625;">Please note that as of Camel
2.16 there’re 5 different overloaded <code>json()</code> DSL methods
which support the <code>prettyPrint</code> option in combination with other
settings for <code>JsonLibrary</code>, <code>unmarshalType</code>,
<code>jsonView</code> etc. </span></p><h3
id="JSON-DependenciesforXStream"><span style="line-height:
1.5625;">Dependencies for XStream</span></h3><p>To use JSON in your camel
routes you need to add the a dependency on <strong>camel-xstream</strong> which
implements this data format.</p><p>If you use maven you could just add the
following to your pom.xml, substituting the version number for the latest &
greatest release (see <a shape="rect" href="download.html">the download page
for the latest versions</a>).</p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
+</div></div><p><span style="line-height: 1.5625;">Please note that as of Camel
2.16 there’re 5 different overloaded <code>json()</code> DSL methods
which support the <code>prettyPrint</code> option in combination with other
settings for <code>JsonLibrary</code>, <code>unmarshalType</code>,
<code>jsonView</code> etc. </span></p><h3 id="JSON-"><span
style="line-height: 1.5625;"> </span></h3><h3
id="JSON-IntegratingJacksonwithCamel'sTypeConverters">Integrating Jackson with
Camel's TypeConverters</h3><h3 id="JSON-.1"><span style="line-height:
1.5625;"> </span></h3><p><strong>Available as of Camel
2.17</strong></p><p><span style="line-height:
1.5625;">The <code>camel-jackson</code> module allows to integrate Jackson
as a <a shape="rect" href="type-converter.html">Type Converter</a> in the
Camel registry. This works in similar ways
that <code>camel-jaxb</code> integrates with the type converter as
well. However <code>camel-jackson</code>
must be explicit enabled, which is done by setting some options on
the <code>CamelContext</code> properties, as shown below:</span></p><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[// enable Jackson json type converter
+getContext().getProperties().put("CamelJacksonEnableTypeConverter",
"true");
+// allow Jackson json to convert to pojo types also (by default jackson only
converts to String and other simple types)
+getContext().getProperties().put("CamelJacksonTypeConverterToPojo",
"true");]]></script>
+</div></div><p>The <code>camel-jackson</code> type converter integrates
with JAXB which means you can annotate POJO class with JAXB annotations
that Jackson can leverage. </p><p><span style="line-height: 1.5625;"><br
clear="none"></span></p><h3 id="JSON-DependenciesforXStream"><span
style="line-height: 1.5625;">Dependencies for XStream</span></h3><p>To use JSON
in your camel routes you need to add the a dependency on
<strong>camel-xstream</strong> which implements this data format.</p><p>If you
use maven you could just add the following to your pom.xml, substituting the
version number for the latest & greatest release (see <a shape="rect"
href="download.html">the download page for the latest versions</a>).</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"><
![http://camel.apache.org/download.data/camel-box-v1.0-150x200.png"](http://camel.apache.org/download.data/camel-box-v1.0-150x200.png"){kind=link}