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 2015/07/24 09:19:48 UTC
svn commit: r959389 - in /websites/production/camel/content:
cache/main.pageCache undertow.html
Author: buildbot
Date: Fri Jul 24 07:19:47 2015
New Revision: 959389
Log:
Production update by buildbot for camel
Modified:
websites/production/camel/content/cache/main.pageCache
websites/production/camel/content/undertow.html
Modified: websites/production/camel/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/camel/content/undertow.html
==============================================================================
--- websites/production/camel/content/undertow.html (original)
+++ websites/production/camel/content/undertow.html Fri Jul 24 07:19:47 2015
@@ -96,7 +96,7 @@
</div></div><h3 id="Undertow-URIformat">URI format</h3><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[undertow:http://hostname[:port][/resourceUri][?options]
]]></script>
-</div></div><p>You can append query options to the URI in the following format, <code>?option=value&option=value&...</code></p><h3 id="Undertow-Options">Options</h3><div class="confluenceTableSmall"><div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Name</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Default Value</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>httpMethodRestrict</p></td><td colspan="1" rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1" class="confluenceTd">Used to only allow consuming if the HttpMethod matches, such as GET/POST/PUT etc. Multiple methods can be specified separated by comma.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>matchOnUriPrefix</p></td><td colspan="1" rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1" cl
ass="confluenceTd">Whether or not the consumer should try to find a target consumer by matching the URI prefix if no exact match is found.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>headerFilterStrategy</p></td><td colspan="1" rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1" class="confluenceTd">To use a custom HeaderFilterStrategy to filter header to and from Camel message.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>sslContext</p></td><td colspan="1" rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1" class="confluenceTd">To configure security using SSLContextParameters</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">throwExceptionOnFailure</td><td colspan="1" rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1" class="confluenceTd">If the option is true, HttpProducer will ignore the Exchange.HTTP_URI header, and use the endpoint's URI for request. You may also se
t the option throwExceptionOnFailure to be false to let the producer send all the fault response back.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">transferException</td><td colspan="1" rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1" class="confluenceTd">Option to disable throwing the HttpOperationFailedException in case of failed responses from the remote server. This allows you to get all responses regardless of the HTTP status code.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">undertowHttpBinding</td><td colspan="1" rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1" class="confluenceTd">To use a custom UndertowHttpBinding to control the mapping between Camel message and undertow.</td></tr></tbody></table></div></div><h3 id="Undertow-MessageHeaders">Message Headers</h3><p>Camel uses the same message headers as the <a shape="rect" href="http.html">HTTP</a> component.<br clear="none"> From Camel 2.2, it a
lso uses <code>Exchange.HTTP_CHUNKED,CamelHttpChunked</code> header to turn on or turn off the chuched encoding on the camel-undertow consumer.</p><p>Camel also populates <strong>all</strong> request.parameter and request.headers. For example, given a client request with the URL, <code><a shape="rect" class="external-link" href="http://myserver/myserver?orderid=123" rel="nofollow">http://myserver/myserver?orderid=123</a></code>, the exchange will contain a header named <code>orderid</code> with the value 123.</p><h3 id="Undertow-ComponentOptions">Component Options</h3><p>The <code>UndertowComponent</code> provides the following options:</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>undertowHttpBinding</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>To use a custom UndertowHttpBinding to control the mapping between Camel message and undertow.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>httpConfiguration</p></td><td colspan="1" rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1" class="confluenceTd">To use the shared HttpConfiguration as base configuration.</td></tr></tbody></table></div></div><h3 id="Undertow-ProducerExample">Producer Example</h3><p>The following is a basic example of how to send an HTTP request to an existing HTTP endpoint.</p><p>in Java DSL</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+</div></div><p>You can append query options to the URI in the following format, <code>?option=value&option=value&...</code></p><h3 id="Undertow-Options">Options</h3><div class="confluenceTableSmall"><div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Name</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Default Value</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>httpMethodRestrict</p></td><td colspan="1" rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1" class="confluenceTd">Used to only allow consuming if the HttpMethod matches, such as GET/POST/PUT etc. Multiple methods can be specified separated by comma.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>matchOnUriPrefix</p></td><td colspan="1" rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1" cl
ass="confluenceTd">Whether or not the consumer should try to find a target consumer by matching the URI prefix if no exact match is found.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>headerFilterStrategy</p></td><td colspan="1" rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1" class="confluenceTd">To use a custom HeaderFilterStrategy to filter header to and from Camel message.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>sslContextParameters</p></td><td colspan="1" rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1" class="confluenceTd">To configure security using SSLContextParameters</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">throwExceptionOnFailure</td><td colspan="1" rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1" class="confluenceTd">If the option is true, HttpProducer will ignore the Exchange.HTTP_URI header, and use the endpoint's URI for request. You m
ay also set the option throwExceptionOnFailure to be false to let the producer send all the fault response back.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">transferException</td><td colspan="1" rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1" class="confluenceTd">Option to disable throwing the HttpOperationFailedException in case of failed responses from the remote server. This allows you to get all responses regardless of the HTTP status code.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">undertowHttpBinding</td><td colspan="1" rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1" class="confluenceTd">To use a custom UndertowHttpBinding to control the mapping between Camel message and undertow.</td></tr></tbody></table></div></div><h3 id="Undertow-MessageHeaders">Message Headers</h3><p>Camel uses the same message headers as the <a shape="rect" href="http.html">HTTP</a> component.<br clear="none"> From Camel
2.2, it also uses <code>Exchange.HTTP_CHUNKED,CamelHttpChunked</code> header to turn on or turn off the chuched encoding on the camel-undertow consumer.</p><p>Camel also populates <strong>all</strong> request.parameter and request.headers. For example, given a client request with the URL, <code><a shape="rect" class="external-link" href="http://myserver/myserver?orderid=123" rel="nofollow">http://myserver/myserver?orderid=123</a></code>, the exchange will contain a header named <code>orderid</code> with the value 123.</p><h3 id="Undertow-ComponentOptions">Component Options</h3><p>The <code>UndertowComponent</code> provides the following options:</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>undertowHttpBinding</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>To use a custom UndertowHttpBinding to control the mapping between Camel message and undertow.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>httpConfiguration</p></td><td colspan="1" rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1" class="confluenceTd">To use the shared HttpConfiguration as base configuration.</td></tr></tbody></table></div></div><h3 id="Undertow-ProducerExample">Producer Example</h3><p>The following is a basic example of how to send an HTTP request to an existing HTTP endpoint.</p><p>in Java DSL</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("direct:start").to("undertow:http://www.google.com");
]]></script>
</div></div><p>or in Spring XML</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">