svn commit: r1013893 [1/2] - in /websites/production/camel/content: book-component-appendix.html book-in-one-page.html cache/main.pageCache http.html

Mon, 12 Jun 2017 10:19:03 -0700 

Author: buildbot
Date: Mon Jun 12 17:18:49 2017
New Revision: 1013893

Log:
Production update by buildbot for camel

Modified:
    websites/production/camel/content/book-component-appendix.html
    websites/production/camel/content/book-in-one-page.html
    websites/production/camel/content/cache/main.pageCache
    websites/production/camel/content/http.html

Modified: websites/production/camel/content/book-component-appendix.html
==============================================================================
--- websites/production/camel/content/book-component-appendix.html (original)
+++ websites/production/camel/content/book-component-appendix.html Mon Jun 12 
17:18:49 2017
@@ -1011,11 +1011,11 @@ template.send("direct:alias-verify&
 ]]></script>
 </div></div><p></p><h3 id="BookComponentAppendix-SeeAlso.8">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="BookComponentAppendix-CXFComponent">CXF Component</h2><div 
class="confluence-information-macro confluence-information-macro-note"><span 
class="aui-icon aui-icon-small aui-iconfont-warning 
confluence-information-macro-icon"></span><div 
class="confluence-information-macro-body"><p>When using CXF as a consumer, the 
<a shape="rect" href="cxf-bean-component.html">CXF Bean Component</a> allows 
you to factor out how message payloads are received from their processing as a 
RESTful or SOAP web service. This has the potential of using a multitude of 
transports to cons
 ume web services. The bean component's configuration is also simpler and 
provides the fastest method to implement web services using Camel and 
CXF.</p></div></div><div class="confluence-information-macro 
confluence-information-macro-tip"><span class="aui-icon aui-icon-small 
aui-iconfont-approve confluence-information-macro-icon"></span><div 
class="confluence-information-macro-body"><p>When using CXF in streaming modes 
(see DataFormat option), then also read about <a shape="rect" 
href="stream-caching.html">Stream caching</a>.</p></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.rbtoc1497151453571 {padding: 0px;}
-div.rbtoc1497151453571 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1497151453571 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1497287855797 {padding: 0px;}
+div.rbtoc1497287855797 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1497287855797 li {margin-left: 0px;padding-left: 0px;}
 
-/*]]>*/</style></p><div class="toc-macro rbtoc1497151453571">
+/*]]>*/</style></p><div class="toc-macro rbtoc1497287855797">
 <ul class="toc-indentation"><li><a shape="rect" 
href="#BookComponentAppendix-CXFComponent">CXF Component</a>
 <ul class="toc-indentation"><li><a shape="rect" 
href="#BookComponentAppendix-URIformat">URI format</a></li><li><a shape="rect" 
href="#BookComponentAppendix-Options">Options</a>
 <ul class="toc-indentation"><li><a shape="rect" 
