Author: buildbot
Date: Wed Apr 26 07:20:06 2017
New Revision: 1011159
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 26
07:20:06 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
from <a shape="rect" href="cdi.html">Camel
CDI</a> configuration</li><li>Camel contexts automatic start can now be
disabled from <a shape="rect" href="cdi.html">Camel
CDI</a> configuration</li><li><a shape="rect" href="cdi.html">Camel
CDI</a> now provides support
for <span><code>TransactionErrorHandler</code>
and <span><code>TransactionPolicy</code> via
JTA</span></span></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.htm
l">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><li>Added
declarative <a shape="rect" class="external-link"
href="https://github.com/apache/camel/blob/master/came
l-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="external-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="e
xternal-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="rect"
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 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>&#
160;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="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-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 co
mponent 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> server 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 fi
les 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">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>Ca
melContext</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 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 Kafka endpoint option
bridgeEndpoint has moved from endpoint to the KafkaConfiguration class so all
options are together.</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 to 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 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 rem
oved 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="confluence
Th"><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">
+<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 in a future
release</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 m
aven 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>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
from <a shape="rect" href="cdi.html">Camel
CDI</a> configuration</li><li>Camel contexts automatic start can now be
disabled from <a shape="rect" href="cdi.html">Camel
CDI</a> configuration</li><li><a shape="rect" href="cdi.html">Camel
CDI</a> now provides support
for <span><code>TransactionErrorHandler</code>
and <span><code>TransactionPolicy</code> via
JTA</span></span></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="no
ne"></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><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="external-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"
clas
s="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="rect"
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-circuite
d 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 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 w
hen 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-digitalocean - The digitalocean component
allows you to interact with the Digitalocean c
loud</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-grpc - The gRPC
component is using for calling remote procedures via HTTP/2</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-olingo4 - Communicates with OData 4.0 services using
Apache Olingo OData API.</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> server 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="language
s.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">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 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 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 Kafka endpoint option
bridgeEndpoint has moved from endpoint t
o the KafkaConfiguration class so all options are
together.</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 to 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 ins
tall 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 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 th
e 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 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><t
h 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/a
pache-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-GettingtheBinariesusingMave
n2">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"><