Author: buildbot
Date: Wed Mar 8 19:18:38 2017
New Revision: 1007944
Log:
Production update by buildbot for camel
Modified:
websites/production/camel/content/cache/main.pageCache
websites/production/camel/content/camel-219-release.html
Modified: websites/production/camel/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/camel/content/camel-219-release.html
==============================================================================
--- websites/production/camel/content/camel-219-release.html (original)
+++ websites/production/camel/content/camel-219-release.html Wed Mar 8
19:18:38 2017
@@ -85,7 +85,13 @@
<tbody>
<tr>
<td valign="top" width="100%">
-<div class="wiki-content maincontent"><h1
id="Camel2.19Release-Camel2.19.0Release(currentlyinprogress)">Camel 2.19.0
Release (currently in progress)</h1><div
style="padding-right:20px;float:left;margin-left:-20px;"><span
class="confluence-embedded-file-wrapper"><img class="confluence-embedded-image
confluence-external-resource"
src="http://camel.apache.org/images/camel-box-small.png"
data-image-src="http://camel.apache.org/images/camel-box-small.png"></span></div><div
style="min-height:200px"> </div><h2
id="Camel2.19Release-NewandNoteworthy">New and Noteworthy</h2><p>Welcome to the
2.19.0 release which approx XXX issues resolved (new features, improvements and
bug fixes such as...)</p><ul><li>Introduced <a shape="rect"
class="external-link"
href="https://github.com/apache/camel/blob/master/connectors/camel-connector/src/main/docs/connector-component.adoc#connector-component"
rel="nofollow">Camel Connector</a>'s which is a simplified version of a Camel
component that has been pr
e-configured for a specific use-case.</li><li>Upgraded to Spring Boot
1.5.x.</li><li>The <a shape="rect" href="camel-maven-plugin.html">Camel Maven
Plugin</a> now provides the <code>camel:validate</code> goal to parse your Java
and XML source code for any Camel routes and report invalid Camel endpoint uri
and simple expression errors. You can run this at code time (not
runtime). </li><li>Camel <code>Main</code> and <a shape="rect"
href="spring-boot.html">Spring Boot</a> and <a shape="rect"
href="camel-maven-plugin.html">Camel Maven Plugin</a> can now auto terminate
the JVM after Camel has been running for maximum duration of seconds, processed
messages or been idle for a period.</li><li>Camel source code can build with
Java 9 in preparation for official support for Java 9 later this
year</li><li>Deprecated more components and camel-core APIs that will be
dropped in Camel 3.0 or sometime in the
future</li><li>Introduced <code>ReloadStrategy</code> as SPI
which allows custom providers to implement logic for triggering live reloads
of Camel routes.</li><li>The  <a shape="rect"
href="camel-maven-plugin.html">Camel Maven Plugin</a> now allows to live
reload route changes from XML files when running Camel. This can also be
enabled from the <code>Main</code> class.</li><li>Introduced a
new <code>camel-catalog-rest</code> artifact which is a tiny
standalone REST API of the CamelCatalog using JAX-RS and Swagger
Annotations.</li><li>Added <code>camel-catalog-rest-app</code> as a
standalone application which used Apache CXF with Jetty to host the Catalog
REST API with embedded Swagger
UI</li><li>Returning <code>null</code> from <a shape="rect"
href="bean.html">Bean</a> should work similar to
how <code>setBody</code> and <code>transform</code> works
when they set a <code>null</code> body.</li><li>The Camel Spring Boot
starter components now have their auto configu
ration depends
on <code>org.apache.camel.springboot.CamelAutoConfiguration</code> which
makes it easier writing unit tests where you can
exclude <code>org.apache.camel.springboot.CamelAutoConfiguration</code> to
turn off Camel Spring Boot auto configuration completely.</li><li>Camel now
supports OWASP dependency check maven plugin</li><li><a shape="rect"
href="nats.html">NATS</a> component now supports TLS and explicit
flushing (with timeout) of the connection</li><li><a shape="rect"
href="https://cwiki.apache.org/confluence/display/BOOKKEEPER/Metrics">Metrics</a> component
now supports Gauge type</li><li><a shape="rect"
href="file2.html">File consumer</a> now supports idempotent-changed and
idempotent-rename read lock strategies for clustering. </li><li>Camel
Catalog now supports custom runtime providers that only includes the supported
Camel components, languages and data formats running in that container. For
example for Karaf or Spring Boot in
the camel-catalog-provider-karaf and
camel-catalog-provider-springboot.</li><li>The <a shape="rect"
href="https://cwiki.apache.org/confluence/display/WW/bean">bean</a> component
will when calling a method that returned an instance of
<code>Callable</code> now call that callable to obtain the chained result.
This allows to call Groovy functions/closures etc.</li><li>Failover <a
shape="rect" href="load-balancer.html">Load Balancer</a> with
inheritErrorHandler=false, now allows Camel's <a shape="rect"
href="error-handler.html">Error Handler</a> to react after the load balancer is
exhausted.</li><li><a shape="rect" href="salesforce.html">Salesforce</a>
component now supports limits, recent items, approvals and composite
API</li><li>Dumping Camel routes as XML now includes custom namespaces which
are at xpath expressions etc. Likewise updating Camel routes from XML can now
include namespaces which will be associated on xpath
expressions.</li><li>Added <code>Route
IdFactory</code> which can auto assign route ids based on the consumer
endpoints to use more sensitible names, instead of route1, route2,
etc.</li><li>Add <code>skip</code> function to <a shape="rect"
href="simple.html">Simple</a> language</li><li>Upgraded to Jetty 9.3 (Jetty 9.2
still supported for Karaf 4.0.x users)</li><li><code>RouteBuilder</code>
auto-configuration can now be disabled in <a shape="rect" href="cdi.html">Camel
CDI</a></li><li><span>Asynchronous support for <a shape="rect"
href="cxfrs.html">CXF JAX-RS</a> producers has been
added</span></li><li><span>The <a shape="rect"
href="jsonpath.html">JSonPath</a> language now supports Map and List types and
POJOs as well. For POJOs you need to have Jackson on the
classpath. </span></li><li><span><a shape="rect"
href="data-format.html">Data Format</a> which marshal to JSon or XML now set
the content-type header to application/json or application/xml
appropriately.<br clear="none"></span></li><li><span>The
 <a shape="rect" href="kafka.html">Kafka</a> component can now store
