camel-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject [CONF] Apache Camel > Camel 2.1.0 Release
Date Thu, 05 Nov 2009 17:45:00 GMT
    <base href="">
            <link rel="stylesheet" href="/confluence/s/1519/1/1/_/styles/combined.css?spaceKey=CAMEL&amp;forWysiwyg=true"
<body style="background-color: white" bgcolor="white">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
     <h2><a href="">Camel
2.1.0 Release</a></h2>
     <h4>Page <b>edited</b> by             <a href="">Claus
     <div class="notificationGreySide">
         <h1><a name="Camel2.1.0Release-Camel2.1.0release%28WorkinProgress%29"></a>Camel
2.1.0 release (Work in Progress)</h1>

<div style="padding-right:20px;float:left;margin-left:-20px;"><p><img src=""
align="absmiddle" border="0" /></p></div>
<div style="min-height:200px"></div>

<h2><a name="Camel2.1.0Release-NewandNoteworthy"></a>New and Noteworthy</h2>

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

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

<h3><a name="Camel2.1.0Release-NewEnterpriseIntegrationPatterns"></a>New
<a href="/confluence/display/CAMEL/Enterprise+Integration+Patterns" title="Enterprise Integration
Patterns">Enterprise Integration Patterns</a></h3>

<h3><a name="Camel2.1.0Release-NewComponents"></a>New <a href="/confluence/display/CAMEL/Components"

	<li><a href="/confluence/display/CAMEL/Printer" title="Printer">camel-printer</a></li>
	<li><a href="/confluence/display/CAMEL/Cache" title="Cache">camel-cache</a></li>
	<li><a href="/confluence/display/CAMEL/SNMP" title="SNMP">camel-snmp</a></li>
	<li><a href="/confluence/display/CAMEL/JavaSpace" title="JavaSpace">camel-javaspace</a></li>

<h3><a name="Camel2.1.0Release-NewDSL"></a>New DSL</h3>

<h3><a name="Camel2.1.0Release-NewAnnotations"></a>New Annotations</h3>

<h3><a name="Camel2.1.0Release-NewDataFormatsDataFormat"></a>New <a href="/confluence/display/CAMEL/Data+Format"
title="Data Format">Data Formats</a></h3>

<h3><a name="Camel2.1.0Release-NewLanguages"></a>New <a href="/confluence/display/CAMEL/Languages"

<h3><a name="Camel2.1.0Release-NewExamples"></a>New <a href="/confluence/display/CAMEL/Examples"

	<li><a href="/confluence/display/CAMEL/Management+Example" title="Management Example">camel-example-management</a></li>
	<li><a href="/confluence/display/CAMEL/Route+Throttling+Example" title="Route Throttling

<h2><a name="Camel2.1.0Release-APIbreaking"></a>API breaking</h2>

<h3><a name="Camel2.1.0Release-DSLchanges"></a>DSL changes</h3>

<p>In the Java DSL the <tt>.errorHandler</tt> 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 <tt>.from</tt> DSL.</p>

<p>In Spring DSL the <tt>errorHandlerRef</tt> attribute is now only visible
on the <tt>&lt;camelContext&gt;</tt> and <tt>&lt;route&gt;</tt>
XML tags.</p>

<h3><a name="Camel2.1.0Release-New.jardependencies"></a>New .jar dependencies</h3>

<p>camel-core now depends on commons-management.jar to facilitate the new overhauled
This project is hosted at <a href="" rel="nofollow">FuseForge</a></p>

<p>This .jar can be retrieved from the maven central repo at: <a href=""
The maven dependency details are:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">

<h3><a name="Camel2.1.0Release-DataFormatresolution"></a>DataFormat resolution</h3>
<p>Data formats is now resolved just as components and languages etc. making it consistent.
If you have your own custom data formats you need to create the magic file under <tt>META-INF/services/org/apache/camel/dataformat</tt>
which is a file with the data format name. See for example <tt>camel-jackson</tt>
for an example how to do that.</p>

<h3><a name="Camel2.1.0Release-CoreAPI"></a>Core API</h3>

<h4><a name="Camel2.1.0Release-CamelContext"></a>CamelContext</h4>

<p>CamelContext have renamed the method <tt>getLifecycleStrategy</tt> to
<tt>getLifecycleStrategies</tt> and now returns a List.</p>

<h4><a name="Camel2.1.0Release-Exchange"></a>Exchange</h4>

<p>The exchange id has been changed to use the <tt>java.util.UUID</tt> instead.
This allows Camel to run on Google App Engine.</p>

<h4><a name="Camel2.1.0Release-Management"></a>Management</h4>

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

<h3><a name="Camel2.1.0Release-ClientAPI"></a>Client API</h3>

<h3><a name="Camel2.1.0Release-Removedclasses"></a>Removed classes</h3>

	<li><tt>org.apache.camel.processor.CompositeProcessor</tt> was never used</li>
	<li><tt>org.apache.camel.impl.ProducerTemplateProcessor</tt> was never
	<li><tt>org.apache.camel.impl.NoPolicy</tt> was never used</li>
was never used</li>
	<li><tt>org.apache.camel.spring.handler.ScriptDefinitionParser</tt> was
