Author: buildbot
Date: Wed Apr 12 13:19:21 2017
New Revision: 1010328
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 Apr 12
13:19:21 2017
@@ -91,7 +91,7 @@
<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>All the Camel Spring Boot starter components now has more of the
components default values included in their metadata which allows tooling to
display such information</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"
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 c
all 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" 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
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 comple
x 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><li>Added
declarative <a shape="rect" class="external-link"
href="https://github.com/apache/camel/blob/master/camel-core/src/main/docs/transformer.adoc"
rel="nofollow">Transformer</a> and <a shape="rect" class="external-link"
href="https://github.com/apache/camel/blob/master/camel-core/src/main/docs/validator.adoc"
rel="nofollow">Validator</a> which performs transformation/validation
according to the data type information declared on a route by <a shape="rect"
class="ex
ternal-link"
href="https://github.com/apache/camel/blob/master/camel-core/src/main/java/org/apache/camel/model/InputTypeDefinition.java"
rel="nofollow">inputType</a> and/or <a shape="rect" class="external-link"
href="https://github.com/apache/camel/blob/master/camel-core/src/main/java/org/apache/camel/model/OutputTypeDefinition.java"
rel="nofollow">outputType</a>. There're a few examples demonstrates this
feature: <a shape="rect" class="external-link"
href="https://github.com/apache/camel/tree/master/examples/camel-example-transformer-blueprint"
rel="nofollow">camel-example-transformer-blueprint</a>, <a shape="rect"
class="external-link"
href="https://github.com/apache/camel/tree/master/examples/camel-example-transformer-cdi"
rel="nofollow">camel-example-transformer-cdi</a>, <a shape="rect"
class="external-link"
href="https://github.com/apache/camel/tree/master/examples/camel-example-transformer-demo"
rel="nofollow">camel-example-transformer-demo</a>, and <a shape="re
ct" class="external-link"
href="https://github.com/apache/camel/tree/master/examples/camel-example-validator-spring-boot"
rel="nofollow">camel-example-validator-spring-boot</a></li><li>Added query
support for <a shape="rect" href="jpa.html">JPA</a> Producer</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 CamelContext and if the
new routes would fail to startup, then before these routes woul
d "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
memo
ry 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="rect" href="netty4.html">Netty4</a> and <a
shape="rect" href="netty4-http.html">Nett
y4 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-digitalocean - The digitalocean component
allows you to interact with the Digitalocean cloud</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-milo - An OPC UA client and server component based
on Eclipse Milo</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-rest-swagger - for accessing REST resources using <a
shape="rect" class="external-link" href="http://swagger.io/"
rel="nofollow">Swagger</a> specification as configuration</li><li>camel-tika
- integrates with Apache Tika to extract content and metadata from
thousands of file types</li><li>camel-sjms2 - JMS 2.0 api compatible component
of the <a shape="rect" href="sjms.html">SJMS</a>
component.</li><li>camel-spring-cloud - integrates with Spring
Cloud</li><li>camel-spring-cloud-netflix - integrates with Spring Cloud
Netflix</li><li>camel-zendesk - interacts with <a shape="rect"
class="external-link" href="https://www.zendesk.com/"
rel="nofollow">Zendesk</a> serv
er with using <a shape="rect" class="external-link"
href="https://developer.zendesk.com/rest_api/docs/api-clients/java"
rel="nofollow">Zendesk Java Client</a></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-rest-swagger - Demonstrates the usage of REST
Swagger component as a generic Swagger client</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">Tutoria
ls</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 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-grid
f schema has been renamed
from <strong>gridfs</strong> to <strong>mongodb-gridfs</strong> to
avoid confusion.</li><li>The commands-core has the Catalog commands
removed</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><li><span
style="font-family: monospace;">The <a shape="rect"
href="infinispan.html">Infinispan</a> uri syntax has changed from
infinispan:hostName?options t
o infinispan:cacheName?options</span></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 Kar
af 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 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="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.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 proj
ect, 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">
+<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>All the Camel Spring Boot starter components now has more of the
components default values included in their metadata which allows tooling to
display such information</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"
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 c
all 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" 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
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 comple
x 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><li>Added
declarative <a shape="rect" class="external-link"
href="https://github.com/apache/camel/blob/master/camel-core/src/main/docs/transformer.adoc"
rel="nofollow">Transformer</a> and <a shape="rect" class="external-link"
href="https://github.com/apache/camel/blob/master/camel-core/src/main/docs/validator.adoc"
rel="nofollow">Validator</a> which performs transformation/validation
according to the data type information declared on a route by <a shape="rect"
class="ex
ternal-link"
href="https://github.com/apache/camel/blob/master/camel-core/src/main/java/org/apache/camel/model/InputTypeDefinition.java"
rel="nofollow">inputType</a> and/or <a shape="rect" class="external-link"
href="https://github.com/apache/camel/blob/master/camel-core/src/main/java/org/apache/camel/model/OutputTypeDefinition.java"
rel="nofollow">outputType</a>. There're a few examples demonstrates this
feature: <a shape="rect" class="external-link"
href="https://github.com/apache/camel/tree/master/examples/camel-example-transformer-blueprint"
rel="nofollow">camel-example-transformer-blueprint</a>, <a shape="rect"
class="external-link"
href="https://github.com/apache/camel/tree/master/examples/camel-example-transformer-cdi"
rel="nofollow">camel-example-transformer-cdi</a>, <a shape="rect"
class="external-link"
href="https://github.com/apache/camel/tree/master/examples/camel-example-transformer-demo"
rel="nofollow">camel-example-transformer-demo</a>, and <a shape="re
ct" class="external-link"
href="https://github.com/apache/camel/tree/master/examples/camel-example-validator-spring-boot"
rel="nofollow">camel-example-validator-spring-boot</a></li><li>Added query
support for <a shape="rect" href="jpa.html">JPA</a> Producer</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 CamelContext and if the
new routes would fail to startup, then before these routes woul
d "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
memo
ry 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="rect" href="netty4.html">Netty4</a> and <a
shape="rect" href="netty4-http.html">Nett
y4 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-digitalocean - The digitalocean component
allows you to interact with the Digitalocean cloud</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-milo - An OPC UA client and server component based
on Eclipse Milo</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-rest-swagger - for accessing REST resources using <a
shape="rect" class="external-link" href="http://swagger.io/"
rel="nofollow">Swagger</a> specification as configuration</li><li>camel-tika
- integrates with Apache Tika to extract content and metadata from
thousands of file types</li><li>camel-sjms2 - JMS 2.0 api compatible component
of the <a shape="rect" href="sjms.html">SJMS</a>
component.</li><li>camel-spring-cloud - integrates with Spring
Cloud</li><li>camel-spring-cloud-netflix - integrates with Spring Cloud
Netflix</li><li>camel-zendesk - interacts with <a shape="rect"
class="external-link" href="https://www.zendesk.com/"
rel="nofollow">Zendesk</a> serv
er with using <a shape="rect" class="external-link"
href="https://developer.zendesk.com/rest_api/docs/api-clients/java"
rel="nofollow">Zendesk Java Client</a></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-rest-swagger - Demonstrates the usage of REST
Swagger component as a generic Swagger client</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">Tutoria
ls</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 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-grid
f schema has been renamed
from <strong>gridfs</strong> to <strong>mongodb-gridfs</strong> to
avoid confusion.</li><li>The commands-core has the Catalog commands
removed</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><li><span
style="font-family: monospace;">The <a shape="rect"
href="infinispan.html">Infinispan</a> uri syntax has changed from
infinispan:hostName?options t
o infinispan:cacheName?options</span></li></ul><h2
id="Camel2.19Release-KnownIssues">Known Issues</h2><h2
id="Camel2.19Release-Importantchangestoconsiderwhenupgrading">Important changes
to consider when upgrading</h2><ul><li>camel-spring-dm has been disabled from
the karaf features file so users cannot install it out of the box as it does
not work properly. camel-spring-dm has been deprecated for a long time and
users are encouraged to use osgi blueprint instead. The JAR is still shipped
and can be installed manually but then you are on your own. The JAR will be
removed completed in a future release.</li><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 beha
vior 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 using string values f
or 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="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 mirr
or 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-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>