You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@camel.apache.org by bu...@apache.org on 2016/05/04 13:18:54 UTC
svn commit: r987459 - in /websites/production/camel/content: beanio.html
cache/main.pageCache camel-2180-release.html
Author: buildbot
Date: Wed May 4 13:18:54 2016
New Revision: 987459
Log:
Production update by buildbot for camel
Modified:
websites/production/camel/content/beanio.html
websites/production/camel/content/cache/main.pageCache
websites/production/camel/content/camel-2180-release.html
Modified: websites/production/camel/content/beanio.html
==============================================================================
--- websites/production/camel/content/beanio.html (original)
+++ websites/production/camel/content/beanio.html Wed May 4 13:18:54 2016
@@ -86,31 +86,7 @@
<tbody>
<tr>
<td valign="top" width="100%">
-<div class="wiki-content maincontent"><h2 id="BeanIO-BeanIO">BeanIO</h2>
-<p><strong>Available as of Camel 2.10</strong></p>
-
-<p>The BeanIO <a shape="rect" href="data-format.html">Data Format</a> uses <a shape="rect" class="external-link" href="http://beanio.org/" rel="nofollow">BeanIO</a> to handle flat payloads (such as XML, CSV, delimited, or fixed length formats).</p>
-
-<p>BeanIO is configured using a <a shape="rect" class="external-link" href="http://beanio.org/2.0/docs/reference/index.html#TheMappingFile" rel="nofollow">mappings XML</a> file where you define the mapping from the flat format to Objects (POJOs). This mapping file is mandatory to use.</p>
-
-<h3 id="BeanIO-Options">Options</h3>
-<div class="confluenceTableSmall">
-<div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p> Option </p></th><th colspan="1" rowspan="1" class="confluenceTh"><p> Default </p></th><th colspan="1" rowspan="1" class="confluenceTh"><p> Description </p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> mapping </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> The BeanIO mapping file. The option is mandatory. Is by default loaded from the classpath. You can prefix with <code>file:</code>, <code>http:</code>, or <code>classpath:</code> to denote from where to load the mapping file. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> streamName </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> The name of the stream to use. This option is mandatory. </p></td></tr><tr><td cols
pan="1" rowspan="1" class="confluenceTd"><p> ignoreUnidentifiedRecords </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>false</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Whether to ignore unidentified records. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> ignoreUnexpectedRecords </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>false</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Whether to ignore unexpected records. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> ignoreInvalidRecords </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>false</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Whether to ignore invalid records. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> encoding </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Platform default </p></td><td colspan="1" rowspan="1" c
lass="confluenceTd"><p> The charset to use. </p></td></tr></tbody></table></div>
-</div>
-
-<h3 id="BeanIO-Usage">Usage</h3>
-
-<p>An example of a <a shape="rect" class="external-link" href="https://svn.apache.org/repos/asf/camel/trunk/components/camel-beanio/src/test/resources/org/apache/camel/dataformat/beanio/mappings.xml">mapping file is here</a>.</p>
-
-<h4 id="BeanIO-UsingJavaDSL">Using Java DSL</h4>
-<p>To use the <code>BeanIODataFormat</code> you need to configure the data format with the mapping file, as well the name of the stream.<br clear="none">
-In Java DSL this can be done as shown below. The streamName is "employeeFile".</p>
-
-<p>Then we have two routes. The first route is for transforming CSV data into a List<Employee> Java objects. Which we then <a shape="rect" href="splitter.html">split</a>, so the mock endpoint<br clear="none">
-receives a message for each row.</p>
-
-<p>The 2nd route is for the reverse operation, to transform a List<Employee> into a stream of CSV data.</p>
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+<div class="wiki-content maincontent"><h2 id="BeanIO-BeanIO">BeanIO</h2><p><strong>Available as of Camel 2.10</strong></p><p>The BeanIO <a shape="rect" href="data-format.html">Data Format</a> uses <a shape="rect" class="external-link" href="http://beanio.org/" rel="nofollow">BeanIO</a> to handle flat payloads (such as XML, CSV, delimited, or fixed length formats).</p><p>BeanIO is configured using a <a shape="rect" class="external-link" href="http://beanio.org/2.0/docs/reference/index.html#TheMappingFile" rel="nofollow">mappings XML</a> file where you define the mapping from the flat format to Objects (POJOs). This mapping file is mandatory to use.</p><h3 id="BeanIO-Options">Options</h3><div class="confluenceTableSmall"><div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Option</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Default</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Description</p>
</th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>mapping</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>The BeanIO mapping file. The option is mandatory. Is by default loaded from the classpath. You can prefix with <code>file:</code>, <code>http:</code>, or <code>classpath:</code> to denote from where to load the mapping file.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>streamName</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>The name of the stream to use. This option is mandatory.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>ignoreUnidentifiedRecords</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Whether to ignore unidentified records.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>ignoreUnexpectedRecords</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Whether to ignore unexpected records.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>ignoreInvalidRecords</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Whether to ignore invalid records.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>encoding</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Platform default</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>The charset to use.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>beanReaderErrorHandler</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>A custom BeanReaderErrorHandler implementa
tion to use in your dataformat definition</p></td></tr></tbody></table></div></div><h3 id="BeanIO-Usage">Usage</h3><p>An example of a <a shape="rect" class="external-link" href="https://svn.apache.org/repos/asf/camel/trunk/components/camel-beanio/src/test/resources/org/apache/camel/dataformat/beanio/mappings.xml">mapping file is here</a>.</p><h4 id="BeanIO-UsingJavaDSL">Using Java DSL</h4><p>To use the <code>BeanIODataFormat</code> you need to configure the data format with the mapping file, as well the name of the stream.<br clear="none"> In Java DSL this can be done as shown below. The streamName is "employeeFile".</p><p>Then we have two routes. The first route is for transforming CSV data into a List<Employee> Java objects. Which we then <a shape="rect" href="splitter.html">split</a>, so the mock endpoint<br clear="none"> receives a message for each row.</p><p>The 2nd route is for the reverse operation, to transform a List<Employee> into a stream of CSV data.</p><div
class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[
// setup beanio data format using the mapping file, loaded from the classpath
DataFormat format = new BeanIODataFormat(
@@ -130,21 +106,14 @@ from("direct:marshal")
.marshal(format)
.to("mock:beanio-marshal");
]]></script>
-</div></div>
-
-<p>The CSV data could for example be as below:</p>
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+</div></div>The CSV data could for example be as below:<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[
private static final String FIXED_DATA =
"Joe,Smith,Developer,75000,10012009" + LS
+ "Jane,Doe,Architect,80000,01152008" + LS
+ "Jon,Anderson,Manager,85000,03182007" + LS;
]]></script>
-</div></div>
-
-<h4 id="BeanIO-UsingXMLDSL">Using XML DSL</h4>
-<p>To use the BeanIO data format in XML, you need to configure it using the <beanio> XML tag as shown below. The routes is similar to the example above.</p>
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+</div></div><h4 id="BeanIO-UsingXMLDSL">Using XML DSL</h4><p>To use the BeanIO data format in XML, you need to configure it using the <beanio> XML tag as shown below. The routes is similar to the example above.</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="brush: xml; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[
<camelContext xmlns="http://camel.apache.org/schema/spring">
<!-- setup beanio data format -->
@@ -168,17 +137,8 @@ private static final String FIXED_DATA =
</route>
</camelContext>
]]></script>
-</div></div>
-
-<h3 id="BeanIO-Dependencies">Dependencies</h3>
-
-<p>To use BeanIO in your Camel routes you need to add a dependency on <strong>camel-beanio</strong> which implements this data format. </p>
-
-<p>If you use Maven you can just add the following to your pom.xml, substituting the version number for the latest & greatest release (see <a shape="rect" href="download.html">the download page for the latest versions</a>).</p>
-
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="brush: xml; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[
-<dependency>
+</div></div><h3 id="BeanIO-Dependencies">Dependencies</h3><p>To use BeanIO in your Camel routes you need to add a dependency on <strong>camel-beanio</strong> which implements this data format.</p><p>If you use Maven you can just add the following to your pom.xml, substituting the version number for the latest & greatest release (see <a shape="rect" href="download.html">the download page for the latest versions</a>).</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+<script class="brush: xml; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-beanio</artifactId>
<version>2.10.0</version>
Modified: websites/production/camel/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/camel/content/camel-2180-release.html
==============================================================================
--- websites/production/camel/content/camel-2180-release.html (original)
+++ websites/production/camel/content/camel-2180-release.html Wed May 4 13:18:54 2016
@@ -85,7 +85,7 @@
<tbody>
<tr>
<td valign="top" width="100%">
-<div class="wiki-content maincontent"><h1 id="Camel2.18.0Release-Camel2.18.0release(currentlyinprogress)">Camel 2.18.0 release (currently in progress)</h1><div style="padding-right:20px;float:left;margin-left:-20px;"><p><span class="confluence-embedded-file-wrapper"><img class="confluence-embedded-image confluence-external-resource" src="http://camel.apache.org/download.data/camel-box-v1.0-150x200.png" data-image-src="http://camel.apache.org/download.data/camel-box-v1.0-150x200.png"></span></p></div><div style="min-height:200px"> </div><h2 id="Camel2.18.0Release-NewandNoteworthy">New and Noteworthy</h2><p>Welcome to the 2.18.0 release which approx XXX issues resolved (new features, improvements and bug fixes such as...)</p><ul><li>Added <a shape="rect" href="hystrix-eip.html">Hystrix EIP</a> as EIP pattern that uses native Hystrix as the Circuit Breaker implementation. This requires having <code>camel-hsytrix</code> on the classpath.</li><li>Improved the <a
shape="rect" href="bean.html">Bean</a> component to better match method parameter types when using <a shape="rect" href="simple.html">Simple</a> language as parameter values.</li><li>Added <code>BindyConverter</code> that allows to implement custom data converters for <a shape="rect" href="bindy.html">Bindy</a></li><li>The access in the <a shape="rect" href="rest-dsl.html">Rest DSL</a> has been deprecated and no longer in use - its not part of swagger specification anymore.</li><li><a shape="rect" href="nats.html">Camel-NATS</a> now uses JNATS client instead of the deprecated Java_nats one.</li><li>During startup of <a shape="rect" href="camelcontext.html">CamelContext</a> the services that are used as part of routes are now deferred being started to the end of the startup process. Some IoC frameworks like Spring can otherwise causes a circular dependency issue if services are started too early. A side effect is that if service startup failures happen w
hen being started later, they are now wrapped in the <code>FailedToStartupRouteException</code> to better pin point which route thas the problem.</li><li>Improved the startup sequence of <a shape="rect" href="spring-java-config.html">Spring Java Config</a> to be similar to <a shape="rect" href="spring-boot.html">Spring Boot</a> that helps prevent Spring initialization errors about circular dependencies issues.</li><li>Added PATCH to <a shape="rect" href="rest-dsl.html">Rest DSL</a></li><li>Added "starts with" and "ends with" operator to the <a shape="rect" href="simple.html">Simple</a> language.</li><li>Added <code>BeanIOSplitter</code> to <a shape="rect" href="beanio.html">BeanIO</a> that can be used with the <a shape="rect" href="splitter.html">Splitter</a> EIP to split big payloads in streaming mode without reading the entire content into memory.</li><li>Some of the <a shape="rect" href="aws.html">AWS</a> components allows to specify ARN in
the endpoint configuration. </li><li>The create operation in <a shape="rect" href="zookeeper.html">Zookeeper</a> now creates sub paths if missing.</li><li>Added support for async mode for <a shape="rect" href="servlet.html">SERVLET</a> component to leverage Asynchronous Servlet from the Servlet 3.0 spec.</li><li><a shape="rect" href="bean.html">Bean</a> component and <a shape="rect" href="bean-language.html">Bean Language</a> validates method name must be a valid according to java identifier rules, and also if parameter syntax has an ending parenthesis.</li><li>You can now use <code>@RunWith(CamelSpringBootJUnit4ClassRunner.class)</code> to test Camel <a shape="rect" href="spring-boot.html">Spring Boot</a> applications and use the Camel test annotations from <a shape="rect" href="spring-testing.html">Spring Testing</a> such as <code>@MockEndpoints</code>.</li><li>To turn on logging exhausted message body with the message history you
can configure this easily on the CamelContext level with <code>setLogExhaustedMessageBody</code></li><li><a shape="rect" href="infinispan.html">Camel-Infinispan</a> now supports Aggregation Repository: InfinispanLocalAggregationRepository and InfinispanRemoteAggregationRepository</li><li>The <a shape="rect" href="sql-component.html">SQL Component</a> and <a shape="rect" href="elsql.html">ElSql</a> now supports <code>outputType=StreamList</code> to use an iterator for the output of the SQL query that allows to process the data in a streaming fashion such as with the <a shape="rect" href="splitter.html">Splitter</a> EIP to process the data row by row, and load data from the database as needed.</li><li><a shape="rect" href="jpa.html">JPA</a> now includes a <code>JpaPollingConsumer</code> implementation that better supports <a shape="rect" href="content-enricher.html">Content Enricher</a> using <code>pollEnrich</code> to do a on-demand poll
that returns either none, one or a list of entities as the result. </li><li>Calling <a shape="rect" href="bean.html">Bean</a> with method parameters defined using <a shape="rect" href="simple.html">Simple</a> parameters, now avoids an intermediate conversion of the paramaters to a String value. This ensures the passed in values when calling the bean method is using the parameter type as-is from <a shape="rect" href="simple.html">Simple</a>.</li><li><a shape="rect" href="cdi.html">Camel CDI</a> now supports importing Camel XML configuration files</li><li><a shape="rect" href="cdi.html">Camel CDI</a> does not deploy an empty Camel context bean anymore if not route builder beans nor Camel beans are deployed</li><li><a shape="rect" href="cdi.html">Camel CDI</a> adds the <code>@Named</code> qualifier to Camel route management events so that it's possible to observe these events for a specific route with an explicit <code>id</code></li></ul><p>Fixed
these issues:</p><ul><li>Fixed <a shape="rect" href="bean.html">Bean</a> component to avoid ambiguous error for classes that extends generic interface and calling which could lead to falsely duplicate methods (due Java type erasure inserts bridge methods) </li><li>Fixed splitting using tarfile could cause OOME if splitting big files which was mistakenly loaded into memory. Now we work on the tar stream directly.</li><li>Fixed <a shape="rect" href="netty-http.html">Netty HTTP</a> and <a shape="rect" href="netty4-http.html">Netty4 HTTP</a> issue when not specifying a port number then port 80 would not be used but an error about port -1 is not allowed.</li><li>Fixed <a shape="rect" href="swagger-java.html">Swagger Java</a> when using property placeholders in <a shape="rect" href="rest-dsl.html">Rest DSL</a> could cause invalid parameters to be included that was from the placeholder.</li><li>The <code>threads</code> EIP now lets <a shap
e="rect" href="error-handling-in-camel.html">Error handling in Camel</a> perform redeliveries if the thread pool would otherwise reject accepting the task. This allows the error handler to perform redeliveries to attempt to put the task on the thread pool queue, or eventually move the message to a dead letter queue etc.</li><li>Fixed <a shape="rect" href="rest-dsl.html">Rest DSL</a> adding empty header if specifying a non required query parameter that has no default value assigned.</li><li>Fixed <a shape="rect" href="loop.html">doWhile</a> loop which could potentially loop forever.</li><li>Fixed a NPE in <a shape="rect" href="zookeeper.html">Zookeeper</a> consumer if no zookeeper node path was set</li><li>Spring-DM for OSGi moved out of camel-spring into a separate camel-spring-dm module.</li><li>When using continued with <a shape="rect" href="exception-clause.html">onException</a> then dead letter channel endpooint should not be invoked.</li><li>Fixed <a shape="
rect" href="error-handler.html">Error Handler</a> to not log exceptions when using <code>continued(true)</code> by default.</li><li>Fixed so using shareUnitOfWork would now also call specialized <code>AggregationStrategy</code> for onTimeout, onCompletion etc.</li><li>Fixed <a shape="rect" href="jetty.html">Jetty</a> consumer incorrectly handle multipart/form data not being mapped as attachments on the Camel Message.</li><li>Fixed <a shape="rect" href="netty4-http.html">Netty4 HTTP</a> may fail reading the http content from the raw netty stream if the Exchange was routed asynchronously.</li><li>Fixed <a shape="rect" href="netty4-http.html">Netty4 HTTP</a> leak ByteBuf's on the producer side which was not released in all corner cases before they may be gargage collected. </li></ul><h3 id="Camel2.18.0Release-New">New <a shape="rect" href="enterprise-integration-patterns.html">Enterprise Integration Patterns</a></h3><h3 id="Camel2.18.0Release-New.1">N
ew <a shape="rect" href="components.html">Components</a></h3><ul><li>camel-cm-sms - For sending SMS messages using SM SMS Gateway</li><li><a shape="rect" href="flink.html">camel-flink</a> - Bridges Camel connectors with Apache Flink tasks.</li><li><a shape="rect" href="hystrix.html">camel-hystrix</a> - For implementing circuit breaker, timeouts, bulkheads, caching, etc.</li><li>camel-servicenow - For cloud management with ServiceNow</li><li><a shape="rect" href="camel-zipkin.html">camel-zipkin</a> - For tracking Camel message flows/timings using <a shape="rect" class="external-link" href="http://zipkin.io/" style="line-height: 1.42857;" rel="nofollow">zipkin</a></li></ul><h3 id="Camel2.18.0Release-NewDSL">New DSL</h3><ul><li><a shape="rect" href="hystrix-eip.html">hystrix</a> - Using Hystrix as circuit breaker. This requires having <code>camel-hsytrix</code> on the classpath.</li></ul><h3 id="Camel2.18.0Release-NewAnnotations">New Annotations</h3><h3 id="Camel2.18.0Release
-NewDataFormats">New <a shape="rect" href="data-format.html">Data Formats</a></h3><h3 id="Camel2.18.0Release-New.2">New <a shape="rect" href="languages.html">Languages</a></h3><h3 id="Camel2.18.0Release-New.3">New <a shape="rect" href="examples.html">Examples</a></h3><ul><li><code>camel-example-cdi-xml</code>: i<span style="color: rgb(0,0,0);">llustrates the use of Camel XML configuration files into a Camel CDI application</span></li></ul><h3 id="Camel2.18.0Release-New.4">New <a shape="rect" href="tutorials.html">Tutorials</a></h3><h2 id="Camel2.18.0Release-APIbreaking">API breaking</h2><h2 id="Camel2.18.0Release-KnownIssues">Known Issues</h2><h2 id="Camel2.18.0Release-Importantchangestoconsiderwhenupgrading">Important changes to consider when upgrading</h2><ul><li><strong>Java 1.8 is now required.</strong></li><li>karaf 2.4.x is no longer supported</li><li>spring 4.0 is no longer supported</li><li>Jetty 8.x is not longer supported and camel-jetty8 has been removed</li><li>removed c
amel-test-spring40 module</li><li>spring 3.x is no longer supported<br clear="none">(only spring-dm using spring 3.2.x as part of camel-spring in osgi/karaf is still in use - but spring-dm is deprecated and we recommend using blueprint)</li><li>Spring-DM for OSGi moved out of camel-spring into a separate camel-spring-dm module. If using Spring XML with Spring-DM then you need to install camel-spring-dm feature in Karaf/ServiceMix.</li><li>The deprecated <code>@LazyLoadTypeConverter</code> has been removed from all <a shape="rect" href="camel-test.html">Camel Test</a> modules</li><li>camel-gae has been removed (was not working anyway)</li><li>The access in the <a shape="rect" href="rest-dsl.html">Rest DSL</a> has been deprecated and no longer in use - its not part of swagger specification anymore.</li><li>Removed the deprecated maven archetypes for SOAP WS using CXF with OSGi Blueprint<br clear="none"><br clear="none"><br clear="none"></li></ul><h2 id="Camel2.18.0Release-Ge
ttingtheDistributions">Getting the Distributions</h2><h3 id="Camel2.18.0Release-BinaryDistributions">Binary Distributions</h3><div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Description</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Download Link</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>PGP Signature file of download</p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>Windows Distribution</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://www.apache.org/dyn/closer.cgi/camel/apache-camel/x.y.x/apache-camel-x.y.x.zip">apache-camel-x.y.x.zip</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://www.apache.org/dist/camel/apache-camel/x.y.x/apache-camel-x.y.x.zip.asc">apache-camel-x.y.x.zip.asc</a></p></td></tr><tr><td colspan="1" rowspan="1" class="co
nfluenceTd"><p>Unix/Linux/Cygwin Distribution</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://www.apache.org/dyn/closer.cgi/camel/apache-camel/x.y.x/apache-camel-x.y.x.tar.gz">apache-camel-x.y.x.tar.gz</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://www.apache.org/dist/camel/apache-camel/x.y.x/apache-camel-x.y.x.tar.gz.asc">apache-camel-x.y.x.tar.gz.asc</a></p></td></tr></tbody></table></div><div class="confluence-information-macro confluence-information-macro-information"><p class="title">The above URLs use redirection</p><span class="aui-icon aui-icon-small aui-iconfont-info confluence-information-macro-icon"></span><div class="confluence-information-macro-body"><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 browser
s). If the download doesn't seem to work for you from the above URL then try using <a shape="rect" class="external-link" href="http://www.mozilla.com/en-US/firefox/" rel="nofollow">FireFox</a></p></div></div><h3 id="Camel2.18.0Release-SourceDistributions">Source Distributions</h3><div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Description</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Download Link</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>PGP Signature file of download</p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>Source for Windows</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://www.apache.org/dyn/closer.cgi/camel/apache-camel/x.y.x/apache-camel-x.y.x-src.zip">apache-camel-x.y.x-src.zip</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http
://www.apache.org/dist/camel/apache-camel/x.y.x/apache-camel-x.y.x-src.zip.asc">apache-camel-x.y.x-src.zip.asc</a></p></td></tr></tbody></table></div><div class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>Source for Unix/Linux/Cygwin</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://www.apache.org/dyn/closer.cgi/camel/apache-camel/x.y.x/apache-camel-x.y.x-src.tar.gz">apache-camel-x.y.x-src.tar.gz</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://www.apache.org/dist/camel/apache-camel/x.y.x/apache-camel-x.y.x-src.tar.gz.asc">apache-camel-x.y.x-src.tar.gz.asc</a></p></td></tr></tbody></table></div><h3 id="Camel2.18.0Release-GettingtheBinariesusingMaven2">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 you
r <a shape="rect" class="external-link" href="http://maven.apache.org/guides/introduction/introduction-to-the-pom.html">Maven POM</a> is:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+<div class="wiki-content maincontent"><h1 id="Camel2.18.0Release-Camel2.18.0release(currentlyinprogress)">Camel 2.18.0 release (currently in progress)</h1><div style="padding-right:20px;float:left;margin-left:-20px;"><p><span class="confluence-embedded-file-wrapper"><img class="confluence-embedded-image confluence-external-resource" src="http://camel.apache.org/download.data/camel-box-v1.0-150x200.png" data-image-src="http://camel.apache.org/download.data/camel-box-v1.0-150x200.png"></span></p></div><div style="min-height:200px"> </div><h2 id="Camel2.18.0Release-NewandNoteworthy">New and Noteworthy</h2><p>Welcome to the 2.18.0 release which approx XXX issues resolved (new features, improvements and bug fixes such as...)</p><ul><li>Added <a shape="rect" href="hystrix-eip.html">Hystrix EIP</a> as EIP pattern that uses native Hystrix as the Circuit Breaker implementation. This requires having <code>camel-hsytrix</code> on the classpath.</li><li>Improved the <a
shape="rect" href="bean.html">Bean</a> component to better match method parameter types when using <a shape="rect" href="simple.html">Simple</a> language as parameter values.</li><li>Added <code>BindyConverter</code> that allows to implement custom data converters for <a shape="rect" href="bindy.html">Bindy</a></li><li>The access in the <a shape="rect" href="rest-dsl.html">Rest DSL</a> has been deprecated and no longer in use - its not part of swagger specification anymore.</li><li><a shape="rect" href="nats.html">Camel-NATS</a> now uses JNATS client instead of the deprecated Java_nats one.</li><li>During startup of <a shape="rect" href="camelcontext.html">CamelContext</a> the services that are used as part of routes are now deferred being started to the end of the startup process. Some IoC frameworks like Spring can otherwise causes a circular dependency issue if services are started too early. A side effect is that if service startup failures happen w
hen being started later, they are now wrapped in the <code>FailedToStartupRouteException</code> to better pin point which route thas the problem.</li><li>Improved the startup sequence of <a shape="rect" href="spring-java-config.html">Spring Java Config</a> to be similar to <a shape="rect" href="spring-boot.html">Spring Boot</a> that helps prevent Spring initialization errors about circular dependencies issues.</li><li>Added PATCH to <a shape="rect" href="rest-dsl.html">Rest DSL</a></li><li>Added "starts with" and "ends with" operator to the <a shape="rect" href="simple.html">Simple</a> language.</li><li>Added <code>BeanIOSplitter</code> to <a shape="rect" href="beanio.html">BeanIO</a> that can be used with the <a shape="rect" href="splitter.html">Splitter</a> EIP to split big payloads in streaming mode without reading the entire content into memory.</li><li>Some of the <a shape="rect" href="aws.html">AWS</a> components allows to specify ARN in
the endpoint configuration. </li><li>The create operation in <a shape="rect" href="zookeeper.html">Zookeeper</a> now creates sub paths if missing.</li><li>Added support for async mode for <a shape="rect" href="servlet.html">SERVLET</a> component to leverage Asynchronous Servlet from the Servlet 3.0 spec.</li><li><a shape="rect" href="bean.html">Bean</a> component and <a shape="rect" href="bean-language.html">Bean Language</a> validates method name must be a valid according to java identifier rules, and also if parameter syntax has an ending parenthesis.</li><li>You can now use <code>@RunWith(CamelSpringBootJUnit4ClassRunner.class)</code> to test Camel <a shape="rect" href="spring-boot.html">Spring Boot</a> applications and use the Camel test annotations from <a shape="rect" href="spring-testing.html">Spring Testing</a> such as <code>@MockEndpoints</code>.</li><li>To turn on logging exhausted message body with the message history you
can configure this easily on the CamelContext level with <code>setLogExhaustedMessageBody</code></li><li><a shape="rect" href="infinispan.html">Camel-Infinispan</a> now supports Aggregation Repository: InfinispanLocalAggregationRepository and InfinispanRemoteAggregationRepository</li><li>The <a shape="rect" href="sql-component.html">SQL Component</a> and <a shape="rect" href="elsql.html">ElSql</a> now supports <code>outputType=StreamList</code> to use an iterator for the output of the SQL query that allows to process the data in a streaming fashion such as with the <a shape="rect" href="splitter.html">Splitter</a> EIP to process the data row by row, and load data from the database as needed.</li><li><a shape="rect" href="jpa.html">JPA</a> now includes a <code>JpaPollingConsumer</code> implementation that better supports <a shape="rect" href="content-enricher.html">Content Enricher</a> using <code>pollEnrich</code> to do a on-demand poll
that returns either none, one or a list of entities as the result. </li><li>Calling <a shape="rect" href="bean.html">Bean</a> with method parameters defined using <a shape="rect" href="simple.html">Simple</a> parameters, now avoids an intermediate conversion of the paramaters to a String value. This ensures the passed in values when calling the bean method is using the parameter type as-is from <a shape="rect" href="simple.html">Simple</a>.</li><li><a shape="rect" href="cdi.html">Camel CDI</a> now supports importing Camel XML configuration files</li><li><a shape="rect" href="cdi.html">Camel CDI</a> does not deploy an empty Camel context bean anymore if not route builder beans nor Camel beans are deployed</li><li><a shape="rect" href="cdi.html">Camel CDI</a> adds the <code>@Named</code> qualifier to Camel route management events so that it's possible to observe these events for a specific route with an explicit <code>id</code></li><li><a shape=
"rect" href="beanio.html">Camel BeanIO</a> now supports the possibility to use a custom BeanReaderErrorHandler implementation in his configuration</li></ul><p>Fixed these issues:</p><ul><li>Fixed <a shape="rect" href="bean.html">Bean</a> component to avoid ambiguous error for classes that extends generic interface and calling which could lead to falsely duplicate methods (due Java type erasure inserts bridge methods) </li><li>Fixed splitting using tarfile could cause OOME if splitting big files which was mistakenly loaded into memory. Now we work on the tar stream directly.</li><li>Fixed <a shape="rect" href="netty-http.html">Netty HTTP</a> and <a shape="rect" href="netty4-http.html">Netty4 HTTP</a> issue when not specifying a port number then port 80 would not be used but an error about port -1 is not allowed.</li><li>Fixed <a shape="rect" href="swagger-java.html">Swagger Java</a> when using property placeholders in <a shape="rect" href="rest-dsl.
html">Rest DSL</a> could cause invalid parameters to be included that was from the placeholder.</li><li>The <code>threads</code> EIP now lets <a shape="rect" href="error-handling-in-camel.html">Error handling in Camel</a> perform redeliveries if the thread pool would otherwise reject accepting the task. This allows the error handler to perform redeliveries to attempt to put the task on the thread pool queue, or eventually move the message to a dead letter queue etc.</li><li>Fixed <a shape="rect" href="rest-dsl.html">Rest DSL</a> adding empty header if specifying a non required query parameter that has no default value assigned.</li><li>Fixed <a shape="rect" href="loop.html">doWhile</a> loop which could potentially loop forever.</li><li>Fixed a NPE in <a shape="rect" href="zookeeper.html">Zookeeper</a> consumer if no zookeeper node path was set</li><li>Spring-DM for OSGi moved out of camel-spring into a separate camel-spring-dm module.</li><li>When using
continued with <a shape="rect" href="exception-clause.html">onException</a> then dead letter channel endpooint should not be invoked.</li><li>Fixed <a shape="rect" href="error-handler.html">Error Handler</a> to not log exceptions when using <code>continued(true)</code> by default.</li><li>Fixed so using shareUnitOfWork would now also call specialized <code>AggregationStrategy</code> for onTimeout, onCompletion etc.</li><li>Fixed <a shape="rect" href="jetty.html">Jetty</a> consumer incorrectly handle multipart/form data not being mapped as attachments on the Camel Message.</li><li>Fixed <a shape="rect" href="netty4-http.html">Netty4 HTTP</a> may fail reading the http content from the raw netty stream if the Exchange was routed asynchronously.</li><li>Fixed <a shape="rect" href="netty4-http.html">Netty4 HTTP</a> leak ByteBuf's on the producer side which was not released in all corner cases before they may be gargage collected. </li></ul><h3 id=
"Camel2.18.0Release-New">New <a shape="rect" href="enterprise-integration-patterns.html">Enterprise Integration Patterns</a></h3><h3 id="Camel2.18.0Release-New.1">New <a shape="rect" href="components.html">Components</a></h3><ul><li>camel-cm-sms - For sending SMS messages using SM SMS Gateway</li><li><a shape="rect" href="flink.html">camel-flink</a> - Bridges Camel connectors with Apache Flink tasks.</li><li><a shape="rect" href="hystrix.html">camel-hystrix</a> - For implementing circuit breaker, timeouts, bulkheads, caching, etc.</li><li>camel-servicenow - For cloud management with ServiceNow</li><li><a shape="rect" href="camel-zipkin.html">camel-zipkin</a> - For tracking Camel message flows/timings using <a shape="rect" class="external-link" href="http://zipkin.io/" style="line-height: 1.42857;" rel="nofollow">zipkin</a></li></ul><h3 id="Camel2.18.0Release-NewDSL">New DSL</h3><ul><li><a shape="rect" href="hystrix-eip.html">hystrix</a> - Using Hystrix as circuit breaker. This
requires having <code>camel-hsytrix</code> on the classpath.</li></ul><h3 id="Camel2.18.0Release-NewAnnotations">New Annotations</h3><h3 id="Camel2.18.0Release-NewDataFormats">New <a shape="rect" href="data-format.html">Data Formats</a></h3><h3 id="Camel2.18.0Release-New.2">New <a shape="rect" href="languages.html">Languages</a></h3><h3 id="Camel2.18.0Release-New.3">New <a shape="rect" href="examples.html">Examples</a></h3><ul><li><code>camel-example-cdi-xml</code>: i<span style="color: rgb(0,0,0);">llustrates the use of Camel XML configuration files into a Camel CDI application</span></li></ul><h3 id="Camel2.18.0Release-New.4">New <a shape="rect" href="tutorials.html">Tutorials</a></h3><h2 id="Camel2.18.0Release-APIbreaking">API breaking</h2><h2 id="Camel2.18.0Release-KnownIssues">Known Issues</h2><h2 id="Camel2.18.0Release-Importantchangestoconsiderwhenupgrading">Important changes to consider when upgrading</h2><ul><li><strong>Java 1.8 is now required.</strong></li><li>karaf
2.4.x is no longer supported</li><li>spring 4.0 is no longer supported</li><li>Jetty 8.x is not longer supported and camel-jetty8 has been removed</li><li>removed camel-test-spring40 module</li><li>spring 3.x is no longer supported<br clear="none">(only spring-dm using spring 3.2.x as part of camel-spring in osgi/karaf is still in use - but spring-dm is deprecated and we recommend using blueprint)</li><li>Spring-DM for OSGi moved out of camel-spring into a separate camel-spring-dm module. If using Spring XML with Spring-DM then you need to install camel-spring-dm feature in Karaf/ServiceMix.</li><li>The deprecated <code>@LazyLoadTypeConverter</code> has been removed from all <a shape="rect" href="camel-test.html">Camel Test</a> modules</li><li>camel-gae has been removed (was not working anyway)</li><li>The access in the <a shape="rect" href="rest-dsl.html">Rest DSL</a> has been deprecated and no longer in use - its not part of swagger specification anymore.</li><li>Removed
the deprecated maven archetypes for SOAP WS using CXF with OSGi Blueprint<br clear="none"><br clear="none"><br clear="none"></li></ul><h2 id="Camel2.18.0Release-GettingtheDistributions">Getting the Distributions</h2><h3 id="Camel2.18.0Release-BinaryDistributions">Binary Distributions</h3><div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Description</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Download Link</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>PGP Signature file of download</p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>Windows Distribution</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://www.apache.org/dyn/closer.cgi/camel/apache-camel/x.y.x/apache-camel-x.y.x.zip">apache-camel-x.y.x.zip</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="h
ttp://www.apache.org/dist/camel/apache-camel/x.y.x/apache-camel-x.y.x.zip.asc">apache-camel-x.y.x.zip.asc</a></p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>Unix/Linux/Cygwin Distribution</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://www.apache.org/dyn/closer.cgi/camel/apache-camel/x.y.x/apache-camel-x.y.x.tar.gz">apache-camel-x.y.x.tar.gz</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://www.apache.org/dist/camel/apache-camel/x.y.x/apache-camel-x.y.x.tar.gz.asc">apache-camel-x.y.x.tar.gz.asc</a></p></td></tr></tbody></table></div><div class="confluence-information-macro confluence-information-macro-information"><p class="title">The above URLs use redirection</p><span class="aui-icon aui-icon-small aui-iconfont-info confluence-information-macro-icon"></span><div class="confluence-information-macro-body"><p>The above URLs use the Apac
he 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 shape="rect" class="external-link" href="http://www.mozilla.com/en-US/firefox/" rel="nofollow">FireFox</a></p></div></div><h3 id="Camel2.18.0Release-SourceDistributions">Source Distributions</h3><div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Description</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Download Link</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>PGP Signature file of download</p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>Source for Windows</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://www.apache.org/dyn/closer.cgi/camel/apache-camel/x.y.x/apa
che-camel-x.y.x-src.zip">apache-camel-x.y.x-src.zip</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://www.apache.org/dist/camel/apache-camel/x.y.x/apache-camel-x.y.x-src.zip.asc">apache-camel-x.y.x-src.zip.asc</a></p></td></tr></tbody></table></div><div class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>Source for Unix/Linux/Cygwin</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://www.apache.org/dyn/closer.cgi/camel/apache-camel/x.y.x/apache-camel-x.y.x-src.tar.gz">apache-camel-x.y.x-src.tar.gz</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://www.apache.org/dist/camel/apache-camel/x.y.x/apache-camel-x.y.x-src.tar.gz.asc">apache-camel-x.y.x-src.tar.gz.asc</a></p></td></tr></tbody></table></div><h3 id="Camel2.18.0Release-GettingtheBina
riesusingMaven2">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 shape="rect" class="external-link" href="http://maven.apache.org/guides/introduction/introduction-to-the-pom.html">Maven POM</a> is:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="brush: xml; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-core</artifactId>