Page History

h1. Camel 2.3.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.3.0 release which approx XXX issues resolved (new features, improvements and bug fixes such as...)

* [Property placeholders|Using PropertyPlaceholder] in for example endpoint uris is not natively supported in *camel-core* which means you no long need to use Spring for that. It works therefore in any environment as its provided out of the box in camel-core.
* [Property placeholders|Using PropertyPlaceholder] also works in the <CamelContext> when using Spring XML. Basically nearly all places where you enter text the property placeholder is supported.
* Added {{ExchangeSentEvent}} to {{EventNotifier}} which contains time taken and is emitted when an [Exchange] is sent to an [Endpoint]. This allows end users to easily gather performance stats for [Exchange] send to endpoints.
* Added {{disconnect}} option to [Mina] to close Mina session right after usage. 
* [Jetty] now supports to get the {{HttpServletRequest}} and {{HttpServletResponse}} from the [Message] header.
* [XPathBuilder|XPath] now supports being used without an [Exchange] which allows you to use it in a custom/generic fashion.
* [XPath] now supports using the JVM system property specifying a custom {{XPathFactory}} to be used. You can use this to switch from default to use e.g. Saxon. 
* [XSLT] now supports using {{<xsl:include>}} where the files is loaded from classpath, and being able to load relative according to the endpoint configured location. See the wiki page for details. 
* [Aggregator] the {{completionPredicate}} is now being evaluated _on-the-fly_ which allows it to trigger before the {{batchTimeout}}.
* [File|File2], [FTP|FTP2] added option {{eagerDeleteTargetFile}} to control the behavior when using {{tempFile}} whether or not to eagerly delete the target file or wait until last moment. 
* Total overhaul of the [Aggregator|Aggregator2] EIP pattern.
* Reduced registering producers in JMX to prevent using too much memory and potentially registering short lived producers which didn't bring much value of being managed as well.
* Upgraded [HTTP] to use Apache HTTP Client 4.0.1. You may need to migrate if you use special or advanced configuration of HTTP Client.
* Fixed the issue that mixing jetty/http in a route screws up the request URI of [HTTP] producer.
* Individual routes can be [Graceful Shutdown] at runtime, which allows you to stop the route in a more reliable and gentle way.

h3. New [Enterprise Integration Patterns]

h3. New [Components]

* [camel-nagios|Nagios] for sending passive checks to [Nagios|http://nagios.org]
* [properties|Properties] for using property placeholders to resolve endpoint uris.
* [camel-gae|GAE] extensions
** [gauth] component for implementing [OAuth|http://code.google.com/apis/accounts/docs/OAuth.html] consumers.
** [glogin] component for programmatic login to Google App Engine applications from Java clients.

h3. New DSL

h3. New Annotations

h3. New [Data Formats|Data Format]

* [soap] data format provides basic webservice support without the CXF Stack

h3. New [Languages]

h3. New [Examples]

h2. API breaking

The [Aggregate|Aggregator2] has been overhauled and thus you need to migrate you Camel application if you use it.
See the [Aggregate|Aggregator2] wiki page for which options it has you should use.

In [Mina] the header key {{MinaConsumer.HEADER_CLOSE_SESSION_WHEN_COMPLETE}} is moved to {{MinaConstants.MINA_CLOSE_SESSION_WHEN_COMPLETE}} 

{{org.apache.camel.spi.PollingConsumerPollStrategy}} now returns a boolean in the {{begin}} method. Use {{true}} to accept to begin polling, and {{false}} to skip polling at this time.

h2. Known Issues

See known issues from previous releases.

h2. Important changes to consider when upgrading

The [SEDA] endpoint is now by default unbounded in size, where as before they had a default size of 1000.

[camel-http|HTTP] has been upgraded to use Apache HTTP Client 4.0.1 from 3.1. These two versions is much different how to configure, so you may have to migrate if you do any special or advanced configuration. Consult the [Apache HTTP Client documentation|http://hc.apache.org/httpcomponents-client/tutorial/html/]. 

h2. Getting the Distributions

h3. Binary Distributions

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

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

h3. SVN Tag Checkout

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

h2. Changelog

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