camel-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r855899 - in /websites/production/camel/content: book-architecture.html components.html configuring-camel.html how-do-i-configure-endpoints.html transport.html uris.html
Date Mon, 25 Mar 2013 15:24:23 GMT
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:joe@myftpserver.com?password=RAW(se+re?t&amp;23)&amp;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&amp;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">&lt;camelContext ...&gt;</span>
+   <span class="code-tag">&lt;propertyPlaceholder id=<span class="code-quote">"properties"</span>
location=<span class="code-quote">"myftp.properties"</span>/&gt;</span>
+   ...
+<span class="code-tag">&lt;/camelContext&gt;</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:joe@myftpserver.com?password={{myFtpPassword}}&amp;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&amp;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:joe@myftpserver.com?password=RAW({{myFtpPassword}})&amp;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&amp;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:joe@myftpserver.com?password=RAW(se+re?t&amp;23)&amp;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&amp;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">&lt;camelContext ...&gt;</span>
+   <span class="code-tag">&lt;propertyPlaceholder id=<span class="code-quote">"properties"</span>
location=<span class="code-quote">"myftp.properties"</span>/&gt;</span>
+   ...
+<span class="code-tag">&lt;/camelContext&gt;</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:joe@myftpserver.com?password={{myFtpPassword}}&amp;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&amp;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:joe@myftpserver.com?password=RAW({{myFtpPassword}})&amp;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&amp;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>
 



Mime
View raw message