View Source

h1. Camel 2.1.0 release (Work in Progress)

{div:style=padding-right:20px;float:left;margin-left:-20px;}
!http://camel.apache.org/download.data/camel-box-v1.0-150x200.png!
{div}
{div:style=min-height:200px}
{div}

h2. New and Noteworthy

Welcome to the 2.1.0 release which approx XXX issues resolved (new features, improvements and bug fixes such as...)

* Pluggable API for Management allowing 3rd party to manage Camel.
** Use {{org.apache.camel.spi.ManagementStrategy}} to plugin 3rd party adapter
** Fine grained events notifications is now being emitted using {{org.apache.camel.spi.EventNotifier}}
** Events being fired can be created using a pluggable factory using {{org.apache.camel.spi.EventFactory}}
** Camel now supports using multiple {{org.apache.camel.spi.LifecycleStrategy}} strategies, that also allows 3rd party to more easily integrate into Camel.
* Overhaul of default [JMX management|Camel JMX] in Camel to be much improved with more attributes, mbeans, operations, statistics, and route timing working as well.
** And yes you can now start/stop routes and individual consumers and producers
** And some special processors such as [Delayer] and [Throttler] can be managed to change their delay/throttle values
** You can dynamic manage [tracing|Tracer] even for already running applications
** [Error handling in Camel] is now also manageable so you for example can change the redelivery policies.
** [JMS] consumers being restarted will pickup any configuration changes on JMS endpoints such as changing {{concurrentConsumers}}. And yes its fully managed using JMX.
** Number of inflight exchanges per consumer, route and totally per camel context.
** And much more...
* Improved [Irc], [Xmpp], [Mina], [CXF] and [Freemarker] components with much thanks to the Camel community
* Added classLoader set and get method in the CamelContext to make Camel work better in the Container.
* Now Camel Karaf features are validated with the Karaf plugin.
* [camel-cxf|CXF] beans component supports JAXWS beans.
* camel-cxf MTOM attachment supports in Payload mode.
* camel-cxf endpoint no longer requires the "serviceClass" option or Service Endpoint Interface (SEI) in Payload mode.&nbsp; It means only WSDL is needed but the intended port and service name in the WSDL must be provided for the camel-cxf endpoint.
* [Velocity] component supports to take the Velocity configuration by using propertiesFile option.
* [Splitter] and [Multicast] EIP patterns now support the option {{stopOnException}} to stop continue processing at first exception occurred. See their documentation for more details.
* [Error handlers|Error handling in Camel] is restricted to be configured on camel context and/or routes only.
* Camel is now more robust and fault tolerant when shutting down.
* Fixed a race condition when shutting down Camel with [JMS] consumers that under some circumstances caused it to appear to hang
* Added pluggable {{org.apache.camel.spi.InflightRepository}} with a basic implementation that can help with graceful shutdown as you can now see how many exchanges are currently in progress.
* [JmsEndpoint|JMS] is now singleton
* Individual routes can be [pre configured to not auto startup|Configuring route startup ordering and autostartup] when Camel starts: {{autoStartup=false}} in XML DSL and {{noAutoStartup()}} in Java DSL.
* Camel is more robust on startup as route inputs are deferred to be started at the very end, ensuring all routes services have been pre started and thus ready when consumers is started.
* Improved unit test coverage, now having more than 4000 unit tests in total.
* Fixed {{ConsumerTemplate}} not working when it was dependency injected with {{@EndpointInjected}} in a [Bean].
* Using IBM special JMS headers now work when sending messages to IBM WebSphere MQ. IBM special headers uses this prefix: {{JMS_IBM\_}}.
* The [ordering of which routes should be started|Configuring route startup ordering and autostartup] can now be configured by the {{startupOrder}} attribute which defines a number. Lowest number is started first.
* And {{autoStartup}} is also supported on [CamelContext] itself where it replaces the {{shouldStartContext}} option, which have been removed.
* The [File|File2] component handles renaming and deleting files on Windows better as Windows could block files. Also Antivirus software could causes files to be blocked.
* Fixed issues using {{tempPrefix}} option with the [File|File2] in case of clashes with existing files. The same goes for the {{localWorkDirectory}} option on the [FTP|FTP2] component which could have a similar issue.
* Optimized [XPath] to allow thread safe concurrency which greatly reduces contention.
* Camel works better with Google App Engine
* The [Bean] component is better at choosing the best method. If given a method name it will only pick among methods with such a name.
* The [Bean] component is now also more strict as it *must* be able to convert to all the parameter types. Was to lenient before by passing in {{null}} instead, when conversion was not successful.
* Fixed an issue with setting global error handling in Spring XML not always working
* Camel [adds properties|Dead Letter Channel] to [Exchange] when sending to endpoints. This is useable with [Dead Letter Channel] where we can use this to know which [Endpoint] failed.
* Improved file operations on Windows platform to retry in case of issues.
* Fixed issue with {{replyTo}} option on [JMS] consumers which wasn't working.
* Fixed issue with using <camel:proxy> not working
* Improved {{<camel:proxy>}} so its easier to work with out of the box. It leverages Camels type converter mechanism to adapt to the interface. Also proxied methods with a single parameter turns that parameter value into the message body.
* Added document for using [Camel proxy|Using CamelProxy].
* Improved {{enrich}} and {{pollEnrich}} with reference lookup of endpoints and aggregation strategy.
* Added {{markRollbackOnly}} attribute on {{<rollback>}} to only mark the [Exchange] for rollback. This allows you to set a custom reply message. Previously a {{RollbackExchangeException}} was always set which causes Camel to thrown an exception to the client. This also works with {{transacted}} routes as well.
* Camel now logs on shutdown whether there was in flight exchanges or not. All together we are getting closer to having graceful shutdown supported in Camel.
* {{@Bean}} is now easier to use at you define {{ref}} and {{method}} instead of one combined value.
* Introduced {{routeId}} in the Java DSL to set the id of the route. Prefer to use this over {{id}}.