href="#BookComponentAppendix-Thedescriptionsofthedataformats">The descriptions 
of the dataformats</a>
@@ -4276,6 +4276,7 @@ from(&quot;mina2:tcp://127.0.0.1:&quot;
 </div></div></td></tr></tbody></table></div><p>URI parameters can either be 
set directly on the endpoint URI or as a header:</p><div 
class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" 
rowspan="1" class="confluenceTh"><p>Java DSL</p></th></tr><tr><td colspan="1" 
rowspan="1" class="confluenceTd"><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[from(&quot;direct:start&quot;)
   .to(&quot;http://oldhost?order=123&amp;detail=short&quot;);
+
 from(&quot;direct:start&quot;)
   .setHeader(Exchange.HTTP_QUERY, 
constant(&quot;order=123&amp;detail=short&quot;))
   .to(&quot;http://oldhost&quot;);
@@ -4293,7 +4294,7 @@ from(&quot;direct:start&quot;)
 &lt;to uri=&quot;http://www.google.com&quot;/&gt;
 &lt;to uri=&quot;mock:results&quot;/&gt;
 ]]></script>
-</div></div></td></tr></tbody></table></div><h3 
id="BookComponentAppendix-HttpEndpointOptions"><code>HttpEndpoint</code> 
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>throwExceptionOnFailure</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 to disable throwing the 
<strong><code>HttpOperationFailedException</code></strong> in case of failed 
responses from the remote server. This allows you to get all responses 
regardless of the HTTP status code.</p></td></tr><tr><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>bridgeEndpoint</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 the option 
is&#160;<strong><code>true</code></strong>,&#160;<strong><code>HttpProducer</code></strong>
 will ignore the&#160;<strong><code>Exchange.HTTP_URI</code></strong> header, 
and use the endpoint's URI for request. You may also set 
<strong><code>throwExceptionOnFailure=false</code></strong> to ensure all 
responses are propagated back to the&#160; 
<strong><code>HttpProducer</code></strong>.</p><p>From<strong> Camel 
2.3:</strong> when <strong><code>true</code></strong> the 
<strong><code>HttpProducer</code></strong> 
and&#160;<strong><code>CamelServlet</code></strong> will skip 
<strong><code>gzip</code></strong> processing when 
<strong><code>content-encoding=gzip</code></strong>.</p></td></tr><tr><td 
colspan="1" rowspan="1" 
class="confluenceTd"><p><code>disableStreamCache</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>fal
 se</code></p></td><td colspan="1" rowspan="1" 
class="confluenceTd"><p>When&#160;<strong><code>false</code></strong> 
the&#160;<strong><code>DefaultHttpBinding</code></strong> will copy the request 
input stream into a stream cache and put it into message body which allows it 
to be read more than once.</p><p>When&#160;<strong><code>true</code></strong> 
the <strong><code>DefaultHttpBinding</code></strong> will set the request input 
stream direct into the message body.</p><p>From<strong> Camel 2.17:</strong> 
this options is now also support by the producer to allow using the response 
stream directly instead of stream caching as by default.</p></td></tr><tr><td 
colspan="1" rowspan="1" class="confluenceTd"><p><span style="color: 
rgb(255,0,0);"><s><code>httpBindingRef</code></s></span></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p><span style="color: 
rgb(255,0,0);"><s><code>null</code></s></span></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><span style="color: r
 gb(255,0,0);"><s><strong>Deprecated and removed in Camel 2.17:</strong> 
Reference to a <code>org.apache.camel.component.http.HttpBinding</code> in the 
<a shape="rect" href="registry.html"><span style="color: 
rgb(255,0,0);">Registry</span></a>. Use the <code>httpBinding</code> option 
instead.</s></span></p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>httpBinding</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>From<strong> Camel 2.3:</strong> reference 
to a <strong><code>org.apache.camel.component.http.HttpBinding</code></strong> 
in the <a shape="rect" href="registry.html">Registry</a>.</p></td></tr><tr><td 
colspan="1" rowspan="1" class="confluenceTd"><p><span style="color: 
rgb(255,0,0);"><s><code>httpClientConfigurerRef</code></s></span></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p><span style="color: 
rgb(255,0,0);"><s><code>null</code></s></span>
 </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><span 
style="color: rgb(255,0,0);"><s><strong>Deprecated and removed in Camel 
2.17:</strong> Reference to a 
<code>org.apache.camel.component.http.HttpClientConfigurer</code> in the <a 
shape="rect" href="registry.html"><span style="color: 
rgb(255,0,0);">Registry</span></a>. Use the <code>httpClientConfigurer</code> 
option instead.</s></span></p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>httpClientConfigurer</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>From <strong>Camel 
2.3:</strong> reference to a 
<strong><code>org.apache.camel.component.http.HttpClientConfigurer</code></strong>
 in the <a shape="rect" href="registry.html">Registry</a>.</p></td></tr><tr><td 
colspan="1" rowspan="1" 
class="confluenceTd"><p><code>httpClient.XXX</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>
 null</code></p></td><td colspan="1" rowspan="1" 
class="confluenceTd"><p>Setting options on the <a shape="rect" 
class="external-link" 
href="http://hc.apache.org/httpclient-3.x/apidocs/org/apache/commons/httpclient/params/HttpClientParams.html";>HttpClientParams</a>.
 For instance <strong><code>httpClient.soTimeout=5000</code></strong> will set 
the <strong><code>SO_TIMEOUT</code></strong> to 5 seconds.</p></td></tr><tr><td 
colspan="1" rowspan="1" 
class="confluenceTd"><p><code>clientConnectionManager</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>To use a custom 
<strong><code>org.apache.http.conn.ClientConnectionManager</code></strong>.</p></td></tr><tr><td
 colspan="1" rowspan="1" 
class="confluenceTd"><p><code>transferException</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>From <strong>Camel 2
 .6:</strong> If enabled and an <a shape="rect" 
href="exchange.html">Exchange</a> failed processing on the consumer side, and 
if the caused <strong><code>Exception</code></strong> was send back serialized 
in the response as a 
<strong><code>application/x-java-serialized-object</code></strong> content type 
(for example using <a shape="rect" href="jetty.html">Jetty</a> or <a 
shape="rect" href="servlet.html">SERVLET</a> Camel components).</p><p>On the 
producer side the exception will be deserialized and thrown as is, instead of 
the <strong><code>HttpOperationFailedException</code></strong>. The caused 
exception will be serialized.</p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>headerFilterStrategy</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>From <strong>Camel 
2.11:</strong> reference to a instance of 
<strong><code>org.apache.camel.spi.HeaderFilterStrategy</code
 ></strong> in the <a shape="rect" href="registry.html">Registry</a>. It will 
 >be used to apply the 
 >custom&#160;<strong><code>headerFilterStrategy</code></strong> on the new 
 >create <strong><code>HttpEndpoint</code></strong>.</p></td></tr><tr><td 
 >colspan="1" rowspan="1" 
 >class="confluenceTd"><p><code>urlRewrite</code></p></td><td colspan="1" 
 >rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1" 
 >rowspan="1" class="confluenceTd"><p>From <strong>Camel 2.11:</strong> 
 ><em><strong>Producer only!</strong> </em></p><p>Refers to a custom 
 ><strong><code>org.apache.camel.component.http.UrlRewrite</code></strong> 
 >which allows you to rewrite URLs when you bridge/proxy endpoints.</p><p>See 
 >more details at <a shape="rect" href="urlrewrite.html">UrlRewrite</a> and <a 
 >shape="rect" 
 >href="how-to-use-camel-as-a-http-proxy-between-a-client-and-server.html">How 
 >to use Camel as a HTTP proxy between a client and 
 >server</a>.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd
 "><p><code>eagerCheckContentAvailable</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>From <strong>Camel 2.15.3/2.16:</strong> 
<em><strong>Consumer only</strong>!</em></p><p>Whether to eager check whether 
the HTTP requests has content when 
<strong><code>content-length=0</code></strong> or is not present.</p><p>This 
option should be set to <strong><code>true</code></strong> for those HTTP 
clients that do not send streamed data.</p></td></tr><tr><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>copyHeaders</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p><code>true</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>From<strong> Camel 
2.16:</strong> if this option is true 
then&#160;<strong><code>IN</code></strong> exchange headers will be copied 
to&#160;<strong><code>OUT</code></strong> exchange headers according to copy 
strategy.</p><p>Setting thi
 s to <strong><code>false</code></strong>, allows to only include the headers 
from the HTTP response (not propagating&#160;<strong><code>IN</code></strong> 
headers).</p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>okStatusCodeRange</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>200-299</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>From<strong> Camel 
2.16:</strong> the range of HTTP status codes for which a response is 
considered a success. The values are inclusive. The range must be defined as 
from-to with the dash included.</p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>ignoreResponseBody</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>From<strong> Camel 2.16:</strong> when 
<strong><code>true</code></strong> 
the&#160;<strong><code>HttpProducer</code></strong> will not read the response 
 body nor cache the input stream.</p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>cookieHandler</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>From<strong> Camel: 2.19:</strong> 
configure a cookie handler to maintain a HTTP 
session</p></td></tr></tbody></table></div></div>
+</div></div></td></tr></tbody></table></div><h3 
id="BookComponentAppendix-HttpEndpointOptions"><code>HttpEndpoint</code> 
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>throwExceptionOnFailure</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 to disable throwing the 
<strong><code>HttpOperationFailedException</code></strong> in case of failed 
responses from the remote server. This allows you to get all responses 
regardless of the HTTP status code.</p></td></tr><tr><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>bridgeEndpoint</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 the option 
is&#160;<strong><code>true</code></strong>,&#160;<strong><code>HttpProducer</code></strong>
 will ignore the&#160;<strong><code>Exchange.HTTP_URI</code></strong> header, 
and use the endpoint's URI for request. You may also set 
<strong><code>throwExceptionOnFailure=false</code></strong> to ensure all 
responses are propagated back to the&#160; 
<strong><code>HttpProducer</code></strong>.</p><p>From<strong> Camel 
2.3:</strong> when <strong><code>true</code></strong> the 
<strong><code>HttpProducer</code></strong> 
and&#160;<strong><code>CamelServlet</code></strong> will skip 
<strong><code>gzip</code></strong> processing when 
<strong><code>content-encoding=gzip</code></strong>.</p></td></tr><tr><td 
colspan="1" rowspan="1" 
class="confluenceTd"><p><code>disableStreamCache</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>fal
 se</code></p></td><td colspan="1" rowspan="1" 
class="confluenceTd"><p>When&#160;<strong><code>false</code></strong> 
the&#160;<strong><code>DefaultHttpBinding</code></strong> will copy the request 
input stream into a stream cache and put it into message body which allows it 
to be read more than once.</p><p>When&#160;<strong><code>true</code></strong> 
the <strong><code>DefaultHttpBinding</code></strong> will set the request input 
stream direct into the message body.</p><p>From<strong> Camel 2.17:</strong> 
this options is now also support by the producer to allow using the response 
stream directly instead of stream caching as by default.</p></td></tr><tr><td 
colspan="1" rowspan="1" class="confluenceTd"><p><span style="color: 
rgb(255,0,0);"><s><code>httpBindingRef</code></s></span></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p><span style="color: 
rgb(255,0,0);"><s><code>null</code></s></span></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><span style="color: r
 gb(255,0,0);"><s><strong>Deprecated and removed in Camel 2.17:</strong> 
Reference to a <code>org.apache.camel.component.http.HttpBinding</code> in the 
<a shape="rect" href="registry.html"><span style="color: 
rgb(255,0,0);">Registry</span></a>. Use the <code>httpBinding</code> option 
instead.</s></span></p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>httpBinding</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>From<strong> Camel 2.3:</strong> reference 
to a <strong><code>org.apache.camel.component.http.HttpBinding</code></strong> 
in the <a shape="rect" href="registry.html">Registry</a>.</p></td></tr><tr><td 
colspan="1" rowspan="1" class="confluenceTd"><p><span style="color: 
rgb(255,0,0);"><s><code>httpClientConfigurerRef</code></s></span></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p><span style="color: 
rgb(255,0,0);"><s><code>null</code></s></span>
 </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><span 
style="color: rgb(255,0,0);"><s><strong>Deprecated and removed in Camel 
2.17:</strong> Reference to a 
<code>org.apache.camel.component.http.HttpClientConfigurer</code> in the <a 
shape="rect" href="registry.html"><span style="color: 
rgb(255,0,0);">Registry</span></a>. Use the <code>httpClientConfigurer</code> 
option instead.</s></span></p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>httpClientConfigurer</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>From <strong>Camel 
2.3:</strong> reference to a 
<strong><code>org.apache.camel.component.http.HttpClientConfigurer</code></strong>
 in the <a shape="rect" href="registry.html">Registry</a>.</p></td></tr><tr><td 
colspan="1" rowspan="1" 
class="confluenceTd"><p><code>httpClient.XXX</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 
this to option to configure the underlying <a shape="rect" 
class="external-link" 
href="http://hc.apache.org/httpclient-3.x/apidocs/org/apache/commons/httpclient/params/HttpClientParams.html";>HttpClientParams</a>.</p><p>Example:
 <strong><code>httpClient.soTimeout=5000</code></strong> will set the 
<strong><code>SO_TIMEOUT</code></strong> to 5 seconds.</p></td></tr><tr><td 
colspan="1" rowspan="1" 
class="confluenceTd"><p><code>clientConnectionManager</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>To use a custom 
<strong><code>org.apache.http.conn.ClientConnectionManager</code></strong>.</p></td></tr><tr><td
 colspan="1" rowspan="1" 
class="confluenceTd"><p><code>transferException</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td colspan="1" 
rowspan="1" class="confluenceT
 d"><p>From <strong>Camel 2.6:</strong> If enabled and an <a shape="rect" 
href="exchange.html">Exchange</a> failed processing on the consumer side, and 
if the caused <strong><code>Exception</code></strong> was send back serialized 
in the response as a 
<strong><code>application/x-java-serialized-object</code></strong> content type 
(for example using <a shape="rect" href="jetty.html">Jetty</a> or <a 
shape="rect" href="servlet.html">SERVLET</a> Camel components).</p><p>On the 
producer side the exception will be deserialized and thrown as is, instead of 
the <strong><code>HttpOperationFailedException</code></strong>. The caused 
exception will be serialized.</p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>headerFilterStrategy</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>From <strong>Camel 
2.11:</strong> reference to a instance of <strong><code>org.apache.camel.spi.
 HeaderFilterStrategy</code></strong> in the <a shape="rect" 
href="registry.html">Registry</a>. It will be used to apply the 
custom&#160;<strong><code>headerFilterStrategy</code></strong> on the new 
create <strong><code>HttpEndpoint</code></strong>.</p></td></tr><tr><td 
colspan="1" rowspan="1" 
class="confluenceTd"><p><code>urlRewrite</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>From <strong>Camel 2.11:</strong> 
<em><strong>Producer only!</strong> </em></p><p>Refers to a custom 
<strong><code>org.apache.camel.component.http.UrlRewrite</code></strong> which 
allows you to rewrite URLs when you bridge/proxy endpoints.</p><p>See more 
details at <a shape="rect" href="urlrewrite.html">UrlRewrite</a> and <a 
shape="rect" 
href="how-to-use-camel-as-a-http-proxy-between-a-client-and-server.html">How to 
use Camel as a HTTP proxy between a client and server</a>.</p></td></tr><tr><td 
colspan="1" rowsp
 an="1" 
class="confluenceTd"><p><code>eagerCheckContentAvailable</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>From <strong>Camel 
2.15.3/2.16:</strong> <em><strong>Consumer only</strong>!</em></p><p>Whether to 
eager check whether the HTTP requests has content when 
<strong><code>content-length=0</code></strong> or is not present.</p><p>This 
option should be set to <strong><code>true</code></strong> for those HTTP 
clients that do not send streamed data.</p></td></tr><tr><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>copyHeaders</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p><code>true</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>From<strong> Camel 
2.16:</strong> if this option is true 
then&#160;<strong><code>IN</code></strong> exchange headers will be copied 
to&#160;<strong><code>OUT</code></strong> exchange headers according to copy s
 trategy.</p><p>Setting this to <strong><code>false</code></strong>, allows to 
only include the headers from the HTTP response (not 
propagating&#160;<strong><code>IN</code></strong> 
headers).</p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>okStatusCodeRange</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>200-299</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>From<strong> Camel 
2.16:</strong> the range of HTTP status codes for which a response is 
considered a success. The values are inclusive. The range must be in the form 
<strong><code>from-to</code></strong>, dash included.</p></td></tr><tr><td 
colspan="1" rowspan="1" 
class="confluenceTd"><p><code>ignoreResponseBody</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>From<strong> Camel 2.16:</strong> when 
<strong><code>true</code></strong> the&#160;<strong><code>HttpPro
 ducer</code></strong> will not read the response body nor cache the input 
stream.</p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>cookieHandler</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>From<strong> Camel: 2.19:</strong> 
configure a cookie handler to maintain a HTTP 
session</p></td></tr></tbody></table></div></div>
 
 
 <h3 id="BookComponentAppendix-AuthenticationandProxy">Authentication and 
Proxy</h3><p>The following authentication options can also be set on the 
<strong><code>HttpEndpoint</code></strong>:</p><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>authMethod</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>Authentication method, either 
as <strong><code>Basic</code></strong>, <strong><code>Digest</code></strong> or 
<strong><code>NTLM</code></strong>.</p></td></tr><tr><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>authMethodPriority</code></p></td><td 
colspan="1"
  rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>Priority of authentication methods. Is a 
list separated with comma.</p><p>For example: 
<code><strong>Basic</strong>,<strong>Digest</strong></code> to exclude 
<strong><code>NTLM</code></strong>.</p></td></tr><tr><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>authUsername</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>Username for 
authentication.</p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>authPassword</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>Password for 
authentication.</p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>authDomain</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>null<
 /code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Domain 
for&#160;<strong><code>NTLM</code></strong> 
authentication.</p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>authHost</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>Optional host 
for&#160;<strong><code>NTLM</code></strong> 
authentication.</p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>proxyHost</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>The proxy host name.</p></td></tr><tr><td 
colspan="1" rowspan="1" 
class="confluenceTd"><p><code>proxyPort</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>The proxy port number.</p></td></tr><tr><td 
colspan="1" rowspan="1" class="conf
 luenceTd"><p><code>proxyAuthMethod</code></p></td><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>null</code></p></td><td colspan="1" rowspan="1" 
class="confluenceTd"><p>Authentication method for proxy, either as 
<strong><code>Basic</code></strong>, <strong><code>Digest</code></strong> or 
<strong><code>NTLM</code></strong>.</p></td></tr><tr><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>proxyAuthUsername</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>Username for proxy 
authentication.</p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>proxyAuthPassword</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>Password for proxy 
authentication.</p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>proxyAuthDomain</code></p></td><td colsp
 an="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>Domain for 
proxy&#160;<strong><code>NTLM</code></strong> 
authentication.</p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>proxyAuthHost</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>Optional host for 
proxy&#160;<strong><code>NTLM</code></strong> 
authentication.</p></td></tr></tbody></table></div></div>
@@ -4325,22 +4326,24 @@ HttpServletRequest response = exchange.g
       &lt;/properties&gt;
    &lt;/camelContext&gt;
 ]]></script>