offset state offline (stateRepository) to preserve this information and be able
to resume from previous offset.</span></li><li>The <a shape="rect"
href="kafka.html">Kafka</a> component has been improved to be easier to
configure and use. Notice there is a backwards incompatible change so users
need to migrate.</li><li>A topic based idempotent repository that is <a
shape="rect" href="kafka.html">Kafka</a> based for the <a
shape="rect" href="idempotent-consumer.html">Idempotent
Consumer</a> EIP</li><li>The <a shape="rect"
href="kafka.html">Kafka</a> component will not automatic type convert the
message body to the type specified by the configured serializer (is string by
default) when sending to kafka. You can also now configure key and partitionKey
in the endpoint uri, instead of having to specify as
headers.</li><li>The <a shape="rect" href="kafka.html">Kafka</a> consumer
wil
l now auto commit on stop to ensure the broker has the latest offset commit.
The option <code>autoCommitOnStop</code> can be configured to be
sync,async or none.</li><li>Added easy predicate parser to <a shape="rect"
href="jsonpath.html">JSonPath</a> to more easily define simple predicates
without using the more complex jsonpath notation with all the symbols to just
say price < 50</li><li>The <a shape="rect" href="box.html">Box</a>
component has been migrated to use the Box v2 Java API as the old v1 API is
going to be shutdown from summer 2017</li><li>Examples overview now generate
from the source code to ensure its up to date at <a shape="rect"
class="external-link"
href="https://github.com/apache/camel/tree/master/examples#examples"
rel="nofollow">https://github.com/apache/camel/tree/master/examples#examples</a></li></ul><p>Fixed
these issues</p><ul><li>Fixed starting Camel on Oracle JDK 1.8.0_19 or lower,
which would throw an UnsupportedOperationE
xception</li><li>Fixed running <code>mvn camel:run</code> when using OSGi
Blueprint</li><li>Fixed <a shape="rect" href="hystrix-eip.html">Hystrix
EIP</a> to also execute fallback if execution was rejected or short-circuited
or other reasons from Hystrix. </li><li>Fixed <a shape="rect"
href="hystrix-eip.html">Hystrix EIP</a> race condition when timeout was hit and
fallback is executed could let to Camel Exchange having wrong caused
exception.</li><li>Fixed adding new routes to running CamelContext and if the
new routes would fail to startup, then before these routes would "hang around".
Now only succesful started routes are added.</li><li>Adding or removing routes
that starts from <a shape="rect" href="undertow.html">Undertow</a> no
longer restart the entire HTTP server</li><li><a shape="rect"
href="vm.html">VM</a> endpoint should prepare exchange with the CamelContext
from the consumer and not from cached endpoint which can be
different</li><li>Fixed a bug w
hen using <a shape="rect" href="rest-dsl.html">Rest DSL</a> with <a
shape="rect" href="servlet.html">SERVLET</a> could cause a java.io.IOException:
Stream closed exception when using <a shape="rect"
href="bean.html">Bean</a> in the route. </li><li>Fixed an issue when
using <code>pipeline</code> in Java DSL not setting up the EIP correctly
which could lead to runtime route not as intended.</li><li>Fixed <a
shape="rect" href="dropbox.html">Dropbox</a> to use <a shape="rect"
href="stream-caching.html">Stream caching</a> to avoid reading entire file into
memory so Camel can process big files</li><li>Fixed <code>toD</code> issue
with splitting uris when RAW values had + sign</li><li>Fixed adviceWith may
behave differently when using multiple advices in the same order and you would
advice on the same nodes.</li><li>Fixed <a shape="rect"
href="camel-zipkin.html">camel-zipkin</a> to be able to startup and work with
Camel XML </li><li>Fixed&#
160;<a shape="rect" href="ftp2.html">FTP2</a> readLock=changed not working
(when fastFileExists=false) if no sub folder was specified as starting
directory.</li><li>Fixed <a shape="rect" href="simple.html">Simple</a>
language when using indexing with a nested function</li><li>Fixed issue
with <code>@Consume</code> not
having <code>CamelContext</code> injected and its lifecycle managed
by <code>CamelContext</code></li><li>Fixed Netty double buffer release
leak in <a shape="rect" href="netty4.html">Netty4</a> and <a
shape="rect" href="netty4-http.html">Netty4 HTTP</a></li></ul><h3
id="Camel2.19Release-New">New <a shape="rect"
href="enterprise-integration-patterns.html">Enterprise Integration
Patterns</a></h3><h3 id="Camel2.19Release-New.1">New <a shape="rect"
href="components.html">Components</a></h3><ul><li>camel-azure - to integrate
with Microsoft Azure Cloud services</li><li>camel-bonita - allow you to
communicate with a remote Bonita engine.
</li><li>camel-couchbase - The couchbase component allows you to treat
CouchBase instances as a producer or consumer of messages.</li><li>camel-drill
- The drill component gives you the ability to querying to Apache Drill
Cluster</li><li>camel-elasticsearch5 - to communicate with Elasticsearch Server
using 5.x APIs</li><li>camel-google-pubsub - allow you communicate with Google
Cloud Pub/Sub</li><li>camel-mongodb3 - Evolution of the component based on v3
driver. Camel-Mongodb still exists allowing compatibility with the v2
driver.</li><li>camel-openstack - allow you to communicate with an Openstack
infrastructure</li><li>camel-opentracing - Distributed tracing using
OpenTracing</li><li>camel-tika - integrates with Apache Tika to extract
content and metadata from thousands of file
types</li><li>camel-spring-cloud - integrates with Spring
Cloud</li><li>camel-spring-cloud-netflix - integrates with Spring Cloud
Netflix</li></ul><h3 id="Camel2.19Release-NewDSL">New DS
L</h3><h3 id="Camel2.19Release-NewAnnotations">New Annotations</h3><h3
id="Camel2.19Release-New.2">New <a shape="rect" href="data-format.html">Data
Format</a></h3><h3 id="Camel2.19Release-New.3">New <a shape="rect"
href="languages.html">Languages</a></h3><h3 id="Camel2.19Release-New.4">New <a
shape="rect" href="examples.html">Examples</a></h3><ul><li>camel-example-reload
- To demonstrate the live reload routes from XML files when running
Camel.</li><li>camel-example-opentracing - An example showing how to trace
incoming and outgoing messages from Camel with OpenTracing</li></ul><h3
id="Camel2.19Release-New.5">New <a shape="rect"
href="tutorials.html">Tutorials</a></h3><h2
id="Camel2.19Release-APIbreaking">API breaking</h2><ul><li>The groovy DSL from
camel-groovy has been moved into its own camel-groovy-dsl module. The
camel-groovy now only contains the Camel Groovy <a shape="rect"
href="language.html">Language</a></li><li>Camel-spring-LDAP now uses
java.util.function.BiFun
ction<L, Q, S> instead
of org.apache.camel.component.springldap.LdapOperationsFunction<Q,
S></li><li>The deprecated APIs from camel-spring-boot has been removed as
part of upgrading and supporting Spring Boot
1.5.x</li><li>The <code>getComponentDocumentation</code> method
on <code>CamelContext</code> is deprecated and returns null. The embedded
HTML documentation in all the Camel components has been removed as they are not
in use/maintained, and the JSon schema is the actual information. Use the
camel-catalog for component documentation where you can get all the
documentation in both ascii doc and html format.</li><li>camel-mongodb-gridf
schema has been renamed
from <strong>gridfs</strong> to <strong>mongodb-gridfs</strong> to
avoid confusion.</li><li>The <a shape="rect"
href="kafka.html">Kafka</a> endpoint option
<code>seekToBeginning=true</code> should be migrated
to <code>seekTo=beginning</code></li><li>The <
a shape="rect" href="kafka.html">Kafka</a> component has been improved to be
easier to configure and use. Notice there is a backwards incompatible change so
users need to migrate. The kafka uri is changed from kafka:brokers to
kafka:topic. So you need to specify the topic name in the context-path and the
brokers as parameters, eg before
<code>kafka:myserver?topic=sometopic</code> is
now <code>kafka:sometopic?brokers=myserver</code></li></ul><h2
id="Camel2.19Release-KnownIssues">Known Issues</h2><h2
id="Camel2.19Release-Importantchangestoconsiderwhenupgrading">Important changes
to consider when upgrading</h2><ul><li>Groovy DSL and Scala DSL is deprecated
and planned to be moved to <a shape="rect" class="external-link"
href="https://camel-extra.github.io/" rel="nofollow">Camel Extra</a> and not
distributed out of the box in the future.</li><li>Camel now uses Karaf 4.x API
and therefore not possible to run on older Karaf
versions.</li><li><code>camel-blueprint</code> cha
nged startup behavior to start on Blueprint.CREATED event which would be more
`correct` way of startup instead of Blueprint.REGISTERED as
before.</li><li>camel-spring-boot now don't include prototype scoped beans when
auto scanning for RouteBuilder instances, which is how camel-spring works. You
can turn this back using the includeNonSingletons
option.</li><li>camel-spring-javaconfig removed from Karaf features as it was
not really supported in OSGi/Karaf.</li><li>camel spring-boot shell commands
have been removed as spring-boot shell has been deprecated in
spring-boot.</li><li>camel-mongodb-gridf schema has been renamed from
<strong>gridfs</strong> to <strong>mongodb-gridfs</strong> to avoid
confusion.</li><li>camel-box has been migrated to use box v2 api so there may
be some migration needed as the old camel-box component was using box v1
api</li><li>The JSon schema from camel-catalog have changed to use boolean,
integer and numeric values when applicable instead of usin
g string values for everything. </li></ul><h2
id="Camel2.19Release-GettingtheDistributions">Getting the Distributions</h2><h3
id="Camel2.19Release-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 exp
erienced 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.19Release-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 (zip)</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="c
onfluenceTd"><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><h3
id="Camel2.19Release-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">
+<div class="wiki-content maincontent"><h1
id="Camel2.19Release-Camel2.19.0Release(currentlyinprogress)">Camel 2.19.0
Release (currently in progress)</h1><div
style="padding-right:20px;float:left;margin-left:-20px;"><span
class="confluence-embedded-file-wrapper"><img class="confluence-embedded-image
confluence-external-resource"
src="http://camel.apache.org/images/camel-box-small.png"
data-image-src="http://camel.apache.org/images/camel-box-small.png"></span></div>
+
+
+<div style="min-height:200px"> </div>
+
+
+<h2 id="Camel2.19Release-NewandNoteworthy">New and Noteworthy</h2><p>Welcome
to the 2.19.0 release which approx XXX issues resolved (new features,
improvements and bug fixes such as...)</p><ul><li>Introduced <a shape="rect"
class="external-link"
href="https://github.com/apache/camel/blob/master/connectors/camel-connector/src/main/docs/connector-component.adoc#connector-component"
rel="nofollow">Camel Connector</a>'s which is a simplified version of a Camel
component that has been pre-configured for a specific
use-case.</li><li>Upgraded to Spring Boot 1.5.x.</li><li>The <a shape="rect"
href="camel-maven-plugin.html">Camel Maven Plugin</a> now provides the
<code>camel:validate</code> goal to parse your Java and XML source code for any
Camel routes and report invalid Camel endpoint uri and simple expression
errors. You can run this at code time (not
runtime). </li><li>Camel <code>Main</code> and <a shape="rect"
href="spring-boot.html">Spring Boot</a> and <a shape="r
ect" href="camel-maven-plugin.html">Camel Maven Plugin</a> can now auto
terminate the JVM after Camel has been running for maximum duration of seconds,
processed messages or been idle for a period.</li><li>Camel source code can
build with Java 9 in preparation for official support for Java 9 later this
year</li><li>Deprecated more components and camel-core APIs that will be
dropped in Camel 3.0 or sometime in the
future</li><li>Introduced <code>ReloadStrategy</code> as SPI which
allows custom providers to implement logic for triggering live reloads of Camel
routes.</li><li>The  <a shape="rect"
href="camel-maven-plugin.html">Camel Maven Plugin</a> now allows to live
reload route changes from XML files when running Camel. This can also be
enabled from the <code>Main</code> class.</li><li>Introduced a
new <code>camel-catalog-rest</code> artifact which is a tiny
standalone REST API of the CamelCatalog using JAX-RS and Swagger
Annotations.</li><li>Added
 <code>camel-catalog-rest-app</code> as a standalone application
