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 2014/02/25 16:22:17 UTC
svn commit: r899164 [3/6] - in /websites/production/camel/content: ./
2010/05/26/ 2014/02/ 2014/02/25/ cache/
Modified: websites/production/camel/content/book-in-one-page.html
==============================================================================
--- websites/production/camel/content/book-in-one-page.html (original)
+++ websites/production/camel/content/book-in-one-page.html Tue Feb 25 15:22:16 2014
@@ -548,7 +548,7 @@ Camel uses a Java based <a shape="rect"
</div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p>For working with <a shape="rect" class="external-link" href="http://aws.amazon.com/s3/" rel="nofollow">Amazon's Simple Storage Service (S3)</a>.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" href="bean.html">Bean</a> / camel-core</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: plain; gutter: false" type="syntaxhighlighter"><![CDATA[bean:beanName[?options]
]]></script>
-</div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Uses the <a shape="rect" href="bean-binding.html">Bean Binding</a> to bind message exchanges to beans in the <a shape="rect" href="registry.html">Registry</a>. Is also used for exposing and invoking POJO (Plain Old Java Objects).</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" href="bean-validation.html">Bean Validation</a> / camel-bean-validator</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+</div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Uses the <a shape="rect" href="bean-binding.html">Bean Binding</a> to bind message exchanges to beans in the <a shape="rect" href="registry.html">Registry</a>. Is also used for exposing and invoking POJO (Plain Old Java Objects).</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" href="bean-validator.html">Bean Validator</a> / camel-bean-validator</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: plain; gutter: false" type="syntaxhighlighter"><![CDATA[bean-validator:label[?options]
]]></script>
</div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Validates the payload of a message using the Java Validation API (<a shape="rect" class="external-link" href="http://jcp.org/en/jsr/detail?id=303" rel="nofollow">JSR 303</a> and JAXP Validation) and its reference implementation <a shape="rect" class="external-link" href="http://docs.jboss.org/hibernate/stable/validator/reference/en/html_single/" rel="nofollow">Hibernate Validator</a></p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" href="browse.html">Browse</a> / camel-core</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
@@ -4269,11 +4269,11 @@ While not actual tutorials you might fin
<p>This tutorial aims to guide the reader through the stages of creating a project which uses Camel to facilitate the routing of messages from a JMS queue to a <a shape="rect" class="external-link" href="http://www.springramework.org" rel="nofollow">Spring</a> service. The route works in a synchronous fashion returning a response to the client.</p>
<style type="text/css">/*<![CDATA[*/
-div.rbtoc1392808726908 {padding: 0px;}
-div.rbtoc1392808726908 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1392808726908 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1393341552744 {padding: 0px;}
+div.rbtoc1393341552744 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1393341552744 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style><div class="toc-macro rbtoc1392808726908">
+/*]]>*/</style><div class="toc-macro rbtoc1393341552744">
<ul class="toc-indentation"><li><a shape="rect" href="#Tutorial-JmsRemoting-TutorialonSpringRemotingwithJMS">Tutorial on Spring Remoting with JMS</a></li><li><a shape="rect" href="#Tutorial-JmsRemoting-Preface">Preface</a></li><li><a shape="rect" href="#Tutorial-JmsRemoting-Prerequisites">Prerequisites</a></li><li><a shape="rect" href="#Tutorial-JmsRemoting-Distribution">Distribution</a></li><li><a shape="rect" href="#Tutorial-JmsRemoting-About">About</a></li><li><a shape="rect" href="#Tutorial-JmsRemoting-CreatetheCamelProject">Create the Camel Project</a>
<ul class="toc-indentation"><li><a shape="rect" href="#Tutorial-JmsRemoting-UpdatethePOMwithDependencies">Update the POM with Dependencies</a></li></ul>
</li><li><a shape="rect" href="#Tutorial-JmsRemoting-WritingtheServer">Writing the Server</a>
@@ -6614,11 +6614,11 @@ So we completed the last piece in the pi
<style type="text/css">/*<![CDATA[*/
-div.rbtoc1392808727338 {padding: 0px;}
-div.rbtoc1392808727338 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1392808727338 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1393341552972 {padding: 0px;}
+div.rbtoc1393341552972 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1393341552972 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style><div class="toc-macro rbtoc1392808727338">
+/*]]>*/</style><div class="toc-macro rbtoc1393341552972">
<ul class="toc-indentation"><li><a shape="rect" href="#Tutorial-AXIS-Camel-TutorialusingAxis1.4withApacheCamel">Tutorial using Axis 1.4 with Apache Camel</a>
<ul class="toc-indentation"><li><a shape="rect" href="#Tutorial-AXIS-Camel-Prerequisites">Prerequisites</a></li><li><a shape="rect" href="#Tutorial-AXIS-Camel-Distribution">Distribution</a></li><li><a shape="rect" href="#Tutorial-AXIS-Camel-Introduction">Introduction</a></li><li><a shape="rect" href="#Tutorial-AXIS-Camel-SettinguptheprojecttorunAxis">Setting up the project to run Axis</a>
<ul class="toc-indentation"><li><a shape="rect" href="#Tutorial-AXIS-Camel-Maven2">Maven 2</a></li><li><a shape="rect" href="#Tutorial-AXIS-Camel-wsdl">wsdl</a></li><li><a shape="rect" href="#Tutorial-AXIS-Camel-ConfiguringAxis">Configuring Axis</a></li><li><a shape="rect" href="#Tutorial-AXIS-Camel-RunningtheExample">Running the Example</a></li></ul>
@@ -20877,37 +20877,17 @@ droppable = false}
<h3 id="BookInOnePage-SeeAlso.20">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 class="error"><span class="error">Unable to render {include}</span> The included page could not be found.</div>
-<h2 id="BookInOnePage-AMQP">AMQP</h2>
-
-
-<p><strong>Available as of Camel X.X</strong></p>
-
-<p>The <strong>amqp:</strong> component supports the <a shape="rect" class="external-link" href="http://www.amqp.org/" rel="nofollow">AMQP protocol</a> using the Client API of the <a shape="rect" class="external-link" href="http://qpid.apache.org/">Qpid</a> project.</p>
-
-<p>Maven users will need to add the following dependency to their <code>pom.xml</code> for this component:</p>
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: xml; gutter: false" type="syntaxhighlighter"><![CDATA[
-<dependency>
+<h2 id="BookInOnePage-AMQP">AMQP</h2><p><strong>Available as of Camel X.X</strong></p><p>The <strong>amqp:</strong> component supports the <a shape="rect" class="external-link" href="http://www.amqp.org/" rel="nofollow">AMQP protocol</a> using the Client API of the <a shape="rect" class="external-link" href="http://qpid.apache.org/">Qpid</a> project. In case you want to use AMQP with RabbitMQ you might also be interested in the <a shape="rect" href="rabbitmq.html">Camel RabbitMQ</a> component.</p><p>Maven users will need to add the following dependency to their <code>pom.xml</code> for this component:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+<script class="theme: Default; brush: xml; gutter: false" type="syntaxhighlighter"><![CDATA[<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-amqp</artifactId>
<version>${camel.version}</version> <!-- use the same version as your Camel core version -->
</dependency>
]]></script>
-</div></div>
-
-<h3 id="BookInOnePage-URIformat.2">URI format</h3>
-
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[
-amqp:[queue:|topic:]destinationName[?options]
+</div></div><h3 id="BookInOnePage-URIformat.2">URI format</h3><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[amqp:[queue:|topic:]destinationName[?options]
]]></script>
-</div></div>
-
-<h3 id="BookInOnePage-AMQPOptions">AMQP Options</h3>
-
-<p>You can specify all of the various configuration options of the <a shape="rect" href="jms.html">JMS</a> component after the destination name.</p>
-
-<h3 id="BookInOnePage-SeeAlso.21">See Also</h3>
+</div></div><h3 id="BookInOnePage-AMQPOptions">AMQP Options</h3><p>You can specify all of the various configuration options of the <a shape="rect" href="jms.html">JMS</a> component after the destination name.</p><p></p><h3 id="BookInOnePage-SeeAlso.21">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>
<h2 id="BookInOnePage-SQSComponent">SQS Component</h2><p><strong>Available as of Camel 2.6</strong></p><p>The sqs component supports sending and receiving messages to <a shape="rect" class="external-link" href="http://aws.amazon.com/sqs" rel="nofollow">Amazon's SQS</a> service.</p> <div class="aui-message hint shadowed information-macro">
<p class="title">Prerequisites</p>
@@ -21254,124 +21234,13 @@ from("direct:start").bean(Exam
<h3 id="BookInOnePage-SeeAlso.24">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>
<ul><li><a shape="rect" href="class.html">Class</a> component</li><li><a shape="rect" href="bean-binding.html">Bean Binding</a></li><li><a shape="rect" href="bean-integration.html">Bean Integration</a></li></ul>
-<h2 id="BookInOnePage-BeanValidationComponent">Bean Validation Component</h2><p><strong>Available as of Camel 2.3</strong></p><p>The Validation component performs bean validation of the message body using the Java Bean Validation API (<a shape="rect" class="external-link" href="http://jcp.org/en/jsr/detail?id=303" rel="nofollow">JSR 303</a>). Camel uses the reference implementation, which is <a shape="rect" class="external-link" href="http://docs.jboss.org/hibernate/validator/4.3/reference/en-US/html_single/" rel="nofollow">Hibernate Validator</a>.</p><p>Maven users will need to add the following dependency to their <code>pom.xml</code> for this component:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: xml; gutter: false" type="syntaxhighlighter"><![CDATA[<dependency>
- <groupId>org.apache.camel</groupId>
- <artifactId>camel-bean-validator</artifactId>
- <version>x.y.z</version>
- <!-- use the same version as your Camel core version -->
-</dependency>
-]]></script>
-</div></div><h3 id="BookInOnePage-URIformat.5">URI format</h3><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[bean-validator:label[?options]
-]]></script>
-</div></div><p>or</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[bean-validator://label[?options]
-]]></script>
-</div></div><p>Where <strong>label</strong> is an arbitrary text value describing the endpoint.<br clear="none"> You can append query options to the URI in the following format, ?option=value&option=value&...</p><h3 id="BookInOnePage-URIOptions.1">URI Options</h3><div class="confluenceTableSmall">
-<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>group</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>javax.validation.groups.Default</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> The custom validation group to use. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>validationProviderResolver</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Depends on JSR303 jar provided. </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Camel <strong>2.13.0</strong>: Reference to a custom <code>javax.validation.ValidationProviderResolver</code> in the <a shape="rect" href="registry.html" title="Registry">Registry</a>. </p>
</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>messageInterpolator</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>org.hibernate.validator.engine.<br clear="none" class="atl-forced-newline">ResourceBundleMessageInterpolator</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Reference to a custom <code>javax.validation.MessageInterpolator</code> in the <a shape="rect" href="registry.html" title="Registry">Registry</a>. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>traversableResolver</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>org.hibernate.validator.engine.resolver.<br clear="none" class="atl-forced-newline">DefaultTraversableResolver</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Reference to a custom <code>javax.validation.TraversableResolver</code> in the <a shape="rect" href="registry.html" title="Registry">Registry</a>. </p><
/td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>constraintValidatorFactory</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>org.hibernate.validator.engine.<br clear="none" class="atl-forced-newline">ConstraintValidatorFactoryImpl</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Reference to a custom <code>javax.validation.ConstraintValidatorFactory</code> in the <a shape="rect" href="registry.html" title="Registry">Registry</a>. </p></td></tr></tbody></table>
-</div><h3 id="BookInOnePage-ServiceMix4/OSGiDeployment.">ServiceMix4/OSGi Deployment.</h3><p>The bean-validator when deployed in an OSGi environment requires a little help to accommodate the resource loading specified in JSR303, this was fixed in Servicemix-Specs 1.6-SNAPSHOT.</p><p>The other way to load Hibernate Validator in the OSGi environment is to use dedicated <code>ValidationProviderResolver</code> implementation, just as <code>org.apache.camel.component.bean.validator.HibernateValidationProviderResolver</code>. The snippet below demonstrates this approach. Keep in mind that you can use <code>HibernateValidationProviderResolver</code> starting from the Camel 2.13.0.</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;"><b>Using HibernateValidationProviderResolver</b></div><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[from("direct:test").
- to("bean-validator://ValidationProviderResolverTest?validationProviderResolver=#myValidationProviderResolver");
-
-...
-
-<bean id="myValidationProviderResolver" class="org.apache.camel.component.bean.validator.HibernateValidationProviderResolver"/> ]]></script>
-</div></div><h3 id="BookInOnePage-Example.12">Example</h3><p>Assumed we have a java bean with the following annotations</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;"><b>Car.java</b></div><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[public class Car {
-
- @NotNull
- private String manufacturer;
-
- @NotNull
- @Size(min = 5, max = 14, groups = OptionalChecks.class)
- private String licensePlate;
-
- // getter and setter
-}
-]]></script>
-</div></div><p>and an interface definition for our custom validation group</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;"><b>OptionalChecks.java</b></div><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[public interface OptionalChecks {
-}
-]]></script>
-</div></div><p>with the following Camel route, only the <strong>@NotNull</strong> constraints on the attributes manufacturer and licensePlate will be validated (Camel uses the default group <code>javax.validation.groups.Default</code>).</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[from("direct:start")
-.to("bean-validator://x")
-.to("mock:end")
-]]></script>
-</div></div><p>If you want to check the constraints from the group <code>OptionalChecks</code>, you have to define the route like this</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[from("direct:start")
-.to("bean-validator://x?group=OptionalChecks")
-.to("mock:end")
-]]></script>
-</div></div><p>If you want to check the constraints from both groups, you have to define a new interface first</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;"><b>AllChecks.java</b></div><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[@GroupSequence({Default.class, OptionalChecks.class})
-public interface AllChecks {
-}
-]]></script>
-</div></div><p>and then your route definition should looks like this</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[from("direct:start")
-.to("bean-validator://x?group=AllChecks")
-.to("mock:end")
-]]></script>
-</div></div><p>And if you have to provide your own message interpolator, traversable resolver and constraint validator factory, you have to write a route like this</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[<bean id="myMessageInterpolator" class="my.ConstraintValidatorFactory" />
-<bean id="myTraversableResolver" class="my.TraversableResolver" />
-<bean id="myConstraintValidatorFactory" class="my.ConstraintValidatorFactory" />
-
-from("direct:start")
-.to("bean-validator://x?group=AllChecks&messageInterpolator=#myMessageInterpolator
-&traversableResolver=#myTraversableResolver&constraintValidatorFactory=#myConstraintValidatorFactory")
-.to("mock:end")
-]]></script>
-</div></div><p>It's also possible to describe your constraints as XML and not as Java annotations. In this case, you have to provide the file <code>META-INF/validation.xml</code> which could looks like this</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;"><b>validation.xml</b></div><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[<?xml version="1.0" encoding="UTF-8"?>
-<validation-config
- xmlns="http://jboss.org/xml/ns/javax/validation/configuration"
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xsi:schemaLocation="http://jboss.org/xml/ns/javax/validation/configuration">
- <default-provider>org.hibernate.validator.HibernateValidator</default-provider>
- <message-interpolator>org.hibernate.validator.engine.ResourceBundleMessageInterpolator</message-interpolator>
- <traversable-resolver>org.hibernate.validator.engine.resolver.DefaultTraversableResolver</traversable-resolver>
- <constraint-validator-factory>org.hibernate.validator.engine.ConstraintValidatorFactoryImpl</constraint-validator-factory>
-
- <constraint-mapping>/constraints-car.xml</constraint-mapping>
-</validation-config>
-]]></script>
-</div></div><p>and the <code>constraints-car.xml</code> file</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;"><b>constraints-car.xml</b></div><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[<?xml version="1.0" encoding="UTF-8"?>
-<constraint-mappings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xsi:schemaLocation="http://jboss.org/xml/ns/javax/validation/mapping validation-mapping-1.0.xsd"
- xmlns="http://jboss.org/xml/ns/javax/validation/mapping">
- <default-package>org.apache.camel.component.bean.validator</default-package>
-
- <bean class="CarWithoutAnnotations" ignore-annotations="true">
- <field name="manufacturer">
- <constraint annotation="javax.validation.constraints.NotNull" />
- </field>
-
- <field name="licensePlate">
- <constraint annotation="javax.validation.constraints.NotNull" />
-
- <constraint annotation="javax.validation.constraints.Size">
- <groups>
- <value>org.apache.camel.component.bean.validator.OptionalChecks</value>
- </groups>
- <element name="min">5</element>
- <element name="max">14</element>
- </constraint>
- </field>
- </bean>
-</constraint-mappings>
-]]></script>
-</div></div><p></p><h3 id="BookInOnePage-SeeAlso.25">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 class="error"><span class="error">Unable to render {include}</span> The included page could not be found.</div>
<h2 id="BookInOnePage-BrowseComponent">Browse Component</h2>
<p>The Browse component provides a simple <a shape="rect" href="browsableendpoint.html">BrowsableEndpoint</a> which can be useful for testing, visualisation tools or debugging. The exchanges sent to the endpoint are all available to be browsed.</p>
-<h3 id="BookInOnePage-URIformat.6">URI format</h3>
+<h3 id="BookInOnePage-URIformat.5">URI format</h3>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[
@@ -21409,7 +21278,7 @@ browse:someName[?options]
</div></div>
-<h3 id="BookInOnePage-SeeAlso.26">See Also</h3>
+<h3 id="BookInOnePage-SeeAlso.25">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>
<h2 id="BookInOnePage-CacheComponent">Cache Component</h2><p><strong>Available as of Camel 2.1</strong></p><p>The <strong>cache</strong> component enables you to perform caching operations using EHCache as the Cache Implementation. The cache itself is created on demand or if a cache of that name already exists then it is simply utilized with its original settings.</p><p>This component supports producer and event based consumer endpoints.</p><p>The Cache consumer is an event based consumer and can be used to listen and respond to specific cache activities. If you need to perform selections from a pre-existing cache, use the processors defined for the cache component.</p><p>Maven users will need to add the following dependency to their <code>pom.xml</code> for this component:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: xml; gutter: false" type="syntaxhighlighter"><![CDATA[<dependency>
@@ -21419,7 +21288,7 @@ browse:someName[?options]
<!-- use the same version as your Camel core version -->
</dependency>
]]></script>
-</div></div><h3 id="BookInOnePage-URIformat.7">URI format</h3><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+</div></div><h3 id="BookInOnePage-URIformat.6">URI format</h3><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[cache://cacheName[?options]
]]></script>
</div></div><p>You can append query options to the URI in the following format, <code>?option=value&option=#beanRef&...</code></p><h3 id="BookInOnePage-Options.25">Options</h3><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>maxElementsInMemory</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>1000</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> The number of elements that may be stored in the defined cache </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>memoryStoreEvictionPolicy</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>MemoryStoreEvictionPolicy.LFU</code> </p></td><td co
lspan="1" rowspan="1" class="confluenceTd"><p> The number of elements that may be stored in the defined cache. Options include</p>
@@ -21599,7 +21468,7 @@ browse:someName[?options]
<p>The <strong>class:</strong> component binds beans to Camel message exchanges. It works in the same way as the <a shape="rect" href="bean.html">Bean</a> component but instead of looking up beans from a <a shape="rect" href="registry.html">Registry</a> it creates the bean based on the class name.</p>
-<h3 id="BookInOnePage-URIformat.8">URI format</h3>
+<h3 id="BookInOnePage-URIformat.7">URI format</h3>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[
@@ -21663,7 +21532,7 @@ For example to use the <code>MyFooBean</
</div>
-<h3 id="BookInOnePage-SeeAlso.27">See Also</h3>
+<h3 id="BookInOnePage-SeeAlso.26">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>
<ul><li><a shape="rect" href="bean.html">Bean</a></li><li><a shape="rect" href="bean-binding.html">Bean Binding</a></li><li><a shape="rect" href="bean-integration.html">Bean Integration</a></li></ul>
<h2 id="BookInOnePage-CometdComponent">Cometd Component</h2>
@@ -21683,7 +21552,7 @@ Using this component in combination with
]]></script>
</div></div>
-<h3 id="BookInOnePage-URIformat.9">URI format</h3>
+<h3 id="BookInOnePage-URIformat.8">URI format</h3>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[
@@ -21778,7 +21647,7 @@ commetdComponent.setSslContextParameters
</div></div>
-<h3 id="BookInOnePage-SeeAlso.28">See Also</h3>
+<h3 id="BookInOnePage-SeeAlso.27">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>
<h2 id="BookInOnePage-ContextComponent">Context Component</h2>
@@ -21800,7 +21669,7 @@ commetdComponent.setSslContextParameters
]]></script>
</div></div>
-<h3 id="BookInOnePage-URIformat.10">URI format</h3>
+<h3 id="BookInOnePage-URIformat.9">URI format</h3>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[
@@ -21821,7 +21690,7 @@ camelContextId:localEndpointName[?option
<p>You can append query options to the URI in the following format, <code>?option=value&option=value&...</code></p>
-<h3 id="BookInOnePage-Example.13">Example</h3>
+<h3 id="BookInOnePage-Example.12">Example</h3>
<p>In this example we'll create a black box context, then we'll use it from another CamelContext.</p>
@@ -21923,7 +21792,7 @@ registry.bind("accounts", blac
<ul class="alternate"><li>Bruce Schneier's Applied Cryptography</li><li>Beginning Cryptography with Java by David Hook</li><li>The ever insightful Wikipedia <a shape="rect" class="external-link" href="http://en.wikipedia.org/wiki/Digital_signature" rel="nofollow">Digital_signatures</a></li></ul>
-<h3 id="BookInOnePage-URIformat.11">URI format</h3>
+<h3 id="BookInOnePage-URIformat.10">URI format</h3>
<p>As mentioned Camel provides a pair of crypto endpoints to create and verify signatures</p>
@@ -22152,7 +22021,7 @@ template.send("direct:alias-verify&
]]></script>
</div></div>
-<h3 id="BookInOnePage-SeeAlso.29">See Also</h3>
+<h3 id="BookInOnePage-SeeAlso.28">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>
<ul><li><a shape="rect" href="crypto.html">Crypto</a> Crypto is also available as a <a shape="rect" href="data-format.html">Data Format</a></li></ul>
<h2 id="BookInOnePage-CXFComponent">CXF Component</h2> <div class="aui-message warning shadowed information-macro">
@@ -22168,11 +22037,11 @@ template.send("direct:alias-verify&
</div>
</div>
<p>The <strong>cxf:</strong> component provides integration with <a shape="rect" href="http://cxf.apache.org">Apache CXF</a> for connecting to JAX-WS services hosted in CXF.</p><p><style type="text/css">/*<![CDATA[*/
-div.rbtoc1392808740568 {padding: 0px;}
-div.rbtoc1392808740568 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1392808740568 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1393341562802 {padding: 0px;}
+div.rbtoc1393341562802 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1393341562802 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1392808740568">
+/*]]>*/</style></p><div class="toc-macro rbtoc1393341562802">
<ul class="toc-indentation"><li><a shape="rect" href="#CXF-CXFComponent">CXF Component</a>
<ul class="toc-indentation"><li><a shape="rect" href="#CXF-URIformat">URI format</a></li><li><a shape="rect" href="#CXF-Options">Options</a>
<ul class="toc-indentation"><li><a shape="rect" href="#CXF-Thedescriptionsofthedataformats">The descriptions of the dataformats</a>
@@ -22197,7 +22066,7 @@ div.rbtoc1392808740568 li {margin-left:
<p>If you want to learn about CXF dependencies you can checkout the <code><a shape="rect" class="external-link" href="http://svn.apache.org/repos/asf/cxf/trunk/distribution/src/main/release/lib/WHICH_JARS">WHICH-JARS</a></code> text file.</p>
</div>
</div>
-<h3 id="BookInOnePage-URIformat.12">URI format</h3><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+<h3 id="BookInOnePage-URIformat.11">URI format</h3><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[cxf:bean:cxfEndpoint[?options]
]]></script>
</div></div><p>Where <strong>cxfEndpoint</strong> represents a bean ID that references a bean in the Spring bean registry. With this URI format, most of the endpoint details are specified in the bean definition.</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
@@ -22785,7 +22654,7 @@ public static class MyProcessor implemen
}
}
]]></script>
-</div></div><p><strong>Message Mode:</strong> Attachments are not supported as it does not process the message at all.</p><h3 id="BookInOnePage-StreamingSupportinPAYLOADmode">Streaming Support in PAYLOAD mode</h3><p>In 2.8.2, the camel-cxf component now supports streaming of incoming messages when using PAYLOAD mode. Previously, the incoming messages would have been completely DOM parsed. For large messages, this is time consuming and uses a significant amount of memory. Starting in 2.8.2, the incoming messages can remain as a javax.xml.transform.Source while being routed and, if nothing modifies the payload, can then be directly streamed out to the target destination. For common "simple proxy" use cases (example: from("cxf:...").to("cxf:...")), this can provide very significant performance increases as well as significantly lowered memory requirements.</p><p>However, there are cases where streaming may not be appropriate or desired. Due to the streaming nature, invalid incoming XML
may not be caught until later in the processing chain. Also, certain actions may require the message to be DOM parsed anyway (like WS-Security or message tracing and such) in which case the advantages of the streaming is limited. At this point, there are two ways to control the streaming:</p><ul><li>Endpoint property: you can add "allowStreaming=false" as an endpoint property to turn the streaming on/off.</li></ul><ul><li>Component property: the CxfComponent object also has an allowStreaming property that can set the default for endpoints created from that component.</li></ul><ul><li>Global system property: you can add a system property of "org.apache.camel.component.cxf.streaming" to "false" to turn if off. That sets the global default, but setting the endpoint property above will override this value for that endpoint.</li></ul><p></p><h3 id="BookInOnePage-SeeAlso.30">See Also</h3>
+</div></div><p><strong>Message Mode:</strong> Attachments are not supported as it does not process the message at all.</p><h3 id="BookInOnePage-StreamingSupportinPAYLOADmode">Streaming Support in PAYLOAD mode</h3><p>In 2.8.2, the camel-cxf component now supports streaming of incoming messages when using PAYLOAD mode. Previously, the incoming messages would have been completely DOM parsed. For large messages, this is time consuming and uses a significant amount of memory. Starting in 2.8.2, the incoming messages can remain as a javax.xml.transform.Source while being routed and, if nothing modifies the payload, can then be directly streamed out to the target destination. For common "simple proxy" use cases (example: from("cxf:...").to("cxf:...")), this can provide very significant performance increases as well as significantly lowered memory requirements.</p><p>However, there are cases where streaming may not be appropriate or desired. Due to the streaming nature, invalid incoming XML
may not be caught until later in the processing chain. Also, certain actions may require the message to be DOM parsed anyway (like WS-Security or message tracing and such) in which case the advantages of the streaming is limited. At this point, there are two ways to control the streaming:</p><ul><li>Endpoint property: you can add "allowStreaming=false" as an endpoint property to turn the streaming on/off.</li></ul><ul><li>Component property: the CxfComponent object also has an allowStreaming property that can set the default for endpoints created from that component.</li></ul><ul><li>Global system property: you can add a system property of "org.apache.camel.component.cxf.streaming" to "false" to turn if off. That sets the global default, but setting the endpoint property above will override this value for that endpoint.</li></ul><p></p><h3 id="BookInOnePage-SeeAlso.29">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>
<h2 id="BookInOnePage-CXFBeanComponent">CXF Bean Component</h2>
@@ -22800,7 +22669,7 @@ public static class MyProcessor implemen
</div>
-<h3 id="BookInOnePage-URIformat.13">URI format</h3>
+<h3 id="BookInOnePage-URIformat.12">URI format</h3>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[
@@ -22868,7 +22737,7 @@ cxfbean:serviceBeanRef
<version>x.x.x</version> <!-- use the same version as your Camel core version -->
</dependency>
]]></script>
-</div></div><h3 id="BookInOnePage-URIformat.14">URI format</h3><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+</div></div><h3 id="BookInOnePage-URIformat.13">URI format</h3><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[cxfrs://address?options
]]></script>
</div></div><p>Where <strong>address</strong> represents the CXF endpoint's address</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
@@ -23128,7 +22997,7 @@ inMessage.setHeader(CxfConstants.CAMEL_C
<p>Camel will use the <a shape="rect" href="log.html">throughput logger</a> when sending dataset's. </p>
-<h3 id="BookInOnePage-URIformat.15">URI format</h3>
+<h3 id="BookInOnePage-URIformat.14">URI format</h3>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[
@@ -23157,7 +23026,7 @@ dataset:name[?options]
]]></script>
</div></div>
-<h3 id="BookInOnePage-Example.14">Example</h3>
+<h3 id="BookInOnePage-Example.13">Example</h3>
<p>For example, to test that a set of messages are sent to a queue and then consumed from the queue without losing any messages:</p>
@@ -23180,7 +23049,7 @@ from("activemq:SomeQueue").to(
<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Property</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Type</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>defaultBody</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>Object</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code><hello>world!</hello></code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Specifies the default message body. For SimpleDataSet it is a constant payload; though if you want to create custom payloads per message, create your own derivation of <code>DataSetSupport</code>. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>reportCount</code> </p></td><td colspan="1" rowspan="1" class="confl
uenceTd"><p> <code>long</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-1</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Specifies the number of messages to be received before reporting progress. Useful for showing progress of a large load test. If < 0, then <code>size</code> / 5, if is 0 then <code>size</code>, else set to <code>reportCount</code> value.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>size</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>long</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>10</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specifies how many messages to send/consume.</p></td></tr></tbody></table>
</div>
-<h3 id="BookInOnePage-SeeAlso.31">See Also</h3>
+<h3 id="BookInOnePage-SeeAlso.30">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>
<ul><li><a shape="rect" href="spring-testing.html">Spring Testing</a></li></ul>
<h2 id="BookInOnePage-Db4oComponent">Db4o Component</h2>
@@ -23198,7 +23067,7 @@ from("activemq:SomeQueue").to(
<p>If you do not wish to delete the object when it has been processed, you can specify <code>consumeDelete=false</code> on the URI. This will result in the POJO being processed each poll.</p>
-<h3 id="BookInOnePage-URIformat.16">URI format</h3>
+<h3 id="BookInOnePage-URIformat.15">URI format</h3>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[
@@ -23213,7 +23082,7 @@ db4o:className[?options]
<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>consumeDelete</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>true</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Option for <code>Db4oConsumer</code> only. Specifies whether or not the entity is deleted after it is consumed.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>consumer.delay</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>500</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Option for consumer only. Delay in millis between each poll. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>consumer.initialDel
ay</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>1000</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Option for consumer only. Millis before polling starts. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>consumer.userFixedDelay</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>false</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Option for consumer only. Set to <code>true</code> to use fixed delay between polls, otherwise fixed rate is used. See <a shape="rect" class="external-link" href="http://java.sun.com/j2se/1.5.0/docs/api/java/util/concurrent/ScheduledExecutorService.html" rel="nofollow">ScheduledExecutorService</a> in JDK for details. </p></td></tr></tbody></table>
</div>
-<h3 id="BookInOnePage-SeeAlso.32">See Also</h3>
+<h3 id="BookInOnePage-SeeAlso.31">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>
<h2 id="BookInOnePage-DirectComponent">Direct Component</h2><p>The <strong>direct:</strong> component provides direct, synchronous invocation of any consumers when a producer sends a message exchange.<br clear="none"> This endpoint can be used to connect existing routes in the <strong>same</strong> camel context.</p> <div class="aui-message success shadowed information-macro">
<p class="title">Asynchronous</p>
@@ -23229,7 +23098,7 @@ db4o:className[?options]
<p>The <a shape="rect" href="vm.html">VM</a> component provides connections between Camel contexts as long they run in the same <strong>JVM</strong>.</p>
</div>
</div>
-<h3 id="BookInOnePage-URIformat.17">URI format</h3><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+<h3 id="BookInOnePage-URIformat.16">URI format</h3><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: text; gutter: false" type="syntaxhighlighter"><![CDATA[direct:someName[?options]
]]></script>
</div></div><p>Where <strong>someName</strong> can be any string to uniquely identify the endpoint</p><h3 id="BookInOnePage-Options.34">Options</h3><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>allowMultipleConsumers</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>@deprecated</strong> If set to <code>false</code>, then when a second consumer is started on the endpoint, an <code>IllegalStateException</code> is thrown. <strong>Will be removed in Camel 2.1:</strong> Direct endpoint does not support multiple consumers.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><cod
e>block</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.11.1:</strong> If sending a message to a direct endpoint which has no active consumer, then we can tell the producer to block and wait for the consumer to become active.</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>30000</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><strong>Camel 2.11.1:</strong> The timeout value to use if block is enabled.</p></td></tr></tbody></table></div><pre>You can append query options to the URI in the following format, ?option=value&option=value&...</pre><p> </p><h3 id="BookInOnePage-Samples.8">Samples</h3><p>In the route below we use the direct component to link the two routes together:</p><div class="code panel pdl" style="border-width: 1px;"><di
v class="codeContent panelContent pdl">
@@ -23254,7 +23123,7 @@ from("direct:processOrder")
<to uri="activemq:queue:order.out"/>
</route>
]]></script>
-</div></div><p>See also samples from the <a shape="rect" href="seda.html">SEDA</a> component, how they can be used together.</p><p></p><h3 id="BookInOnePage-SeeAlso.33">See Also</h3>
+</div></div><p>See also samples from the <a shape="rect" href="seda.html">SEDA</a> component, how they can be used together.</p><p></p><h3 id="BookInOnePage-SeeAlso.32">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><ul class="alternate"><li><a shape="rect" href="seda.html">SEDA</a></li><li><a shape="rect" href="vm.html">VM</a></li></ul>
<h2 id="BookInOnePage-DNS">DNS</h2>
<p><strong>Available as of Camel 2.7</strong></p>
@@ -23287,7 +23156,7 @@ If you use Apache ServiceMix or Apache K
]]></script>
</div></div>
-<h3 id="BookInOnePage-URIformat.18">URI format</h3>
+<h3 id="BookInOnePage-URIformat.17">URI format</h3>
<p>The URI scheme for a DNS component is as follows</p>
@@ -23353,7 +23222,7 @@ The name to lookup must be provided in t
<p>The query must be provided in the header with key <code>"dns.query"</code>.</p>
-<h3 id="BookInOnePage-SeeAlso.34">See Also</h3>
+<h3 id="BookInOnePage-SeeAlso.33">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>
<h2 id="BookInOnePage-EJBComponent">EJB Component</h2>
<p><strong>Available as of Camel 2.4</strong></p>
@@ -23373,7 +23242,7 @@ The name to lookup must be provided in t
</div></div>
-<h3 id="BookInOnePage-URIformat.19">URI format</h3>
+<h3 id="BookInOnePage-URIformat.18">URI format</h3>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[
@@ -23513,10 +23382,10 @@ However if you need to access a applicat
-<h3 id="BookInOnePage-SeeAlso.35">See Also</h3>
+<h3 id="BookInOnePage-SeeAlso.34">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>
<ul><li><a shape="rect" href="bean.html">Bean</a></li><li><a shape="rect" href="bean-binding.html">Bean Binding</a></li><li><a shape="rect" href="bean-integration.html">Bean Integration</a></li></ul>
-<h2 id="BookInOnePage-Esper">Esper</h2><p>The Esper component supports the <a shape="rect" class="external-link" href="http://esper.codehaus.org" rel="nofollow">Esper Library</a> for Event Stream Processing. The <strong>camel-esper</strong> library is provided by the <a shape="rect" class="external-link" href="http://code.google.com/p/camel-extra/" rel="nofollow">Camel Extra</a> project which hosts all *GPL related components for Camel.</p><h3 id="BookInOnePage-URIformat.20">URI format</h3><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+<h2 id="BookInOnePage-Esper">Esper</h2><p>The Esper component supports the <a shape="rect" class="external-link" href="http://esper.codehaus.org" rel="nofollow">Esper Library</a> for Event Stream Processing. The <strong>camel-esper</strong> library is provided by the <a shape="rect" class="external-link" href="http://code.google.com/p/camel-extra/" rel="nofollow">Camel Extra</a> project which hosts all *GPL related components for Camel.</p><h3 id="BookInOnePage-URIformat.19">URI format</h3><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[esper:name[?options]
]]></script>
</div></div><p>When consuming from an Esper endpoint you must specify a <strong>pattern</strong> or <strong>eql</strong> statement to query the event stream.</p><p>Pattern example:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
@@ -23537,10 +23406,10 @@ To configure Esper via a configuration f
<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[ EventBean newEvent = exchange.getIn(EsperMessage.class).getNewEvent();
EventBean oldEvent = exchange.getIn(EsperMessage.class).getOldEvent();
]]></script>
-</div></div><p>By default if you get the body of <code>org.apacheextras.camel.component.esper.EsperMessage</code> it returns the new <code>EventBean</code> as in previous versions.</p><h3 id="BookInOnePage-Demo">Demo</h3><p>There is a <a shape="rect" class="external-link" href="http://code.google.com/p/camel-extra/wiki/EsperDemo" rel="nofollow">demo which shows how to work with ActiveMQ, Camel and Esper</a> in the <a shape="rect" class="external-link" href="http://code.google.com/p/camel-extra/" rel="nofollow">Camel Extra</a> project</p><p></p><h3 id="BookInOnePage-SeeAlso.36">See Also</h3>
+</div></div><p>By default if you get the body of <code>org.apacheextras.camel.component.esper.EsperMessage</code> it returns the new <code>EventBean</code> as in previous versions.</p><h3 id="BookInOnePage-Demo">Demo</h3><p>There is a <a shape="rect" class="external-link" href="http://code.google.com/p/camel-extra/wiki/EsperDemo" rel="nofollow">demo which shows how to work with ActiveMQ, Camel and Esper</a> in the <a shape="rect" class="external-link" href="http://code.google.com/p/camel-extra/" rel="nofollow">Camel Extra</a> project</p><p></p><h3 id="BookInOnePage-SeeAlso.35">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><ul><li><a shape="rect" class="external-link" href="http://code.google.com/p/camel-extra/wiki/EsperDemo" rel="nofollow">Esper Camel Demo</a></li></ul>
<div class="error"><span class="error">Unable to render {include}</span> The included page could not be found.</div>
-<h2 id="BookInOnePage-FileComponent">File Component</h2><p>The File component provides access to file systems, allowing files to be processed by any other Camel <a shape="rect" href="components.html">Components</a> or messages from other components to be saved to disk.</p><h3 id="BookInOnePage-URIformat.21">URI format</h3><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+<h2 id="BookInOnePage-FileComponent">File Component</h2><p>The File component provides access to file systems, allowing files to be processed by any other Camel <a shape="rect" href="components.html">Components</a> or messages from other components to be saved to disk.</p><h3 id="BookInOnePage-URIformat.20">URI format</h3><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[file:directoryName[?options]
]]></script>
</div></div><p>or</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
@@ -23560,7 +23429,7 @@ To configure Esper via a configuration f
<p>Beware the JDK File IO API is a bit limited in detecting whether another application is currently writing/copying a file. And the implementation can be different depending on OS platform as well. This could lead to that Camel thinks the file is not locked by another process and start consuming it. Therefore you have to do you own investigation what suites your environment. To help with this Camel provides different <code>readLock</code> options and <code>doneFileName</code> option that you can use. See also the section <em>Consuming files from folders where others drop files directly</em>.</p>
</div>
</div>
-<h3 id="BookInOnePage-URIOptions.2">URI Options</h3><h4 id="BookInOnePage-Common">Common</h4><div class="confluenceTableSmall">
+<h3 id="BookInOnePage-URIOptions.1">URI Options</h3><h4 id="BookInOnePage-Common">Common</h4><div class="confluenceTableSmall">
<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>autoCreate</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>true</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Automatically create missing directories in the file's pathname. For the file consumer, that means creating the starting directory. For the file producer, it means the directory the files should be written to. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>bufferSize</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> 128kb </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Write buffer sized in bytes. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>fileName</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>null</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Use <a shape="rect" href="expression.html" title="Expression">Expression</a> such as <a shape="rect" href="file-language.html" title="File Language">File Language</a> to dynamically set the filename. For consumers, it's used as a filename filter. For producers, it's used to evaluate the filename to write. If an expression is set, it take precedence over the <code>CamelFileName</code> header. (<strong>Note:</strong> The header itself can also be an <a shape="rect" href="expression.html" title="Expression">Expression</a>). The expression options support both <code>String</code> and <code>Expression</code> types. If the expression is a <code>String</code> type, it is <strong>always</strong> evaluated using the <a shape="rect" href="file-language.html" title="File Language">File Language</a>. If the e
xpression is an <code>Expression</code> type, the specified <code>Expression</code> type is used - this allows you, for instance, to use <a shape="rect" href="ognl.html" title="OGNL">OGNL</a> expressions. For the consumer, you can use it to filter filenames, so you can for instance consume today's file using the <a shape="rect" href="file-language.html" title="File Language">File Language</a> syntax: <code>mydata-${date:now:yyyyMMdd}.txt</code>. From <strong>Camel 2.11</strong> onwards the producers support the <code>CamelOverruleFileName</code> header which takes precedence over any existing <code>CamelFileName</code> header; the <code>CamelOverruleFileName</code> is a header that is used only once, and makes it easier as this avoids to temporary store <code>CamelFileName</code> and have to restore it afterwards. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>flatten</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>false</code
> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Flatten is used to flatten the file name path to strip any leading paths, so it's just the file name. This allows you to consume recursively into sub-directories, but when you eg write the files to another directory they will be written in a single directory. Setting this to <code>true</code> on the producer enforces that any file name recived in <code>CamelFileName</code> header will be stripped for any leading paths. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>charset</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.3:</strong> this option is used to specify the encoding of the file, and camel will set the Exchange property with <code>Exchange.CHARSET_NAME</code> with the value of this option. You can use this on the consumer, to specify the encodings of the files, whic
h allow Camel to know the charset it should load the file content in case the file content is being accessed. Likewise when writing a file, you can use this option to specify which charset to write the file as well. See further below for a examples and more important details. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>copyAndDeleteOnRenameFail</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</strong>: whether to fallback and do a copy and delete file, in case the file could not be renamed directly. This option is not available for the <a shape="rect" href="ftp2.html" title="FTP2">FTP</a> component. </p></td></tr></tbody></table>
</div><h4 id="BookInOnePage-Consumer">Consumer</h4><div class="confluenceTableSmall">
<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>initialDelay</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>1000</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Milliseconds before polling the file/directory starts. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>delay</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>500</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Milliseconds before the next poll of the file/directory. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>useFixedDelay</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> 
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Controls if fixed delay or fixed rate is used. See <a shape="rect" class="external-link" href="http://java.sun.com/j2se/1.5.0/docs/api/java/util/concurrent/ScheduledExecutorService.html" rel="nofollow">ScheduledExecutorService</a> in JDK for details. In <strong>Camel 2.7.x</strong> or older the default value is <code>false</code>. From <strong>Camel 2.8</strong> onwards the default value is <code>true</code>. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>runLoggingLevel</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>TRACE</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <strong>Camel 2.8:</strong> The consumer logs a start/complete log line when it polls. This option allows you to configure the logging level for that. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>recursive</code> </p></td><td colspan="1" rowspan="
1" class="confluenceTd"><p> <code>false</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> If a directory, will look for files in all the sub-directories as well. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>delete</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>false</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> If <code>true</code>, the file will be deleted <strong>after</strong> it is processed </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>noop</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>false</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> If <code>true</code>, the file is not moved or deleted in any way. This option is good for readonly data, or for <a shape="rect" href="etl.html" title="ETL">ETL</a> type requirements. If <code>noop=true</code>, Camel will set <code>idempotent=true</code> as well,
to avoid consuming the same files over and over again. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>preMove</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>null</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <a shape="rect" href="expression.html" title="Expression">Expression</a> (such as <a shape="rect" href="file-language.html" title="File Language">File Language</a>) used to dynamically set the filename when moving it <strong>before</strong> processing. For example to move in-progress files into the <code>order</code> directory set this value to <code>order</code>. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>move</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>.camel</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <a shape="rect" href="expression.html" title="Expression">Expression</a> (such as <a shape="rect" href="file
-language.html" title="File Language">File Language</a>) used to dynamically set the filename when moving it <strong>after</strong> processing. To move files into a <code>.done</code> subdirectory just enter <code>.done</code>. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>moveFailed</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>null</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <a shape="rect" href="expression.html" title="Expression">Expression</a> (such as <a shape="rect" href="file-language.html" title="File Language">File Language</a>) used to dynamically set a different target directory when moving files after processing (configured via <code>move</code> defined above) failed. For example, to move files into a <code>.error</code> subdirectory use: <code>.error</code>. Note: When moving the files to the “fail” location Camel will <strong>handle</strong> the error and will not pick up
the file again. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>include</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>null</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Is used to include files, if filename matches the regex pattern. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>exclude</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>null</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Is used to exclude files, if filename matches the regex pattern. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>antInclude</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.10:</strong> Ant style filter inclusion, for example <code>antInclude=*</code><code><strong>/</strong></code><code>.txt</code>. Mu
ltiple inclusions may be specified in comma-delimited format. See <a shape="rect" href="#BookInOnePage-FilteringusingANTpathmatcher">below</a> for more details about ant path filters. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>antExclude</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.10:</strong> Ant style filter exclusion. If both <code>antInclude</code> and <code>antExclude</code> are used, <code>antExclude</code> takes precedence over <code>antInclude</code>. Multiple exclusions may be specified in comma-delimited format. See <a shape="rect" href="#BookInOnePage-FilteringusingANTpathmatcher">below</a> for more details about ant path filters. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>antFilterCaseSensitive</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> Ant style filter which is case sensitive or not. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>idempotent</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>false</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Option to use the <a shape="rect" href="idempotent-consumer.html" title="Idempotent Consumer">Idempotent Consumer</a> EIP pattern to let Camel skip already processed files. Will by default use a memory based LRUCache that holds 1000 entries. If <code>noop=true</code> then idempotent will be enabled as well to avoid consuming the same files over and over again. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>idempotentKey</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>Expression</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <strong>Camel 2
.11:</strong> To use a custom idempotent key. By default the absolute path of the file is used. You can use the <a shape="rect" href="file-language.html" title="File Language">File Language</a>, for example to use the file name and file size, you can do: </p>
@@ -23569,7 +23438,7 @@ To configure Esper via a configuration f
</div></div>
<p>. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>idempotentRepository</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>null</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> A pluggable repository <a shape="rect" class="external-link" href="http://camel.apache.org/maven/current/camel-core/apidocs/org/apache/camel/spi/IdempotentRepository.html">org.apache.camel.spi.IdempotentRepository</a> which by default use <code>MemoryMessageIdRepository</code> if none is specified and <code>idempotent</code> is <code>true</code>. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>inProgressRepository</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>memory</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> A pluggable in-progress repository <a shape="rect" class="external-link" href="http://camel.apache.org/maven/current/camel-core/apidocs/org/apache/
camel/spi/IdempotentRepository.html">org.apache.camel.spi.IdempotentRepository</a>. The in-progress repository is used to account the current in progress files being consumed. By default a memory based repository is used. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>filter</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>null</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Pluggable filter as a <code>org.apache.camel.component.file.GenericFileFilter</code> class. Will skip files if filter returns <code>false</code> in its <code>accept()</code> method. More details in section below. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>sorter</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>null</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Pluggable sorter as a <a shape="rect" class="external-link" href="http://java.sun.com/j2se/1.5.0
/docs/api/java/util/Comparator.html" rel="nofollow">java.util.Comparator<org.apache.camel.component.file.GenericFile></a> class. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>sortBy</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>null</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Built-in sort using the <a shape="rect" href="file-language.html" title="File Language">File Language</a>. Supports nested sorts, so you can have a sort by file name and as a 2nd group sort by modified date. See sorting section below for details. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>readLock</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>markerFile</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Used by consumer, to only poll the files if it has exclusive read-lock on the file (i.e. the file is not in-progress or being written). Camel
will wait until the file lock is granted. <br clear="none" class="atl-forced-newline">
This option provides the build in strategies: <br clear="none" class="atl-forced-newline"> <code>markerFile</code> Camel creates a marker file (fileName.camelLock) and then holds a lock on it. This option is <strong>not</strong> available for the <a shape="rect" href="ftp2.html" title="FTP2">FTP</a> component. <br clear="none" class="atl-forced-newline"> <code>changed</code> is using file length/modification timestamp to detect whether the file is currently being copied or not. Will at least use 1 sec. to determine this, so this option cannot consume files as fast as the others, but can be more reliable as the JDK IO API cannot always determine whether a file is currently being used by another process. The option <code>readLockCheckInterval</code> can be used to set the check frequency. This option is <strong>only</strong> avail for the <a shape="rect" href="ftp2.html" title="FTP2">FTP</a> component from <strong>Camel 2.8</strong> onwards. Notice that from <strong>Camel 2.10.1</st
rong> onwards the <a shape="rect" href="ftp2.html" title="FTP2">FTP</a> option <code>fastExistsCheck</code> can be enabled to speedup this readLock strategy, if the FTP server support the LIST operation with a full file name (some servers may not). <br clear="none" class="atl-forced-newline"> <code>fileLock</code> is for using <code>java.nio.channels.FileLock</code>. This option is <strong>not</strong> avail for the <a shape="rect" href="ftp2.html" title="FTP2">FTP</a> component. This approach should be avoided when accessing a remote file system via a mount/share unless that file system supports distributed file locks. <br clear="none" class="atl-forced-newline"> <code>rename</code> is for using a try to rename the file as a test if we can get exclusive read-lock. <br clear="none" class="atl-forced-newline"> <code>none</code> is for no read locks at all. <br clear="none" class="atl-forced-newline">
-Notice from <strong>Camel 2.10</strong> onwards the read locks <code>changed</code>, <code>fileLock</code> and <code>rename</code> will also use a <code>markerFile</code> as well, to ensure not picking up files that may be in process by another Camel consumer running on another node (eg cluster). This is only supported by the file component (not the ftp component). </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>readLockTimeout</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>10000</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Optional timeout in millis for the read-lock, if supported by the read-lock. If the read-lock could not be granted and the timeout triggered, then Camel will skip the file. At next poll Camel, will try the file again, and this time maybe the read-lock could be granted. Use a value of 0 or lower to indicate forever. In <strong>Camel 2.0</strong> the default value is 0. Starting with <
strong>Camel 2.1</strong> the default value is 10000. Currently <code>fileLock</code>, <code>changed</code> and <code>rename</code> support the timeout. <strong>Notice:</strong> For <a shape="rect" href="ftp2.html" title="FTP2">FTP</a> the default <code>readLockTimeout</code> value is <code>20000</code> instead of <code>10000</code>. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>readLockCheckInterval</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>1000</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <strong>Camel 2.6:</strong> Interval in millis for the read-lock, if supported by the read lock. This interval is used for sleeping between attempts to acquire the read lock. For example when using the <code>changed</code> read lock, you can set a higher interval period to cater for <em>slow writes</em>. The default of 1 sec. may be <em>too fast</em> if the producer is very slow writing the file. For <a shape=
"rect" href="ftp2.html" title="FTP2">FTP</a> the default <code>readLockCheckInterval</code> is <code>5000</code>. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>readLockMinLength</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>1</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <strong>Camel 2.10.1:</strong> This option applied only for <code>readLock=changed</code>. This option allows you to configure a minimum file length. By default Camel expects the file to contain data, and thus the default value is 1. You can set this option to zero, to allow consuming zero-length files. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>readLockLoggingLevel</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>WARN</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <strong>Camel 2.12:</strong> Logging level used when a read lock could not be acquired. By
default a WARN is logged. You can change this level, for example to OFF to not have any logging. This option is only applicable for readLock of types: changed, fileLock, rename. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>directoryMustExist</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.5:</strong> Similar to <code>startingDirectoryMustExist</code> but this applies during polling recursive sub directories. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>doneFileName</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.6:</strong> If provided, Camel will only consume files if a <em>done</em> file exists. This option configures what file name to use. Either you can specify a fixed name. Or you ca
n use dynamic placeholders. The <em>done</em> file is <strong>always</strong> expected in the same folder as the original file. See <em>using done file</em> and <em>writing done file</em> sections for examples. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>exclusiveReadLockStrategy</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>null</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Pluggable read-lock as a <code>org.apache.camel.component.file.GenericFileExclusiveReadLockStrategy</code> implementation. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>maxMessagesPerPoll</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>0</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> An integer to define a maximum messages to gather per poll. By default no maximum is set. Can be used to set a limit of e.g. 1000 to avoid when starting up the server th
at there are thousands of files. Set a value of 0 or negative to disabled it. See more details at <a shape="rect" href="batch-consumer.html" title="Batch Consumer">Batch Consumer</a>. <strong>Notice:</strong> If this option is in use then the <a shape="rect" href="file2.html" title="File2">File</a> and <a shape="rect" href="ftp2.html" title="FTP2">FTP</a> components will limit <strong>before</strong> any sorting. For example if you have 100000 files and use <code>maxMessagesPerPoll=500</code>, then only the first 500 files will be picked up, and then sorted. You can use the <code>eagerMaxMessagesPerPoll</code> option and set this to <code>false</code> to allow to scan all files first and then sort afterwards. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>eagerMaxMessagesPerPoll</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.3:</strong
> Allows for controlling whether the limit from <code>maxMessagesPerPoll</code> is eager or not. If eager then the limit is during the scanning of files. Where as <code>false</code> would scan all files, and then perform sorting. Setting this option to <code>false</code> allows for sorting all files first, and then limit the poll. Mind that this requires a higher memory usage as all file details are in memory to perform the sorting. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>minDepth</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> 0 </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <strong>Camel 2.8</strong>: The minimum depth to start processing when recursively processing a directory. Using <code>minDepth=1</code> means the base directory. Using <code>minDepth=2</code> means the first sub directory. This option is supported by <a shape="rect" href="ftp2.html" title="FTP2">FTP</a> consumer from <strong>Camel 2.8.2,
2.9</strong> onwards. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>maxDepth</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>Integer.MAX_VALUE</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <strong>Camel 2.8:</strong> The maximum depth to traverse when recursively processing a directory. This option is supported by <a shape="rect" href="ftp2.html" title="FTP2">FTP</a> consumer from <strong>Camel 2.8.2, 2.9</strong> onwards. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>processStrategy</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>null</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> A pluggable <code>org.apache.camel.component.file.GenericFileProcessStrategy</code> allowing you to implement your own <code>readLock</code> option or similar. Can also be used when special conditions must be met before a file can be consumed, suc
h as a special <em>ready</em> file exists. If this option is set then the <code>readLock</code> option does not apply. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>startingDirectoryMustExist</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.5:</strong> Whether the starting directory must exist. Mind that the <code>autoCreate</code> option is default enabled, which means the starting directory is normally auto created if it doesn't exist. You can disable <code>autoCreate</code> and enable this to ensure the starting directory must exist. Will thrown an exception if the directory doesn't exist. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>pollStrategy</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>null</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> A pluggabl
e <code>org.apache.camel.PollingConsumerPollStrategy</code> allowing you to provide your custom implementation to control error handling usually occurred during the <code>poll</code> operation <strong>before</strong> an <a shape="rect" href="exchange.html" title="Exchange">Exchange</a> have been created and being routed in Camel. In other words the error occurred while the polling was gathering information, for instance access to a file network failed so Camel cannot access it to scan for files. The default implementation will log the caused exception at <code>WARN</code> level and ignore it. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>sendEmptyMessageWhenIdle</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.9:</strong> If the polling consumer did not poll any files, you can enable this option to send an empty message (no body) instead
. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>consumer.bridgeErrorHandler</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> Allows for bridging the consumer to the Camel routing <a shape="rect" href="error-handler.html" title="Error Handler">Error Handler</a>, which mean any exceptions occurred while trying to pickup files, or the likes, will now be processed as a message and handled by the routing <a shape="rect" href="error-handler.html" title="Error Handler">Error Handler</a>. By default the consumer will use the <code>org.apache.camel.spi.ExceptionHandler</code> to deal with exceptions, that by default will be logged at WARN/ERROR level and ignored. See further below on this page fore more details, at section <em>How to use the Camel error handler to deal with exceptions triggered outside the routing engine</em>. </p></
td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>scheduledExecutorService</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.10:</strong> Allows for configuring a custom/shared thread pool to use for the consumer. By default each consumer has its own single threaded thread pool. This option allows you to share a thread pool among multiple file consumers. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>scheduler</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.12:</strong> To use a custom scheduler to trigger the consumer to run. See more details at <a shape="rect" href="polling-consumer.html" title="Polling Consumer">Polling Consumer</a>, for example there is a <a shape="rect" href="quartz2.html" title="Qua
rtz2">Quartz2</a>, and <a shape="rect" href="spring.html" title="Spring">Spring</a> based scheduler that supports CRON expressions. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>backoffMultiplier</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>0</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <strong>Camel 2.12:</strong> To let the scheduled polling consumer backoff if there has been a number of subsequent idles/errors in a row. The multiplier is then the number of polls that will be skipped before the next actual attempt is happening again. When this option is in use then <code>backoffIdleThreshold</code> and/or <code>backoffErrorThreshold</code> must also be configured. See more details at <a shape="rect" href="polling-consumer.html" title="Polling Consumer">Polling Consumer</a>. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>backoffIdleThreshold</code> </p></td><td colspan
="1" rowspan="1" class="confluenceTd"><p> <code>0</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <strong>Camel 2.12:</strong> The number of subsequent idle polls that should happen before the <code>backoffMultipler</code> should kick-in. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>backoffErrorThreshold</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>0</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <strong>Camel 2.12:</strong> The number of subsequent error polls (failed due some error) that should happen before the <code>backoffMultipler</code> should kick-in. </p></td></tr></tbody></table>
[... 2045 lines stripped ...]