-</div></div></td></tr></tbody></table></div><p>Options 
on&#160;<strong><code>Endpoint</code></strong> will override options on the 
context.</p><h3 
id="BookComponentAppendix-Configuringcharset">Configuring&#160;<code>charset</code></h3><p>If
 you are using <strong><code>POST</code></strong> to send data you can 
configure the <strong><code>charset</code></strong></p><div class="code panel 
pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="brush: java; gutter: false; theme: Default" 
type="syntaxhighlighter"><![CDATA[setProperty(Exchange.CHARSET_NAME, 
&quot;iso-8859-1&quot;);
+</div></div></td></tr></tbody></table></div><p>Options 
on&#160;<strong><code>Endpoint</code></strong> will override options on the 
context.</p><h3 
id="BookComponentAppendix-Configuringcharset">Configuring&#160;<code>charset</code></h3><p>If
 you are using&#160;<strong><code>POST</code></strong> to send data you can 
configure the <strong><code>charset</code></strong>:</p><div class="code panel 
pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+<script class="brush: java; gutter: false; theme: Default" 
type="syntaxhighlighter"><![CDATA[.setProperty(Exchange.CHARSET_NAME, 
&quot;iso-8859-1&quot;);
 ]]></script>
 </div></div><h3 id="BookComponentAppendix-SamplewithScheduledPoll">Sample with 
Scheduled Poll</h3><p>The sample polls the Google homepage every 10 seconds and 
write the page to the file <strong><code>message.html</code></strong>:</p><div 
class="code panel pdl" style="border-width: 1px;"><div class="codeContent 
panelContent pdl">
 <script class="brush: java; gutter: false; theme: Default" 
type="syntaxhighlighter"><![CDATA[from(&quot;timer://foo?fixedRate=true&amp;delay=0&amp;period=10000&quot;)
     .to(&quot;http://www.google.com&quot;)
-    .setHeader(FileComponent.HEADER_FILE_NAME, 
&quot;message.html&quot;).to(&quot;file:target/google&quot;);
+    .setHeader(FileComponent.HEADER_FILE_NAME, &quot;message.html&quot;)
+    .to(&quot;file:target/google&quot;);
 ]]></script>
 </div></div><h3 id="BookComponentAppendix-GettingtheResponseCode">Getting the 
Response Code</h3><p>You can get the HTTP response code from the HTTP component 
by getting the value from the&#160;<strong><code>OUT</code></strong> message 
header with <strong><code>Exchange.HTTP_RESPONSE_CODE</code></strong>:</p><div 
class="code panel pdl" style="border-width: 1px;"><div class="codeContent 
panelContent pdl">
-<script class="brush: java; gutter: false; theme: Default" 
type="syntaxhighlighter"><![CDATA[   Exchange exchange = 
template.send(&quot;http://www.google.com/search&quot;, new Processor() {
-            public void process(Exchange exchange) throws Exception {
-                exchange.getIn().setHeader(Exchange.HTTP_QUERY, 
constant(&quot;hl=en&amp;q=activemq&quot;));
-            }
-   });
-   Message out = exchange.getOut();
-   int responseCode = out.getHeader(Exchange.HTTP_RESPONSE_CODE, 
Integer.class);
+<script class="brush: java; gutter: false; theme: Default" 
type="syntaxhighlighter"><![CDATA[Exchange exchange = 
template.send(&quot;http://www.google.com/search&quot;, new Processor() {
+    public void process(Exchange exchange) throws Exception {
+      exchange.getIn().setHeader(Exchange.HTTP_QUERY, 
constant(&quot;hl=en&amp;q=activemq&quot;));
+    }
+});
+
+Message out = exchange.getOut();
+int responseCode = out.getHeader(Exchange.HTTP_RESPONSE_CODE, Integer.class);
 ]]></script>
 </div></div><h3 
id="BookComponentAppendix-UsingthrowExceptionOnFailure=falseToObtainAllServerResponses">Using
 <code>throwExceptionOnFailure=false</code> To Obtain All Server 
Responses</h3><p>In the route below we want to route a message that we <a 
shape="rect" href="content-enricher.html">enrich</a> with data returned from a 
remote HTTP call. As we want all responses from the remote server, we set the 
<strong><code>throwExceptionOnFailure=false</code></strong> so we get any 
response in the <strong><code>AggregationStrategy</code></strong>. As the code 
is based on a unit test that simulates a HTTP status code 404, there is some 
assertion code etc.</p><div class="code panel pdl" style="border-width: 
1px;"><div class="codeContent panelContent pdl">
 <script class="brush: java; gutter: false; theme: Default" 
type="syntaxhighlighter"><![CDATA[
@@ -4366,7 +4369,7 @@ from(&quot;jetty://http://localhost:8222
             }
         });
 ]]></script>
-</div></div><h3 id="BookComponentAppendix-DisablingCookies">Disabling 
Cookies</h3><p>To disable cookies you can set the HTTP Client to ignore cookies 
by adding this URI option:<br clear="none"> 
<strong><code>httpClient.cookiePolicy=ignoreCookies</code></strong></p><h3 
id="BookComponentAppendix-AdvancedUsage">Advanced Usage</h3><p>If you need more 
control over the HTTP producer you should use the 
<strong><code>HttpComponent</code></strong> where you can set various classes 
to give you custom behavior.</p><h4 
id="BookComponentAppendix-SettingMaxConnectionsPerHost">Setting&#160;<code>MaxConnectionsPerHost</code></h4><p>The
 <a shape="rect" href="http.html">HTTP</a> Component has a 
<strong><code>org.apache.commons.httpclient.HttpConnectionManager</code></strong>
 where you can configure various global configuration for the given component. 
By global, we mean that any endpoint the component creates has the same shared 
<strong><code>HttpConnectionManager</code></strong>. So, if we want to s
 et a different value for the max connection per host, we need to define it on 
the HTTP component and <em>not</em> on the endpoint URI that we usually use. So 
here comes:</p><p>First, we define the <strong><code>http</code></strong> 
component in Spring XML. Yes, we use the same scheme name, 
<strong><code>http</code></strong>, because otherwise Camel will auto-discover 
and create the component with default settings. What we need is to overrule 
this so we can set our options. In the sample below we set the max connection 
to 5 instead of the default of 2.</p><div class="code panel pdl" 
style="border-width: 1px;"><div class="codeContent panelContent pdl">
+</div></div><h3 id="BookComponentAppendix-DisablingCookies">Disabling 
Cookies</h3><p>To disable cookies you can set the HTTP Client to ignore cookies 
by adding this URI option: 
<strong><code>httpClient.cookiePolicy=ignoreCookies</code></strong></p><h3 
id="BookComponentAppendix-AdvancedUsage">Advanced Usage</h3><p>If you need more 
control over the HTTP producer you should use the 
<strong><code>HttpComponent</code></strong> where you can set various classes 
to give you custom behavior.</p><h4 
id="BookComponentAppendix-SettingMaxConnectionsPerHost">Setting&#160;<code>MaxConnectionsPerHost</code></h4><p>The
 <a shape="rect" href="http.html">HTTP</a> Component has a 
<strong><code>org.apache.commons.httpclient.HttpConnectionManager</code></strong>
 where you can configure various global configuration for the given component. 
By global, we mean that any endpoint the component creates has the same shared 
<strong><code>HttpConnectionManager</code></strong>. So, if we want to set a 
different va
 lue for the max connection per host, we need to define it on the HTTP 
component and <em>not</em> on the endpoint URI that we usually use. So here 
comes:</p><p>First, we define the <strong><code>http</code></strong> component 
in Spring XML. Yes, we use the same scheme name, 
<strong><code>http</code></strong>, because otherwise Camel will auto-discover 
and create the component with default settings. What we need is to overrule 
this so we can set our options. In the sample below we set the max connection 
to 5 instead of the default of 2.</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[
 &lt;bean id=&quot;http&quot; 
class=&quot;org.apache.camel.component.http.HttpComponent&quot;&gt;
     &lt;property name=&quot;camelContext&quot; ref=&quot;camel&quot;/&gt;
@@ -4404,22 +4407,18 @@ kmp.setKeyPassword(&quot;keyPassword&quo
 SSLContextParameters scp = new SSLContextParameters();
 scp.setKeyManagers(kmp);
 
-ProtocolSocketFactory factory =
-    new SSLContextParametersSecureProtocolSocketFactory(scp);
+ProtocolSocketFactory factory = new 
SSLContextParametersSecureProtocolSocketFactory(scp);
 
-Protocol.registerProtocol(&quot;https&quot;,
-        new Protocol(
-        &quot;https&quot;,
-        factory,
-        443));
+Protocol.registerProtocol(&quot;https&quot;, new Protocol(&quot;https&quot;, 
factory, 443));
 
 from(&quot;direct:start&quot;)
-        
.to(&quot;https://mail.google.com/mail/&quot;).to(&quot;mock:results&quot;);
+    .to(&quot;https://mail.google.com/mail/&quot;)
+    .to(&quot;mock:results&quot;);
 ]]></script>
 </div></div><h5 
id="BookComponentAppendix-ConfiguringApacheHTTPClientDirectly">Configuring 
Apache HTTP Client 
Directly</h5><p>Basically&#160;<strong><code>camel-http</code></strong> 
component is built on the top of Apache HTTP client, and you can implement a 
custom 
<strong><code>org.apache.camel.component.http.HttpClientConfigurer</code></strong>
 to do some configuration on the HTTP client if you need full control of 
it.</p><p>However, if you <em>just</em> want to specify 
the&#160;<strong><code>keystore</code></strong> 
and&#160;<strong><code>truststore</code></strong> you can do this with Apache 
HTTP <strong><code>HttpClientConfigurer</code></strong>, for example:</p><div 
class="code panel pdl" style="border-width: 1px;"><div class="codeContent 
panelContent pdl">
-<script class="brush: java; gutter: false; theme: Default" 
type="syntaxhighlighter"><![CDATA[Protocol authhttps = new 
Protocol(&quot;https&quot;, new AuthSSLProtocolSocketFactory(
-  new URL(&quot;file:my.keystore&quot;), &quot;mypassword&quot;,
-  new URL(&quot;file:my.truststore&quot;), &quot;mypassword&quot;), 443);
+<script class="brush: java; gutter: false; theme: Default" 
type="syntaxhighlighter"><![CDATA[Protocol authhttps = new 
Protocol(&quot;https&quot;, 
+                                  new AuthSSLProtocolSocketFactory(new 
URL(&quot;file:my.keystore&quot;), &quot;mypassword&quot;, new 
URL(&quot;file:my.truststore&quot;), &quot;mypassword&quot;), 
+                                  443);
 
 Protocol.registerProtocol(&quot;https&quot;, authhttps);
 ]]></script>
@@ -4428,9 +4427,7 @@ Protocol.registerProtocol(&quot;https&qu
 httpComponent.setHttpClientConfigurer(new MyHttpClientConfigurer());
 ]]></script>
 </div></div><p>If you are doing this using the Spring DSL, you can specify 
your <strong><code>HttpClientConfigurer</code></strong> using the URI. For 
example:</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[&lt;bean id=&quot;myHttpClientConfigurer&quot;
- class=&quot;my.https.HttpClientConfigurer&quot;&gt;
-&lt;/bean&gt;
+<script class="brush: xml; gutter: false; theme: Default" 
type="syntaxhighlighter"><![CDATA[&lt;bean 
id=&quot;myHttpClientConfigurer&quot; 
class=&quot;my.https.HttpClientConfigurer&quot;/&gt;
 
 &lt;to 
uri=&quot;https://myhostname.com:443/myURL?httpClientConfigurerRef=myHttpClientConfigurer&quot;/&gt;
 ]]></script>

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 Mon Jun 12 17:18:49 
2017
@@ -3545,11 +3545,11 @@ The tutorial has been designed in two pa
 While not actual tutorials you might find working through the source of the 
various <a shape="rect" href="examples.html">Examples</a> useful.</li></ul>
 
 <h2 id="BookInOnePage-TutorialonSpringRemotingwithJMS">Tutorial on Spring 
Remoting with JMS</h2><p>&#160;</p><div class="confluence-information-macro 
confluence-information-macro-information"><p class="title">Thanks</p><span 
class="aui-icon aui-icon-small aui-iconfont-info 
confluence-information-macro-icon"></span><div 
class="confluence-information-macro-body"><p>This tutorial was kindly donated 
to Apache Camel by Martin Gilday.</p></div></div><h2 
id="BookInOnePage-Preface">Preface</h2><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><p><style type="text/css">/*<![CDATA[*/
-div.rbtoc1497151465015 {padding: 0px;}
-div.rbtoc1497151465015 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1497151465015 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1497287861052 {padding: 0px;}
+div.rbtoc1497287861052 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1497287861052 li {margin-left: 0px;padding-left: 0px;}
 
-/*]]>*/</style></p><div class="toc-macro rbtoc1497151465015">
+/*]]>*/</style></p><div class="toc-macro rbtoc1497287861052">
 <ul class="toc-indentation"><li><a shape="rect" 
href="#BookInOnePage-TutorialonSpringRemotingwithJMS">Tutorial on Spring 
Remoting with JMS</a></li><li><a shape="rect" 
href="#BookInOnePage-Preface">Preface</a></li><li><a shape="rect" 
href="#BookInOnePage-Prerequisites">Prerequisites</a></li><li><a shape="rect" 
href="#BookInOnePage-Distribution">Distribution</a></li><li><a shape="rect" 
href="#BookInOnePage-About">About</a></li><li><a shape="rect" 
href="#BookInOnePage-CreatetheCamelProject">Create the Camel Project</a>
 <ul class="toc-indentation"><li><a shape="rect" 
href="#BookInOnePage-UpdatethePOMwithDependencies">Update the POM with 
Dependencies</a></li></ul>
 </li><li><a shape="rect" href="#BookInOnePage-WritingtheServer">Writing the 
Server</a>
@@ -5664,11 +5664,11 @@ So we completed the last piece in the pi
 <p>This example has been removed from <strong>Camel 2.9</strong> onwards. 
Apache Axis 1.4 is a very old and unsupported framework. We encourage users to 
use <a shape="rect" href="cxf.html">CXF</a> instead of Axis.</p></div></div>
 
 <style type="text/css">/*<![CDATA[*/
-div.rbtoc1497151465161 {padding: 0px;}
-div.rbtoc1497151465161 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1497151465161 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1497287861252 {padding: 0px;}
+div.rbtoc1497287861252 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1497287861252 li {margin-left: 0px;padding-left: 0px;}
 
-/*]]>*/</style><div class="toc-macro rbtoc1497151465161">
+/*]]>*/</style><div class="toc-macro rbtoc1497287861252">
 <ul class="toc-indentation"><li><a shape="rect" 
href="#BookInOnePage-TutorialusingAxis1.4withApacheCamel">Tutorial using Axis 
1.4 with Apache Camel</a>
 <ul class="toc-indentation"><li><a shape="rect" 
href="#BookInOnePage-Prerequisites">Prerequisites</a></li><li><a shape="rect" 
href="#BookInOnePage-Distribution">Distribution</a></li><li><a shape="rect" 
href="#BookInOnePage-Introduction">Introduction</a></li><li><a shape="rect" 
href="#BookInOnePage-SettinguptheprojecttorunAxis">Setting up the project to 
run Axis</a>
 <ul class="toc-indentation"><li><a shape="rect" 
href="#BookInOnePage-Maven2">Maven 2</a></li><li><a shape="rect" 
href="#BookInOnePage-wsdl">wsdl</a></li><li><a shape="rect" 
href="#BookInOnePage-ConfiguringAxis">Configuring Axis</a></li><li><a 
shape="rect" href="#BookInOnePage-RunningtheExample">Running the 
Example</a></li></ul>
@@ -16869,11 +16869,11 @@ template.send(&quot;direct:alias-verify&
 ]]></script>
 </div></div><p></p><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="confluence-information-macro confluence-information-macro-note"><span 
class="aui-icon aui-icon-small aui-iconfont-warning 
confluence-information-macro-icon"></span><div 
class="confluence-information-macro-body"><p>When using CXF as a consumer, the 
<a shape="rect" href="cxf-bean-component.html">CXF Bean Component</a> allows 
you to factor out how message payloads are received from their processing as a 
RESTful or SOAP web service. This has the potential of using a multitude of 
transports to consume web 
 services. The bean component's configuration is also simpler and provides the 
fastest method to implement web services using Camel and 
CXF.</p></div></div><div class="confluence-information-macro 
confluence-information-macro-tip"><span class="aui-icon aui-icon-small 
aui-iconfont-approve confluence-information-macro-icon"></span><div 
class="confluence-information-macro-body"><p>When using CXF in streaming modes 
(see DataFormat option), then also read about <a shape="rect" 
href="stream-caching.html">Stream caching</a>.</p></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.rbtoc1497151466417 {padding: 0px;}
-div.rbtoc1497151466417 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1497151466417 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1497287862311 {padding: 0px;}
+div.rbtoc1497287862311 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1497287862311 li {margin-left: 0px;padding-left: 0px;}
 
-/*]]>*/</style></p><div class="toc-macro rbtoc1497151466417">
+/*]]>*/</style></p><div class="toc-macro rbtoc1497287862311">
 <ul class="toc-indentation"><li><a shape="rect" 
href="#BookInOnePage-CXFComponent">CXF Component</a>
 <ul class="toc-indentation"><li><a shape="rect" 
href="#BookInOnePage-URIformat">URI format</a></li><li><a shape="rect" 
href="#BookInOnePage-Options">Options</a>
 <ul class="toc-indentation"><li><a shape="rect" 
href="#BookInOnePage-Thedescriptionsofthedataformats">The descriptions of the 
dataformats</a>
@@ -20134,6 +20134,7 @@ from(&quot;mina2:tcp://127.0.0.1:&quot;
 </div></div></td></tr></tbody></table></div><p>URI parameters can either be 
set directly on the endpoint URI or as a header:</p><div 
class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" 
rowspan="1" class="confluenceTh"><p>Java DSL</p></th></tr><tr><td colspan="1" 
rowspan="1" class="confluenceTd"><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[from(&quot;direct:start&quot;)
   .to(&quot;http://oldhost?order=123&amp;detail=short&quot;);
+
 from(&quot;direct:start&quot;)
   .setHeader(Exchange.HTTP_QUERY, 
constant(&quot;order=123&amp;detail=short&quot;))
   .to(&quot;http://oldhost&quot;);
@@ -20151,7 +20152,7 @@ from(&quot;direct:start&quot;)
 &lt;to uri=&quot;http://www.google.com&quot;/&gt;
 &lt;to uri=&quot;mock:results&quot;/&gt;
 ]]></script>
-</div></div></td></tr></tbody></table></div><h3 
id="BookInOnePage-HttpEndpointOptions"><code>HttpEndpoint</code> 
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>throwExceptionOnFailure</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 to disable throwing the 
<strong><code>HttpOperationFailedException</code></strong> in case of failed 
responses from the remote server. This allows you to get all responses 
regardless of the HTTP status code.</p></td></tr><tr><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>bridgeEndpoint</code></p></td><td c
 olspan="1" rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>If the option 
is&#160;<strong><code>true</code></strong>,&#160;<strong><code>HttpProducer</code></strong>
 will ignore the&#160;<strong><code>Exchange.HTTP_URI</code></strong> header, 
and use the endpoint's URI for request. You may also set 
<strong><code>throwExceptionOnFailure=false</code></strong> to ensure all 
responses are propagated back to the&#160; 
<strong><code>HttpProducer</code></strong>.</p><p>From<strong> Camel 
2.3:</strong> when <strong><code>true</code></strong> the 
<strong><code>HttpProducer</code></strong> 
and&#160;<strong><code>CamelServlet</code></strong> will skip 
<strong><code>gzip</code></strong> processing when 
<strong><code>content-encoding=gzip</code></strong>.</p></td></tr><tr><td 
colspan="1" rowspan="1" 
class="confluenceTd"><p><code>disableStreamCache</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>false</code
 ></p></td><td colspan="1" rowspan="1" 
 >class="confluenceTd"><p>When&#160;<strong><code>false</code></strong> 
 >the&#160;<strong><code>DefaultHttpBinding</code></strong> will copy the 
 >request input stream into a stream cache and put it into message body which 
 >allows it to be read more than 
 >once.</p><p>When&#160;<strong><code>true</code></strong> the 
 ><strong><code>DefaultHttpBinding</code></strong> will set the request input 
 >stream direct into the message body.</p><p>From<strong> Camel 2.17:</strong> 
 >this options is now also support by the producer to allow using the response 
 >stream directly instead of stream caching as by default.</p></td></tr><tr><td 
 >colspan="1" rowspan="1" class="confluenceTd"><p><span style="color: 
 >rgb(255,0,0);"><s><code>httpBindingRef</code></s></span></p></td><td 
 >colspan="1" rowspan="1" class="confluenceTd"><p><span style="color: 
 >rgb(255,0,0);"><s><code>null</code></s></span></p></td><td colspan="1" 
 >rowspan="1" class="confluenceTd"><p><span style="color: rgb(255,0
 ,0);"><s><strong>Deprecated and removed in Camel 2.17:</strong> Reference to a 
<code>org.apache.camel.component.http.HttpBinding</code> in the <a shape="rect" 
href="registry.html"><span style="color: rgb(255,0,0);">Registry</span></a>. 
Use the <code>httpBinding</code> option 
instead.</s></span></p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>httpBinding</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>From<strong> Camel 2.3:</strong> reference 
to a <strong><code>org.apache.camel.component.http.HttpBinding</code></strong> 
in the <a shape="rect" href="registry.html">Registry</a>.</p></td></tr><tr><td 
colspan="1" rowspan="1" class="confluenceTd"><p><span style="color: 
rgb(255,0,0);"><s><code>httpClientConfigurerRef</code></s></span></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p><span style="color: 
rgb(255,0,0);"><s><code>null</code></s></span></p></td
 ><td colspan="1" rowspan="1" class="confluenceTd"><p><span style="color: 
 >rgb(255,0,0);"><s><strong>Deprecated and removed in Camel 2.17:</strong> 
 >Reference to a 
 ><code>org.apache.camel.component.http.HttpClientConfigurer</code> in the <a 
 >shape="rect" href="registry.html"><span style="color: 
 >rgb(255,0,0);">Registry</span></a>. Use the <code>httpClientConfigurer</code> 
 >option instead.</s></span></p></td></tr><tr><td colspan="1" rowspan="1" 
 >class="confluenceTd"><p><code>httpClientConfigurer</code></p></td><td 
 >colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td 
 >colspan="1" rowspan="1" class="confluenceTd"><p>From <strong>Camel 
 >2.3:</strong> reference to a 
 ><strong><code>org.apache.camel.component.http.HttpClientConfigurer</code></strong>
 > in the <a shape="rect" 
 >href="registry.html">Registry</a>.</p></td></tr><tr><td colspan="1" 
 >rowspan="1" class="confluenceTd"><p><code>httpClient.XXX</code></p></td><td 
 >colspan="1" rowspan="1" class="confluenceTd"><p><code>null</co
 de></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Setting 
options on the <a shape="rect" class="external-link" 
href="http://hc.apache.org/httpclient-3.x/apidocs/org/apache/commons/httpclient/params/HttpClientParams.html";>HttpClientParams</a>.
 For instance <strong><code>httpClient.soTimeout=5000</code></strong> will set 
the <strong><code>SO_TIMEOUT</code></strong> to 5 seconds.</p></td></tr><tr><td 
colspan="1" rowspan="1" 
class="confluenceTd"><p><code>clientConnectionManager</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>To use a custom 
<strong><code>org.apache.http.conn.ClientConnectionManager</code></strong>.</p></td></tr><tr><td
 colspan="1" rowspan="1" 
class="confluenceTd"><p><code>transferException</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>From <strong>Camel 2.6:</str
 ong> If enabled and an <a shape="rect" href="exchange.html">Exchange</a> 
failed processing on the consumer side, and if the caused 
<strong><code>Exception</code></strong> was send back serialized in the 
response as a 
<strong><code>application/x-java-serialized-object</code></strong> content type 
(for example using <a shape="rect" href="jetty.html">Jetty</a> or <a 
shape="rect" href="servlet.html">SERVLET</a> Camel components).</p><p>On the 
producer side the exception will be deserialized and thrown as is, instead of 
the <strong><code>HttpOperationFailedException</code></strong>. The caused 
exception will be serialized.</p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>headerFilterStrategy</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>From <strong>Camel 
2.11:</strong> reference to a instance of 
<strong><code>org.apache.camel.spi.HeaderFilterStrategy</code></stron
 g> in the <a shape="rect" href="registry.html">Registry</a>. It will be used 
to apply the custom&#160;<strong><code>headerFilterStrategy</code></strong> on 
the new create <strong><code>HttpEndpoint</code></strong>.</p></td></tr><tr><td 
colspan="1" rowspan="1" 
class="confluenceTd"><p><code>urlRewrite</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>From <strong>Camel 2.11:</strong> 
<em><strong>Producer only!</strong> </em></p><p>Refers to a custom 
<strong><code>org.apache.camel.component.http.UrlRewrite</code></strong> which 
allows you to rewrite URLs when you bridge/proxy endpoints.</p><p>See more 
details at <a shape="rect" href="urlrewrite.html">UrlRewrite</a> and <a 
shape="rect" 
href="how-to-use-camel-as-a-http-proxy-between-a-client-and-server.html">How to 
use Camel as a HTTP proxy between a client and server</a>.</p></td></tr><tr><td 
colspan="1" rowspan="1" class="confluenceTd"><p><co
 de>eagerCheckContentAvailable</code></p></td><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>false</code></p></td><td colspan="1" rowspan="1" 
class="confluenceTd"><p>From <strong>Camel 2.15.3/2.16:</strong> 
<em><strong>Consumer only</strong>!</em></p><p>Whether to eager check whether 
the HTTP requests has content when 
<strong><code>content-length=0</code></strong> or is not present.</p><p>This 
option should be set to <strong><code>true</code></strong> for those HTTP 
clients that do not send streamed data.</p></td></tr><tr><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>copyHeaders</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p><code>true</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>From<strong> Camel 
2.16:</strong> if this option is true 
then&#160;<strong><code>IN</code></strong> exchange headers will be copied 
to&#160;<strong><code>OUT</code></strong> exchange headers according to copy 
strategy.</p><p>Setting this to <st
 rong><code>false</code></strong>, allows to only include the headers from the 
HTTP response (not propagating&#160;<strong><code>IN</code></strong> 
headers).</p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>okStatusCodeRange</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>200-299</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>From<strong> Camel 
2.16:</strong> the range of HTTP status codes for which a response is 
considered a success. The values are inclusive. The range must be defined as 
from-to with the dash included.</p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>ignoreResponseBody</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>From<strong> Camel 2.16:</strong> when 
<strong><code>true</code></strong> 
the&#160;<strong><code>HttpProducer</code></strong> will not read the response 
body nor
  cache the input stream.</p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>cookieHandler</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>From<strong> Camel: 2.19:</strong> 
configure a cookie handler to maintain a HTTP 
session</p></td></tr></tbody></table></div></div>
+</div></div></td></tr></tbody></table></div><h3 
id="BookInOnePage-HttpEndpointOptions"><code>HttpEndpoint</code> 
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>throwExceptionOnFailure</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 to disable throwing the 
<strong><code>HttpOperationFailedException</code></strong> in case of failed 
responses from the remote server. This allows you to get all responses 
regardless of the HTTP status code.</p></td></tr><tr><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>bridgeEndpoint</code></p></td><td c
 olspan="1" rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>If the option 
is&#160;<strong><code>true</code></strong>,&#160;<strong><code>HttpProducer</code></strong>
 will ignore the&#160;<strong><code>Exchange.HTTP_URI</code></strong> header, 
and use the endpoint's URI for request. You may also set 
<strong><code>throwExceptionOnFailure=false</code></strong> to ensure all 
responses are propagated back to the&#160; 
<strong><code>HttpProducer</code></strong>.</p><p>From<strong> Camel 
2.3:</strong> when <strong><code>true</code></strong> the 
<strong><code>HttpProducer</code></strong> 
and&#160;<strong><code>CamelServlet</code></strong> will skip 
<strong><code>gzip</code></strong> processing when 
<strong><code>content-encoding=gzip</code></strong>.</p></td></tr><tr><td 
colspan="1" rowspan="1" 
class="confluenceTd"><p><code>disableStreamCache</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>false</code
 ></p></td><td colspan="1" rowspan="1" 
 >class="confluenceTd"><p>When&#160;<strong><code>false</code></strong> 
 >the&#160;<strong><code>DefaultHttpBinding</code></strong> will copy the 
 >request input stream into a stream cache and put it into message body which 
 >allows it to be read more than 
 >once.</p><p>When&#160;<strong><code>true</code></strong> the 
 ><strong><code>DefaultHttpBinding</code></strong> will set the request input 
 >stream direct into the message body.</p><p>From<strong> Camel 2.17:</strong> 
 >this options is now also support by the producer to allow using the response 
 >stream directly instead of stream caching as by default.</p></td></tr><tr><td 
 >colspan="1" rowspan="1" class="confluenceTd"><p><span style="color: 
 >rgb(255,0,0);"><s><code>httpBindingRef</code></s></span></p></td><td 
 >colspan="1" rowspan="1" class="confluenceTd"><p><span style="color: 
 >rgb(255,0,0);"><s><code>null</code></s></span></p></td><td colspan="1" 
 >rowspan="1" class="confluenceTd"><p><span style="color: rgb(255,0
 ,0);"><s><strong>Deprecated and removed in Camel 2.17:</strong> Reference to a 
<code>org.apache.camel.component.http.HttpBinding</code> in the <a shape="rect" 
href="registry.html"><span style="color: rgb(255,0,0);">Registry</span></a>. 
Use the <code>httpBinding</code> option 
instead.</s></span></p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>httpBinding</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>From<strong> Camel 2.3:</strong> reference 
to a <strong><code>org.apache.camel.component.http.HttpBinding</code></strong> 
in the <a shape="rect" href="registry.html">Registry</a>.</p></td></tr><tr><td 
colspan="1" rowspan="1" class="confluenceTd"><p><span style="color: 
rgb(255,0,0);"><s><code>httpClientConfigurerRef</code></s></span></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p><span style="color: 
rgb(255,0,0);"><s><code>null</code></s></span></p></td
 ><td colspan="1" rowspan="1" class="confluenceTd"><p><span style="color: 
 >rgb(255,0,0);"><s><strong>Deprecated and removed in Camel 2.17:</strong> 
 >Reference to a 
 ><code>org.apache.camel.component.http.HttpClientConfigurer</code> in the <a 
 >shape="rect" href="registry.html"><span style="color: 
 >rgb(255,0,0);">Registry</span></a>. Use the <code>httpClientConfigurer</code> 
 >option instead.</s></span></p></td></tr><tr><td colspan="1" rowspan="1" 
 >class="confluenceTd"><p><code>httpClientConfigurer</code></p></td><td 
 >colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td 
 >colspan="1" rowspan="1" class="confluenceTd"><p>From <strong>Camel 
 >2.3:</strong> reference to a 
 ><strong><code>org.apache.camel.component.http.HttpClientConfigurer</code></strong>
 > in the <a shape="rect" 
 >href="registry.html">Registry</a>.</p></td></tr><tr><td colspan="1" 
 >rowspan="1" class="confluenceTd"><p><code>httpClient.XXX</code></p></td><td 
 >colspan="1" rowspan="1" class="confluenceTd"><p><code>null</co
 de></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Use this to 
option to configure the underlying <a shape="rect" class="external-link" 
href="http://hc.apache.org/httpclient-3.x/apidocs/org/apache/commons/httpclient/params/HttpClientParams.html";>HttpClientParams</a>.</p><p>Example:
 <strong><code>httpClient.soTimeout=5000</code></strong> will set the 
<strong><code>SO_TIMEOUT</code></strong> to 5 seconds.</p></td></tr><tr><td 
colspan="1" rowspan="1" 
class="confluenceTd"><p><code>clientConnectionManager</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>To use a custom 
<strong><code>org.apache.http.conn.ClientConnectionManager</code></strong>.</p></td></tr><tr><td
 colspan="1" rowspan="1" 
class="confluenceTd"><p><code>transferException</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>Fr
 om <strong>Camel 2.6:</strong> If enabled and an <a shape="rect" 
href="exchange.html">Exchange</a> failed processing on the consumer side, and 
if the caused <strong><code>Exception</code></strong> was send back serialized 
in the response as a 
<strong><code>application/x-java-serialized-object</code></strong> content type 
(for example using <a shape="rect" href="jetty.html">Jetty</a> or <a 
shape="rect" href="servlet.html">SERVLET</a> Camel components).</p><p>On the 
producer side the exception will be deserialized and thrown as is, instead of 
the <strong><code>HttpOperationFailedException</code></strong>. The caused 
exception will be serialized.</p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>headerFilterStrategy</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>From <strong>Camel 
2.11:</strong> reference to a instance of 
<strong><code>org.apache.camel.spi.HeaderFi
 lterStrategy</code></strong> in the <a shape="rect" 
href="registry.html">Registry</a>. It will be used to apply the 
custom&#160;<strong><code>headerFilterStrategy</code></strong> on the new 
create <strong><code>HttpEndpoint</code></strong>.</p></td></tr><tr><td 
colspan="1" rowspan="1" 
class="confluenceTd"><p><code>urlRewrite</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>From <strong>Camel 2.11:</strong> 
<em><strong>Producer only!</strong> </em></p><p>Refers to a custom 
<strong><code>org.apache.camel.component.http.UrlRewrite</code></strong> which 
allows you to rewrite URLs when you bridge/proxy endpoints.</p><p>See more 
details at <a shape="rect" href="urlrewrite.html">UrlRewrite</a> and <a 
shape="rect" 
href="how-to-use-camel-as-a-http-proxy-between-a-client-and-server.html">How to 
use Camel as a HTTP proxy between a client and server</a>.</p></td></tr><tr><td 
colspan="1" rowspan="1" c
 lass="confluenceTd"><p><code>eagerCheckContentAvailable</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>From <strong>Camel 
2.15.3/2.16:</strong> <em><strong>Consumer only</strong>!</em></p><p>Whether to 
eager check whether the HTTP requests has content when 
<strong><code>content-length=0</code></strong> or is not present.</p><p>This 
option should be set to <strong><code>true</code></strong> for those HTTP 
clients that do not send streamed data.</p></td></tr><tr><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>copyHeaders</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p><code>true</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>From<strong> Camel 
2.16:</strong> if this option is true 
then&#160;<strong><code>IN</code></strong> exchange headers will be copied 
to&#160;<strong><code>OUT</code></strong> exchange headers according to copy 
strategy.
 </p><p>Setting this to <strong><code>false</code></strong>, allows to only 
include the headers from the HTTP response (not 
propagating&#160;<strong><code>IN</code></strong> 
headers).</p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>okStatusCodeRange</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>200-299</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>From<strong> Camel 
2.16:</strong> the range of HTTP status codes for which a response is 
considered a success. The values are inclusive. The range must be in the form 
<strong><code>from-to</code></strong>, dash included.</p></td></tr><tr><td 
colspan="1" rowspan="1" 
class="confluenceTd"><p><code>ignoreResponseBody</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>From<strong> Camel 2.16:</strong> when 
<strong><code>true</code></strong> the&#160;<strong><code>HttpProducer</c
 ode></strong> will not read the response body nor cache the input 
stream.</p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>cookieHandler</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>From<strong> Camel: 2.19:</strong> 
configure a cookie handler to maintain a HTTP 
session</p></td></tr></tbody></table></div></div>
 
 
 <h3 id="BookInOnePage-AuthenticationandProxy">Authentication and 
Proxy</h3><p>The following authentication options can also be set on the 
<strong><code>HttpEndpoint</code></strong>:</p><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>authMethod</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>Authentication method, either 
as <strong><code>Basic</code></strong>, <strong><code>Digest</code></strong> or 
<strong><code>NTLM</code></strong>.</p></td></tr><tr><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>authMethodPriority</code></p></td><td 
colspan="1" rowspan
 ="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>Priority of authentication methods. Is a 
list separated with comma.</p><p>For example: 
<code><strong>Basic</strong>,<strong>Digest</strong></code> to exclude 
<strong><code>NTLM</code></strong>.</p></td></tr><tr><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>authUsername</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>Username for 
authentication.</p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>authPassword</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>Password for 
authentication.</p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>authDomain</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>null</code></
 p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Domain 
for&#160;<strong><code>NTLM</code></strong> 
authentication.</p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>authHost</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>Optional host 
for&#160;<strong><code>NTLM</code></strong> 
authentication.</p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>proxyHost</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>The proxy host name.</p></td></tr><tr><td 
colspan="1" rowspan="1" 
class="confluenceTd"><p><code>proxyPort</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>The proxy port number.</p></td></tr><tr><td 
colspan="1" rowspan="1" class="confluenceTd
 "><p><code>proxyAuthMethod</code></p></td><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>null</code></p></td><td colspan="1" rowspan="1" 
class="confluenceTd"><p>Authentication method for proxy, either as 
<strong><code>Basic</code></strong>, <strong><code>Digest</code></strong> or 
<strong><code>NTLM</code></strong>.</p></td></tr><tr><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>proxyAuthUsername</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td 
colspan="1" rowspan="1" class="confluenceTd"><p>Username for proxy 
authentication.</p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>proxyAuthPassword</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>Password for proxy 
authentication.</p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>proxyAuthDomain</code></p></td><td colspan="1" r
 owspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>Domain for 
proxy&#160;<strong><code>NTLM</code></strong> 
authentication.</p></td></tr><tr><td colspan="1" rowspan="1" 
class="confluenceTd"><p><code>proxyAuthHost</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1" 
rowspan="1" class="confluenceTd"><p>Optional host for 
proxy&#160;<strong><code>NTLM</code></strong> 
authentication.</p></td></tr></tbody></table></div></div>
@@ -20183,22 +20184,24 @@ HttpServletRequest response = exchange.g
       &lt;/properties&gt;
    &lt;/camelContext&gt;
 ]]></script>
-</div></div></td></tr></tbody></table></div><p>Options 
on&#160;<strong><code>Endpoint</code></strong> will override options on the 
context.</p><h3 
id="BookInOnePage-Configuringcharset">Configuring&#160;<code>charset</code></h3><p>If
 you are using <strong><code>POST</code></strong> to send data you can 
configure the <strong><code>charset</code></strong></p><div class="code panel 
pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="brush: java; gutter: false; theme: Default" 
type="syntaxhighlighter"><![CDATA[setProperty(Exchange.CHARSET_NAME, 
&quot;iso-8859-1&quot;);
+</div></div></td></tr></tbody></table></div><p>Options 
on&#160;<strong><code>Endpoint</code></strong> will override options on the 
context.</p><h3 
id="BookInOnePage-Configuringcharset">Configuring&#160;<code>charset</code></h3><p>If
 you are using&#160;<strong><code>POST</code></strong> to send data you can 
configure the <strong><code>charset</code></strong>:</p><div class="code panel 
pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+<script class="brush: java; gutter: false; theme: Default" 
type="syntaxhighlighter"><![CDATA[.setProperty(Exchange.CHARSET_NAME, 
&quot;iso-8859-1&quot;);
 ]]></script>
 </div></div><h3 id="BookInOnePage-SamplewithScheduledPoll">Sample with 
Scheduled Poll</h3><p>The sample polls the Google homepage every 10 seconds and 
write the page to the file <strong><code>message.html</code></strong>:</p><div 
class="code panel pdl" style="border-width: 1px;"><div class="codeContent 
panelContent pdl">
 <script class="brush: java; gutter: false; theme: Default" 
type="syntaxhighlighter"><![CDATA[from(&quot;timer://foo?fixedRate=true&amp;delay=0&amp;period=10000&quot;)
     .to(&quot;http://www.google.com&quot;)
-    .setHeader(FileComponent.HEADER_FILE_NAME, 
&quot;message.html&quot;).to(&quot;file:target/google&quot;);
+    .setHeader(FileComponent.HEADER_FILE_NAME, &quot;message.html&quot;)
+    .to(&quot;file:target/google&quot;);
 ]]></script>
 </div></div><h3 id="BookInOnePage-GettingtheResponseCode">Getting the Response 
Code</h3><p>You can get the HTTP response code from the HTTP component by 
getting the value from the&#160;<strong><code>OUT</code></strong> message 
header with <strong><code>Exchange.HTTP_RESPONSE_CODE</code></strong>:</p><div 
class="code panel pdl" style="border-width: 1px;"><div class="codeContent 
panelContent pdl">
-<script class="brush: java; gutter: false; theme: Default" 
type="syntaxhighlighter"><![CDATA[   Exchange exchange = 
template.send(&quot;http://www.google.com/search&quot;, new Processor() {
-            public void process(Exchange exchange) throws Exception {
-                exchange.getIn().setHeader(Exchange.HTTP_QUERY, 
constant(&quot;hl=en&amp;q=activemq&quot;));
-            }
-   });
-   Message out = exchange.getOut();
-   int responseCode = out.getHeader(Exchange.HTTP_RESPONSE_CODE, 
Integer.class);
+<script class="brush: java; gutter: false; theme: Default" 
type="syntaxhighlighter"><![CDATA[Exchange exchange = 
template.send(&quot;http://www.google.com/search&quot;, new Processor() {
+    public void process(Exchange exchange) throws Exception {
+      exchange.getIn().setHeader(Exchange.HTTP_QUERY, 
constant(&quot;hl=en&amp;q=activemq&quot;));
+    }
+});
+
+Message out = exchange.getOut();
+int responseCode = out.getHeader(Exchange.HTTP_RESPONSE_CODE, Integer.class);
 ]]></script>
 </div></div><h3 
id="BookInOnePage-UsingthrowExceptionOnFailure=falseToObtainAllServerResponses">Using
 <code>throwExceptionOnFailure=false</code> To Obtain All Server 
Responses</h3><p>In the route below we want to route a message that we <a 
shape="rect" href="content-enricher.html">enrich</a> with data returned from a 
remote HTTP call. As we want all responses from the remote server, we set the 
<strong><code>throwExceptionOnFailure=false</code></strong> so we get any 
response in the <strong><code>AggregationStrategy</code></strong>. As the code 
is based on a unit test that simulates a HTTP status code 404, there is some 
assertion code etc.</p><div class="code panel pdl" style="border-width: 
1px;"><div class="codeContent panelContent pdl">
 <script class="brush: java; gutter: false; theme: Default" 
type="syntaxhighlighter"><![CDATA[
@@ -20224,7 +20227,7 @@ from(&quot;jetty://http://localhost:8222
             }
         });
 ]]></script>
-</div></div><h3 id="BookInOnePage-DisablingCookies">Disabling 
Cookies</h3><p>To disable cookies you can set the HTTP Client to ignore cookies 
by adding this URI option:<br clear="none"> 
<strong><code>httpClient.cookiePolicy=ignoreCookies</code></strong></p><h3 
id="BookInOnePage-AdvancedUsage">Advanced Usage</h3><p>If you need more control 
over the HTTP producer you should use the 
<strong><code>HttpComponent</code></strong> where you can set various classes 
to give you custom behavior.</p><h4 
id="BookInOnePage-SettingMaxConnectionsPerHost">Setting&#160;<code>MaxConnectionsPerHost</code></h4><p>The
 <a shape="rect" href="http.html">HTTP</a> Component has a 
<strong><code>org.apache.commons.httpclient.HttpConnectionManager</code></strong>
 where you can configure various global configuration for the given component. 
By global, we mean that any endpoint the component creates has the same shared 
<strong><code>HttpConnectionManager</code></strong>. So, if we want to set a 
different value for
  the max connection per host, we need to define it on the HTTP component and 
<em>not</em> on the endpoint URI that we usually use. So here 
comes:</p><p>First, we define the <strong><code>http</code></strong> component 
in Spring XML. Yes, we use the same scheme name, 
<strong><code>http</code></strong>, because otherwise Camel will auto-discover 
and create the component with default settings. What we need is to overrule 
this so we can set our options. In the sample below we set the max connection 
to 5 instead of the default of 2.</p><div class="code panel pdl" 
style="border-width: 1px;"><div class="codeContent panelContent pdl">
+</div></div><h3 id="BookInOnePage-DisablingCookies">Disabling 
Cookies</h3><p>To disable cookies you can set the HTTP Client to ignore cookies 
by adding this URI option: 
<strong><code>httpClient.cookiePolicy=ignoreCookies</code></strong></p><h3 
id="BookInOnePage-AdvancedUsage">Advanced Usage</h3><p>If you need more control 
over the HTTP producer you should use the 
<strong><code>HttpComponent</code></strong> where you can set various classes 
to give you custom behavior.</p><h4 
id="BookInOnePage-SettingMaxConnectionsPerHost">Setting&#160;<code>MaxConnectionsPerHost</code></h4><p>The
 <a shape="rect" href="http.html">HTTP</a> Component has a 
<strong><code>org.apache.commons.httpclient.HttpConnectionManager</code></strong>
 where you can configure various global configuration for the given component. 
By global, we mean that any endpoint the component creates has the same shared 
<strong><code>HttpConnectionManager</code></strong>. So, if we want to set a 
different value for the max connecti
 on per host, we need to define it on the HTTP component and <em>not</em> on 
the endpoint URI that we usually use. So here comes:</p><p>First, we define the 
<strong><code>http</code></strong> component in Spring XML. Yes, we use the 
same scheme name, <strong><code>http</code></strong>, because otherwise Camel 
will auto-discover and create the component with default settings. What we need 
is to overrule this so we can set our options. In the sample below we set the 
max connection to 5 instead of the default of 2.</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[
 &lt;bean id=&quot;http&quot; 
class=&quot;org.apache.camel.component.http.HttpComponent&quot;&gt;
     &lt;property name=&quot;camelContext&quot; ref=&quot;camel&quot;/&gt;
@@ -20262,22 +20265,18 @@ kmp.setKeyPassword(&quot;keyPassword&quo
 SSLContextParameters scp = new SSLContextParameters();
 scp.setKeyManagers(kmp);
 
-ProtocolSocketFactory factory =
-    new SSLContextParametersSecureProtocolSocketFactory(scp);
+ProtocolSocketFactory factory = new 
SSLContextParametersSecureProtocolSocketFactory(scp);
 
-Protocol.registerProtocol(&quot;https&quot;,
-        new Protocol(
-        &quot;https&quot;,
-        factory,
-        443));
+Protocol.registerProtocol(&quot;https&quot;, new Protocol(&quot;https&quot;, 
factory, 443));
 
 from(&quot;direct:start&quot;)
-        
.to(&quot;https://mail.google.com/mail/&quot;).to(&quot;mock:results&quot;);
+    .to(&quot;https://mail.google.com/mail/&quot;)
+    .to(&quot;mock:results&quot;);
 ]]></script>
 </div></div><h5 
id="BookInOnePage-ConfiguringApacheHTTPClientDirectly">Configuring Apache HTTP 
Client Directly</h5><p>Basically&#160;<strong><code>camel-http</code></strong> 
component is built on the top of Apache HTTP client, and you can implement a 
custom 
<strong><code>org.apache.camel.component.http.HttpClientConfigurer</code></strong>
 to do some configuration on the HTTP client if you need full control of 
it.</p><p>However, if you <em>just</em> want to specify 
the&#160;<strong><code>keystore</code></strong> 
and&#160;<strong><code>truststore</code></strong> you can do this with Apache 
HTTP <strong><code>HttpClientConfigurer</code></strong>, for example:</p><div 
class="code panel pdl" style="border-width: 1px;"><div class="codeContent 
panelContent pdl">
-<script class="brush: java; gutter: false; theme: Default" 
type="syntaxhighlighter"><![CDATA[Protocol authhttps = new 
Protocol(&quot;https&quot;, new AuthSSLProtocolSocketFactory(
-  new URL(&quot;file:my.keystore&quot;), &quot;mypassword&quot;,
-  new URL(&quot;file:my.truststore&quot;), &quot;mypassword&quot;), 443);
+<script class="brush: java; gutter: false; theme: Default" 
type="syntaxhighlighter"><![CDATA[Protocol authhttps = new 
Protocol(&quot;https&quot;, 
+                                  new AuthSSLProtocolSocketFactory(new 
URL(&quot;file:my.keystore&quot;), &quot;mypassword&quot;, new 
URL(&quot;file:my.truststore&quot;), &quot;mypassword&quot;), 
+                                  443);
 
 Protocol.registerProtocol(&quot;https&quot;, authhttps);
 ]]></script>
@@ -20286,9 +20285,7 @@ Protocol.registerProtocol(&quot;https&qu
 httpComponent.setHttpClientConfigurer(new MyHttpClientConfigurer());
 ]]></script>
 </div></div><p>If you are doing this using the Spring DSL, you can specify 
your <strong><code>HttpClientConfigurer</code></strong> using the URI. For 
example:</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[&lt;bean id=&quot;myHttpClientConfigurer&quot;
- class=&quot;my.https.HttpClientConfigurer&quot;&gt;
-&lt;/bean&gt;
+<script class="brush: xml; gutter: false; theme: Default" 
type="syntaxhighlighter"><![CDATA[&lt;bean 
id=&quot;myHttpClientConfigurer&quot; 
class=&quot;my.https.HttpClientConfigurer&quot;/&gt;
 
 &lt;to 
uri=&quot;https://myhostname.com:443/myURL?httpClientConfigurerRef=myHttpClientConfigurer&quot;/&gt;
 ]]></script>

Modified: websites/production/camel/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.

Reply via email to