Since we're on a major migration process of this website, some component documents here are out of sync right now. In the meantime you may want to look at the asciidoc in the repository:
https://github.com/apache/camel/blob/master/README.md
https://github.com/apache/camel/blob/master/components/readme.adoc

Camel 2.15.0 release

New and Noteworthy

Component, data format, language and eip documentation now included in the built component JARs. And Java API and JMX API to access that documentation. And APIs to explain an endpoint uri, eip configuration and what all those configured options mean. In other words the same level of complete documentation of your Camel apps at both design and runtime, accessible from Java / JMX and tooling.

Component, data format, language and eip can now have associated label(s) which are used for grouping components into: core, database, messaging, http, rest, etc.

The XML DSL schema now include documentation

Provide Configurer for user to configure the CXF conduit and CXF destination from Java code

Added a DelegateEndpoint interface into Camel API

Support to setup the SslContextParameters in the camel-restlet component

Camel Using PropertyPlaceholder now supports not having to define a PropertiesComponent if all the placeholder keys has default values which are to be used (less configuration needed in those situations).

Camel Using PropertyPlaceholder now supports 3rd party functions to lookup the property values, this allow end users to implement their own logic - we provide 3 out of the box functions to lookup values from OS environment variable, JVM system properties, or the service name idiom.

RabbitMQ now pools Channels for the producer to avoid sharing same Channel among concurrent producers which are not recommended by RabbitMQ client.

Camel commands is now reusable outside Apache Karaf as a base by the commands-core module.

Camel commands using Jolokia for remote communication by the commands-jolokia module.

More minor processors such as setHeader, removeHeader, removeHeaders and ditto for properties is now also enlisted in JMX under processors.

Optimized usage of type conversion during routing reducing the number of attempts needed.

Optimized CaseInsentiveMap used as message headers to use a single map instead of two and yield less memory overhead and performance

Asynchronous routing engine that are forced to block threads now exposes this using a manager that offers runtime insight using JMX. And as well attempts to free blocked threads during graceful shutdown, to avoid any threads hanging in the JVM.

Swagger now supports any kind of runtime environment, as only JMX being enabled is required.

Inflight repository now allows to browse the current inflight exchanges to obtain information where these exchanges are inflight and for how long. Expose this information in JMX and Camel commands as well.

Graceful Shutdown now logs information about the inflight exchanges that are still present during shutdown and a timeout was hit.

DefaultClassLoader now fallback and use the application context classloader that may have been set on CamelContext to better be able to load classes/resources from classpath in different runtime environments.

Camel JMX now includes current inflight exchanges at processor level, which means we can have a complete breakdown where exchanges are, and as well from the improved InflightRegistry which has APi and JMX api to browse the current inflight with details of the exchange and processing times etc.

Support for Jetty 9 using the new camel-component-jetty9 module.

The EndpointRegistry now stores endpoints in two caches; a static unbounded cache to keep endpoints for their lifetime, and a dynamic limited cache to keep only the recently used endpoints.

Endpoint's used by routes are kept in the static cache of the EndpointRegistry as long as the lifetime of the routes.

Removing a route now also remove its static Endpoint's from the EndpointRegistry (if those endpoints are not shared and used by other routes). Mind that any dynamic endpoint created during routing from dynamic EIPs such as recipient list, routing slip, dynamic router etc, are not removed from the EndpointRegistry when the route is removed.

Dead Letter Channel now logs a WARN if a new exception occurred while it was attempting to process the dead letter message. The new exception will by default be handled so the Dead Letter Channel always complete succesfull. The new option deadLetterHandleNewException can be set to false to turn this off.

Configuring endpoint uris in XML DSL now allow to specify the uri attribute using multiple lines; this can make it more readable when having very long uris. Notice only the uri attributes support this.

Configuring endpoint uris in XML DSL now allow to specify endpoint options using <property> bean style in the <endpoint> configuration; this can make it more readable when having very long uris.

Using custom Jackson modules is easier with the Jackson JSON data format.

Enabling and disabling features using Jackson data format is easier from both Java and XML DSL.

Some HTTP producer now allows GET operations with message body (though a bit unusual to do)

Aggregate EIP now supports letting the AggregationStrategy determine if the current group is complete by returning a boolean property on the returned exchange.

camel-cdi supports CDI 1.0 onwards now.

Fixed issues

Fixed processors was not enlisted in JMX when routes was transacted.

Fixed the NullPointerException when using CXF endpoint with enrich

Fixed the endpointProperty of restConfiguration doesn't work issue

Fixed the issue that CircuitBreakerLoadBalancer fails on async processors

Fixed potential issue with pollEnrich not triggering error handler if an exception was thrown in the polling.

