Author: buildbot
Date: Mon Mar 25 15:24:22 2013
New Revision: 855899
Log:
Production update by buildbot for camel
Modified:
websites/production/camel/content/book-architecture.html
websites/production/camel/content/components.html
websites/production/camel/content/configuring-camel.html
websites/production/camel/content/how-do-i-configure-endpoints.html
websites/production/camel/content/transport.html
websites/production/camel/content/uris.html
Modified: websites/production/camel/content/book-architecture.html
==============================================================================
--- websites/production/camel/content/book-architecture.html (original)
+++ websites/production/camel/content/book-architecture.html Mon Mar 25
15:24:22 2013
@@ -99,7 +99,9 @@
<h2><a shape="rect" name="BookArchitecture-URIs"></a>URIs</h2>
-<p>Camel makes extensive use of URIs to allow you to refer to endpoints which
are lazily created by a <a shape="rect" href="component.html"
title="Component">Component</a> if you refer to them within <a shape="rect"
href="routes.html" title="Routes">Routes</a></p>
+<p>Camel makes extensive use of URIs to allow you to refer to endpoints which
are lazily created by a <a shape="rect" href="component.html"
title="Component">Component</a> if you refer to them within <a shape="rect"
href="routes.html" title="Routes">Routes</a>.</p>
+
+<div class="panelMacro"><table class="tipMacro"><colgroup span="1"><col
span="1" width="24"><col span="1"></colgroup><tr><td colspan="1" rowspan="1"
valign="top"><img align="middle"
src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif";
width="16" height="16" alt="" border="0"></td><td colspan="1"
rowspan="1"><b>important</b><br clear="none">Make sure to read <a shape="rect"
href="how-do-i-configure-endpoints.html" title="How do I configure
endpoints">How do I configure endpoints</a> to learn more about configuring
endpoints. For example how to refer to beans in the <a shape="rect"
href="registry.html" title="Registry">Registry</a> or how to use raw values for
password options, and using <a shape="rect"
href="using-propertyplaceholder.html" title="Using
PropertyPlaceholder">property placeholders</a> etc.</td></tr></table></div>
<h3><a shape="rect" name="BookArchitecture-CurrentSupportedURIs"></a>Current
Supported URIs</h3>
Modified: websites/production/camel/content/components.html
==============================================================================
--- websites/production/camel/content/components.html (original)
+++ websites/production/camel/content/components.html Mon Mar 25 15:24:22 2013
@@ -79,6 +79,8 @@
<p>Camel includes the following <a shape="rect" href="component.html"
title="Component">Component</a> implementations via <a shape="rect"
href="uris.html" title="URIs">URIs</a>.</p>
+<div class="panelMacro"><table class="tipMacro"><colgroup span="1"><col
span="1" width="24"><col span="1"></colgroup><tr><td colspan="1" rowspan="1"
valign="top"><img align="middle"
src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif";
width="16" height="16" alt="" border="0"></td><td colspan="1"
rowspan="1"><b>important</b><br clear="none">Make sure to read <a shape="rect"
href="how-do-i-configure-endpoints.html" title="How do I configure
endpoints">How do I configure endpoints</a> to learn more about configuring
endpoints. For example how to refer to beans in the <a shape="rect"
href="registry.html" title="Registry">Registry</a> or how to use raw values for
password options, and using <a shape="rect"
href="using-propertyplaceholder.html" title="Using
PropertyPlaceholder">property placeholders</a> etc.</td></tr></table></div>
+
<div class="table-wrap">
<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"> Component / ArtifactId / URI </th><th colspan="1"
rowspan="1" class="confluenceTh"> Description </th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"> <a shape="rect" href="ahc.html"
title="AHC">AHC</a> / camel-ahc
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
@@ -803,7 +805,7 @@ zeromq:(tcp|ipc)://hostname:port
<h3><a shape="rect" name="Components-SeeAlso"></a>See Also</h3>
-<ul><li><a shape="rect" href="component.html"
title="Component">Component</a></li><li><a shape="rect" href="endpoint.html"
title="Endpoint">Endpoint</a></li><li><a shape="rect" href="uris.html"
title="URIs">URIs</a></li><li><a shape="rect" href="writing-components.html"
title="Writing Components">Writing Components</a></li><li><a shape="rect"
href="how-do-i-add-a-component.html" title="How do I add a component">How do I
add a component</a></li><li><a shape="rect"
href="how-do-i-configure-endpoints.html" title="How do I configure
endpoints">How do I configure endpoints</a></li></ul>
+<ul><li><a shape="rect" href="component.html"
title="Component">Component</a></li><li><a shape="rect" href="endpoint.html"
title="Endpoint">Endpoint</a></li><li><a shape="rect" href="uris.html"
title="URIs">URIs</a></li><li><a shape="rect" href="writing-components.html"
title="Writing Components">Writing Components</a></li><li><a shape="rect"
href="how-do-i-add-a-component.html" title="How do I add a component">How do I
add a component</a></li><li><a shape="rect"
href="how-do-i-configure-endpoints.html" title="How do I configure
endpoints">How do I configure endpoints</a></li><li><a shape="rect"
href="using-propertyplaceholder.html" title="Using PropertyPlaceholder">Using
PropertyPlaceholder</a></li></ul>
</div>
</td>
<td valign="top">
Modified: websites/production/camel/content/configuring-camel.html
==============================================================================
--- websites/production/camel/content/configuring-camel.html (original)
+++ websites/production/camel/content/configuring-camel.html Mon Mar 25
15:24:22 2013
@@ -139,9 +139,68 @@ file:<span class="code-comment">//inbox?
</div></div>
<p>Will lookup a bean with the id <b>mySpecialFileSorter</b> in the <a
shape="rect" href="registry.html" title="Registry">Registry</a>.</p>
+<h4><a shape="rect"
name="ConfiguringCamel-Configuringparametervaluesusingrawvalues%2Cegsuchaspasswords"></a>Configuring
parameter values using raw values, eg such as passwords</h4>
+<p><b>Available as of Camel 2.11</b></p>
+
+<p>When configuring endpoint options using URI syntax, then the values is by
default URI encoded. This can be a problem if you want to configure passwords
and just use the value <em>as is</em> without any encoding. For example you may
have a plus sign in the password, which would be decimal encoded by default.</p>
+
+<p>So from Camel 2.11 onwards we made this easier as you can denote a
parameter value to be <b>raw</b> using the following syntax
<tt>RAW(value)</tt>. eg the value starts with <tt>RAW(</tt> and then ends with
the parenthesis <tt>)</tt>. Here is a little example:</p>
+
+<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
+<pre class="code-java">
+.to(<span
class="code-quote">"ftp:[email protected]?password=RAW(se+re?t&23)&binary=<span
class="code-keyword">true</span>"</span>
+</pre>
+</div></div>
+
+<p>In the above example, we have declare the password value as raw, and the
actual password would be as typed, eg <tt>se+re?t&23</tt>.</p>
+
+<h4><a shape="rect"
name="ConfiguringCamel-Usingpropertyplaceholders"></a>Using property
placeholders</h4>
+
+<p>Camel have extensive support for using property placeholders, which you can
read more <a shape="rect" href="using-propertyplaceholder.html" title="Using
PropertyPlaceholder">about here</a>. For example in the ftp example above we
can externalize the password to a .properties file.</p>
+
+<p>For example configuring the property placeholder when using a <a
shape="rect" href="dsl.html" title="DSL">XML DSL</a>, where we declare the
location of the .properties file. Though we can also define this in Java code.
See the <a shape="rect" href="using-propertyplaceholder.html" title="Using
PropertyPlaceholder">documentation</a> for more details.</p>
+<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
+<pre class="code-xml">
+<span class="code-tag"><camelContext ...></span>
+ <span class="code-tag"><propertyPlaceholder id=<span
class="code-quote">"properties"</span> location=<span
class="code-quote">"myftp.properties"</span>/></span>
+ ...
+<span class="code-tag"></camelContext></span>
+</pre>
+</div></div>
+
+<p>And the Camel route now refers to the placeholder using the {{ key }}
notation:</p>
+<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
+<pre class="code-java">
+.to(<span
class="code-quote">"ftp:[email protected]?password={{myFtpPassword}}&binary=<span
class="code-keyword">true</span>"</span>
+</pre>
+</div></div>
+
+<p>And have a myftp.properties file with password. Notice we still define the
RAW(value) style to ensure the password is used <em>as is</em> </p>
+<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
+<pre class="code-java">
+myFtpPassword=RAW(se+re?t&23)
+</pre>
+</div></div>
+
+<p>We could still have used the RAW(value) in the Camel route instead:</p>
+<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
+<pre class="code-java">
+.to(<span
class="code-quote">"ftp:[email protected]?password=RAW({{myFtpPassword}})&binary=<span
class="code-keyword">true</span>"</span>
+</pre>
+</div></div>
+
+<p>And then we would need to remove the RAW from the properties file:</p>
+<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
+<pre class="code-java">
+myFtpPassword=se+re?t&23
+</pre>
+</div></div>
+
+<p>To understand more about property placeholders, read the <a shape="rect"
href="using-propertyplaceholder.html" title="Using
PropertyPlaceholder">documentation</a>.</p>
+
<h2><a shape="rect" name="ConfiguringCamel-SeeAlso"></a>See Also</h2>
-<ul><li><a shape="rect" href="how-do-i-add-a-component.html" title="How do I
add a component">How do I add a component</a></li><li><a shape="rect"
href="spring.html" title="Spring">Spring</a></li><li><a shape="rect"
href="uris.html" title="URIs">URIs</a></li></ul>
+<ul><li><a shape="rect" href="how-do-i-add-a-component.html" title="How do I
add a component">How do I add a component</a></li><li><a shape="rect"
href="spring.html" title="Spring">Spring</a></li><li><a shape="rect"
href="uris.html" title="URIs">URIs</a></li><li><a shape="rect"
href="using-propertyplaceholder.html" title="Using PropertyPlaceholder">Using
PropertyPlaceholder</a></li></ul>
<h2><a shape="rect"
name="ConfiguringCamel-HowdoIimportroutesfromotherXMLfiles"></a>How do I import
routes from other XML files</h2>
<p><b>Available as of Camel 2.3</b></p>
Modified: websites/production/camel/content/how-do-i-configure-endpoints.html
==============================================================================
--- websites/production/camel/content/how-do-i-configure-endpoints.html
(original)
+++ websites/production/camel/content/how-do-i-configure-endpoints.html Mon Mar
25 15:24:22 2013
@@ -139,9 +139,68 @@ file:<span class="code-comment">//inbox?
</div></div>
<p>Will lookup a bean with the id <b>mySpecialFileSorter</b> in the <a
shape="rect" href="registry.html" title="Registry">Registry</a>.</p>
+<h4><a shape="rect"
name="HowdoIconfigureendpoints-Configuringparametervaluesusingrawvalues%2Cegsuchaspasswords"></a>Configuring
parameter values using raw values, eg such as passwords</h4>
+<p><b>Available as of Camel 2.11</b></p>
+
+<p>When configuring endpoint options using URI syntax, then the values is by
default URI encoded. This can be a problem if you want to configure passwords
and just use the value <em>as is</em> without any encoding. For example you may
have a plus sign in the password, which would be decimal encoded by default.</p>
+
+<p>So from Camel 2.11 onwards we made this easier as you can denote a
parameter value to be <b>raw</b> using the following syntax
<tt>RAW(value)</tt>. eg the value starts with <tt>RAW(</tt> and then ends with
the parenthesis <tt>)</tt>. Here is a little example:</p>
+
+<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
+<pre class="code-java">
+.to(<span
class="code-quote">"ftp:[email protected]?password=RAW(se+re?t&23)&binary=<span
class="code-keyword">true</span>"</span>
+</pre>
+</div></div>
+
+<p>In the above example, we have declare the password value as raw, and the
actual password would be as typed, eg <tt>se+re?t&23</tt>.</p>
+
+<h4><a shape="rect"
name="HowdoIconfigureendpoints-Usingpropertyplaceholders"></a>Using property
placeholders</h4>
+
+<p>Camel have extensive support for using property placeholders, which you can
read more <a shape="rect" href="using-propertyplaceholder.html" title="Using
PropertyPlaceholder">about here</a>. For example in the ftp example above we
can externalize the password to a .properties file.</p>
+
+<p>For example configuring the property placeholder when using a <a
shape="rect" href="dsl.html" title="DSL">XML DSL</a>, where we declare the
location of the .properties file. Though we can also define this in Java code.
See the <a shape="rect" href="using-propertyplaceholder.html" title="Using
PropertyPlaceholder">documentation</a> for more details.</p>
+<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
+<pre class="code-xml">
+<span class="code-tag"><camelContext ...></span>
+ <span class="code-tag"><propertyPlaceholder id=<span
class="code-quote">"properties"</span> location=<span
class="code-quote">"myftp.properties"</span>/></span>
+ ...
+<span class="code-tag"></camelContext></span>
+</pre>
+</div></div>
+
+<p>And the Camel route now refers to the placeholder using the {{ key }}
notation:</p>
+<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
+<pre class="code-java">
+.to(<span
class="code-quote">"ftp:[email protected]?password={{myFtpPassword}}&binary=<span
class="code-keyword">true</span>"</span>
+</pre>
+</div></div>
+
+<p>And have a myftp.properties file with password. Notice we still define the
RAW(value) style to ensure the password is used <em>as is</em> </p>
+<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
+<pre class="code-java">
+myFtpPassword=RAW(se+re?t&23)
+</pre>
+</div></div>
+
+<p>We could still have used the RAW(value) in the Camel route instead:</p>
+<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
+<pre class="code-java">
+.to(<span
class="code-quote">"ftp:[email protected]?password=RAW({{myFtpPassword}})&binary=<span
class="code-keyword">true</span>"</span>
+</pre>
+</div></div>
+
+<p>And then we would need to remove the RAW from the properties file:</p>
+<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
+<pre class="code-java">
+myFtpPassword=se+re?t&23
+</pre>
+</div></div>
+
+<p>To understand more about property placeholders, read the <a shape="rect"
href="using-propertyplaceholder.html" title="Using
PropertyPlaceholder">documentation</a>.</p>
+
<h2><a shape="rect" name="HowdoIconfigureendpoints-SeeAlso"></a>See Also</h2>
-<ul><li><a shape="rect" href="how-do-i-add-a-component.html" title="How do I
add a component">How do I add a component</a></li><li><a shape="rect"
href="spring.html" title="Spring">Spring</a></li><li><a shape="rect"
href="uris.html" title="URIs">URIs</a></li></ul>
+<ul><li><a shape="rect" href="how-do-i-add-a-component.html" title="How do I
add a component">How do I add a component</a></li><li><a shape="rect"
href="spring.html" title="Spring">Spring</a></li><li><a shape="rect"
href="uris.html" title="URIs">URIs</a></li><li><a shape="rect"
href="using-propertyplaceholder.html" title="Using PropertyPlaceholder">Using
PropertyPlaceholder</a></li></ul>
</div>
</td>
<td valign="top">
Modified: websites/production/camel/content/transport.html
==============================================================================
--- websites/production/camel/content/transport.html (original)
+++ websites/production/camel/content/transport.html Mon Mar 25 15:24:22 2013
@@ -83,6 +83,8 @@
<p>Camel includes the following <a shape="rect" href="component.html"
title="Component">Component</a> implementations via <a shape="rect"
href="uris.html" title="URIs">URIs</a>.</p>
+<div class="panelMacro"><table class="tipMacro"><colgroup span="1"><col
span="1" width="24"><col span="1"></colgroup><tr><td colspan="1" rowspan="1"
valign="top"><img align="middle"
src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif";
width="16" height="16" alt="" border="0"></td><td colspan="1"
rowspan="1"><b>important</b><br clear="none">Make sure to read <a shape="rect"
href="how-do-i-configure-endpoints.html" title="How do I configure
endpoints">How do I configure endpoints</a> to learn more about configuring
endpoints. For example how to refer to beans in the <a shape="rect"
href="registry.html" title="Registry">Registry</a> or how to use raw values for
password options, and using <a shape="rect"
href="using-propertyplaceholder.html" title="Using
PropertyPlaceholder">property placeholders</a> etc.</td></tr></table></div>
+
<div class="table-wrap">
<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"> Component / ArtifactId / URI </th><th colspan="1"
rowspan="1" class="confluenceTh"> Description </th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"> <a shape="rect" href="ahc.html"
title="AHC">AHC</a> / camel-ahc
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
@@ -807,7 +809,7 @@ zeromq:(tcp|ipc)://hostname:port
<h3><a shape="rect" name="Transport-SeeAlso"></a>See Also</h3>
-<ul><li><a shape="rect" href="component.html"
title="Component">Component</a></li><li><a shape="rect" href="endpoint.html"
title="Endpoint">Endpoint</a></li><li><a shape="rect" href="uris.html"
title="URIs">URIs</a></li><li><a shape="rect" href="writing-components.html"
title="Writing Components">Writing Components</a></li><li><a shape="rect"
href="how-do-i-add-a-component.html" title="How do I add a component">How do I
add a component</a></li><li><a shape="rect"
href="how-do-i-configure-endpoints.html" title="How do I configure
endpoints">How do I configure endpoints</a></li></ul>
+<ul><li><a shape="rect" href="component.html"
title="Component">Component</a></li><li><a shape="rect" href="endpoint.html"
title="Endpoint">Endpoint</a></li><li><a shape="rect" href="uris.html"
title="URIs">URIs</a></li><li><a shape="rect" href="writing-components.html"
title="Writing Components">Writing Components</a></li><li><a shape="rect"
href="how-do-i-add-a-component.html" title="How do I add a component">How do I
add a component</a></li><li><a shape="rect"
href="how-do-i-configure-endpoints.html" title="How do I configure
endpoints">How do I configure endpoints</a></li><li><a shape="rect"
href="using-propertyplaceholder.html" title="Using PropertyPlaceholder">Using
PropertyPlaceholder</a></li></ul>
</div>
</td>
<td valign="top">
Modified: websites/production/camel/content/uris.html
==============================================================================
--- websites/production/camel/content/uris.html (original)
+++ websites/production/camel/content/uris.html Mon Mar 25 15:24:22 2013
@@ -77,7 +77,9 @@
<td valign="top" width="100%">
<div class="wiki-content maincontent"><h2><a shape="rect"
name="URIs-URIs"></a>URIs</h2>
-<p>Camel makes extensive use of URIs to allow you to refer to endpoints which
are lazily created by a <a shape="rect" href="component.html"
title="Component">Component</a> if you refer to them within <a shape="rect"
href="routes.html" title="Routes">Routes</a></p>
+<p>Camel makes extensive use of URIs to allow you to refer to endpoints which
are lazily created by a <a shape="rect" href="component.html"
title="Component">Component</a> if you refer to them within <a shape="rect"
href="routes.html" title="Routes">Routes</a>.</p>
+
+<div class="panelMacro"><table class="tipMacro"><colgroup span="1"><col
span="1" width="24"><col span="1"></colgroup><tr><td colspan="1" rowspan="1"
valign="top"><img align="middle"
src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif";
width="16" height="16" alt="" border="0"></td><td colspan="1"
rowspan="1"><b>important</b><br clear="none">Make sure to read <a shape="rect"
href="how-do-i-configure-endpoints.html" title="How do I configure
endpoints">How do I configure endpoints</a> to learn more about configuring
endpoints. For example how to refer to beans in the <a shape="rect"
href="registry.html" title="Registry">Registry</a> or how to use raw values for
password options, and using <a shape="rect"
href="using-propertyplaceholder.html" title="Using
PropertyPlaceholder">property placeholders</a> etc.</td></tr></table></div>
<h3><a shape="rect" name="URIs-CurrentSupportedURIs"></a>Current Supported
URIs</h3>
![https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif"](https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif"){kind=link}