which used Apache CXF with Jetty to host the Catalog REST API with embedded
Swagger UI</li><li>Returning <code>null</code> from <a
shape="rect" href="bean.html">Bean</a> should work similar to
how <code>setBody</code> and <code>transform</code> works
when they set a <code>null</code> body.</li><li>The Camel Spring Boot
starter components now have their auto configuration depends
on <code>org.apache.camel.springboot.CamelAutoConfiguration</code> which
makes it easier writing unit tests where you can
exclude <code>org.apache.camel.springboot.CamelAutoConfiguration</code> to
turn off Camel Spring Boot auto configuration completely.</li><li>Camel now
supports OWASP dependency check maven plugin</li><li><a shape="rect"
href="nats.html">NATS</a> component now supports TLS and explicit
flushing (with timeout) of the connection</li><li><a shape="rect" h
ref="https://cwiki.apache.org/confluence/display/BOOKKEEPER/Metrics">Metrics</a> component
now supports Gauge type</li><li><a shape="rect"
href="file2.html">File consumer</a> now supports idempotent-changed and
idempotent-rename read lock strategies for clustering. </li><li>Camel
Catalog now supports custom runtime providers that only includes the supported
Camel components, languages and data formats running in that container. For
example for Karaf or Spring Boot in the camel-catalog-provider-karaf and
camel-catalog-provider-springboot.</li><li>The <a shape="rect"
href="https://cwiki.apache.org/confluence/display/WW/bean">bean</a> component
will when calling a method that returned an instance of
<code>Callable</code> now call that callable to obtain the chained result.
This allows to call Groovy functions/closures etc.</li><li>Failover <a
shape="rect" href="load-balancer.html">Load Balancer</a> with
inheritErrorHandler=false, now allows Camel's <a
shape="rect" href="error-handler.html">Error Handler</a> to react after the
load balancer is exhausted.</li><li><a shape="rect"
href="salesforce.html">Salesforce</a> component now supports limits, recent
items, approvals and composite API</li><li>Dumping Camel routes as XML now
includes custom namespaces which are at xpath expressions etc. Likewise
updating Camel routes from XML can now include namespaces which will be
associated on xpath expressions.</li><li>Added <code>RouteIdFactory</code>
which can auto assign route ids based on the consumer endpoints to use more
sensitible names, instead of route1, route2,
etc.</li><li>Add <code>skip</code> function to <a shape="rect"
href="simple.html">Simple</a> language</li><li>Upgraded to Jetty 9.3 (Jetty 9.2
still supported for Karaf 4.0.x users)</li><li><code>RouteBuilder</code>
auto-configuration can now be disabled in <a shape="rect" href="cdi.html">Camel
CDI</a></li><li><span>Asynchronous support for <a shape="rect" hre
f="cxfrs.html">CXF JAX-RS</a> producers has been
added</span></li><li><span>The <a shape="rect"
href="jsonpath.html">JSonPath</a> language now supports Map and List types and
POJOs as well. For POJOs you need to have Jackson on the
classpath. </span></li><li><span><a shape="rect"
href="data-format.html">Data Format</a> which marshal to JSon or XML now set
the content-type header to application/json or application/xml
appropriately.<br clear="none"></span></li><li><span>The <a shape="rect"
href="kafka.html">Kafka</a> component can now store offset state offline
(stateRepository) to preserve this information and be able to resume from
previous offset.</span></li><li>The <a shape="rect"
href="kafka.html">Kafka</a> component has been improved to be easier to
configure and use. Notice there is a backwards incompatible change so users
need to migrate.</li><li>A topic based idempotent repository that is <a
shape="rect" href="kafka.html">Kafka</a> based for the
 <a shape="rect" href="idempotent-consumer.html">Idempotent
