Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Wiki Markup
h1. Camel 2.7.0 release (currently 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.7.0 release which approx XXX issues resolved (new features, improvements and bug fixes such as...)

{info:title=Dependency changes}
The Camel 2.7.0 release has a number of major dependency changes:
- JDK 1.6+ is now required
- Spring 3.x+ is now required if using Spring
- [slf4j|http://www.slf4j.org/] is used as logger instead of commons logging

In other words support for JDK 1.5 and Spring 2.x has been dropped.
{info}

* Switched to use [slf4j|http://www.slf4j.org/] as the logger instead of commons logging.
* Camel now checks state of {{Service}} during starting/stopping the [Lifecycle] of the {{Service}}. This avoids double starting/stopping in case the service was already in the desired state.
* Added support for [MDC logging] with Camel
* [JMS] consumer now eager checks if Camel is shutting down and signals that to its {{DefaultMessageListenerContainer}} which avoids trying to re-connect/failover during shutdown.
* Introduced option to automatic [Mock] endpoints during testing. This makes testing without having to add [Mock] endpoints in your routes a breeze. See more details at [Mock] component documentation.
* Added {{assertPeriod}} option to [Mock] endpoint, which is a period im milliseconds, that the [Mock] will pause and then re-assert itself to ensure the assertion is still valid. This can be used as a threshold when testing with expectations that *exactly* a given number of messages should arrive on the [Mock] endpoint.
* Added {{arrives}} DSL to [Mock] endpoint to allow you to setup expectations about timespan between messages arriving on the [Mock] endpoint. See more details at [Mock] component documentation.
* [HTTP4] is upgraded to use Apache HttpClient 4.1
* Fixed an issue with [File|File2] consumer having absolute starting directory and using absolute paths in the {{move}} option as well
* Fixed concurrent append to the same file in the [File|File2] producer
* Fixed issue with restarting [Quartz] causing a failure due trigger name already exists issue for stateful jobs.
* Its now possible to use multiple QuartzScheduler's when deploying multiple Camel applications in the same JVM classloader.
* [Quartz] update checker is now always disabled, see more [details here|http://forums.terracotta.org/forums/posts/list/3395.page#19058] 
* Fixed potential issue installing {{camel-ftp}} feature in Apache ServiceMix
* New JdbcMessageIdRepository for the idempotent consumer EIP in [SQL|SQL Component]
* Relaxed how aggressive Camel was registering services as MBeans in JMX. Now Camel will by default only registeres MBeans when starting [CamelContext] or starting new routes. This avoids registering too many MBeans if using dynamic [EIP] patterns such as [Recipient List] using different endpoint urls, causing new endpoints and its associated services to be registered in JMX. This would keep growing over time and consume memory as well. You can use the {{registerAlways}} or {{registerNewRoutes}} options on {{ManagementAgent}} to control this behavior. See [Camel JMX] for more details. 

h3. New [Enterprise Integration Patterns]

* None

h3. New [Components]

* None

h3. New DSL

* None

h3. New Annotations

* None

h3. New [Data Formats|Data Format]

* None

h3. New [Languages]

* None

h3. New [Examples]

* {{camel-example-osgi-rmi}}

h3. New [Tutorials]

* None

h2. API breaking

* {{FATAL}} has been removed from {{org.apache.camel.LoggingLevel}}. Use {{ERROR}} instead.
* {{org.apache.camel.processor.Logger}} has been renamed to {{org.apache.camel.processor.CamelLogger}}, and it now uses [slf4j|http://www.slf4j.org/] as the logger.
* Removed {{getLeftValue}} and {{getRightValue}} methods on {{BinaryPredicate}}.

h2. Known Issues

* The [Tracer] may not output all details for some situations such as when using {{onCompletion}} or {{intercept}} etc.
* Not all [Examples] have ANT build.xml files to run the example using ANT.
* Project cannot be fully build using Maven 3.0
* {{camel-script}} which uses {{ScriptEngineManager}} from the JDK, cannot load script engines from packages outside the JDK.
* Stopping a route after using {{adviceWith}} maybe cause issues with error handlers, see [CAMEL-3534|https://issues.apache.org/jira/browse/CAMEL-3534]

h2. Important changes to consider when upgrading

* Java 1.6 or better is required
* Spring 3.0.x or better is required, when using Spring
* Apache CXF 2.3.2 or better is required, when using CXF
* Switched to use [slf4j|http://www.slf4j.org/] as the logger instead of commons logging. That means you may have to included {{slf4j-log4j12}} as dependency if you are using log4j.
  See documentation at [slf4j|http://www.slf4j.org/] for more details.
* If you have developed custom Camel [Component]s and your {{Endpoint}} class extends {{DefaultEndpoint}} then its advised to use the {{doStart}} and {{doStop}} instead of {{start}} and {{stop}}.
* camel-cxf endpoint will copy the attachments between the camel message and cxf message when it works in POJO data format, please access the attachment objects from the camel message body.

h2. Getting the Distributions

h3. Binary Distributions

|| Description || Download Link || PGP Signature file of download ||
| Windows Distribution | [apache-camel-2.7.0.zip|http://www.apache.org/dyn/closer.cgi/camel/apache-camel/2.7.0/apache-camel-2.7.0.zip] | [apache-camel-2.7.0.zip.asc|http://www.apache.org/dist/camel/apache-camel/2.7.0/apache-camel-2.7.0.zip.asc] |
| Unix/Linux/Cygwin Distribution | [apache-camel-2.7.0.tar.gz|http://www.apache.org/dyn/closer.cgi/camel/apache-camel/2.7.0/apache-camel-2.7.0.tar.gz] | [apache-camel-2.7.0.tar.gz.asc|http://www.apache.org/dist/camel/apache-camel/2.7.0/apache-camel-2.7.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.7.0-src.zip|http://www.apache.org/dyn/closer.cgi/camel/apache-camel/2.7.0/apache-camel-2.7.0-src.zip] | [apache-camel-2.7.0-src.zip.asc|http://www.apache.org/dist/camel/apache-camel/2.7.0/apache-camel-2.7.0-src.zip.asc] |

| Source for Unix/Linux/Cygwin | [apache-camel-2.7.0-src.tar.gz|http://www.apache.org/dyn/closer.cgi/camel/apache-camel/2.7.0/apache-camel-2.7.0-src.tar.gz] | [apache-camel-2.7.0-src.tar.gz.asc|http://www.apache.org/dist/camel/apache-camel/2.7.0/apache-camel-2.7.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.7.0</version>
</dependency>
{code}

h3. SVN Tag Checkout

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

h2. Changelog

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