h3. New [Enterprise Integration Patterns]

h3. New [Components]

* [camel-printer|Printer]
* [camel-cache|Cache]
* [camel-snmp|SNMP]
* [camel-javaspace|Javaspace]

h3. New DSL

h3. New Annotations

h3. New [Data Formats|Data Format]

h3. New [Languages]

h3. New [Examples]

* [Management Example]
* camel-example-route-throttling

h2. API breaking

h3. DSL changes

In the Java DSL the {{.errorHandler}} is now restricted to be configured on camel context and/or routes only. That means for configuring on routes you have to set it directly after the {{.from}} DSL.

In Spring DSL the {{errorHandlerRef}} attribute is now only visible on the {{<camelContext>}} and {{<route>}} XML tags.

h3. New .jar dependencies

camel-core now depends on commons-management.jar to facilitate the new overhauled management.
This project is hosted at [FuseForge|http://commonman.fusesource.org/]

This .jar can be retrieved from the maven central repo at: [http://repo1.maven.org/maven2/org/fusesource/commonman/commons-management/1.0/]
The maven dependency details are:
{code}
 <groupId>org.fusesource.commonman</groupId>
 <artifactId>commons-management</artifactId>
 <version>1.0</version>
{code}

h3. Core API

h4. CamelContext

CamelContext have renamed the method {{getLifecycleStrategy}} to {{getLifecycleStrategies}} and now returns a List.

h4. Exchange

The exchange id has been changed to use the {{java.util.UUID}} instead. This allows Camel to run on Google App Engine.

h4. Management

The API in {{org.apache.camel.spi.ManagementNamingStrategy}} had its methods renaming and method signature adjusted to accommodate the big theme for Camel which was overhaul of management (JMX).

h3. Client API

h3. Removed classes

* {{org.apache.camel.processor.CompositeProcessor}} was never used
* {{org.apache.camel.impl.ProducerTemplateProcessor}} was never used
* {{org.apache.camel.impl.NoPolicy}} was never used
* {{org.apache.camel.spring.handler.LazyLoadingBeanDefinitionParser}} was never used
* {{org.apache.camel.spring.handler.ScriptDefinitionParser}} was never used
* {{org.apache.camel.spring.remoting.SendBeforeInterceptor}} was never used
* {{org.apache.camel.spring.spi.SpringConverters}} was never used

h3. Moved classes

* {{org.apache.camel.PollingConsumerPollStrategy}} is moved to {{org.apache.camel.spi.PollingConsumerPollStrategy}}

h3. Removed methods

* {{getSingletonEndpoints}} method have been removed from various classes in the {{camel-test}} component.

h3. Removed in Spring XML

The option {{shouldStartContext}} on <camelContext> have been removed. Its replaced with {{autoStartup}} which you can read more about here [Configuring route startup ordering and autostartup].

h3. @Bean

@Bean now uses a {{ref}} attribute to refer to the bean name. Also added a new {{method}} attribute to set the method to use (optional).
You need to upgrade your code to use these attributes as the default {{value}} have been removed. We assume only a very few people knew and uses this @Bean annotation.

h2. Known Issues

See known issues from previous releases.

h2. Important changes to consider when upgrading

h2. Getting the Distributions

h3. Binary Distributions

|| Description || Download Link || PGP Signature file of download ||
| Windows Distribution | [apache-camel-2.1.0.zip|http://www.apache.org/dyn/closer.cgi/activemq/apache-camel/2.1.0/apache-camel-2.1.0.zip] | [apache-camel-2.1.0.zip.asc|http://www.apache.org/dist/activemq/apache-camel/2.1.0/apache-camel-2.1.0.zip.asc] |
| Unix/Linux/Cygwin Distribution | [apache-camel-2.1.0.tar.gz|http://www.apache.org/dyn/closer.cgi/activemq/apache-camel/2.1.0/apache-camel-2.1.0.tar.gz] | [apache-camel-2.1.0.tar.gz.asc|http://www.apache.org/dist/activemq/apache-camel/2.1.0/apache-camel-2.1.0.tar.gz.asc] |
{info:title=The above URLs use redirection}
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|http://www.mozilla.com/en-US/firefox/]
{info}

h3. Source Distributions

|| Description || Download Link || PGP Signature file of download ||
| Source for Windows | [apache-camel-2.1.0-src.zip|http://www.apache.org/dyn/closer.cgi/activemq/apache-camel/2.1.0/apache-camel-2.1.0-src.zip] | [apache-camel-2.1.0-src.zip.asc|http://www.apache.org/dist/activemq/apache-camel/2.1.0/apache-camel-2.1.0-src.zip.asc] |

| Source for Unix/Linux/Cygwin | [apache-camel-2.1.0-src.tar.gz|http://www.apache.org/dyn/closer.cgi/activemq/apache-camel/2.1.0/apache-camel-2.1.0-src.tar.gz] | [apache-camel-2.1.0-src.tar.gz.asc|http://www.apache.org/dist/activemq/apache-camel/2.1.0/apache-camel-2.1.0-src.tar.gz.asc] |

h3. Getting the Binaries using Maven 2

To use this release in your maven project, the proper dependency configuration that you should use in your [Maven POM|http://maven.apache.org/guides/introduction/introduction-to-the-pom.html] is:
{code:xml}
<dependency>
  <groupId>org.apache.camel</groupId>
  <artifactId>camel-core</artifactId>
  <version>2.1.0</version>
</dependency>
{code}

h3. SVN Tag Checkout

{code}
svn co http://svn.apache.org/repos/asf/camel/tags/camel-2.1.0
{code}

h2. Changelog

For a more detailed view of new features and bug fixes, see the:
TODO: Fix for 2.1.0
* [release notes for 2.1.0|http://issues.apache.org/activemq/secure/ReleaseNote.jspa?projectId=11020&styleName=Html&version=11900]