never used</li>
	<li><tt>org.apache.camel.spring.remoting.SendBeforeInterceptor</tt> was
never used</li>
	<li><tt>org.apache.camel.spring.spi.SpringConverters</tt> was never used</li>

<h3><a name="Camel2.1.0Release-Movedclasses"></a>Moved classes</h3>

	<li><tt>org.apache.camel.PollingConsumerPollStrategy</tt> is moved to <tt>org.apache.camel.spi.PollingConsumerPollStrategy</tt></li>

<h3><a name="Camel2.1.0Release-Removedmethods"></a>Removed methods</h3>

	<li><tt>getSingletonEndpoints</tt> method have been removed from various
classes in the <tt>camel-test</tt> component.</li>

<h3><a name="Camel2.1.0Release-RemovedinSpringXML"></a>Removed in Spring

<p>The option <tt>shouldStartContext</tt> on &lt;camelContext&gt;
have been removed. Its replaced with <tt>autoStartup</tt> which you can read more
about here <a href="/confluence/display/CAMEL/Configuring+route+startup+ordering+and+autostartup"
title="Configuring route startup ordering and autostartup">Configuring route startup ordering
and autostartup</a>.</p>

<h3><a name="Camel2.1.0Release-@Bean"></a>@Bean</h3>

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

<h2><a name="Camel2.1.0Release-KnownIssues"></a>Known Issues</h2>

<p>See known issues from previous releases.</p>

<h2><a name="Camel2.1.0Release-Importantchangestoconsiderwhenupgrading"></a>Important
changes to consider when upgrading</h2>

<h2><a name="Camel2.1.0Release-GettingtheDistributions"></a>Getting the

<h3><a name="Camel2.1.0Release-BinaryDistributions"></a>Binary Distributions</h3>

<table class='confluenceTable'><tbody>
<th class='confluenceTh'> Description </th>
<th class='confluenceTh'> Download Link </th>
<th class='confluenceTh'> PGP Signature file of download </th>
<td class='confluenceTd'> Windows Distribution </td>
<td class='confluenceTd'> <a href=""
rel="nofollow"></a> </td>
<td class='confluenceTd'> <a href=""
rel="nofollow"></a> </td>
<td class='confluenceTd'> Unix/Linux/Cygwin Distribution </td>
<td class='confluenceTd'> <a href=""
rel="nofollow">apache-camel-2.1.0.tar.gz</a> </td>
<td class='confluenceTd'> <a href=""
rel="nofollow">apache-camel-2.1.0.tar.gz.asc</a> </td>
<div class='panelMacro'><table class='infoMacro'><colgroup><col width='24'><col></colgroup><tr><td
valign='top'><img src="/confluence/images/icons/emoticons/information.gif" width="16"
height="16" align="absmiddle" alt="" border="0"></td><td><b>The above
URLs use redirection</b><br /><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 href=""

<h3><a name="Camel2.1.0Release-SourceDistributions"></a>Source Distributions</h3>

<table class='confluenceTable'><tbody>
<th class='confluenceTh'> Description </th>
<th class='confluenceTh'> Download Link </th>
<th class='confluenceTh'> PGP Signature file of download </th>
<td class='confluenceTd'> Source for Windows </td>
<td class='confluenceTd'> <a href=""
rel="nofollow"></a> </td>
<td class='confluenceTd'> <a href=""
rel="nofollow"></a> </td>

<table class='confluenceTable'><tbody>
<td class='confluenceTd'> Source for Unix/Linux/Cygwin </td>
<td class='confluenceTd'> <a href=""
rel="nofollow">apache-camel-2.1.0-src.tar.gz</a> </td>
<td class='confluenceTd'> <a href=""
rel="nofollow">apache-camel-2.1.0-src.tar.gz.asc</a> </td>

<h3><a name="Camel2.1.0Release-GettingtheBinariesusingMaven2"></a>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 href=""
rel="nofollow">Maven POM</a> is:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml">
<span class="code-tag">&lt;dependency&gt;</span>
  <span class="code-tag">&lt;groupId&gt;</span>org.apache.camel<span
  <span class="code-tag">&lt;artifactId&gt;</span>camel-core<span class="code-tag">&lt;/artifactId&gt;</span>
  <span class="code-tag">&lt;version&gt;</span>2.1.0<span class="code-tag">&lt;/version&gt;</span>
<span class="code-tag">&lt;/dependency&gt;</span>

<h3><a name="Camel2.1.0Release-SVNTagCheckout"></a>SVN Tag Checkout</h3>

<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">
svn co http:<span class="code-comment">//</span>

<h2><a name="Camel2.1.0Release-Changelog"></a>Changelog</h2>

<p>For a more detailed view of new features and bug fixes, see the:<br/>
TODO: Fix for 2.1.0</p>
	<li><a href=";styleName=Html&amp;version=11900"
rel="nofollow">release notes for 2.1.0</a></li>

     <div id="commentsSection" class="wiki-content pageSection">
       <div style="float: right;">
            <a href=""
class="grey">Change Notification Preferences</a>

       <a href="">View
       <a href="">View
       <a href=";showCommentArea=true#addcomment">Add

View raw message