Fixed a memory leak if using Dynamic Router that loops many times, and uses any of convertBodyTo or setBody or transform in the loop, causing memory to stack up until the Exchange is done.

Fixed and improved how Bean component and Simple language invoking beans detect methods that are overridden, and able to filter and apply this as a single method, to be invoked. Avoids AmbiguousMethodCallException being thrown.

Fixed a thread leak if restarting routes using stop/start and the routes is a scheduled poll consumer, such as file/ftp components.

Using ?exchangePattern=InOnly or InOut in endpoint uris now take precedence as the pattern in use when sending to the endpoint, using to/recipient list.

Mail component no longer includes headers starting with Camel in their keys, as those are consider internal headers and should not be included in the sent emails.

Fixed readLock=fileLock on the file component

Fixed Stomp not detecting failure when sending, but was assuming a send always succeeded

Fixed MQTT sending to broker being more resilient and automatic ensure re-connection when connection failures

Fixed sending to FTP may cause the producer to hang in an endless reconnection attempt if the socket connection is dead. (Use soTimeout=10000 or some positive value to potential mitigate this in older releases).

Wire Tap and Multicast (in parallel mode) EIPs now copies the message body if its Stream caching based - this allows concurrent threads to work individually using their own copy of the stream, to have reliable access to the body.

New DSL

New Annotations

Known Issues

The camel-cxf feature doesn't install the required camel-spring feature by default. Therefore, you have to install it separately before: 'features:install camel-spring'

The camel-swagger feature doesn't install the required scala-reflect bundle by default. Therefore, you have to install it separately before: 'install -s mvn:org.scala-lang/scala-reflect/2.10.4'

Dependency Upgrades

AWS-Java-SDK 1.8.3 to 1.8.9.1

Codahale Metrics 3.0 to 3.1

CXF 3.0.2 to 3.0.4

Hazelcast 3.3.2 to 3.4

JAXB 2.2.7 to 2.2.11

JRuby 1.7.16 to 1.7.18

Guava 17.0 to 18.0

Jsch 0.1.50 to 0.1.51

JsonPath 1.1.0 to 1.2.0

Spring 4.0.7.RELEASE to 4.1.5.RELEASE

Spring Security 3.1.7.RELEASE to 3.2.5.RELEASE

RX Java 0.20 to 1.0.5

Disruptor 3.3.0 to 3.3.2

... and many other upgrades

Important changes to consider when upgrading

Spring 4.1.x is now the default out of the box Spring version.

Unit testing with Spring 4.0.x requires using camel-test-spring40, as camel-test-spring is for Spring 4.1 or better.

Remember to add @BootstrapWith(CamelTestContextBootstrapper.class) if upgrading from Spring 3.x or 4.0.x to Spring 4.1 onwards, and using the camel-test-spring module.

XSLT component now require configuring transformerFactory using URIs with the #syntax to refer to a bean. Just like any other component would do.

Slight refactor in camel-metrics component which may affect users who are using the java endpoint types instead of configuring using uris

camel-csv upgraded to Commons CSV 1.x which has a different API than the old 0.x version. End users may need to adjust their code.

camel-sjms has been refactored a bit to further harden this component. End users may need to adjust their code.

The simple function properties:locations:key has been renamed to properties-location:locations:key, as it would clash with the new functionality to specify a default value after the key name, eg properties:key:default

Removed the backlog tracer commands from the Karaf Camel commands as they are not suitable for a CLI environment

The need for runtime specific servlets in Swagger has been removed, and instead just use the default servlet which is provided out of the box.

org.apache.camel.spi.InflightRepository now includes additional methods for browsing in-flight exchanges.

Using ?exchangePattern=InOnly or InOut in endpoint uris now take precedence as the pattern in use when sending to the endpoint, using to/recipient list.

DefaultClassLoader now fallback and use the application context classloader that may have been set on CamelContext to better be able to load classes/resources from classpath in different runtime environments.

Mail component no longer includes headers starting with Camel in their keys, as those are consider internal headers and should not be included in the sent emails.

Removing a route now also remove its static Endpoint's from the EndpointRegistry (if those endpoints are not shared and used by other routes). Mind that any dynamic endpoint created during routing from dynamic EIPs such as recipient list, routing slip, dynamic router etc, are not removed from the EndpointRegistry when the route is removed.

All boolean isFoo methods on the model classes has been removed to ensure the model has consistent java bean getter/setter style with exactly one getter and one setter of the same type.

The exchange property language has been renamed from property to exchangeProperty to avoid ambiguity, confusion and clash with properties as a general term. So use exchangeProperty instead of property.

The delay option in SNMP has changed from using seconds to millis as time unit.

Routing starting from a Bean endpoint is not supported (which wasnt really intended anyway), instead start with a scheduler and use to bean instead.

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 FireFox