Modified: websites/production/camel/content/camel-2170-release.html
==============================================================================
--- websites/production/camel/content/camel-2170-release.html (original)
+++ websites/production/camel/content/camel-2170-release.html Sat Jan 16
09:25:55 2016
@@ -85,7 +85,7 @@
<tbody>
<tr>
<td valign="top" width="100%">
-<div class="wiki-content maincontent"><h1
id="Camel2.17.0Release-Camel2.17.0release(currentlyinprogress)">Camel 2.17.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.17.0Release-NewandNoteworthy">New and Noteworthy</h2><p>Welcome to
the x.y.z release which approx XXX issues resolved (new features, improvements
and bug fixes such as...)</p><ul><li>The component documentation generated from
the source code has been double checked to be up to date and include all the
options the endpoints supports.</li><li>Upgraded camel-hbase to Hadoop 2.x and
HBase 1.1.x</li><li><a shape="rect" href="tools.html"
>Camel commands</a> for <a shape="rect" href="spring-boot.html">Spring
>Boot</a></li><li>Many improvements to Camel <a shape="rect"
>href="kura.html">Kura</a></li><li>Added transacted option to <a
>shape="rect" href="sql-component.html">SQL Component</a> when used as a
>consumer in a transacted route.</li><li>Added support for UPDATE operation
>to <a shape="rect"
>href="elasticsearch.html">ElasticSearch</a>.</li><li>Allow to reuse existing
>configured Elasticsearch Client on the <a shape="rect"
>href="elasticsearch.html">ElasticSearch</a> component, instead of creating a
>client per endpoint. </li><li>The <code>include</code>
>and <code>exclude</code> options on <a shape="rect"
>href="file2.html">File2</a> and <a shape="rect" href="ftp.html">FTP</a>
>endpoints is now case in-sensitive out of the box.</li><li>Resource based
>component such as <a shape="rect" href="xslt.html">XSLT</a>, <a
>shape="rect" href="velocity.html">Velocity</a>
0;etc can load the resource file from the <a shape="rect"
href="registry.html">Registry</a> by using <code>ref:</code> as
prefix.</li><li><span>Upgraded camel-amqp to the latest qpid-jms-client (also
AMQP < 1.0 is not supported anymore).</span></li><li><span>Many improvements
to Camel <a shape="rect" href="amqp.html">AMQP</a>
component.</span></li><li><span>The <a shape="rect"
href="metrics-component.html">Metrics Component</a> allows to capture <a
shape="rect" href="message-history.html">Message History</a> performance
statistics with
the <code>MetricsMessageHistoryFactory </code></span></li><li>Reduced
the number of mbeans enlisted in the services tree, to only include mbeans that
has value to be managed.</li><li>The <a shape="rect"
href="elasticsearch.html">Elasticsearch Component</a> now supports
MultiGet operation</li><li>The <a shape="rect"
href="throttler.html">Throttler</a> has been improved to be more performant and
use a
rolling window for time periods which gives a better
flow.</li><li>The <code>setHeader</code>
and <code>setExchangeProperty</code> allows to use a dynamic header key
using the <a shape="rect" href="simple.html">Simple</a> language if
the name of the key is a <a shape="rect"
href="simple.html">Simple</a> language expression.</li><li>Add collate
function to <a shape="rect" href="simple.html">Simple</a> language to make
it easier to split a message body into sub lists of a specified size. The
function is similar to the collate function from Groovy.</li><li>The <a
shape="rect" href="camel-run-maven-goal.html">Camel Run Maven Goal</a> is able
to auto detect if its a OSGi Blueprint or CDI project so end users no longer
have to explicit configure this on the plugin.</li><li><a shape="rect"
href="elasticsearch.html">Camel-Elasticsearch</a> now supports Multiget,
Multisearch and exists operation</li><li><a shape="rect"
href="git.html">Camel-Git</a> no
w supports Cherry-pick operation</li><li>Stopping the <code>Main</code>
class from JMX will now trigger shutdown of the Main class/JVM also, as it does
when hitting ctrl + c.</li><li>Added option to skipFirst to the <a
shape="rect" href="tokenizer.html">Tokenizer</a> language to make it easy to
skip the very first element, when for example splitting a CSV file using
the <a shape="rect" href="splitter.html">Splitter</a>
EIP.</li></ul><p>Fixed these issues</p><ul><li>The <a shape="rect"
href="swagger-java.html">Swagger Java</a> now parses nested types in the POJO
model that has been annotated with the swagger api annotations to use in the
schema api model</li><li>Fixed <a shape="rect" href="rest-dsl.html">Rest
DSL</a> with apiContextPath fail to start if there are 2 ore more rest's
in use.</li><li>Paho component name is not limited to 4 characters
anymore.</li><li>Fixed <a shape="rect" href="spring-boot.html">Spring
Boot</a> not starting Camel routes
if running in Spring Cloud.</li><li>Fixed an issue with <a shape="rect"
href="swagger-java.html">Swagger Java</a> using api-docs could lead to api-doc
route being added multiple times</li><li>Fixed a few things missing in the
generated swagger model when using <a shape="rect"
href="swagger-java.html">Swagger Java</a></li><li>Fixed
using <code>statement.xxx</code> options on the <a shape="rect"
href="jdbc.html">JDBC</a> consumer would only be used in first
poll.</li><li>Fixed  <a shape="rect"
href="http.html">HTTP</a> and <a shape="rect"
href="http4.html">HTTP4</a> to keep trailing slash if provided in uri when
calling remote HTTP service.</li><li>Fixed <a shape="rect"
href="oncompletion.html">OnCompletion</a> to keep any caught exception stored
as property on the <code>Exchange</code> which allows to access that
information to know if there was an exception during
routing.</li><li>Fixed <a shape="rect" href="idempotent-consumer
.html">Idempotent Consumer</a> would not propagate exception thrown
from <code>IdempotentRepository</code> to Camel's <a shape="rect"
href="error-handler.html">Error Handler</a> such
as <code>onException</code><code><br clear="none"></code></li></ul><h3
id="Camel2.17.0Release-New">New <a shape="rect"
href="enterprise-integration-patterns.html">Enterprise Integration
Patterns</a></h3><h3 id="Camel2.17.0Release-New.1">New <a shape="rect"
href="components.html">Components</a></h3><ul><li>camel-kubernetes - Integrates
Camel with Kubernetes</li><li>camel-aws - AWS kinesis streams component
added</li><li>camel-aws - DynamoDB streams component added</li><li><a
shape="rect" href="ignite.html">camel-ignite</a> - for working with Apache
Ignite.</li><li>camel-mllp - <span style="color: rgb(0,0,0);">for working
with the HL7 MLLP protocol. This is an alternative to <a shape="rect"
href="hl7.html">HL7</a> component.</span></li><li>camel-spark - bridges Apache
Spark comput
ations with Camel endpoints</li><li>camel-sql - Now supports calling stored
procedures using the new sql-stored component.</li><li>camel-braintree - for
interacting with Braintree Payments.</li></ul><h3
id="Camel2.17.0Release-NewDSL">New DSL</h3><h3
id="Camel2.17.0Release-NewAnnotations">New Annotations</h3><h3
id="Camel2.17.0Release-NewDataFormats">New <a shape="rect"
href="data-format.html">Data Formats</a></h3><ul><li><a shape="rect"
href="mime-multipart.html">MIME-Multipart</a> - mime based data
format.</li></ul><h3 id="Camel2.17.0Release-New.2">New <a shape="rect"
href="languages.html">Languages</a></h3><h3 id="Camel2.17.0Release-New.3">New
<a shape="rect"
href="examples.html">Examples</a></h3><ul><li>camel-example-spring-boot-metrics
- showing a Camel spring-boot application that report metrics to Graphite.
Requires Graphite running on your
network.</li><li>camel-example-widget-gadget-java - The Widget and Gadget
use-case from the EIP book implemented in plain old Java Main wi
thout any kind of <em>application
server</em>.</li><li>camel-example-widget-gadget-xml - The Widget and Gadget
use-case from the EIP book implemented in Spring XML without any Java code or
any kind of <em>application server</em>.</li></ul><h3
id="Camel2.17.0Release-New.4">New <a shape="rect"
href="tutorials.html">Tutorials</a></h3><h2
id="Camel2.17.0Release-APIbreaking">API breaking</h2><h2
id="Camel2.17.0Release-KnownIssues">Known Issues</h2><h2
id="Camel2.17.0Release-Dependencyupgrades">Dependency
upgrades</h2><ul><li>Apache Cassandra from 2.1.8 to 2.2.2</li><li>Apache
Deltaspike from 1.5.1 to 1.5.2</li><li>Apache Gora from 0.6 to
0.6.1</li><li>Apache Jackrabbit from 2.11.0 to 2.11.3</li><li>Apache Kafka from
0.8.2.2 to 0.9.0.0</li><li>Apache Lucene from 4.10.4 to 5.2.1</li><li>Apache
Mina from 2.0.9 to 2.0.10</li><li>Apache OpenEjb from 4.7.2 to
4.7.3</li><li>Apache Solr from 4.10.4 to 5.2.1</li><li>Aws SDK Java to version
1.10.37</li><li>Atmosphere from <span class="blob-co
de-inner">2.4.0</span> to 2.4.1.4</li><li>Cassandra driver from 2.1.8 to
2.1.9</li><li>Cassandra-unit from 2.1.9.2 to 2.2.2.1</li><li>Cglib from 3.1 to
3.2.0</li><li>Classmate from 1.3.0 to 1.3.1</li><li>Chunk from 3.0.1 to
3.1.2</li><li>Drools from 6.2.0.Final to 6.3.0.Final</li><li>EHCache from
2.10.0 to 2.10.1</li><li>Elasticsearch from 1.7.3 to 2.0.0</li><li>Embedded
Mongodb from 1.50.0 to 1.50.1</li><li>Facebook4j from 2.3.1 to
2.4.1</li><li>GAE from 1.9.26 to 1.9.28</li><li>Google Gson from 2.4 to
2.5</li><li>Hazelcast from 3.5.2 to 3.5.4</li><li>Infinispan from 8.0.1.Final
to 8.1.0.Final</li><li>Jackson from 2.6.3 to 2.6.4</li><li>Jboss Xnio from
3.3.1.Final to 3.3.2.Final</li><li>Jboss Weld from 2.3.0.Final to
2.3.2.Final</li><li>Jbpm from 6.2.0.Final to 6.3.0.Final</li><li>Jgit from
<span class="blob-code-inner">4.1.<span class="x x-first
x-last">0.201509280440</span>-r</span> to <span
class="blob-code-inner">4.1.<span class="x x-first
x-last">1.201511131810</span>-r</span>
</li><li>Joda-time from 2.8.2 to 2.9.1</li><li>Json-path from 2.0.0 to
2.1.0</li><li>Jt400 from 8.6 to 8.7</li><li>Kie from 6.2.0.Final to
6.3.0.Final</li><li>Maven Exec plugin from 1.2.1 to 1.4.0</li><li>Mongodb Java
driver from 3.0.4 to 3.2.0</li><li>Mvel from 2.2.6.Final to
2.2.7.Final</li><li>Ognl from 3.1 to 3.1.1</li><li>Olingo from 2.0.4 to
2.0.5</li><li>Optaplanner from 6.2.0.Final to 6.3.0.Final</li><li>Pax-exam from
4.6.0 to 4.8.0</li><li>Spring 4.1.x to 4.2.x</li><li>Spring-Boot 1.2.x to
1.3.x</li><li>Spring Integration 2.x to 4.x</li><li>slf4j-api 1.6.x to
1.7.x</li><li>Undertow from 1.3.3.Final to 1.3.7.Final</li><li>Vertx from 3.1.0
to 3.2.0</li><li>Zookeeper from 3.4.6 to 3.4.7</li></ul><h2
id="Camel2.17.0Release-Importantchangestoconsiderwhenupgrading">Important
changes to consider when upgrading</h2><ul><li>Removed camel-hbase as Karaf
feature as it did not really work well in OSGi</li><li>camel-infinispan
requires Java 8.</li><li>Support for Spring 4.0.x is depreca
ted.</li><li>Moved some Camel tooling related dependencies (such as
maven/plexus) from the Camel Parent BOM to the tooling BOM (to have them
separated).</li><li>camel-amqp do not support 0.9
anymore. </li><li>camel-spring-integration feature has been removed from
the Camel karaf.</li><li>The <a shape="rect" href="mail.html">Mail</a>
component now requires to configure to, cc, and bcc using lower case keys, eg
to=f...@bar.com, instead of <a shape="rect" class="external-link"
href="mailto:To=f...@bar.com"; rel="nofollow">To=f...@bar.com</a> as
previously.</li><li>If using <a shape="rect"
href="bean.html">Bean</a> or <a shape="rect"
href="class.html">Class</a> component and specifying additional parameters
in the endpoint uri to configure on the bean, then these options should now be
prefixed with bean., eg <code>foo=123</code> is now
<code>bean.foo=123</code>.</li><li>The <a shape="rect"
href="hbase.html">hbase</a> component now require ro
w mapping from the endpoint uri to be prefixed with <code>row.</code> as
prefix.<br clear="none">Before:
<code>family=info&qualifier=firstName&family2=birthdate&qualifier2=year</code>. After: <code>row.family=info&row.qualifier=firstName&row.family2=birthdate&row.qualifier2=year</code>.</li></ul><h2
id="Camel2.17.0Release-GettingtheDistributions">Getting the
Distributions</h2><h3 id="Camel2.17.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="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 abo
ve 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
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.17.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="conf
luenceTd"><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.17.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 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">
+<div class="wiki-content maincontent"><h1
id="Camel2.17.0Release-Camel2.17.0release(currentlyinprogress)">Camel 2.17.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.17.0Release-NewandNoteworthy">New and Noteworthy</h2><p>Welcome to
the x.y.z release which approx XXX issues resolved (new features, improvements
and bug fixes such as...)</p><ul><li>The component documentation generated from
the source code has been double checked to be up to date and include all the
options the endpoints supports.</li><li>Upgraded camel-hbase to Hadoop 2.x and
HBase 1.1.x</li><li><a shape="rect" href="tools.html"
>Camel commands</a> for <a shape="rect" href="spring-boot.html">Spring
>Boot</a></li><li>Many improvements to Camel <a shape="rect"
>href="kura.html">Kura</a></li><li>Added transacted option to <a
>shape="rect" href="sql-component.html">SQL Component</a> when used as a
>consumer in a transacted route.</li><li>Added support for UPDATE operation
>to <a shape="rect"
>href="elasticsearch.html">ElasticSearch</a>.</li><li>Allow to reuse existing
>configured Elasticsearch Client on the <a shape="rect"
>href="elasticsearch.html">ElasticSearch</a> component, instead of creating a
>client per endpoint. </li><li>The <code>include</code>
>and <code>exclude</code> options on <a shape="rect"
>href="file2.html">File2</a> and <a shape="rect" href="ftp.html">FTP</a>
>endpoints is now case in-sensitive out of the box.</li><li>Resource based
>component such as <a shape="rect" href="xslt.html">XSLT</a>, <a
>shape="rect" href="velocity.html">Velocity</a>
0;etc can load the resource file from the <a shape="rect"
href="registry.html">Registry</a> by using <code>ref:</code> as
prefix.</li><li><span>Upgraded camel-amqp to the latest qpid-jms-client (also
AMQP < 1.0 is not supported anymore).</span></li><li><span>Many improvements
to Camel <a shape="rect" href="amqp.html">AMQP</a>
component.</span></li><li><span>The <a shape="rect"
href="metrics-component.html">Metrics Component</a> allows to capture <a
shape="rect" href="message-history.html">Message History</a> performance
statistics with
the <code>MetricsMessageHistoryFactory </code></span></li><li>Reduced
the number of mbeans enlisted in the services tree, to only include mbeans that
has value to be managed.</li><li>The <a shape="rect"
href="elasticsearch.html">Elasticsearch Component</a> now supports
MultiGet operation</li><li>The <a shape="rect"
href="throttler.html">Throttler</a> has been improved to be more performant and
use a
rolling window for time periods which gives a better
flow.</li><li>The <code>setHeader</code>
and <code>setExchangeProperty</code> allows to use a dynamic header key
using the <a shape="rect" href="simple.html">Simple</a> language if
the name of the key is a <a shape="rect"
href="simple.html">Simple</a> language expression.</li><li>Add collate
function to <a shape="rect" href="simple.html">Simple</a> language to make
it easier to split a message body into sub lists of a specified size. The
function is similar to the collate function from Groovy.</li><li>The <a
shape="rect" href="camel-run-maven-goal.html">Camel Run Maven Goal</a> is able
to auto detect if its a OSGi Blueprint or CDI project so end users no longer
have to explicit configure this on the plugin.</li><li><a shape="rect"
href="elasticsearch.html">Camel-Elasticsearch</a> now supports Multiget,
Multisearch and exists operation</li><li><a shape="rect"
href="git.html">Camel-Git</a> no
w supports Cherry-pick operation</li><li>Stopping the <code>Main</code>
class from JMX will now trigger shutdown of the Main class/JVM also, as it does
when hitting ctrl + c.</li><li>Added option to skipFirst to the <a
shape="rect" href="tokenizer.html">Tokenizer</a> language to make it easy to
skip the very first element, when for example splitting a CSV file using
the <a shape="rect" href="splitter.html">Splitter</a>
EIP.</li></ul><p>Fixed these issues</p><ul><li>The <a shape="rect"
href="swagger-java.html">Swagger Java</a> now parses nested types in the POJO
model that has been annotated with the swagger api annotations to use in the
schema api model</li><li>Fixed <a shape="rect" href="rest-dsl.html">Rest
DSL</a> with apiContextPath fail to start if there are 2 ore more rest's
in use.</li><li>Paho component name is not limited to 4 characters
anymore.</li><li>Fixed <a shape="rect" href="spring-boot.html">Spring
Boot</a> not starting Camel routes
if running in Spring Cloud.</li><li>Fixed an issue with <a shape="rect"
href="swagger-java.html">Swagger Java</a> using api-docs could lead to api-doc
route being added multiple times</li><li>Fixed a few things missing in the
generated swagger model when using <a shape="rect"
href="swagger-java.html">Swagger Java</a></li><li>Fixed
using <code>statement.xxx</code> options on the <a shape="rect"
href="jdbc.html">JDBC</a> consumer would only be used in first
poll.</li><li>Fixed  <a shape="rect"
href="http.html">HTTP</a> and <a shape="rect"
href="http4.html">HTTP4</a> to keep trailing slash if provided in uri when
calling remote HTTP service.</li><li>Fixed <a shape="rect"
href="oncompletion.html">OnCompletion</a> to keep any caught exception stored
as property on the <code>Exchange</code> which allows to access that
information to know if there was an exception during routing.</li><li>Fixed an
issue with <a shape="rect" href="bean.
html">Bean</a> component or <a shape="rect" href="simple.html">Simple</a>
language with OGNL method call, would pick method with java.lang.Object type
over a better suited method, when the method is
overloaded.</li><li>Fixed <a shape="rect"
href="idempotent-consumer.html">Idempotent Consumer</a> would not propagate
exception thrown from <code>IdempotentRepository</code> to Camel's <a
shape="rect" href="error-handler.html">Error Handler</a> such
as <code>onException</code><code><br clear="none"></code></li></ul><h3
id="Camel2.17.0Release-New">New <a shape="rect"
href="enterprise-integration-patterns.html">Enterprise Integration
Patterns</a></h3><h3 id="Camel2.17.0Release-New.1">New <a shape="rect"
href="components.html">Components</a></h3><ul><li>camel-kubernetes - Integrates
Camel with Kubernetes</li><li>camel-aws - AWS kinesis streams component
added</li><li>camel-aws - DynamoDB streams component added</li><li><a
shape="rect" href="ignite.html">camel-ignite
</a> - for working with Apache Ignite.</li><li>camel-mllp - <span
style="color: rgb(0,0,0);">for working with the HL7 MLLP protocol. This is an
alternative to <a shape="rect" href="hl7.html">HL7</a>
component.</span></li><li>camel-spark - bridges Apache Spark computations with
Camel endpoints</li><li>camel-sql - Now supports calling stored procedures
using the new sql-stored component.</li><li>camel-braintree - for interacting
with Braintree Payments.</li></ul><h3 id="Camel2.17.0Release-NewDSL">New
DSL</h3><h3 id="Camel2.17.0Release-NewAnnotations">New Annotations</h3><h3
id="Camel2.17.0Release-NewDataFormats">New <a shape="rect"
href="data-format.html">Data Formats</a></h3><ul><li><a shape="rect"
href="mime-multipart.html">MIME-Multipart</a> - mime based data
format.</li></ul><h3 id="Camel2.17.0Release-New.2">New <a shape="rect"
href="languages.html">Languages</a></h3><h3 id="Camel2.17.0Release-New.3">New
<a shape="rect" href="examples.html">Examples</a></h3><ul><li>camel
-example-spring-boot-metrics - showing a Camel spring-boot application that
report metrics to Graphite. Requires Graphite running on your
network.</li><li>camel-example-widget-gadget-java - The Widget and Gadget
use-case from the EIP book implemented in plain old Java Main without any kind
of <em>application server</em>.</li><li>camel-example-widget-gadget-xml - The
Widget and Gadget use-case from the EIP book implemented in Spring XML without
any Java code or any kind of <em>application server</em>.</li></ul><h3
id="Camel2.17.0Release-New.4">New <a shape="rect"
href="tutorials.html">Tutorials</a></h3><h2
id="Camel2.17.0Release-APIbreaking">API breaking</h2><h2
id="Camel2.17.0Release-KnownIssues">Known Issues</h2><h2
id="Camel2.17.0Release-Dependencyupgrades">Dependency
upgrades</h2><ul><li>Apache Cassandra from 2.1.8 to 2.2.2</li><li>Apache
Deltaspike from 1.5.1 to 1.5.2</li><li>Apache Gora from 0.6 to
0.6.1</li><li>Apache Jackrabbit from 2.11.0 to 2.11.3</li><li>Apache Kafka
from 0.8.2.2 to 0.9.0.0</li><li>Apache Lucene from 4.10.4 to
5.2.1</li><li>Apache Mina from 2.0.9 to 2.0.10</li><li>Apache OpenEjb from
4.7.2 to 4.7.3</li><li>Apache Solr from 4.10.4 to 5.2.1</li><li>Aws SDK Java to
version 1.10.37</li><li>Atmosphere from <span
class="blob-code-inner">2.4.0</span> to 2.4.1.4</li><li>Cassandra driver from
2.1.8 to 2.1.9</li><li>Cassandra-unit from 2.1.9.2 to 2.2.2.1</li><li>Cglib
from 3.1 to 3.2.0</li><li>Classmate from 1.3.0 to 1.3.1</li><li>Chunk from
3.0.1 to 3.1.2</li><li>Drools from 6.2.0.Final to 6.3.0.Final</li><li>EHCache
from 2.10.0 to 2.10.1</li><li>Elasticsearch from 1.7.3 to
2.0.0</li><li>Embedded Mongodb from 1.50.0 to 1.50.1</li><li>Facebook4j from
2.3.1 to 2.4.1</li><li>GAE from 1.9.26 to 1.9.28</li><li>Google Gson from 2.4
to 2.5</li><li>Hazelcast from 3.5.2 to 3.5.4</li><li>Infinispan from
8.0.1.Final to 8.1.0.Final</li><li>Jackson from 2.6.3 to 2.6.4</li><li>Jboss
Xnio from 3.3.1.Final to 3.3.2.Final</li><li>Jboss Weld from 2.3.0.Fi
nal to 2.3.2.Final</li><li>Jbpm from 6.2.0.Final to 6.3.0.Final</li><li>Jgit
from <span class="blob-code-inner">4.1.<span class="x x-first
x-last">0.201509280440</span>-r</span> to <span
class="blob-code-inner">4.1.<span class="x x-first
x-last">1.201511131810</span>-r</span></li><li>Joda-time from 2.8.2 to
2.9.1</li><li>Json-path from 2.0.0 to 2.1.0</li><li>Jt400 from 8.6 to
8.7</li><li>Kie from 6.2.0.Final to 6.3.0.Final</li><li>Maven Exec plugin from
1.2.1 to 1.4.0</li><li>Mongodb Java driver from 3.0.4 to 3.2.0</li><li>Mvel
from 2.2.6.Final to 2.2.7.Final</li><li>Ognl from 3.1 to 3.1.1</li><li>Olingo
from 2.0.4 to 2.0.5</li><li>Optaplanner from 6.2.0.Final to
6.3.0.Final</li><li>Pax-exam from 4.6.0 to 4.8.0</li><li>Spring 4.1.x to
4.2.x</li><li>Spring-Boot 1.2.x to 1.3.x</li><li>Spring Integration 2.x to
4.x</li><li>slf4j-api 1.6.x to 1.7.x</li><li>Undertow from 1.3.3.Final to
1.3.7.Final</li><li>Vertx from 3.1.0 to 3.2.0</li><li>Zookeeper from 3.4.6 to
3.4.7</li></ul><h2 id="Ca
mel2.17.0Release-Importantchangestoconsiderwhenupgrading">Important changes to
consider when upgrading</h2><ul><li>Removed camel-hbase as Karaf feature as it
did not really work well in OSGi</li><li>camel-infinispan requires Java
8.</li><li>Support for Spring 4.0.x is deprecated.</li><li>Moved some Camel
tooling related dependencies (such as maven/plexus) from the Camel Parent BOM
to the tooling BOM (to have them separated).</li><li>camel-amqp do not support
0.9 anymore. </li><li>camel-spring-integration feature has been removed
from the Camel karaf.</li><li>The <a shape="rect"
href="mail.html">Mail</a> component now requires to configure to, cc, and bcc
using lower case keys, eg to=f...@bar.com, instead of <a shape="rect"
class="external-link" href="mailto:To=f...@bar.com";
rel="nofollow">To=f...@bar.com</a> as previously.</li><li>If using <a
shape="rect" href="bean.html">Bean</a> or <a shape="rect"
href="class.html">Class</a> component and speci
fying additional parameters in the endpoint uri to configure on the bean, then
these options should now be prefixed with bean., eg
<code>foo=123</code> is now <code>bean.foo=123</code>.</li><li>The <a
shape="rect" href="hbase.html">hbase</a> component now require row mapping from
the endpoint uri to be prefixed with <code>row.</code> as prefix.<br
clear="none">Before:
<code>family=info&qualifier=firstName&family2=birthdate&qualifier2=year</code>. After: <code>row.family=info&row.qualifier=firstName&row.family2=birthdate&row.qualifier2=year</code>.</li></ul><h2
id="Camel2.17.0Release-GettingtheDistributions">Getting the
Distributions</h2><h3 id="Camel2.17.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" ro
wspan="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="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="exte
rnal-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
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.17.0Release-SourceDistributions">Source Distributions</h3><div
class="table-wrap"><table class="confluenceTable"><tbody><tr><th colsp
an="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.17.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 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>
Modified: websites/production/camel/content/cometd.html
==============================================================================
--- websites/production/camel/content/cometd.html (original)
+++ websites/production/camel/content/cometd.html Sat Jan 16 09:25:55 2016
@@ -100,7 +100,7 @@
<pre>cometd://localhost:8080/service/mychannel
cometds://localhost:8443/service/mychannel
</pre>
-</div></div><p>where <code>cometds:</code> represents an SSL configured
endpoint.</p><h3 id="Cometd-Options">Options</h3><div
class="confluenceTableSmall"><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p>Name</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Default Value</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>resourceBase</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The root directory for the web resources or
classpath. Use the protocol file: or classpath: depending if you want that the
component loads the resource from file system or classpath. Classpath is
required for OSGI deployment where the resources are packaged in the jar.
Notice this option has been renamed to <code>baseResource</code> from
<strong>Cam
el 2.7</strong> onwards.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>baseResource</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.7:</strong> The root directory for the
web resources or classpath. Use the protocol file: or classpath: depending if
you want that the component loads the resource from file system or classpath.
Classpath is required for OSGI deployment where the resources are packaged in
the jar</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>timeout</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>240000</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The server side poll timeout in
milliseconds. This is how long the server will hold a reconnect request before
responding.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>interval</code></p></td><
td colspan="1" rowspan="1" class="confluenceTd"><p><code>0</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>The client side poll timeout in
milliseconds. How long a client will wait between
reconnects</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>maxInterval</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>30000</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The max client side poll timeout in
milliseconds. A client will be removed if a connection is not received in this
time.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>multiFrameInterval</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>1500</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The client side poll timeout, if multiple
connections are detected from the same browser.</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>jsonCommented</code>
</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>true</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>If <code>true</code>, the server will accept JSON
wrapped in a comment and will generate JSON wrapped in a comment. This is a
defence against Ajax Hijacking.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>logLevel</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>1</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>0</code>=none, <code>1</code>=info,
<code>2</code>=debug.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>crossOriginFilterOn</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><strong>Camel 2.10:</strong> If
<code>true</code>, the server will support for cross-domain
filtering</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><
p><code>allowedOrigins</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>*</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.10:</strong> The origins domain that
support to cross, if the <code>crosssOriginFilterOn</code> is
<code>true</code></p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>filterPath</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.10:</strong> The filterPath will be
used by the CrossOriginFilter, if the <code>crosssOriginFilterOn</code> is
<code>true</code></p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>disconnectLocalSession</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>true</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><strong>Camel 2.10.5/2.11.1:
(Producer only)</strong>: Whether to disconnect local sessions
after publishing a message to its channel. Disconnecting local session is
needed as they are not swept by default by CometD, and therefore you can run
out of memory.</p></td></tr></tbody></table></div></div><p>You can append query
options to the URI in the following format,
<code>?option=value&option=value&...</code></p><p>Here is some examples
on How to pass the parameters</p><p>For file (for webapp resources located in
the Web Application directory -->
cometd://localhost:8080?resourceBase=file./webapp<br clear="none"> For
classpath (when by example the web resources are packaged inside the webapp
folder --> cometd://localhost:8080?resourceBase=classpath:webapp</p><h3
id="Cometd-Authentication">Authentication</h3><p><strong>Available as of Camel
2.8</strong></p><p>You can configure custom <code>SecurityPolicy</code> and
<code>Extension</code>'s to the <code>CometdComponent</code> which allows you
to use authentication as <a shape="rect" class="external-link" href="ht
tp://cometd.org/documentation/howtos/authentication" rel="nofollow">documented
here</a></p><h3 id="Cometd-SettingupSSLforCometdComponent">Setting up SSL for
Cometd Component</h3><h4 id="Cometd-UsingtheJSSEConfigurationUtility">Using the
JSSE Configuration Utility</h4><p>As of Camel 2.9, the Cometd component
supports SSL/TLS configuration through the <a shape="rect"
href="camel-configuration-utilities.html">Camel JSSE Configuration
Utility</a>.  This utility greatly decreases the amount of component
specific code you need to write and is configurable at the endpoint and
component levels.  The following examples demonstrate how to use the
utility with the Cometd component. You need to configure SSL on the
CometdComponent.</p><h5
id="Cometd-Programmaticconfigurationofthecomponent">Programmatic configuration
of the component</h5><div class="code panel pdl" style="border-width:
1px;"><div class="codeContent panelContent pdl">
+</div></div><p>where <code>cometds:</code> represents an SSL configured
endpoint.</p><h3 id="Cometd-Options">Options</h3><div
class="confluenceTableSmall"><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p>Name</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Default Value</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>resourceBase</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The root directory for the web resources or
classpath. Use the protocol file: or classpath: depending if you want that the
component loads the resource from file system or classpath. Classpath is
required for OSGI deployment where the resources are packaged in the jar.
Notice this option has been renamed to <code>baseResource</code> from
<strong>Cam
el 2.7</strong> onwards.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>baseResource</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.7:</strong> The root directory for the
web resources or classpath. Use the protocol file: or classpath: depending if
you want that the component loads the resource from file system or classpath.
Classpath is required for OSGI deployment where the resources are packaged in
the jar</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>timeout</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>240000</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The server side poll timeout in
milliseconds. This is how long the server will hold a reconnect request before
responding.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>interval</code></p></td><
td colspan="1" rowspan="1" class="confluenceTd"><p><code>0</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>The client side poll timeout in
milliseconds. How long a client will wait between
reconnects</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>maxInterval</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>30000</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The max client side poll timeout in
milliseconds. A client will be removed if a connection is not received in this
time.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>multiFrameInterval</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>1500</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The client side poll timeout, if multiple
connections are detected from the same browser.</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>jsonCommented</code>
</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>true</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>If <code>true</code>, the server will accept JSON
wrapped in a comment and will generate JSON wrapped in a comment. This is a
defence against Ajax Hijacking.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>logLevel</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>1</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>0</code>=none, <code>1</code>=info,
<code>2</code>=debug.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>crossOriginFilterOn</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><strong>Camel 2.10:</strong> If
<code>true</code>, the server will support for cross-domain
filtering</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><
p><code>allowedOrigins</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>*</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.10:</strong> The origins domain that
support to cross, if the <code>crosssOriginFilterOn</code> is
<code>true</code></p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>filterPath</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.10:</strong> The filterPath will be
used by the CrossOriginFilter, if the <code>crosssOriginFilterOn</code> is
<code>true</code></p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>disconnectLocalSession</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel 2.10.5/2.11.1: (Producer
only)</strong>: Whether to disconnect local sessions after publ
ishing a message to its channel. Disconnecting local session is needed as they
are not swept by default by CometD, and therefore you can run out of memory. In
Camel 2.16.1/2.15.5 or older the default value is true. From newer versions the
default value is false.</p></td></tr></tbody></table></div></div><p>You can
append query options to the URI in the following format,
<code>?option=value&option=value&...</code></p><p>Here is some examples
on How to pass the parameters</p><p>For file (for webapp resources located in
the Web Application directory -->
cometd://localhost:8080?resourceBase=file./webapp<br clear="none"> For
classpath (when by example the web resources are packaged inside the webapp
folder --> cometd://localhost:8080?resourceBase=classpath:webapp</p><h3
id="Cometd-Authentication">Authentication</h3><p><strong>Available as of Camel
2.8</strong></p><p>You can configure custom <code>SecurityPolicy</code> and
<code>Extension</code>'s to the <code>CometdComponent
</code> which allows you to use authentication as <a shape="rect"
class="external-link"
href="http://cometd.org/documentation/howtos/authentication";
rel="nofollow">documented here</a></p><h3
id="Cometd-SettingupSSLforCometdComponent">Setting up SSL for Cometd
Component</h3><h4 id="Cometd-UsingtheJSSEConfigurationUtility">Using the JSSE
Configuration Utility</h4><p>As of Camel 2.9, the Cometd component supports
SSL/TLS configuration through the <a shape="rect"
href="camel-configuration-utilities.html">Camel JSSE Configuration
Utility</a>.  This utility greatly decreases the amount of component
specific code you need to write and is configurable at the endpoint and
component levels.  The following examples demonstrate how to use the
utility with the Cometd component. You need to configure SSL on the
CometdComponent.</p><h5
id="Cometd-Programmaticconfigurationofthecomponent">Programmatic configuration
of the component</h5><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[KeyStoreParameters ksp = new
KeyStoreParameters();
ksp.setResource("/users/home/server/keystore.jks");
ksp.setPassword("keystorePassword");
Modified: websites/production/camel/content/validation.html
==============================================================================
--- websites/production/camel/content/validation.html (original)
+++ websites/production/camel/content/validation.html Sat Jan 16 09:25:55 2016
@@ -86,53 +86,18 @@
<tbody>
<tr>
<td valign="top" width="100%">
-<div class="wiki-content maincontent"><h2
id="Validation-ValidationComponent">Validation Component</h2>
-
-<p>The Validation component performs XML validation of the message body using
the JAXP Validation API and based on any of the supported XML schema languages,
which defaults to <a shape="rect" class="external-link"
href="http://www.w3.org/XML/Schema"; rel="nofollow">XML Schema</a> </p>
-
-<p>Note that the <a shape="rect" href="jing.html">Jing</a> component also
supports the following useful schema languages:</p>
-
-<ul><li><a shape="rect" class="external-link"
href="http://relaxng.org/compact-tutorial-20030326.html"; rel="nofollow">RelaxNG
Compact Syntax</a></li><li><a shape="rect" class="external-link"
href="http://relaxng.org/"; rel="nofollow">RelaxNG XML Syntax</a></li></ul>
-
-
-<p>The <a shape="rect" href="msv.html">MSV</a> component also supports <a
shape="rect" class="external-link" href="http://relaxng.org/";
rel="nofollow">RelaxNG XML Syntax</a>.</p>
-
-<h3 id="Validation-URIformat">URI format</h3>
-
-<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[
-validator:someLocalOrRemoteResource
+<div class="wiki-content maincontent"><h2
id="Validation-ValidationComponent">Validation Component</h2><p>The Validation
component performs XML validation of the message body using the JAXP Validation
API and based on any of the supported XML schema languages, which defaults to
<a shape="rect" class="external-link" href="http://www.w3.org/XML/Schema";
rel="nofollow">XML Schema</a></p><p>Note that the <a shape="rect"
href="jing.html">Jing</a> component also supports the following useful schema
languages:</p><ul><li><a shape="rect" class="external-link"
href="http://relaxng.org/compact-tutorial-20030326.html"; rel="nofollow">RelaxNG
Compact Syntax</a></li><li><a shape="rect" class="external-link"
href="http://relaxng.org/"; rel="nofollow">RelaxNG XML
Syntax</a></li></ul><p>The <a shape="rect" href="msv.html">MSV</a> component
also supports <a shape="rect" class="external-link" href="http://relaxng.org/";
rel="nofollow">RelaxNG XML Syntax</a>.</p><h3 id="Validation-URIformat">URI
format</h
3><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[validator:someLocalOrRemoteResource
]]></script>
-</div></div>
-
-<p>Where <strong>someLocalOrRemoteResource</strong> is some URL to a local
resource on the classpath or a full URL to a remote resource or resource on the
file system which contains the XSD to validate against. For example:</p>
-
-<ul><li><code>msv:org/foo/bar.xsd</code></li><li><code>msv:file:../foo/bar.xsd</code></li><li><code>msv:<a
shape="rect" class="external-link" href="http://acme.com/cheese.xsd";
rel="nofollow">http://acme.com/cheese.xsd</a></code></li><li><code>validator:com/mypackage/myschema.xsd</code></li></ul>
-
-
-<p>Maven users will need to add the following dependency to their
<code>pom.xml</code> for this component when using <strong>Camel 2.8</strong>
or older:</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><p>Where <strong>someLocalOrRemoteResource</strong> is some URL to
a local resource on the classpath or a full URL to a remote resource or
resource on the file system which contains the XSD to validate against. For
example:</p><ul><li><code>msv:org/foo/bar.xsd</code></li><li><code>msv:file:../foo/bar.xsd</code></li><li><code>msv:<a
shape="rect" class="external-link" href="http://acme.com/cheese.xsd";
rel="nofollow">http://acme.com/cheese.xsd</a></code></li><li><code>validator:com/mypackage/myschema.xsd</code></li></ul><p>Maven
users will need to add the following dependency to their <code>pom.xml</code>
for this component when using <strong>Camel 2.8</strong> or older:</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-spring</artifactId>
<version>x.x.x</version>
<!-- use the same version as your Camel core version -->
</dependency>
]]></script>
-</div></div>
-<p>From Camel 2.9 onwards the <a shape="rect"
href="validation.html">Validation</a> component is provided directly in the
camel-core.</p>
-
-<h3 id="Validation-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>
<code>resourceResolver</code> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>null</code> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> <strong>Camel 2.9:</strong> Reference to a
<code>org.w3c.dom.ls.LSResourceResolver</code> in the <a shape="rect"
href="registry.html">Registry</a>. </p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>useDom</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>false</code>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Whether
<code>DOMSource</code>/<code>DOMResult</code> or
<code>SaxSource</code>/<code>SaxResult</code>
should be used by the validator. </p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>useSharedSchema</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>true</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <strong>Camel 2.3:</strong>
Whether the <code>Schema</code> instance should be shared or not. This option
is introduced to work around a <a shape="rect" class="external-link"
href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6773084";
rel="nofollow">JDK 1.6.x bug</a>. Xerces should not have this issue.
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
<code>failOnNullBody</code> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>true</code> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> <strong>Camel 2.9.5/2.10.3:</strong> Whether to fail
if no body exists. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>headerName</code> </p
></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>null</code>
></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <strong>Camel
>2.11:</strong> To validate against a header instead of the message body.
></p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
><code>failOnNullHeader</code> </p></td><td colspan="1" rowspan="1"
>class="confluenceTd"><p> <code>true</code> </p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p> <strong>Camel 2.11:</strong> Whether to
>fail if no header exists when validating against a header.
></p></td></tr></tbody></table></div>
-</div>
-
-<h3 id="Validation-Example">Example</h3>
-
-<p>The following <a shape="rect" class="external-link"
href="http://svn.apache.org/repos/asf/camel/trunk/components/camel-spring/src/test/resources/org/apache/camel/component/validator/camelContext.xml";>example</a>
shows how to configure a route from endpoint <strong>direct:start</strong>
which then goes to one of two endpoints, either <strong>mock:valid</strong> or
<strong>mock:invalid</strong> based on whether or not the XML matches the given
schema (which is supplied on the classpath).</p>
-
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
+</div></div><p>From Camel 2.9 onwards the <a shape="rect"
href="validation.html">Validation</a> component is provided directly in the
camel-core.</p><h3 id="Validation-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><code>resourceResolver</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><strong>Camel 2.9:</strong>
Reference to a <code>org.w3c.dom.ls.LSResourceResolver</code> in the <a
shape="rect" href="registry.html">Registry</a>.</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>useDom</code></p></td><td
colspan="1" rowspan="1"
class="confluenceTd"><p><code>false</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Whether
<code>DOMSource</code>/<code>DOMResult</code> or
<code>SaxSource</code>/<code>SaxResult</code> should be used by the
validator.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>useSharedSchema</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>true</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel 2.3:</strong> Whether the
<code>Schema</code> instance should be shared or not. This option is introduced
to work around a <a shape="rect" class="external-link"
href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6773084";
rel="nofollow">JDK 1.6.x bug</a>. Xerces should not have this
issue.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>failOnNullBody</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>true</code></p></td><td colspan="1"
rowspan="1"
class="confluenceTd"><p><strong>Camel 2.9.5/2.10.3:</strong> Whether to fail
if no body exists.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>headerName</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel 2.11:</strong> To validate
against a header instead of the message body.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>failOnNullHeader</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>true</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><strong>Camel 2.11:</strong>
Whether to fail if no header exists when validating against a
header.</p></td></tr></tbody></table></div></div><h3
id="Validation-Example">Example</h3><p>The following <a shape="rect"
class="external-link"
href="http://svn.apache.org/repos/asf/camel/trunk/components/camel-spring/src/test/resources/org/apache/camel/c
omponent/validator/camelContext.xml">example</a> shows how to configure a
route from endpoint <strong>direct:start</strong> which then goes to one of two
endpoints, either <strong>mock:valid</strong> or <strong>mock:invalid</strong>
based on whether or not the XML matches the given schema (which is supplied on
the classpath).</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[
<route>
<from uri="direct:start"/>
@@ -149,9 +114,7 @@ validator:someLocalOrRemoteResource
</doTry>
</route>
]]></script>
-</div></div>
-
-<h3 id="Validation-SeeAlso">See Also</h3>
+</div></div><h3 id="Validation-Advanced:JMXmethodclearCachedSchema">Advanced:
JMX method clearCachedSchema</h3><p>Since <strong>Camel 2.17</strong>, you can
force that the cached schema in the validator endpoint is cleared and reread
with the next process call with the JMX operation <code>clearCachedSchema.
</code>You can also use this method to programmatically clear the cache. This
method is available on the <code>ValidatorEndpoint
</code>class<code>.</code></p><p></p><h3 id="Validation-SeeAlso">See Also</h3>
<ul><li><a shape="rect" href="configuring-camel.html">Configuring
Camel</a></li><li><a shape="rect"
href="component.html">Component</a></li><li><a shape="rect"
href="endpoint.html">Endpoint</a></li><li><a shape="rect"
href="getting-started.html">Getting Started</a></li></ul></div>
</td>
<td valign="top">
![http://camel.apache.org/download.data/camel-box-v1.0-150x200.png"](http://camel.apache.org/download.data/camel-box-v1.0-150x200.png"){kind=link}