You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@camel.apache.org by bu...@apache.org on 2017/04/12 13:19:21 UTC
svn commit: r1010328 - in /websites/production/camel/content:
cache/main.pageCache camel-219-release.html
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>