Consumer</a> EIP</li><li>The <a shape="rect"
href="kafka.html">Kafka</a> component will not automatic type convert the
message body to the type specified by the configured serializer (is string by
default) when sending to kafka. You can also now configure key and partitionKey
in the endpoint uri, instead of having to specify as
headers.</li><li>The <a shape="rect" href="kafka.html">Kafka</a> consumer
will now auto commit on stop to ensure the broker has the latest offset commit.
The option <code>autoCommitOnStop</code> can be configured to be
sync,async or none.</li><li>Added easy predicate parser to <a shape="rect"
href="jsonpath.html">JSonPath</a> to more easily define simple predicates
without using the more complex jsonpath notation with all the symbols to just
say price < 50</li><li>The <a shape="rect" href="box.html">Box</a>
component has been migrated to use the Box v2 Java
API as the old v1 API is going to be shutdown from summer
2017</li><li>Examples overview now generate from the source code to ensure its
up to date at <a shape="rect" class="external-link"
href="https://github.com/apache/camel/tree/master/examples#examples"
rel="nofollow">https://github.com/apache/camel/tree/master/examples#examples</a></li></ul><p>Fixed
these issues</p><ul><li>Fixed starting Camel on Oracle JDK 1.8.0_19 or lower,
which would throw an UnsupportedOperationException</li><li>Fixed running
<code>mvn camel:run</code> when using OSGi Blueprint</li><li>Fixed <a
shape="rect" href="hystrix-eip.html">Hystrix EIP</a> to also execute fallback
if execution was rejected or short-circuited or other reasons from
Hystrix. </li><li>Fixed <a shape="rect"
href="hystrix-eip.html">Hystrix EIP</a> race condition when timeout was hit and
fallback is executed could let to Camel Exchange having wrong caused
exception.</li><li>Fixed adding new routes to running C
amelContext and if the new routes would fail to startup, then before these
routes would "hang around". Now only succesful started routes are
added.</li><li>Adding or removing routes that starts from <a shape="rect"
href="undertow.html">Undertow</a> no longer restart the entire HTTP
server</li><li><a shape="rect" href="vm.html">VM</a> endpoint should prepare
exchange with the CamelContext from the consumer and not from cached endpoint
which can be different</li><li>Fixed a bug when using <a shape="rect"
href="rest-dsl.html">Rest DSL</a> with <a shape="rect"
href="servlet.html">SERVLET</a> could cause a java.io.IOException: Stream
closed exception when using <a shape="rect" href="bean.html">Bean</a> in
the route. </li><li>Fixed an issue when using <code>pipeline</code>
in Java DSL not setting up the EIP correctly which could lead to runtime route
not as intended.</li><li>Fixed <a shape="rect"
href="dropbox.html">Dropbox</a> to use <a shape="rect
" href="stream-caching.html">Stream caching</a> to avoid reading entire file
into memory so Camel can process big files</li><li>Fixed <code>toD</code>
issue with splitting uris when RAW values had + sign</li><li>Fixed adviceWith
may behave differently when using multiple advices in the same order and you
would advice on the same nodes.</li><li>Fixed <a shape="rect"
href="camel-zipkin.html">camel-zipkin</a> to be able to startup and work with
Camel XML </li><li>Fixed <a shape="rect" href="ftp2.html">FTP2</a>
readLock=changed not working (when fastFileExists=false) if no sub folder was
specified as starting directory.</li><li>Fixed <a shape="rect"
href="simple.html">Simple</a> language when using indexing with a nested
function</li><li>Fixed issue with <code>@Consume</code> not
having <code>CamelContext</code> injected and its lifecycle managed
by <code>CamelContext</code></li><li>Fixed Netty double buffer release
leak in <a shape="rec
t" href="netty4.html">Netty4</a> and <a shape="rect"
href="netty4-http.html">Netty4 HTTP</a></li></ul><h3
id="Camel2.19Release-New">New <a shape="rect"
href="enterprise-integration-patterns.html">Enterprise Integration
Patterns</a></h3><h3 id="Camel2.19Release-New.1">New <a shape="rect"
href="components.html">Components</a></h3><ul><li>camel-azure - to integrate
with Microsoft Azure Cloud services</li><li>camel-bonita - allow you to
communicate with a remote Bonita engine.</li><li>camel-couchbase - The
couchbase component allows you to treat CouchBase instances as a producer or
consumer of messages.</li><li>camel-drill - The drill component gives you
the ability to querying to Apache Drill Cluster</li><li>camel-elasticsearch5 -
to communicate with Elasticsearch Server using 5.x
APIs</li><li>camel-google-pubsub - allow you communicate with Google Cloud
Pub/Sub</li><li>camel-mongodb3 - Evolution of the component based on v3 driver.
Camel-Mongodb still exists allowing co
mpatibility with the v2 driver.</li><li>camel-openstack - allow you to
communicate with an Openstack infrastructure</li><li>camel-opentracing
- Distributed tracing using OpenTracing</li><li>camel-tika
- integrates with Apache Tika to extract content and metadata from
thousands of file types</li><li>camel-spring-cloud - integrates with
Spring Cloud</li><li>camel-spring-cloud-netflix - integrates with Spring Cloud
Netflix</li></ul><h3 id="Camel2.19Release-NewDSL">New DSL</h3><h3
id="Camel2.19Release-NewAnnotations">New Annotations</h3><h3
id="Camel2.19Release-New.2">New <a shape="rect" href="data-format.html">Data
Format</a></h3><h3 id="Camel2.19Release-New.3">New <a shape="rect"
href="languages.html">Languages</a></h3><h3 id="Camel2.19Release-New.4">New <a
shape="rect" href="examples.html">Examples</a></h3><ul><li>camel-example-reload
- To demonstrate the live reload routes from XML files when running
Camel.</li><li>camel-example-opentracing - An example showing h
ow to trace incoming and outgoing messages from Camel with
OpenTracing</li></ul><h3 id="Camel2.19Release-New.5">New <a shape="rect"
href="tutorials.html">Tutorials</a></h3><h2
id="Camel2.19Release-APIbreaking">API breaking</h2><ul><li>The groovy DSL from
camel-groovy has been moved into its own camel-groovy-dsl module. The
camel-groovy now only contains the Camel Groovy <a shape="rect"
href="language.html">Language</a></li><li>Camel-spring-LDAP now uses
java.util.function.BiFunction<L, Q, S> instead
of org.apache.camel.component.springldap.LdapOperationsFunction<Q,
S></li><li>The deprecated APIs from camel-spring-boot has been removed as
part of upgrading and supporting Spring Boot
1.5.x</li><li>The <code>getComponentDocumentation</code> method
on <code>CamelContext</code> is deprecated and returns null. The embedded
HTML documentation in all the Camel components has been removed as they are not
in use/maintained, and the JSon schema is the actual inf
ormation. Use the camel-catalog for component documentation where you can get
all the documentation in both ascii doc and html
format.</li><li>camel-mongodb-gridf schema has been renamed
from <strong>gridfs</strong> to <strong>mongodb-gridfs</strong> to
avoid confusion.</li><li>The <a shape="rect"
href="kafka.html">Kafka</a> endpoint option
<code>seekToBeginning=true</code> should be migrated
to <code>seekTo=beginning</code></li><li>The <a shape="rect"
href="kafka.html">Kafka</a> component has been improved to be easier to
configure and use. Notice there is a backwards incompatible change so users
need to migrate. The kafka uri is changed from kafka:brokers to kafka:topic. So
you need to specify the topic name in the context-path and the brokers as
parameters, eg before <code>kafka:myserver?topic=sometopic</code> is
now <code>kafka:sometopic?brokers=myserver</code></li></ul><h2
id="Camel2.19Release-KnownIssues">Known Issues</h2>
<h2 id="Camel2.19Release-Importantchangestoconsiderwhenupgrading">Important
changes to consider when upgrading</h2><ul><li>Groovy DSL and Scala DSL is
deprecated and planned to be moved to <a shape="rect" class="external-link"
href="https://camel-extra.github.io/" rel="nofollow">Camel Extra</a> and not
distributed out of the box in the future.</li><li>Camel now uses Karaf 4.x API
and therefore not possible to run on older Karaf
versions.</li><li><code>camel-blueprint</code> changed startup behavior to
start on Blueprint.CREATED event which would be more `correct` way of startup
instead of Blueprint.REGISTERED as before.</li><li>camel-spring-boot now don't
include prototype scoped beans when auto scanning for RouteBuilder instances,
which is how camel-spring works. You can turn this back using
the includeNonSingletons option.</li><li>camel-spring-javaconfig removed
from Karaf features as it was not really supported in OSGi/Karaf.</li><li>camel
spring-boot shell commands hav
e been removed as spring-boot shell has been deprecated in
spring-boot.</li><li>camel-mongodb-gridf schema has been renamed from
<strong>gridfs</strong> to <strong>mongodb-gridfs</strong> to avoid
confusion.</li><li>camel-box has been migrated to use box v2 api so there may
be some migration needed as the old camel-box component was using box v1
api</li><li>The JSon schema from camel-catalog have changed to use boolean,
integer and numeric values when applicable instead of using string values for
everything. </li><li>The camel-catalog Karaf commands has been
removed</li></ul><h2 id="Camel2.19Release-GettingtheDistributions">Getting the
Distributions</h2><h3 id="Camel2.19Release-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="conflue
nceTh"><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.19Release-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 (zip)</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><h3
id="Camel2.19Release-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-l
ink"
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>