Modified: websites/production/camel/content/book-languages-appendix.html
==============================================================================
--- websites/production/camel/content/book-languages-appendix.html (original)
+++ websites/production/camel/content/book-languages-appendix.html Thu Mar 19
07:21:50 2015
@@ -1066,7 +1066,7 @@ result = body * 2 + 1
<p>The <a shape="rect"
href="simple.html">Simple</a> language have been improved from Camel 2.9
onwards to use a better syntax parser, which can do index precise error
messages, so you know exactly what is wrong and where the problem is. For
example if you have made a typo in one of the operators, then previously the
parser would not be able to detect this, and cause the evaluation to be true.
There is a few changes in the syntax which are no longer backwards compatible.
When using <a shape="rect" href="simple.html">Simple</a> language as a <a
shape="rect" href="predicate.html">Predicate</a> then the literal text
<strong>must</strong> be enclosed in either single or double quotes. For
example: <code>"${body} == 'Camel'"</code>. Notice how we have single quotes
around the literal. The old style of using <code>"body"</code> and
<code>"header.foo"</code> to refer to the message body and header is
@deprecated, and its encouraged to always use ${ } tokens for
the built-in functions.<br clear="none"> The range operator now requires the
range to be in single quote as well as shown: <code>"${header.zip} between
'30000..39999'"</code>.</p>
</div>
</div>
-<p>To get the body of the in message: <code>"body"</code>, or
<code>"in.body"</code> or <code>"${body}"</code>.</p><p>A complex expression
must use ${ } placeholders, such as: <code>"Hello ${in.header.name} how are
you?"</code>.</p><p>You can have multiple functions in the same expression:
<code>"Hello ${in.header.name} this is ${in.header.me} speaking"</code>.<br
clear="none"> However you can <strong>not</strong> nest functions in Camel
2.8.x or older (i.e. having another ${ } placeholder in an existing, is not
allowed).<br clear="none"> From <strong>Camel 2.9</strong> onwards you can nest
functions.</p><h3 id="BookLanguagesAppendix-Variables.4">Variables</h3><div
class="confluenceTableSmall"><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p>Variable</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Type</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="
1" rowspan="1" class="confluenceTd"><p>camelId</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.10:</strong> the <a shape="rect"
href="camelcontext.html">CamelContext</a> name</p></td></tr><tr><td colspan="1"
rowspan="1"
class="confluenceTd"><p>camelContext.<strong>OGNL</strong></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel 2.11:</strong> the
CamelContext invoked using a Camel OGNL expression.</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>exchangeId</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel 2.3:</strong> the exchange
id</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>id</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>String</p></td><td colspan="
1" rowspan="1" class="confluenceTd"><p>the input message
id</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>body</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>the input body</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>in.body</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>the input body</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>body.<strong>OGNL</strong></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel 2.3:</strong> the input body
invoked using a Camel OGNL expression.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>in.body.<strong>OGNL</strong></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1"
rowspan
="1" class="confluenceTd"><p><strong>Camel 2.3:</strong> the input body
invoked using a Camel OGNL expression.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>bodyAs(<em>type</em>)</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Type</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel 2.3:</strong> Converts the
body to the given type determined by its classname. The converted body can be
null.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>mandatoryBodyAs(<em>type</em>)</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Type</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.5:</strong> Converts the body to the
given type determined by its classname, and expects the body to be not
null.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>out.body</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1" class="co
nfluenceTd"><p>the output body</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>header.foo</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>refer to the input foo header</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>header[foo]</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel 2.9.2:</strong> refer to the
input foo header</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>headers.foo</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>refer to the input foo header</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>headers[foo]</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel
2.9.2:</strong> refer to the input foo header</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>in.header.foo</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>refer to the input foo header</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>in.header[foo]</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel 2.9.2:</strong> refer to the
input foo header</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>in.headers.foo</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>refer to the input foo header</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>in.headers[foo]</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1"
rowspan="1" class="conf
luenceTd"><p><strong>Camel 2.9.2:</strong> refer to the input foo
header</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>header.foo[bar]</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.3:</strong> regard input foo header as
a map and perform lookup on the map with bar as key</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>in.header.foo[bar]</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel 2.3:</strong> regard input
foo header as a map and perform lookup on the map with bar as
key</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>in.headers.foo[bar]</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.3:</strong> regard input foo header as
a map and pe
rform lookup on the map with bar as key</p></td></tr><tr><td colspan="1"
rowspan="1"
class="confluenceTd"><p>header.foo.<strong>OGNL</strong></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel 2.3:</strong> refer to the
input foo header and invoke its value using a Camel OGNL
expression.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>in.header.foo.<strong>OGNL</strong></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel 2.3:</strong> refer to the
input foo header and invoke its value using a Camel OGNL
expression.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>in.headers.foo.<strong>OGNL</strong></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel 2.3:</strong> refer to the in
put foo header and invoke its value using a Camel OGNL
expression.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>out.header.foo</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>refer to the out header foo</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>out.header[foo]</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel 2.9.2:</strong> refer to the
out header foo</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>out.headers.foo</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>refer to the out header foo</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>out.headers[foo]</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1"
rows
pan="1" class="confluenceTd"><p><strong>Camel 2.9.2:</strong> refer to the out
header foo</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>headerAs(<em>key</em>,<em>type</em>)</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Type</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel 2.5:</strong> Converts the
header to the given type determined by its classname</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>headers</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Map</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.9:</strong> refer to the input
headers</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>in.headers</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Map</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.9:</strong> refer to the input
headers</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><
p>property.foo</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Deprecated:</strong> refer to the foo property
on the exchange</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd">exchangeProperty.foo</td><td colspan="1" rowspan="1"
class="confluenceTd">Object</td><td colspan="1" rowspan="1"
class="confluenceTd"><span><strong>Camel 2.15:</strong> refer to the foo
property on the exchange</span></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>property[foo]</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Deprecated:</strong> refer to the foo property
on the exchange</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><span>exchangeProperty[foo]</span></td><td colspan="1"
rowspan="1" class="confluenceTd">Object</td><td colspan="1" rowspan="1"
class="confluenceTd"><strong>C
amel 2.15:</strong><span> refer to the foo property on the
exchange</span></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>property.foo.<strong>OGNL</strong></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Deprecated:</strong> refer to the
foo property on the exchange and invoke its value using a Camel OGNL
expression.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><span>exchangeProperty.foo.</span><strong>OGNL</strong></td><td
colspan="1" rowspan="1" class="confluenceTd">Object</td><td colspan="1"
rowspan="1" class="confluenceTd"><strong>Camel 2.15:</strong><span> refer to
the foo property on the exchange and invoke its value using a Camel OGNL
expression.</span></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>sys.foo</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>r
efer to the system property</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>sysenv.foo</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.3:</strong> refer to the system
environment</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>exception</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.4:</strong> Refer to the exception
object on the exchange, is <strong>null</strong> if no exception set on
exchange. Will fallback and grab caught exceptions
(<code>Exchange.EXCEPTION_CAUGHT</code>) if the Exchange has
any.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>exception.<strong>OGNL</strong></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.4:</strong>
Refer to the exchange exception invoked using a Camel OGNL expression
object</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>exception.message</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Refer to the exception.message on the exchange, is
<strong>null</strong> if no exception set on exchange. Will fallback and grab
caught exceptions (<code>Exchange.EXCEPTION_CAUGHT</code>) if the Exchange has
any.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>exception.stacktrace</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.6.</strong> Refer to the
exception.stracktrace on the exchange, is <strong>null</strong> if no exception
set on exchange. Will fallback and grab caught exceptions
(<code>Exchange.EXCEPTION_CAUGHT</code>) if the Exchange has
any.</p></td></tr><tr><td colspan="1
" rowspan="1"
class="confluenceTd"><p>date:<em>command:pattern</em></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Date formatting using the
<code>java.text.SimpleDataFormat</code> patterns. Supported commands are:
<strong>now</strong> for current timestamp, <strong>in.header.xxx</strong> or
<strong>header.xxx</strong> to use the Date object in the IN header with the
key xxx. <strong>out.header.xxx</strong> to use the Date object in the OUT
header with the key xxx.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>bean:<em>bean expression</em></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Invoking a bean expression using the <a shape="rect"
href="bean.html">Bean</a> language. Specifying a method name you must use dot
as separator. We also support the ?method=methodname syntax that is used by the
<a shape="
rect" href="bean.html">Bean</a> component.</p></td></tr><tr><td colspan="1"
rowspan="1"
class="confluenceTd"><p>properties:<em>locations:key</em></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Deprecated (use properties-location
instead) Camel 2.3:</strong> Lookup a property with the given key. The
<code>locations</code> option is optional. See more at <a shape="rect"
href="using-propertyplaceholder.html">Using
PropertyPlaceholder</a>.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>properties-location:<em><a shape="rect"
class="external-link" href="http://locationskey";
rel="nofollow">locations:key</a></em></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.14.1:</strong> Lookup a property with
the given key. The <code>locations</code> option is optional. See more at <a
shape="rect" hr
ef="using-propertyplaceholder.html">Using
PropertyPlaceholder</a>.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd">properties:key:default</td><td colspan="1" rowspan="1"
class="confluenceTd">String</td><td colspan="1" rowspan="1"
class="confluenceTd"><strong>Camel 2.14.1</strong>: Lookup a property with the
given key. If the key does not exists or has no value, then an optional default
value can be specified.</td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>routeId</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.11:</strong> Returns the id of the
current route the <a shape="rect" href="exchange.html">Exchange</a> is being
routed.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>threadName</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.3:</str
ong> Returns the name of the current thread. Can be used for logging
purpose.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>ref:xxx</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.6:</strong> To lookup a bean from the
<a shape="rect" href="registry.html">Registry</a> with the given
id.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>type:name.field</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.11:</strong> To refer to a type or
field by its FQN name. To refer to a field you can append .FIELD_NAME. For
example you can refer to the constant field from Exchange as:
<code>org.apache.camel.Exchange.FILE_NAME</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>null</p></td
><td colspan="1" rowspan="1" class="confluenceTd"><p> </p></td><td
>colspan="1" rowspan="1" class="confluenceTd"><p><strong>Camel
>2.12.3:</strong> represents a
><strong>null</strong></p></td></tr></tbody></table></div></div><h3
>id="BookLanguagesAppendix-OGNLexpressionsupport">OGNL expression
>support</h3><p><strong>Available as of Camel 2.3</strong></p> <div
>class="aui-message hint shadowed information-macro">
+<p>To get the body of the in message: <code>"body"</code>, or
<code>"in.body"</code> or <code>"${body}"</code>.</p><p>A complex expression
must use ${ } placeholders, such as: <code>"Hello ${in.header.name} how are
you?"</code>.</p><p>You can have multiple functions in the same expression:
<code>"Hello ${in.header.name} this is ${in.header.me} speaking"</code>.<br
clear="none"> However you can <strong>not</strong> nest functions in Camel
2.8.x or older (i.e. having another ${ } placeholder in an existing, is not
allowed).<br clear="none"> From <strong>Camel 2.9</strong> onwards you can nest
functions.</p><h3 id="BookLanguagesAppendix-Variables.4">Variables</h3><div
class="confluenceTableSmall"><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p>Variable</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Type</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="
1" rowspan="1" class="confluenceTd"><p>camelId</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.10:</strong> the <a shape="rect"
href="camelcontext.html">CamelContext</a> name</p></td></tr><tr><td colspan="1"
rowspan="1"
class="confluenceTd"><p>camelContext.<strong>OGNL</strong></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel 2.11:</strong> the
CamelContext invoked using a Camel OGNL expression.</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd">exchange</td><td colspan="1"
rowspan="1" class="confluenceTd">Exchange</td><td colspan="1" rowspan="1"
class="confluenceTd"><strong>Camel 2.16:</strong> the <a shape="rect"
href="exchange.html">Exchange</a></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd">exchange.<strong>OGNL</strong></td><td colspan="1"
rowspan="1" class="conflu
enceTd">Object</td><td colspan="1" rowspan="1"
class="confluenceTd"><strong>Camel 2.16:</strong><span> the </span><a
shape="rect" href="exchange.html">Exchange</a><span> invoked using a Camel OGNL
expression.</span></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>exchangeId</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.3:</strong> the exchange
id</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>id</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>the input message id</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>body</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>the input body</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>in.body</p></td><td colspan="
1" rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>the input body</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>body.<strong>OGNL</strong></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.3:</strong> the input body invoked
using a Camel OGNL expression.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>in.body.<strong>OGNL</strong></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.3:</strong> the input body invoked
using a Camel OGNL expression.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>bodyAs(<em>type</em>)</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Type</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.3:</strong> Converts the body t
o the given type determined by its classname. The converted body can be
null.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>mandatoryBodyAs(<em>type</em>)</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Type</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.5:</strong> Converts the body to the
given type determined by its classname, and expects the body to be not
null.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>out.body</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>the output body</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>header.foo</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>refer to the input foo header</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>header[foo]</p></td><td
colspan="1" r
owspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.9.2:</strong> refer to the input foo
header</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>headers.foo</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>refer to the input foo header</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>headers[foo]</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel 2.9.2:</strong> refer to the
input foo header</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>in.header.foo</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>refer to the input foo header</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>in.header[foo]</p><
/td><td colspan="1" rowspan="1" class="confluenceTd"><p>Object</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><strong>Camel 2.9.2:</strong>
refer to the input foo header</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>in.headers.foo</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>refer to the input foo header</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>in.headers[foo]</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel 2.9.2:</strong> refer to the
input foo header</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>header.foo[bar]</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.3:</strong> regard input foo header as
a map and perform lookup on the ma
p with bar as key</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>in.header.foo[bar]</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.3:</strong> regard input foo header as
a map and perform lookup on the map with bar as key</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>in.headers.foo[bar]</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel 2.3:</strong> regard input
foo header as a map and perform lookup on the map with bar as
key</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>header.foo.<strong>OGNL</strong></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel 2.3:</strong> refer to the
input foo header and invoke its value using a Camel OGNL express
ion.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>in.header.foo.<strong>OGNL</strong></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel 2.3:</strong> refer to the
input foo header and invoke its value using a Camel OGNL
expression.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>in.headers.foo.<strong>OGNL</strong></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel 2.3:</strong> refer to the
input foo header and invoke its value using a Camel OGNL
expression.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>out.header.foo</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>refer to the out header foo</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p
>out.header[foo]</p></td><td colspan="1" rowspan="1"
>class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
>class="confluenceTd"><p><strong>Camel 2.9.2:</strong> refer to the out header
>foo</p></td></tr><tr><td colspan="1" rowspan="1"
>class="confluenceTd"><p>out.headers.foo</p></td><td colspan="1" rowspan="1"
>class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
>class="confluenceTd"><p>refer to the out header foo</p></td></tr><tr><td
>colspan="1" rowspan="1" class="confluenceTd"><p>out.headers[foo]</p></td><td
>colspan="1" rowspan="1" class="confluenceTd"><p>Object</p></td><td
>colspan="1" rowspan="1" class="confluenceTd"><p><strong>Camel 2.9.2:</strong>
>refer to the out header foo</p></td></tr><tr><td colspan="1" rowspan="1"
>class="confluenceTd"><p>headerAs(<em>key</em>,<em>type</em>)</p></td><td
>colspan="1" rowspan="1" class="confluenceTd"><p>Type</p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p><strong>Camel 2.5:</strong> Converts the
>header to th
e given type determined by its classname</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>headers</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Map</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.9:</strong> refer to the input
headers</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>in.headers</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Map</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.9:</strong> refer to the input
headers</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>property.foo</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Deprecated:</strong> refer to the foo property
on the exchange</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd">exchangeProperty.foo</td><td colspan="1" rowspan="1"
class="confluenceTd">Object</td><td colspa
n="1" rowspan="1" class="confluenceTd"><span><strong>Camel 2.15:</strong>
refer to the foo property on the exchange</span></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>property[foo]</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Deprecated:</strong> refer to the foo property
on the exchange</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><span>exchangeProperty[foo]</span></td><td colspan="1"
rowspan="1" class="confluenceTd">Object</td><td colspan="1" rowspan="1"
class="confluenceTd"><strong>Camel 2.15:</strong><span> refer to the foo
property on the exchange</span></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>property.foo.<strong>OGNL</strong></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Deprecated:</strong> refer to the
foo property on the exchange a
nd invoke its value using a Camel OGNL expression.</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><span>exchangeProperty.foo.</span><strong>OGNL</strong></td><td
colspan="1" rowspan="1" class="confluenceTd">Object</td><td colspan="1"
rowspan="1" class="confluenceTd"><strong>Camel 2.15:</strong><span> refer to
the foo property on the exchange and invoke its value using a Camel OGNL
expression.</span></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>sys.foo</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>refer to the system property</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>sysenv.foo</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel 2.3:</strong> refer to the
system environment</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>exception<
/p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Object</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><strong>Camel 2.4:</strong>
Refer to the exception object on the exchange, is <strong>null</strong> if no
exception set on exchange. Will fallback and grab caught exceptions
(<code>Exchange.EXCEPTION_CAUGHT</code>) if the Exchange has
any.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>exception.<strong>OGNL</strong></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.4:</strong> Refer to the exchange
exception invoked using a Camel OGNL expression object</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>exception.message</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Refer to the exception.message on the
exchange, is <strong>null</strong> if no exce
ption set on exchange. Will fallback and grab caught exceptions
(<code>Exchange.EXCEPTION_CAUGHT</code>) if the Exchange has
any.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>exception.stacktrace</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.6.</strong> Refer to the
exception.stracktrace on the exchange, is <strong>null</strong> if no exception
set on exchange. Will fallback and grab caught exceptions
(<code>Exchange.EXCEPTION_CAUGHT</code>) if the Exchange has
any.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>date:<em>command:pattern</em></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Date formatting using the
<code>java.text.SimpleDataFormat</code> patterns. Supported commands are:
<strong>now</strong> for current timestamp, <strong>in.header.xxx</strong> or <
strong>header.xxx</strong> to use the Date object in the IN header with the
key xxx. <strong>out.header.xxx</strong> to use the Date object in the OUT
header with the key xxx.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>bean:<em>bean expression</em></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Invoking a bean expression using the <a shape="rect"
href="bean.html">Bean</a> language. Specifying a method name you must use dot
as separator. We also support the ?method=methodname syntax that is used by the
<a shape="rect" href="bean.html">Bean</a> component.</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>properties:<em>locations:key</em></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Deprecated (use properties-location
instead) Camel 2.3:</strong> Lookup a property with the g
iven key. The <code>locations</code> option is optional. See more at <a
shape="rect" href="using-propertyplaceholder.html">Using
PropertyPlaceholder</a>.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>properties-location:<em><a shape="rect"
class="external-link" href="http://locationskey";
rel="nofollow">locations:key</a></em></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.14.1:</strong> Lookup a property with
the given key. The <code>locations</code> option is optional. See more at <a
shape="rect" href="using-propertyplaceholder.html">Using
PropertyPlaceholder</a>.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd">properties:key:default</td><td colspan="1" rowspan="1"
class="confluenceTd">String</td><td colspan="1" rowspan="1"
class="confluenceTd"><strong>Camel 2.14.1</strong>: Lookup a property with the
given key. If the key does not exists or has no
value, then an optional default value can be specified.</td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>routeId</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.11:</strong> Returns the id of the
current route the <a shape="rect" href="exchange.html">Exchange</a> is being
routed.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>threadName</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.3:</strong> Returns the name of the
current thread. Can be used for logging purpose.</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>ref:xxx</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.6:</strong> To lookup a bean from the
<a shape="rect" href="registry.html">R
egistry</a> with the given id.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>type:name.field</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Object</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.11:</strong> To refer to a type or
field by its FQN name. To refer to a field you can append .FIELD_NAME. For
example you can refer to the constant field from Exchange as:
<code>org.apache.camel.Exchange.FILE_NAME</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>null</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>null</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.12.3:</strong> represents a
<strong>null</strong></p></td></tr></tbody></table></div></div><h3
id="BookLanguagesAppendix-OGNLexpressionsupport">OGNL expression
support</h3><p><strong>Available as of Camel 2.3</strong></p> <div class="aui
-message hint shadowed information-macro">
<span class="aui-icon icon-hint">Icon</span>
<div class="message-content">
<p>Camel's OGNL support is for invoking methods
only. You cannot access fields.<br clear="none"> From <strong>Camel
2.11.1</strong> onwards we added special support for accessing the length field
of Java arrays.</p>
Modified: websites/production/camel/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/camel/content/camel-2160-release.html
==============================================================================
--- websites/production/camel/content/camel-2160-release.html (original)
+++ websites/production/camel/content/camel-2160-release.html Thu Mar 19
07:21:50 2015
@@ -84,7 +84,7 @@
<tbody>
<tr>
<td valign="top" width="100%">
-<div class="wiki-content maincontent"><h1
id="Camel2.16.0Release-Camel2.16.0release(currentlyinprogress)">Camel
2.16.0 release (currently in progress)</h1><div
style="padding-right:20px;float:left;margin-left:-20px;"><p><img
class="confluence-embedded-image confluence-external-resource"
src="http://camel.apache.org/download.data/camel-box-v1.0-150x200.png";
data-image-src="http://camel.apache.org/download.data/camel-box-v1.0-150x200.png";></p></div><div
style="min-height:200px"> </div><h2
id="Camel2.16.0Release-NewandNoteworthy">New and Noteworthy</h2><p>Welcome to
the x.y.z release which approx XXX issues resolved (new features, improvements
and bug fixes such as...)</p><p>Noteworthy improvements:</p><ul><li>The route
models (definition classes) preserve property placeholders, which allows round
trip editing, and also prevents showing potential sensitive
information</li><li>Added onPrepareFailure option to <a shape="rect"
href="dead-letter-channel.html">Dead Letter Cha
nnel</a> to allow a custom processor to prepare the Exchange before sending to
the dead letter queue.</li><li><a shape="rect" href="mongodb.html">MongoDB</a>
tailable consumers now allow setting the <code>readPreference</code>
option.</li><li>Using setFaultBody / setFaultHeader behaves similar to setBody
/ setHeader to preserve existing headers/attachments by setting on existing IN
or OUT message.</li><li>Java DSL using choice with end vs endChoice now
validates you use them as intended. Any misconfiguration now throws an
exception explaining the problem.</li><li><a shape="rect"
href="pojo-producing.html">POJO Producing</a> and <a shape="rect"
href="pojo-consuming.html">POJO Consuming</a> lifecycle is now in sync with <a
shape="rect" href="camelcontext.html">CamelContext</a> which ensures it
works as similar to Camel <a shape="rect" href="routes.html">Routes</a>
does. Also the created producer/consumer is stopped when <a shape="rect"
href="camelcontext.html">Came
lContext</a> is stopping to cleanup properly.</li><li><a shape="rect"
href="jms.html">JMS</a> component now allows configuring
concurrentConsumers/maxConcurrentConsumers separately between from(jms) vs
to(jms) using request/reply over JMS</li><li><span><a shape="rect"
class="external-link"
href="https://issues.apache.org/jira/browse/CAMEL-8506";>Added SEARCH</a>
operation to Elasticsearch component</span></li></ul><p>Fixed the following
issues:</p><ul><li>File language now properly supports file extensions having
double dots, such as .tar.gz</li><li>Fixed issue with doTry not stopping
routing if a fault message was set using setFaultBody within the
doTry.</li><li>Fixed <a shape="rect"
href="bean.html">Bean</a> language to support end parenthesis in quoted
string literals as part of method parameters, and not as end of method
signature. </li></ul><h3 id="Camel2.16.0Release-New">New <a shape="rect"
href="enterprise-integration-patterns.html">Enterprise Integrat
ion Patterns</a></h3><h3 id="Camel2.16.0Release-New.1">New <a shape="rect"
href="components.html">Components</a></h3><ul><li><a shape="rect"
href="paho.html">camel-paho</a> - For MQTT messaging using Eclipse Paho
client</li></ul><h3 id="Camel2.16.0Release-NewDSL">New DSL</h3><h3
id="Camel2.16.0Release-NewAnnotations">New Annotations</h3><h3
id="Camel2.16.0Release-NewDataFormats">New <a shape="rect"
href="data-format.html">Data Formats</a></h3><ul><li>camel-boon - For mapping
POJO to/from json<br clear="none"><br clear="none"></li></ul><h3
id="Camel2.16.0Release-New.2">New <a shape="rect"
href="languages.html">Languages</a></h3><h3 id="Camel2.16.0Release-New.3">New
<a shape="rect" href="examples.html">Examples</a></h3><h3
id="Camel2.16.0Release-New.4">New <a shape="rect"
href="tutorials.html">Tutorials</a></h3><h2
id="Camel2.16.0Release-APIbreaking">API breaking</h2><h2
id="Camel2.16.0Release-KnownIssues">Known Issues</h2><h2
id="Camel2.16.0Release-Dependencyupgrades">Dependency
upgrades</h2><ul><li>MongoDB Java Driver from 2.12.4 to 2.13.0.</li><li>Embed
MongoDB test harness from 1.46.4 to 1.47.0.</li></ul><h2
id="Camel2.16.0Release-Importantchangestoconsiderwhenupgrading">Important
changes to consider when upgrading</h2><ul><li>The dumpRoutesAsXml operation
now preserve property placeholder used in the route models. </li><li>Using
setFaultBody / setFaultHeader behaves similar to setBody / setHeader to
preserve existing headers/attachments by setting on existing IN or OUT
message.</li><li>If using concurrent consumer on <a shape="rect"
href="jms.html">JMS</a> endpoints for request/reply over JMS then you must
use the new replyToConcurrentConsumers, replyToMaxConcurrentConsumers options
to configure the values. </li></ul><h2
id="Camel2.16.0Release-GettingtheDistributions">Getting the
Distributions</h2><h3 id="Camel2.16.0Release-BinaryDistributions">Binary
Distributions</h3><div class="table-wrap"><table
class="confluenceTable"><tbody><t
r><th colspan="1" rowspan="1" class="confluenceTh"><p>Description</p></th><th
colspan="1" rowspan="1" class="confluenceTh"><p>Download Link</p></th><th
colspan="1" rowspan="1" class="confluenceTh"><p>PGP Signature file of
download</p></th></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>Windows Distribution</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link"
href="http://www.apache.org/dyn/closer.cgi/camel/apache-camel/2.16.0/apache-camel-2.16.0.zip";>apache-camel-2.16.0.zip</a></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect"
class="external-link"
href="http://www.apache.org/dist/camel/apache-camel/2.16.0/apache-camel-2.16.0.zip.asc";>apache-camel-2.16.0.zip.asc</a></p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>Unix/Linux/Cygwin
Distribution</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a
shape="rect" class="external-link" href="http://www.apache.org/dyn/closer.c
gi/camel/apache-camel/2.16.0/apache-camel-2.16.0.tar.gz">apache-camel-2.16.0.tar.gz</a></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect"
class="external-link"
href="http://www.apache.org/dist/camel/apache-camel/2.16.0/apache-camel-2.16.0.tar.gz.asc";>apache-camel-2.16.0.tar.gz.asc</a></p></td></tr></tbody></table></div>
<div class="aui-message hint shadowed information-macro">
+<div class="wiki-content maincontent"><h1
id="Camel2.16.0Release-Camel2.16.0release(currentlyinprogress)">Camel
2.16.0 release (currently in progress)</h1><div
style="padding-right:20px;float:left;margin-left:-20px;"><p><img
class="confluence-embedded-image confluence-external-resource"
src="http://camel.apache.org/download.data/camel-box-v1.0-150x200.png";
data-image-src="http://camel.apache.org/download.data/camel-box-v1.0-150x200.png";></p></div><div
style="min-height:200px"> </div><h2
id="Camel2.16.0Release-NewandNoteworthy">New and Noteworthy</h2><p>Welcome to
the x.y.z release which approx XXX issues resolved (new features, improvements
and bug fixes such as...)</p><p>Noteworthy improvements:</p><ul><li>The route
models (definition classes) preserve property placeholders, which allows round
trip editing, and also prevents showing potential sensitive
information</li><li>Added onPrepareFailure option to <a shape="rect"
href="dead-letter-channel.html">Dead Letter Cha
nnel</a> to allow a custom processor to prepare the Exchange before sending to
the dead letter queue.</li><li><a shape="rect" href="mongodb.html">MongoDB</a>
tailable consumers now allow setting the <code>readPreference</code>
option.</li><li>Using setFaultBody / setFaultHeader behaves similar to setBody
/ setHeader to preserve existing headers/attachments by setting on existing IN
or OUT message.</li><li>Java DSL using choice with end vs endChoice now
validates you use them as intended. Any misconfiguration now throws an
exception explaining the problem.</li><li><a shape="rect"
href="pojo-producing.html">POJO Producing</a> and <a shape="rect"
href="pojo-consuming.html">POJO Consuming</a> lifecycle is now in sync with <a
shape="rect" href="camelcontext.html">CamelContext</a> which ensures it
works as similar to Camel <a shape="rect" href="routes.html">Routes</a>
does. Also the created producer/consumer is stopped when <a shape="rect"
href="camelcontext.html">Came
lContext</a> is stopping to cleanup properly.</li><li><a shape="rect"
href="jms.html">JMS</a> component now allows configuring
concurrentConsumers/maxConcurrentConsumers separately between from(jms) vs
to(jms) using request/reply over JMS</li><li><span><a shape="rect"
class="external-link"
href="https://issues.apache.org/jira/browse/CAMEL-8506";>Added SEARCH</a>
operation to Elasticsearch component</span></li><li><span>The <a
shape="rect" href="properties.html">Properties</a> component (property
placeholder) now supports an encoding option to allow reading the .properties
files using a specific charset such as UTF-8. By default ISO-8859-1 is used
(latin1)</span></li></ul><p>Fixed the following issues:</p><ul><li>File
language now properly supports file extensions having double dots, such as
.tar.gz</li><li>Fixed issue with doTry not stopping routing if a fault message
was set using setFaultBody within the doTry.</li><li>Fixed <a shape="rect"
href="bean.html">Bean<
/a> language to support end parenthesis in quoted string literals as part
of method parameters, and not as end of method signature. </li></ul><h3
id="Camel2.16.0Release-New">New <a shape="rect"
href="enterprise-integration-patterns.html">Enterprise Integration
Patterns</a></h3><h3 id="Camel2.16.0Release-New.1">New <a shape="rect"
href="components.html">Components</a></h3><ul><li><a shape="rect"
href="paho.html">camel-paho</a> - For MQTT messaging using Eclipse Paho
client</li></ul><h3 id="Camel2.16.0Release-NewDSL">New DSL</h3><h3
id="Camel2.16.0Release-NewAnnotations">New Annotations</h3><h3
id="Camel2.16.0Release-NewDataFormats">New <a shape="rect"
href="data-format.html">Data Formats</a></h3><ul><li>camel-boon - For mapping
POJO to/from json<br clear="none"><br clear="none"></li></ul><h3
id="Camel2.16.0Release-New.2">New <a shape="rect"
href="languages.html">Languages</a></h3><h3 id="Camel2.16.0Release-New.3">New
<a shape="rect" href="examples.html">Examples</a></h
3><h3 id="Camel2.16.0Release-New.4">New <a shape="rect"
href="tutorials.html">Tutorials</a></h3><h2
id="Camel2.16.0Release-APIbreaking">API breaking</h2><h2
id="Camel2.16.0Release-KnownIssues">Known Issues</h2><h2
id="Camel2.16.0Release-Dependencyupgrades">Dependency
upgrades</h2><ul><li>MongoDB Java Driver from 2.12.4 to 2.13.0.</li><li>Embed
MongoDB test harness from 1.46.4 to 1.47.0.</li></ul><h2
id="Camel2.16.0Release-Importantchangestoconsiderwhenupgrading">Important
changes to consider when upgrading</h2><ul><li>The dumpRoutesAsXml operation
now preserve property placeholder used in the route models. </li><li>Using
setFaultBody / setFaultHeader behaves similar to setBody / setHeader to
preserve existing headers/attachments by setting on existing IN or OUT
message.</li><li>If using concurrent consumer on <a shape="rect"
href="jms.html">JMS</a> endpoints for request/reply over JMS then you must
use the new replyToConcurrentConsumers, replyToMaxConcurrentConsumers
options to configure the values. </li></ul><h2
id="Camel2.16.0Release-GettingtheDistributions">Getting the
Distributions</h2><h3 id="Camel2.16.0Release-BinaryDistributions">Binary
Distributions</h3><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Download Link</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>PGP Signature file of download</p></th></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>Windows
Distribution</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a
shape="rect" class="external-link"
href="http://www.apache.org/dyn/closer.cgi/camel/apache-camel/2.16.0/apache-camel-2.16.0.zip";>apache-camel-2.16.0.zip</a></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect"
class="external-link"
href="http://www.apache.org/dist/camel/apache-camel/2.16.0/apache-camel-2.16.0.zip.asc";>apa
che-camel-2.16.0.zip.asc</a></p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>Unix/Linux/Cygwin Distribution</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link"
href="http://www.apache.org/dyn/closer.cgi/camel/apache-camel/2.16.0/apache-camel-2.16.0.tar.gz";>apache-camel-2.16.0.tar.gz</a></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect"
class="external-link"
href="http://www.apache.org/dist/camel/apache-camel/2.16.0/apache-camel-2.16.0.tar.gz.asc";>apache-camel-2.16.0.tar.gz.asc</a></p></td></tr></tbody></table></div>
<div class="aui-message hint shadowed information-macro">
<p class="title">The above URLs use redirection</p>
<span class="aui-icon icon-hint">Icon</span>
<div class="message-content">
Modified: websites/production/camel/content/properties.html
==============================================================================
--- websites/production/camel/content/properties.html (original)
+++ websites/production/camel/content/properties.html Thu Mar 19 07:21:50 2015
@@ -86,35 +86,17 @@
<tbody>
<tr>
<td valign="top" width="100%">
-<div class="wiki-content maincontent"><h2
id="Properties-PropertiesComponent">Properties Component</h2>
-
-<p><strong>Available as of Camel 2.3</strong></p>
-
-<h3 id="Properties-URIformat">URI format</h3>
-
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[
-properties:key[?options]
+<div class="wiki-content maincontent"><h2
id="Properties-PropertiesComponent">Properties
Component</h2><p><strong>Available as of Camel 2.3</strong></p><h3
id="Properties-URIformat">URI format</h3><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
+<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[properties:key[?options]
]]></script>
-</div></div>
-<p>Where <strong>key</strong> is the key for the property to lookup</p>
-
-<h3 id="Properties-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> Type </p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p> Default </p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p> Description </p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>cache</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>boolean</code>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>true</code>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Whether or not to
cache loaded properties. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>locations</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>String</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>null</code> </p></td><td
colspan="1" rowspan="1" class="conf
luenceTd"><p> A list of locations to load properties. You can use comma to
separate multiple locations. This option will override any default locations
and <strong>only</strong> use the locations from this option.
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
<code>ignoreMissingLocation</code> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>boolean</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>false</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <strong>Camel 2.10:</strong>
Whether to silently ignore if a location cannot be located, such as a
properties file not found. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>propertyPrefix</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>String</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>null</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <s
trong>Camel 2.9</strong> Optional prefix prepended to property names before
resolution. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>propertySuffix</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>String</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>null</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <strong>Camel 2.9</strong>
Optional suffix appended to property names before resolution.
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
<code>fallbackToUnaugmentedProperty</code> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>boolean</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>true</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <strong>Camel 2.9</strong> If true, first
attempt resolution of property name augmented with <code>propertyPrefix</code>
and <code>propertySuffix</code> befor
e falling back the plain property name specified. If false, only the
augmented property name is searched. </p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>prefixToken</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>String</code>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> {{ <br
clear="none" class="atl-forced-newline"> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> <strong>Camel 2.9</strong> The token to indicate the
beginning of a property token. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>suffixToken</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>String</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> }} <br clear="none"
class="atl-forced-newline"> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> <strong>Camel 2.9</strong> The token to indicate the
end of a property token. </p></td></tr></tbody></tabl
e></div>
-</div>
-
- <div class="aui-message success shadowed information-macro">
+</div></div><p>Where <strong>key</strong> is the key for the property to
lookup</p><h3 id="Properties-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>Type</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Default</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>cache</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>boolean</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>true</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Whether or not to cache loaded
properties.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>locations</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>Stri
ng</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>null</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>A list of locations to load properties. You can use
comma to separate multiple locations. This option will override any default
locations and <strong>only</strong> use the locations from this
option.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><code>encoding</code></td><td colspan="1" rowspan="1"
class="confluenceTd"><code>String</code></td><td colspan="1" rowspan="1"
class="confluenceTd"><code>null</code></td><td colspan="1" rowspan="1"
class="confluenceTd"><strong>Camel 2.14.3/2.15.1:</strong> To use a specific
charset to load the properties, such as UTF-8. By default ISO-8859-1 (latin1)
is used.</td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>ignoreMissingLocation</code></p></td><td
colspan="1" rowspan="1"
class="confluenceTd"><p><code>boolean</code></p></td><td colspan="1"
rowspan="1" clas
s="confluenceTd"><p><code>false</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.10:</strong> Whether to silently ignore
if a location cannot be located, such as a properties file not
found.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>propertyPrefix</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>String</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel 2.9</strong> Optional prefix
prepended to property names before resolution.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>propertySuffix</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>String</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><strong>Camel 2.9</strong>
Optional suffix appended
to property names before resolution.</p></td></tr><tr><td colspan="1"
rowspan="1"
class="confluenceTd"><p><code>fallbackToUnaugmentedProperty</code></p></td><td
colspan="1" rowspan="1"
class="confluenceTd"><p><code>boolean</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>true</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel 2.9</strong> If true, first
attempt resolution of property name augmented with <code>propertyPrefix</code>
and <code>propertySuffix</code> before falling back the plain property name
specified. If false, only the augmented property name is
searched.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>prefixToken</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>String</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>{{</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.9</strong> The token to indicate the
beginning of a
property token.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>suffixToken</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>String</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>}}</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><strong>Camel 2.9</strong> The token to indicate the
end of a property token.</p></td></tr></tbody></table></div></div> <div
class="aui-message success shadowed information-macro">
<p class="title">Resolving property from Java code</p>
<span class="aui-icon icon-success">Icon</span>
<div class="message-content">
-
-<p>You can use the method <code>resolvePropertyPlaceholders</code> on the
<code>CamelContext</code> to resolve a property from any Java code.</p>
+ <p>You can use the method
<code>resolvePropertyPlaceholders</code> on the <code>CamelContext</code> to
resolve a property from any Java code.</p>
</div>
</div>
-
-
-<h2 id="Properties-UsingPropertyPlaceholder">Using
PropertyPlaceholder</h2><p><strong>Available as of Camel
2.3</strong></p><p>Camel now provides a new <code>PropertiesComponent</code> in
<strong>camel-core</strong> which allows you to use property placeholders when
defining Camel <a shape="rect" href="endpoint.html">Endpoint</a> URIs. <br
clear="none"> This works much like you would do if using Spring's
<code><property-placeholder></code> tag. However Spring have a limitation
which prevents 3rd party frameworks to leverage Spring property placeholders to
the fullest. See more at <a shape="rect"
href="how-do-i-use-spring-property-placeholder-with-camel-xml.html">How do I
use Spring Property Placeholder with Camel XML</a>.</p> <div
class="aui-message success shadowed information-macro">
+<p></p><h2 id="Properties-UsingPropertyPlaceholder">Using
PropertyPlaceholder</h2><p><strong>Available as of Camel
2.3</strong></p><p>Camel now provides a new <code>PropertiesComponent</code> in
<strong>camel-core</strong> which allows you to use property placeholders when
defining Camel <a shape="rect" href="endpoint.html">Endpoint</a> URIs. <br
clear="none"> This works much like you would do if using Spring's
<code><property-placeholder></code> tag. However Spring have a limitation
which prevents 3rd party frameworks to leverage Spring property placeholders to
the fullest. See more at <a shape="rect"
href="how-do-i-use-spring-property-placeholder-with-camel-xml.html">How do I
use Spring Property Placeholder with Camel XML</a>.</p> <div
class="aui-message success shadowed information-macro">
<p class="title">Bridging Spring and Camel property
placeholders</p>
<span class="aui-icon icon-success">Icon</span>
<div class="message-content">
@@ -718,11 +700,8 @@ export $FOO_SERVICE_PORT=8888]]></script
pc.addFunction(new MyBeerFunction());
]]></script>
-</div></div><p> </p><h2 id="Properties-SeeAlso">See Also</h2><ul
class="alternate"><li><a shape="rect" href="properties.html">Properties</a>
component</li></ul>
-
-<h3 id="Properties-SeeAlso.1">See Also</h3>
-<ul><li><a shape="rect" href="configuring-camel.html">Configuring
Camel</a></li><li><a shape="rect"
href="component.html">Component</a></li><li><a shape="rect"
href="endpoint.html">Endpoint</a></li><li><a shape="rect"
href="getting-started.html">Getting Started</a></li></ul>
-<ul class="alternate"><li><a shape="rect" href="jasypt.html">Jasypt</a> for
using encrypted values (eg passwords) in the properties</li></ul></div>
+</div></div><p> </p><h2 id="Properties-SeeAlso">See Also</h2><ul
class="alternate"><li><a shape="rect" href="properties.html">Properties</a>
component</li></ul> <h3 id="Properties-SeeAlso.1">See Also</h3>
+<ul><li><a shape="rect" href="configuring-camel.html">Configuring
Camel</a></li><li><a shape="rect"
href="component.html">Component</a></li><li><a shape="rect"
href="endpoint.html">Endpoint</a></li><li><a shape="rect"
href="getting-started.html">Getting Started</a></li></ul><ul
class="alternate"><li><a shape="rect" href="jasypt.html">Jasypt</a> for using
encrypted values (eg passwords) in the properties</li></ul></div>
</td>
<td valign="top">
<div class="navigation">
![http://camel.apache.org/download.data/camel-box-v1.0-150x200.png"](http://camel.apache.org/download.data/camel-box-v1.0-150x200.png"){kind=link}