Author: buildbot
Date: Thu Jan 8 19:23:25 2015
New Revision: 935518
Log:
Production update by buildbot for camel
Modified:
websites/production/camel/content/book-component-appendix.html
websites/production/camel/content/book-in-one-page.html
websites/production/camel/content/cache/main.pageCache
websites/production/camel/content/camel-2150-release.html
websites/production/camel/content/hl7.html
Modified: websites/production/camel/content/book-component-appendix.html
==============================================================================
--- websites/production/camel/content/book-component-appendix.html (original)
+++ websites/production/camel/content/book-component-appendix.html Thu Jan 8
19:23:25 2015
@@ -1360,11 +1360,11 @@ template.send("direct:alias-verify&
</div>
</div>
<p>The <strong>cxf:</strong> component provides integration with <a
shape="rect" href="http://cxf.apache.org";>Apache CXF</a> for connecting to
JAX-WS services hosted in CXF.</p><p><style type="text/css">/*<![CDATA[*/
-div.rbtoc1420600948571 {padding: 0px;}
-div.rbtoc1420600948571 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1420600948571 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1420744767941 {padding: 0px;}
+div.rbtoc1420744767941 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1420744767941 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1420600948571">
+/*]]>*/</style></p><div class="toc-macro rbtoc1420744767941">
<ul class="toc-indentation"><li><a shape="rect" href="#CXF-CXFComponent">CXF
Component</a>
<ul class="toc-indentation"><li><a shape="rect" href="#CXF-URIformat">URI
format</a></li><li><a shape="rect" href="#CXF-Options">Options</a>
<ul class="toc-indentation"><li><a shape="rect"
href="#CXF-Thedescriptionsofthedataformats">The descriptions of the
dataformats</a>
@@ -4854,7 +4854,7 @@ hibernate:[entityClassName][?options]
<h3 id="BookComponentAppendix-SeeAlso.20">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="hibernate-example.html">Hibernate Example</a></li></ul>
-<h2 id="BookComponentAppendix-HL7Component">HL7 Component</h2><p>The
<strong>HL7</strong> component is used for working with the HL7 MLLP protocol
and <a shape="rect" class="external-link"
href="http://www.hl7.org/implement/standards/product_brief.cfm?product_id=185";
rel="nofollow">HL7 v2 messages</a> using the <a shape="rect"
class="external-link" href="http://hl7api.sourceforge.net"; rel="nofollow">HAPI
library</a>.</p><p>This component supports the following:</p><ul
class="alternate"><li>HL7 MLLP codec for <a shape="rect" class="external-link"
href="http://mina.apache.org/";>Mina</a></li><li><a shape="rect"
href="type-converter.html">Type Converter</a> from/to HAPI and
String</li><li>HL7 DataFormat using the HAPI library</li><li
class="confluence-link">Even more ease-of-use as it's integrated well with the
<a shape="rect" href="mina2.html">camel-mina2</a> component.</li></ul><p>Maven
users will need to add the following dependency to their <code>pom.xml</code>
for this component:</
p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeContent panelContent pdl">
+<h2 id="BookComponentAppendix-HL7Component">HL7 Component</h2><p>The
<strong>HL7</strong> component is used for working with the HL7 MLLP protocol
and <a shape="rect" class="external-link"
href="http://www.hl7.org/implement/standards/product_brief.cfm?product_id=185";
rel="nofollow">HL7 v2 messages</a> using the <a shape="rect"
class="external-link" href="http://hl7api.sourceforge.net"; rel="nofollow">HAPI
library</a>.</p><p>This component supports the following:</p><ul
class="alternate"><li>HL7 MLLP codec for <a shape="rect" class="external-link"
href="http://mina.apache.org/";>Mina</a></li><li>HL7 MLLP codec for <a
shape="rect" href="netty4.html">Netty4</a> from <strong>Camel
2.15</strong> onwards</li><li><a shape="rect" href="type-converter.html">Type
Converter</a> from/to HAPI and String</li><li>HL7 DataFormat using the HAPI
library</li><li class="confluence-link">Even more ease-of-use as it's
integrated well with the <a shape="rect" href="mina2.html">camel-mina2</a> comp
onent.</li></ul><p>Maven users will need to add the following dependency to
their <code>pom.xml</code> for this component:</p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: xml; gutter: false"
type="syntaxhighlighter"><![CDATA[<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-hl7</artifactId>
@@ -4862,7 +4862,7 @@ hibernate:[entityClassName][?options]
<!-- use the same version as your Camel core version -->
</dependency>
]]></script>
-</div></div><h3 id="BookComponentAppendix-HL7MLLPprotocol">HL7 MLLP
protocol</h3><p>HL7 is often used with the HL7 MLLP protocol, which is a text
based TCP socket based protocol. This component ships with a Mina Codec that
conforms to the MLLP protocol so you can easily expose an HL7 listener
accepting HL7 requests over the TCP transport layer. To expose a HL7 listener
service, the <a shape="rect" href="mina2.html">camel-mina2</a> component is
used with the <code>HL7MLLPCodec</code> as codec.</p><p>The HL7 MLLP codec has
the following options:</p><div class="confluenceTableSmall"><div
class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1"
rowspan="1" class="confluenceTh"><p>Name</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Default Value</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>startByte</code></p></td><td
colspan="1" rowspan="1" class="conflu
enceTd"><p><code>0x0b</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>The start byte spanning the HL7
payload.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>endByte1</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>0x1c</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The first end byte spanning the HL7
payload.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>endByte2</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>0x0d</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The 2nd end byte spanning the HL7
payload.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>charset</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>JVM Default</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The encoding (a <a shape="rect"
class="external-link" href="http://docs.oracle.com/javase/6/docs/ap
i/java/nio/charset/Charset.html" rel="nofollow">charset name</a>) to use for
the codec. If not provided, Camel will use the <a shape="rect"
class="external-link"
href="http://docs.oracle.com/javase/6/docs/api/java/nio/charset/Charset.html#defaultCharset()"
rel="nofollow">JVM default Charset</a>.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><code>produceString</code></td><td colspan="1"
rowspan="1" class="confluenceTd"><code>true</code></td><td colspan="1"
rowspan="1" class="confluenceTd"><strong>(Camel 2.14.1)</strong> If true, the
codec creates a string using the defined charset. If false, the codec sends a
plain byte array into the route, so that the HL7 Data Format can determine the
actual charset from the HL7 message content.</td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><code>convertLFtoCR</code></td><td colspan="1"
rowspan="1" class="confluenceTd"><code>false</code></td><td colspan="1"
rowspan="1" class="confluenceTd">Will convert <code>\n<
/code> to <code>\r</code> (<code>0x0d</code>, 13 decimal) as HL7 stipulates
<code>\r</code> as segment terminators. The HAPI library requires the use of
<code>\r</code>.</td></tr></tbody></table></div></div><h4
id="BookComponentAppendix-ExposinganHL7listener">Exposing an HL7
listener</h4><p>In the Spring XML file, we configure a mina2 endpoint to listen
for HL7 requests using TCP on port <code>8888</code>:</p><div class="code panel
pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+</div></div><h3 id="BookComponentAppendix-HL7MLLPprotocol">HL7 MLLP
protocol</h3><p>HL7 is often used with the HL7 MLLP protocol, which is a text
based TCP socket based protocol. This component ships with a Mina and Netty4
Codec that conforms to the MLLP protocol so you can easily expose an HL7
listener accepting HL7 requests over the TCP transport layer. To expose a HL7
listener service, the <a shape="rect" href="mina2.html">camel-mina2</a> or
<a shape="rect" href="netty4.html">camel-netty4</a> component is used with the
<code>HL7MLLPCodec</code> (mina2) or
<code>HL7MLLPConfig</code> (Netty4) as codec.</p><p>The HL7 MLLP
codec has the following options:</p><div class="confluenceTableSmall"><div
class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1"
rowspan="1" class="confluenceTh"><p>Name</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Default Value</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th>
</tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>startByte</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>0x0b</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The start byte spanning the HL7
payload.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>endByte1</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>0x1c</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The first end byte spanning the HL7
payload.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>endByte2</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>0x0d</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The 2nd end byte spanning the HL7
payload.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>charset</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>JVM Default</p></td><td colspan="1" ro
wspan="1" class="confluenceTd"><p>The encoding (a <a shape="rect"
class="external-link"
href="http://docs.oracle.com/javase/6/docs/api/java/nio/charset/Charset.html";
rel="nofollow">charset name</a>) to use for the codec. If not provided, Camel
will use the <a shape="rect" class="external-link"
href="http://docs.oracle.com/javase/6/docs/api/java/nio/charset/Charset.html#defaultCharset()"
rel="nofollow">JVM default Charset</a>.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><code>produceString</code></td><td colspan="1"
rowspan="1" class="confluenceTd"><code>true</code></td><td colspan="1"
rowspan="1" class="confluenceTd"><strong>(Camel 2.14.1)</strong> If true, the
codec creates a string using the defined charset. If false, the codec sends a
plain byte array into the route, so that the HL7 Data Format can determine the
actual charset from the HL7 message content.</td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><code>convertLFtoCR</code></td><td colspa
n="1" rowspan="1" class="confluenceTd"><code>false</code></td><td colspan="1"
rowspan="1" class="confluenceTd">Will convert <code>\n</code> to
<code>\r</code> (<code>0x0d</code>, 13 decimal) as HL7 stipulates
<code>\r</code> as segment terminators. The HAPI library requires the use of
<code>\r</code>.</td></tr></tbody></table></div></div><h4
id="BookComponentAppendix-ExposinganHL7listenerusingMina">Exposing an HL7
listener using Mina</h4><p>In the Spring XML file, we configure a mina2
endpoint to listen for HL7 requests using TCP on port
<code>8888</code>:</p><div class="code panel pdl" style="border-width:
1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: xml; gutter: false"
type="syntaxhighlighter"><![CDATA[ <endpoint id="hl7listener"
uri="mina2:tcp://localhost:8888?sync=true&amp;codec=#hl7codec"/>
]]></script>
</div></div><p><strong>sync=true</strong> indicates that this listener is
synchronous and therefore will return a HL7 response to the caller. The HL7
codec is setup with <strong>codec=#hl7codec</strong>. Note that
<code>hl7codec</code> is just a Spring bean ID, so it could be named
<code>mygreatcodecforhl7</code> or whatever. The codec is also set up in the
Spring XML file:</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeContent panelContent pdl">
Modified: websites/production/camel/content/book-in-one-page.html
==============================================================================
--- websites/production/camel/content/book-in-one-page.html (original)
+++ websites/production/camel/content/book-in-one-page.html Thu Jan 8 19:23:25
2015
@@ -4126,11 +4126,11 @@ While not actual tutorials you might fin
</div>
</div>
<h2 id="BookInOnePage-Preface">Preface</h2><p>This tutorial aims to guide the
reader through the stages of creating a project which uses Camel to facilitate
the routing of messages from a JMS queue to a <a shape="rect"
class="external-link" href="http://www.springramework.org";
rel="nofollow">Spring</a> service. The route works in a synchronous fashion
returning a response to the client.</p><p><style type="text/css">/*<![CDATA[*/
-div.rbtoc1420601063344 {padding: 0px;}
-div.rbtoc1420601063344 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1420601063344 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1420744826850 {padding: 0px;}
+div.rbtoc1420744826850 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1420744826850 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1420601063344">
+/*]]>*/</style></p><div class="toc-macro rbtoc1420744826850">
<ul class="toc-indentation"><li><a shape="rect"
href="#Tutorial-JmsRemoting-TutorialonSpringRemotingwithJMS">Tutorial on Spring
Remoting with JMS</a></li><li><a shape="rect"
href="#Tutorial-JmsRemoting-Preface">Preface</a></li><li><a shape="rect"
href="#Tutorial-JmsRemoting-Prerequisites">Prerequisites</a></li><li><a
shape="rect"
href="#Tutorial-JmsRemoting-Distribution">Distribution</a></li><li><a
shape="rect" href="#Tutorial-JmsRemoting-About">About</a></li><li><a
shape="rect" href="#Tutorial-JmsRemoting-CreatetheCamelProject">Create the
Camel Project</a>
<ul class="toc-indentation"><li><a shape="rect"
href="#Tutorial-JmsRemoting-UpdatethePOMwithDependencies">Update the POM with
Dependencies</a></li></ul>
</li><li><a shape="rect" href="#Tutorial-JmsRemoting-WritingtheServer">Writing
the Server</a>
@@ -6316,11 +6316,11 @@ So we completed the last piece in the pi
<style type="text/css">/*<![CDATA[*/
-div.rbtoc1420601067241 {padding: 0px;}
-div.rbtoc1420601067241 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1420601067241 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1420744831590 {padding: 0px;}
+div.rbtoc1420744831590 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1420744831590 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style><div class="toc-macro rbtoc1420601067241">
+/*]]>*/</style><div class="toc-macro rbtoc1420744831590">
<ul class="toc-indentation"><li><a shape="rect"
href="#Tutorial-AXIS-Camel-TutorialusingAxis1.4withApacheCamel">Tutorial using
Axis 1.4 with Apache Camel</a>
<ul class="toc-indentation"><li><a shape="rect"
href="#Tutorial-AXIS-Camel-Prerequisites">Prerequisites</a></li><li><a
shape="rect"
href="#Tutorial-AXIS-Camel-Distribution">Distribution</a></li><li><a
shape="rect"
href="#Tutorial-AXIS-Camel-Introduction">Introduction</a></li><li><a
shape="rect" href="#Tutorial-AXIS-Camel-SettinguptheprojecttorunAxis">Setting
up the project to run Axis</a>
<ul class="toc-indentation"><li><a shape="rect"
href="#Tutorial-AXIS-Camel-Maven2">Maven 2</a></li><li><a shape="rect"
href="#Tutorial-AXIS-Camel-wsdl">wsdl</a></li><li><a shape="rect"
href="#Tutorial-AXIS-Camel-ConfiguringAxis">Configuring Axis</a></li><li><a
shape="rect" href="#Tutorial-AXIS-Camel-RunningtheExample">Running the
Example</a></li></ul>
@@ -19174,11 +19174,11 @@ template.send("direct:alias-verify&
</div>
</div>
<p>The <strong>cxf:</strong> component provides integration with <a
shape="rect" href="http://cxf.apache.org";>Apache CXF</a> for connecting to
JAX-WS services hosted in CXF.</p><p><style type="text/css">/*<![CDATA[*/
-div.rbtoc1420601101678 {padding: 0px;}
-div.rbtoc1420601101678 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1420601101678 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1420744867174 {padding: 0px;}
+div.rbtoc1420744867174 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1420744867174 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1420601101678">
+/*]]>*/</style></p><div class="toc-macro rbtoc1420744867174">
<ul class="toc-indentation"><li><a shape="rect" href="#CXF-CXFComponent">CXF
Component</a>
<ul class="toc-indentation"><li><a shape="rect" href="#CXF-URIformat">URI
format</a></li><li><a shape="rect" href="#CXF-Options">Options</a>
<ul class="toc-indentation"><li><a shape="rect"
href="#CXF-Thedescriptionsofthedataformats">The descriptions of the
dataformats</a>
@@ -22668,7 +22668,7 @@ hibernate:[entityClassName][?options]
<h3 id="BookInOnePage-SeeAlso.40">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="hibernate-example.html">Hibernate Example</a></li></ul>
-<h2 id="BookInOnePage-HL7Component">HL7 Component</h2><p>The
<strong>HL7</strong> component is used for working with the HL7 MLLP protocol
and <a shape="rect" class="external-link"
href="http://www.hl7.org/implement/standards/product_brief.cfm?product_id=185";
rel="nofollow">HL7 v2 messages</a> using the <a shape="rect"
class="external-link" href="http://hl7api.sourceforge.net"; rel="nofollow">HAPI
library</a>.</p><p>This component supports the following:</p><ul
class="alternate"><li>HL7 MLLP codec for <a shape="rect" class="external-link"
href="http://mina.apache.org/";>Mina</a></li><li><a shape="rect"
href="type-converter.html">Type Converter</a> from/to HAPI and
String</li><li>HL7 DataFormat using the HAPI library</li><li
class="confluence-link">Even more ease-of-use as it's integrated well with the
<a shape="rect" href="mina2.html">camel-mina2</a> component.</li></ul><p>Maven
users will need to add the following dependency to their <code>pom.xml</code>
for this component:</p><div c
lass="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
+<h2 id="BookInOnePage-HL7Component">HL7 Component</h2><p>The
<strong>HL7</strong> component is used for working with the HL7 MLLP protocol
and <a shape="rect" class="external-link"
href="http://www.hl7.org/implement/standards/product_brief.cfm?product_id=185";
rel="nofollow">HL7 v2 messages</a> using the <a shape="rect"
class="external-link" href="http://hl7api.sourceforge.net"; rel="nofollow">HAPI
library</a>.</p><p>This component supports the following:</p><ul
class="alternate"><li>HL7 MLLP codec for <a shape="rect" class="external-link"
href="http://mina.apache.org/";>Mina</a></li><li>HL7 MLLP codec for <a
shape="rect" href="netty4.html">Netty4</a> from <strong>Camel
2.15</strong> onwards</li><li><a shape="rect" href="type-converter.html">Type
Converter</a> from/to HAPI and String</li><li>HL7 DataFormat using the HAPI
library</li><li class="confluence-link">Even more ease-of-use as it's
integrated well with the <a shape="rect" href="mina2.html">camel-mina2</a>
component.</
li></ul><p>Maven users will need to add the following dependency to their
<code>pom.xml</code> for this component:</p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: xml; gutter: false"
type="syntaxhighlighter"><![CDATA[<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-hl7</artifactId>
@@ -22676,7 +22676,7 @@ hibernate:[entityClassName][?options]
<!-- use the same version as your Camel core version -->
</dependency>
]]></script>
-</div></div><h3 id="BookInOnePage-HL7MLLPprotocol">HL7 MLLP
protocol</h3><p>HL7 is often used with the HL7 MLLP protocol, which is a text
based TCP socket based protocol. This component ships with a Mina Codec that
conforms to the MLLP protocol so you can easily expose an HL7 listener
accepting HL7 requests over the TCP transport layer. To expose a HL7 listener
service, the <a shape="rect" href="mina2.html">camel-mina2</a> component is
used with the <code>HL7MLLPCodec</code> as codec.</p><p>The HL7 MLLP codec has
the following options:</p><div class="confluenceTableSmall"><div
class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1"
rowspan="1" class="confluenceTh"><p>Name</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Default Value</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>startByte</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd">
<p><code>0x0b</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>The start byte spanning the HL7
payload.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>endByte1</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>0x1c</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The first end byte spanning the HL7
payload.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>endByte2</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>0x0d</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The 2nd end byte spanning the HL7
payload.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>charset</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>JVM Default</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The encoding (a <a shape="rect"
class="external-link" href="http://docs.oracle.com/javase/6/docs/api/java/n
io/charset/Charset.html" rel="nofollow">charset name</a>) to use for the
codec. If not provided, Camel will use the <a shape="rect"
class="external-link"
href="http://docs.oracle.com/javase/6/docs/api/java/nio/charset/Charset.html#defaultCharset()"
rel="nofollow">JVM default Charset</a>.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><code>produceString</code></td><td colspan="1"
rowspan="1" class="confluenceTd"><code>true</code></td><td colspan="1"
rowspan="1" class="confluenceTd"><strong>(Camel 2.14.1)</strong> If true, the
codec creates a string using the defined charset. If false, the codec sends a
plain byte array into the route, so that the HL7 Data Format can determine the
actual charset from the HL7 message content.</td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><code>convertLFtoCR</code></td><td colspan="1"
rowspan="1" class="confluenceTd"><code>false</code></td><td colspan="1"
rowspan="1" class="confluenceTd">Will convert <code>\n</code> t
o <code>\r</code> (<code>0x0d</code>, 13 decimal) as HL7 stipulates
<code>\r</code> as segment terminators. The HAPI library requires the use of
<code>\r</code>.</td></tr></tbody></table></div></div><h4
id="BookInOnePage-ExposinganHL7listener">Exposing an HL7 listener</h4><p>In the
Spring XML file, we configure a mina2 endpoint to listen for HL7 requests using
TCP on port <code>8888</code>:</p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
+</div></div><h3 id="BookInOnePage-HL7MLLPprotocol">HL7 MLLP
protocol</h3><p>HL7 is often used with the HL7 MLLP protocol, which is a text
based TCP socket based protocol. This component ships with a Mina and Netty4
Codec that conforms to the MLLP protocol so you can easily expose an HL7
listener accepting HL7 requests over the TCP transport layer. To expose a HL7
listener service, the <a shape="rect" href="mina2.html">camel-mina2</a> or
<a shape="rect" href="netty4.html">camel-netty4</a> component is used with the
<code>HL7MLLPCodec</code> (mina2) or
<code>HL7MLLPConfig</code> (Netty4) as codec.</p><p>The HL7 MLLP
codec has the following options:</p><div class="confluenceTableSmall"><div
class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1"
rowspan="1" class="confluenceTh"><p>Name</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Default Value</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th></tr><tr
><td colspan="1" rowspan="1"
>class="confluenceTd"><p><code>startByte</code></p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p><code>0x0b</code></p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p>The start byte spanning the HL7
>payload.</p></td></tr><tr><td colspan="1" rowspan="1"
>class="confluenceTd"><p><code>endByte1</code></p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p><code>0x1c</code></p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p>The first end byte spanning the HL7
>payload.</p></td></tr><tr><td colspan="1" rowspan="1"
>class="confluenceTd"><p><code>endByte2</code></p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p><code>0x0d</code></p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p>The 2nd end byte spanning the HL7
>payload.</p></td></tr><tr><td colspan="1" rowspan="1"
>class="confluenceTd"><p><code>charset</code></p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p>JVM Default</p></td><td colspan="1"
>rowspan="1
" class="confluenceTd"><p>The encoding (a <a shape="rect"
class="external-link"
href="http://docs.oracle.com/javase/6/docs/api/java/nio/charset/Charset.html";
rel="nofollow">charset name</a>) to use for the codec. If not provided, Camel
will use the <a shape="rect" class="external-link"
href="http://docs.oracle.com/javase/6/docs/api/java/nio/charset/Charset.html#defaultCharset()"
rel="nofollow">JVM default Charset</a>.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><code>produceString</code></td><td colspan="1"
rowspan="1" class="confluenceTd"><code>true</code></td><td colspan="1"
rowspan="1" class="confluenceTd"><strong>(Camel 2.14.1)</strong> If true, the
codec creates a string using the defined charset. If false, the codec sends a
plain byte array into the route, so that the HL7 Data Format can determine the
actual charset from the HL7 message content.</td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><code>convertLFtoCR</code></td><td colspan="1"
ro
wspan="1" class="confluenceTd"><code>false</code></td><td colspan="1"
rowspan="1" class="confluenceTd">Will convert <code>\n</code> to
<code>\r</code> (<code>0x0d</code>, 13 decimal) as HL7 stipulates
<code>\r</code> as segment terminators. The HAPI library requires the use of
<code>\r</code>.</td></tr></tbody></table></div></div><h4
id="BookInOnePage-ExposinganHL7listenerusingMina">Exposing an HL7 listener
using Mina</h4><p>In the Spring XML file, we configure a mina2 endpoint to
listen for HL7 requests using TCP on port <code>8888</code>:</p><div
class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
<script class="theme: Default; brush: xml; gutter: false"
type="syntaxhighlighter"><![CDATA[ <endpoint id="hl7listener"
uri="mina2:tcp://localhost:8888?sync=true&amp;codec=#hl7codec"/>
]]></script>
</div></div><p><strong>sync=true</strong> indicates that this listener is
synchronous and therefore will return a HL7 response to the caller. The HL7
codec is setup with <strong>codec=#hl7codec</strong>. Note that
<code>hl7codec</code> is just a Spring bean ID, so it could be named
<code>mygreatcodecforhl7</code> or whatever. The codec is also set up in the
Spring XML file:</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeContent panelContent pdl">
Modified: websites/production/camel/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/camel/content/camel-2150-release.html
==============================================================================
--- websites/production/camel/content/camel-2150-release.html (original)
+++ websites/production/camel/content/camel-2150-release.html Thu Jan 8
19:23:25 2015
@@ -84,7 +84,7 @@
<tbody>
<tr>
<td valign="top" width="100%">
-<div class="wiki-content maincontent"><h1
id="Camel2.15.0Release-Camel2.15.0release(currentlyinprogress)">Camel 2.15.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.15.0Release-NewandNoteworthy">New and Noteworthy</h2><p>Welcome to
the 2.15.0 release which approx XXX issues resolved (new features, improvements
and bug fixes such as...)</p><ul><li><span>Component documentation now included
in the built component JARs. And Java API and JMX API to access that
documentation. And APIs to explain an endpoint uri and what all those
configured options mean. </span></li><li><span>Component can now
have associated label(s) which are use
d for grouping components into: core, database, messaging, http, rest,
etc.</span></li><li><span>Provide Configurer for user to configure the CXF
conduit and CXF destination from Java code</span></li><li><span><span>Added a
<code>DelegateEndpoint</code> interface into Camel
API</span></span></li><li>Support to setup the SslContextParameters in the <a
shape="rect" href="restlet.html">camel-restlet</a> component</li><li>Java DSL -
Should support nested choice in doTry .. doCatch</li><li><a shape="rect"
href="mongodb.html">MongoDb</a> component now <a shape="rect"
class="external-link"
href="https://issues.apache.org/jira/browse/CAMEL-7996";>stores OIDs</a> of
the inserted records in the message header</li><li><a shape="rect"
href="recipient-list.html">Recipient List</a> now supports specifying
custom <a shape="rect" href="exchange-pattern.html">Exchange Pattern</a>
in the endpoint ur's</li><li><a shape="rect" href="type-converter.html">Type
Converter</a> to enum's is now
case insensitive, so you can convert safely level=info to an enum with name
Level.INFO etc.</li><li><a shape="rect" href="xslt.html">XSLT</a> and <a
shape="rect"
href="https://cwiki.apache.org/confluence/display/SM/Validation";>Validation</a>
components now provides all their endpoint configurations in the endpoint, and
not only in the component, making these components like any other
components.</li><li>Made the <a shape="rect" href="karaf.html">Camel Karaf
Commands</a> reusable by moving common code into
a <code>camel-commands-core</code> module that SPI can extend and plugin
Camel commands for other environments.</li><li>Further hardening of the <a
shape="rect" href="sjms.html">SJMS</a> component.</li><li><a shape="rect"
href="rest-dsl.html">Rest DSL</a> with embedded routes now supports <a
shape="rect" href="exception-clause.html">onException</a>, <a shape="rect"
href="intercept.html">intercept</a> etc in use for those embedded routes, just
like any regular r
outes. </li><li><a shape="rect" href="rest-dsl.html">Rest DSL</a> now by
default uses custom error message as-is without attempting to binding output
(requires a HTTP error code of 300+ is set as a header)</li><li>Camel <a
shape="rect" href="using-propertyplaceholder.html">Using
PropertyPlaceholder</a> now supports specifying a default value together with
the key to lookup.</li><li>Camel <a shape="rect"
href="using-propertyplaceholder.html">Using PropertyPlaceholder</a> now
supports not having to define a PropertiesComponent if all the placeholder keys
has default values which are to be used (less configuration needed in those
situations).</li><li>Camel <a shape="rect"
href="using-propertyplaceholder.html">Using PropertyPlaceholder</a> now
supports 3rd party functions to lookup the property values, this allow end
users to implement their own logic - we provide 3 out of the box functions to
lookup values from OS environment variable, JVM system properties, or the
service name idiom.</li><li><a shape="rect" href="rabbitmq.html">RabbitMQ</a>
now pools Channels for the producer to avoid sharing same Channel among
concurrent producers which are not recommended by RabbitMQ
client.</li><li>Camel commands is now reusable outside Apache Karaf as a base
by the <code>commands-core</code> module.</li><li>Camel commands using <a
shape="rect" class="external-link" href="http://www.jolokia.org/";
rel="nofollow">Jolokia</a> for remote communication by
the <code>commands-jolokia</code> module.</li><li>More minor processors
such as setHeader, removeHeader, removeHeaders and ditto for properties is now
also enlisted in JMX under processors.</li><li>Optimized usage of type
conversion during routing reducing the number of attempts
needed.</li><li>Asynchronous routing engine that are forced to block threads
now exposes this using a <a shape="rect"
href="asyncprocessorawaitmanager.html">manager</a> that offers runtime insight
using JMX. And as well attem
pts to free blocked threads during graceful shutdown, to avoid any threads
hanging in the JVM.</li><li><a shape="rect" href="swagger.html">Swagger</a> now
supports any kind of runtime environment, as only JMX being enabled is
required.</li><li><a shape="rect" href="xml-security-component.html">XML
Security component</a> supports now  XAdES-BES/EPES in the
signer endpoint.</li></ul><h3 id="Camel2.15.0Release-Fixedissues">Fixed
issues</h3><ul><li>Fixed processors was not enlisted in JMX when routes was
transacted.</li><li>Fixed the NullPointerException when using CXF endpoint with
enrich</li><li>Fixed the endpointProperty of restConfiguration
doesn't work issue</li><li>Fixed the issue that CircuitBreakerLoadBalancer
fails on async processors</li><li>Fixed MyBatis consumer <a shape="rect"
class="external-link"
href="https://issues.apache.org/jira/browse/CAMEL-8011";>ignoring
maxMessagesPerPoll</a> option</li><li>Fixed potential issue with pollEnri
ch not triggering error handler if an exception was thrown in the
polling.</li><li>Fixed a memory leak if using <a shape="rect"
href="dynamic-router.html">Dynamic Router</a> that loops many times, and
uses any of <code>convertBodyTo</code> or <code>setBody</code>
or <code>transform</code> in the loop, causing memory to stack up until
the Exchange is done.</li><li>Fixed and improved how <a shape="rect"
href="bean.html">Bean</a> component and <a shape="rect"
href="simple.html">Simple</a> language invoking beans detect methods that
are overridden, and able to filter and apply this as a single method, to be
invoked. Avoids AmbiguousMethodCallException being thrown.</li><li>Fixed a
thread leak if restarting routes using stop/start and the routes is a scheduled
poll consumer, such as file/ftp components.<br clear="none"><br
clear="none"></li></ul><h3 id="Camel2.15.0Release-New">New <a shape="rect"
href="enterprise-integration-patterns
.html">Enterprise Integration Patterns</a></h3><h3
id="Camel2.15.0Release-New.1">New <a shape="rect"
href="components.html">Components</a></h3><ul><li><a shape="rect"
href="beanstalk.html">camel-beanstalk</a> - for working with Amazon Beanstalk
jobs.</li><li>came-cassandraql - Cassandra CQL3
support</li><li><code>camel-chunk</code> - for templating with Chunk
engine.</li><li><a shape="rect" href="docker.html">camel-docker</a> - to
communicate with Docker.</li><li>camel-github - for integrating with
github</li><li>camel-google-calendar - provides access to <a
shape="rect" class="external-link" href="http://google.com/calendar";
rel="nofollow">Google Calendar</a> via the <a shape="rect"
class="external-link"
href="https://developers.google.com/google-apps/calendar/v3/reference/";
rel="nofollow">Google Calendar Web APIs</a>.</li><li>camel-google-mail
- provides access to <a shape="rect" class="external-link"
href="http://gmail.com/"; rel="nofollow">Gmail
</a> via the <a shape="rect" class="external-link"
href="https://developers.google.com/gmail/api/v1/reference/";
rel="nofollow">Google Mail Web APIs</a>.</li><li>camel-pgevent - Component
for sending/receiving notifications in PostgreSQL via the pgjdbc-ng
driver</li><li>camel-jira - for integrating with JIRA issue
tracker</li><li>camel-scr - for using Camel with <a shape="rect"
class="external-link"
href="http://felix.apache.org/documentation/subprojects/apache-felix-maven-scr-plugin/scr-annotations.html";>SCR</a> (OSGi
declarative services) on OSGi containers such as Apache Karaf</li><li><a
shape="rect" href="spring-boot.html">camel-spring-boot</a> - for using Camel
with Spring Boot</li><li>camel-test-spring40 - for testing with Spring 4.0.x.
camel-test-spring is for Spring 4.1.x onwards.</li></ul><h3
id="Camel2.15.0Release-NewDSL">New DSL</h3><ul><li>Added
<strong>removeProperties</strong> to remove the properties from
exchange.</li></ul><h3 id="Camel2.15.0Releas
e-NewAnnotations">New Annotations</h3><h3
id="Camel2.15.0Release-NewDataFormats">New <a shape="rect"
href="data-format.html">Data
Formats</a></h3><ul><li>camel-univocity-parsers</li></ul><h3
id="Camel2.15.0Release-New.2">New <a shape="rect"
href="languages.html">Languages</a></h3><h3 id="Camel2.15.0Release-New.3">New
<a shape="rect" href="examples.html">Examples</a></h3><h3
id="Camel2.15.0Release-New.4">New <a shape="rect"
href="tutorials.html">Tutorials</a></h3><h2
id="Camel2.15.0Release-KnownIssues">Known Issues</h2><h2
id="Camel2.15.0Release-DependencyUpgrades"><span>Dependency
Upgrades</span></h2><ul><li>AWS-Java-SDK 1.8.3 to 1.8.9.1</li><li>Codahale
Metrics 3.0 to 3.1</li><li>CXF 3.0.2 to 3.0.3</li><li>Hazelcast 3.3.2 to
3.4</li><li>JAXB 2.2.7 to 2.2.11</li><li>JRuby 1.7.16 to 1.7.18</li><li>Guava
17.0 to 18.0</li><li>Jsch 0.1.50 to 0.1.51</li><li>Spring 4.0.7.RELEASE to
4.1.4.RELEASE</li><li>Spring Security 3.1.7.RELEASE to 3.2.5.RELEASE</li><li>RX
Java 0.20 to 1.0.2</li><li>.
.. and many other upgrades</li></ul><h2
id="Camel2.15.0Release-Importantchangestoconsiderwhenupgrading">Important
changes to consider when upgrading</h2><ul><li>Spring 4.1.x is now the default
out of the box Spring version.</li><li><span style="color: rgb(0,0,0);">Unit
testing with Spring 4.0.x requires using camel-test-spring40, as
camel-test-spring is for Spring 4.1 or better.</span></li><li><span
style="color: rgb(0,0,0);">Remember to add <code class="java
color1">@BootstrapWith</code><code class="java
plain">(CamelTestContextBootstrapper.</code><code class="java
keyword">class</code><code class="java plain">)</code> if upgrading from
Spring 3.x or 4.0.x to Spring 4.1 onwards, and using the camel-test-spring
module.</span></li><li><a shape="rect" href="xslt.html">XSLT</a> component
now require configuring <code>transformerFactory</code> using <a
shape="rect" href="uris.html">URIs</a> with the #syntax to refer to a bean.
Just like any other component would
do.</li><li>Slight refactor in <code>camel-metrics</code> component
which may affect users who are using the java endpoint types instead of
configuring using uris</li><li><code>camel-csv</code> upgraded to Commons CSV
1.x which has a different API than the old 0.x version. End users may need to
adjust their code.</li><li><code>camel-sjms</code> has been refactored a bit to
further harden this component. End users may need to adjust their
code.</li><li>The <a shape="rect" href="simple.html">simple</a> function
properties:locations:key has been renamed to properties-location:locations:key,
as it would clash with the new functionality to specify a default value after
the key name, eg properties:key:default</li><li>Support for Jetty 8.x is
deprecated and being considered to be dropped in next release (as Jetty 8 is
EOL).</li><li>Removed the backlog tracer commands from the Karaf Camel commands
as they are not suitable for a CLI environment</li><li>The need for runtime
specifi
c servlets in <a shape="rect" href="swagger.html">Swagger</a> has been
removed, and instead just use the default servlet which is provided out of the
box. </li></ul><h2 id="Camel2.15.0Release-GettingtheDistributions">Getting
the Distributions</h2><h3 id="Camel2.15.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.15.0/apache-camel-x.y.x.zip";>apache-camel-2.15.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.15.0/apache-camel-x.y.x.zip.asc";>apache-camel-2.15.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.15.0/apache-camel-x.y.x.tar.gz";>apache-camel-2.15.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.15.0/apache-camel-x.y.x.tar.gz.asc";>apache-camel-2.15.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.15.0Release-Camel2.15.0release(currentlyinprogress)">Camel 2.15.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.15.0Release-NewandNoteworthy">New and Noteworthy</h2><p>Welcome to
the 2.15.0 release which approx XXX issues resolved (new features, improvements
and bug fixes such as...)</p><ul><li><span>Component documentation now included
in the built component JARs. And Java API and JMX API to access that
documentation. And APIs to explain an endpoint uri and what all those
configured options mean. </span></li><li><span>Component can now
have associated label(s) which are use
d for grouping components into: core, database, messaging, http, rest,
etc.</span></li><li><span>Provide Configurer for user to configure the CXF
conduit and CXF destination from Java code</span></li><li><span><span>Added a
<code>DelegateEndpoint</code> interface into Camel
API</span></span></li><li>Support to setup the SslContextParameters in the <a
shape="rect" href="restlet.html">camel-restlet</a> component</li><li>Java DSL -
Should support nested choice in doTry .. doCatch</li><li><a shape="rect"
href="mongodb.html">MongoDb</a> component now <a shape="rect"
class="external-link"
href="https://issues.apache.org/jira/browse/CAMEL-7996";>stores OIDs</a> of
the inserted records in the message header</li><li><a shape="rect"
href="recipient-list.html">Recipient List</a> now supports specifying
custom <a shape="rect" href="exchange-pattern.html">Exchange Pattern</a>
in the endpoint ur's</li><li><a shape="rect" href="type-converter.html">Type
Converter</a> to enum's is now
case insensitive, so you can convert safely level=info to an enum with name
Level.INFO etc.</li><li><a shape="rect" href="xslt.html">XSLT</a> and <a
shape="rect"
href="https://cwiki.apache.org/confluence/display/SM/Validation";>Validation</a>
components now provides all their endpoint configurations in the endpoint, and
not only in the component, making these components like any other
components.</li><li>Made the <a shape="rect" href="karaf.html">Camel Karaf
Commands</a> reusable by moving common code into
a <code>camel-commands-core</code> module that SPI can extend and plugin
Camel commands for other environments.</li><li>Further hardening of the <a
shape="rect" href="sjms.html">SJMS</a> component.</li><li><a shape="rect"
href="rest-dsl.html">Rest DSL</a> with embedded routes now supports <a
shape="rect" href="exception-clause.html">onException</a>, <a shape="rect"
href="intercept.html">intercept</a> etc in use for those embedded routes, just
like any regular r
outes. </li><li><a shape="rect" href="rest-dsl.html">Rest DSL</a> now by
default uses custom error message as-is without attempting to binding output
(requires a HTTP error code of 300+ is set as a header)</li><li>Camel <a
shape="rect" href="using-propertyplaceholder.html">Using
PropertyPlaceholder</a> now supports specifying a default value together with
the key to lookup.</li><li>Camel <a shape="rect"
href="using-propertyplaceholder.html">Using PropertyPlaceholder</a> now
supports not having to define a PropertiesComponent if all the placeholder keys
has default values which are to be used (less configuration needed in those
situations).</li><li>Camel <a shape="rect"
href="using-propertyplaceholder.html">Using PropertyPlaceholder</a> now
supports 3rd party functions to lookup the property values, this allow end
users to implement their own logic - we provide 3 out of the box functions to
lookup values from OS environment variable, JVM system properties, or the
service name idiom.</li><li><a shape="rect" href="rabbitmq.html">RabbitMQ</a>
now pools Channels for the producer to avoid sharing same Channel among
concurrent producers which are not recommended by RabbitMQ
client.</li><li>Camel commands is now reusable outside Apache Karaf as a base
by the <code>commands-core</code> module.</li><li>Camel commands using <a
shape="rect" class="external-link" href="http://www.jolokia.org/";
rel="nofollow">Jolokia</a> for remote communication by
the <code>commands-jolokia</code> module.</li><li>More minor processors
such as setHeader, removeHeader, removeHeaders and ditto for properties is now
also enlisted in JMX under processors.</li><li>Optimized usage of type
conversion during routing reducing the number of attempts
needed.</li><li>Asynchronous routing engine that are forced to block threads
now exposes this using a <a shape="rect"
href="asyncprocessorawaitmanager.html">manager</a> that offers runtime insight
using JMX. And as well attem
pts to free blocked threads during graceful shutdown, to avoid any threads
hanging in the JVM.</li><li><a shape="rect" href="swagger.html">Swagger</a> now
supports any kind of runtime environment, as only JMX being enabled is
required.</li><li><a shape="rect" href="xml-security-component.html">XML
Security component</a> supports now  XAdES-BES/EPES in the
signer endpoint.</li><li><a shape="rect" href="hl7.html">HL7</a> MLLP codec now
supports <a shape="rect" href="netty4.html">Netty4</a> based
transport.</li></ul><h3 id="Camel2.15.0Release-Fixedissues">Fixed
issues</h3><ul><li>Fixed processors was not enlisted in JMX when routes was
transacted.</li><li>Fixed the NullPointerException when using CXF endpoint with
enrich</li><li>Fixed the endpointProperty of restConfiguration
doesn't work issue</li><li>Fixed the issue that CircuitBreakerLoadBalancer
fails on async processors</li><li>Fixed MyBatis consumer <a shape="rect"
class="external-link" hre
f="https://issues.apache.org/jira/browse/CAMEL-8011";>ignoring
maxMessagesPerPoll</a> option</li><li>Fixed potential issue
with pollEnrich not triggering error handler if an exception was thrown in
the polling.</li><li>Fixed a memory leak if using <a shape="rect"
href="dynamic-router.html">Dynamic Router</a> that loops many times, and
uses any of <code>convertBodyTo</code> or <code>setBody</code>
or <code>transform</code> in the loop, causing memory to stack up until
the Exchange is done.</li><li>Fixed and improved how <a shape="rect"
href="bean.html">Bean</a> component and <a shape="rect"
href="simple.html">Simple</a> language invoking beans detect methods that
are overridden, and able to filter and apply this as a single method, to be
invoked. Avoids AmbiguousMethodCallException being thrown.</li><li>Fixed a
thread leak if restarting routes using stop/start and the routes is a scheduled
poll consumer, such as file/ftp comp
onents.<br clear="none"><br clear="none"></li></ul><h3
id="Camel2.15.0Release-New">New <a shape="rect"
href="enterprise-integration-patterns.html">Enterprise Integration
Patterns</a></h3><h3 id="Camel2.15.0Release-New.1">New <a shape="rect"
href="components.html">Components</a></h3><ul><li><a shape="rect"
href="beanstalk.html">camel-beanstalk</a> - for working with Amazon Beanstalk
jobs.</li><li>came-cassandraql - Cassandra CQL3
support</li><li><code>camel-chunk</code> - for templating with Chunk
engine.</li><li><a shape="rect" href="docker.html">camel-docker</a> - to
communicate with Docker.</li><li>camel-github - for integrating with
github</li><li>camel-google-calendar - provides access to <a
shape="rect" class="external-link" href="http://google.com/calendar";
rel="nofollow">Google Calendar</a> via the <a shape="rect"
class="external-link"
href="https://developers.google.com/google-apps/calendar/v3/reference/";
rel="nofollow">Google Calendar Web APIs</a>.<
/li><li>camel-google-mail - provides access to <a shape="rect"
class="external-link" href="http://gmail.com/";
rel="nofollow">Gmail</a> via the <a shape="rect"
class="external-link"
href="https://developers.google.com/gmail/api/v1/reference/";
rel="nofollow">Google Mail Web APIs</a>.</li><li>camel-pgevent - Component
for sending/receiving notifications in PostgreSQL via the pgjdbc-ng
driver</li><li>camel-jira - for integrating with JIRA issue
tracker</li><li>camel-scr - for using Camel with <a shape="rect"
class="external-link"
href="http://felix.apache.org/documentation/subprojects/apache-felix-maven-scr-plugin/scr-annotations.html";>SCR</a> (OSGi
declarative services) on OSGi containers such as Apache Karaf</li><li><a
shape="rect" href="spring-boot.html">camel-spring-boot</a> - for using Camel
with Spring Boot</li><li>camel-test-spring40 - for testing with Spring 4.0.x.
camel-test-spring is for Spring 4.1.x onwards.</li></ul><h3
id="Camel2.15.0Release-Ne
wDSL">New DSL</h3><ul><li>Added <strong>removeProperties</strong> to remove
the properties from exchange.</li></ul><h3
id="Camel2.15.0Release-NewAnnotations">New Annotations</h3><h3
id="Camel2.15.0Release-NewDataFormats">New <a shape="rect"
href="data-format.html">Data
Formats</a></h3><ul><li>camel-univocity-parsers</li></ul><h3
id="Camel2.15.0Release-New.2">New <a shape="rect"
href="languages.html">Languages</a></h3><h3 id="Camel2.15.0Release-New.3">New
<a shape="rect" href="examples.html">Examples</a></h3><h3
id="Camel2.15.0Release-New.4">New <a shape="rect"
href="tutorials.html">Tutorials</a></h3><h2
id="Camel2.15.0Release-KnownIssues">Known Issues</h2><h2
id="Camel2.15.0Release-DependencyUpgrades"><span>Dependency
Upgrades</span></h2><ul><li>AWS-Java-SDK 1.8.3 to 1.8.9.1</li><li>Codahale
Metrics 3.0 to 3.1</li><li>CXF 3.0.2 to 3.0.3</li><li>Hazelcast 3.3.2 to
3.4</li><li>JAXB 2.2.7 to 2.2.11</li><li>JRuby 1.7.16 to 1.7.18</li><li>Guava
17.0 to 18.0</li><li>Jsch 0.1.50 to 0.1.51<
/li><li>Spring 4.0.7.RELEASE to 4.1.4.RELEASE</li><li>Spring Security
3.1.7.RELEASE to 3.2.5.RELEASE</li><li>RX Java 0.20 to 1.0.2</li><li>... and
many other upgrades</li></ul><h2
id="Camel2.15.0Release-Importantchangestoconsiderwhenupgrading">Important
changes to consider when upgrading</h2><ul><li>Spring 4.1.x is now the default
out of the box Spring version.</li><li><span style="color: rgb(0,0,0);">Unit
testing with Spring 4.0.x requires using camel-test-spring40, as
camel-test-spring is for Spring 4.1 or better.</span></li><li><span
style="color: rgb(0,0,0);">Remember to add <code class="java
color1">@BootstrapWith</code><code class="java
plain">(CamelTestContextBootstrapper.</code><code class="java
keyword">class</code><code class="java plain">)</code> if upgrading from
Spring 3.x or 4.0.x to Spring 4.1 onwards, and using the camel-test-spring
module.</span></li><li><a shape="rect" href="xslt.html">XSLT</a> component
now require configuring <code>transformer
Factory</code> using <a shape="rect" href="uris.html">URIs</a> with the
#syntax to refer to a bean. Just like any other component would
do.</li><li>Slight refactor in <code>camel-metrics</code> component which
may affect users who are using the java endpoint types instead of configuring
using uris</li><li><code>camel-csv</code> upgraded to Commons CSV 1.x which has
a different API than the old 0.x version. End users may need to adjust their
code.</li><li><code>camel-sjms</code> has been refactored a bit to further
harden this component. End users may need to adjust their
code.</li><li>The <a shape="rect" href="simple.html">simple</a> function
properties:locations:key has been renamed to properties-location:locations:key,
as it would clash with the new functionality to specify a default value after
the key name, eg properties:key:default</li><li>Support for Jetty 8.x is
deprecated and being considered to be dropped in next release (as Jetty 8 is
EOL).</li><li>Removed t
he backlog tracer commands from the Karaf Camel commands as they are not
suitable for a CLI environment</li><li>The need for runtime specific servlets
in <a shape="rect" href="swagger.html">Swagger</a> has been removed, and
instead just use the default servlet which is provided out of the
box. </li></ul><h2 id="Camel2.15.0Release-GettingtheDistributions">Getting
the Distributions</h2><h3 id="Camel2.15.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/c
amel/apache-camel/2.15.0/apache-camel-x.y.x.zip">apache-camel-2.15.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.15.0/apache-camel-x.y.x.zip.asc";>apache-camel-2.15.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.15.0/apache-camel-x.y.x.tar.gz";>apache-camel-2.15.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.15.0/apache-camel-x.y.x.tar.gz.asc";>apache-camel-2.15.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/hl7.html
==============================================================================
--- websites/production/camel/content/hl7.html (original)
+++ websites/production/camel/content/hl7.html Thu Jan 8 19:23:25 2015
@@ -86,7 +86,7 @@
<tbody>
<tr>
<td valign="top" width="100%">
-<div class="wiki-content maincontent"><h2 id="HL7-HL7Component">HL7
Component</h2><p>The <strong>HL7</strong> component is used for working with
the HL7 MLLP protocol and <a shape="rect" class="external-link"
href="http://www.hl7.org/implement/standards/product_brief.cfm?product_id=185";
rel="nofollow">HL7 v2 messages</a> using the <a shape="rect"
class="external-link" href="http://hl7api.sourceforge.net"; rel="nofollow">HAPI
library</a>.</p><p>This component supports the following:</p><ul
class="alternate"><li>HL7 MLLP codec for <a shape="rect" class="external-link"
href="http://mina.apache.org/";>Mina</a></li><li><a shape="rect"
href="type-converter.html">Type Converter</a> from/to HAPI and
String</li><li>HL7 DataFormat using the HAPI library</li><li
class="confluence-link">Even more ease-of-use as it's integrated well with the
<a shape="rect" href="mina2.html">camel-mina2</a> component.</li></ul><p>Maven
users will need to add the following dependency to their <code>pom.xml</code> f
or this component:</p><div class="code panel pdl" style="border-width:
1px;"><div class="codeContent panelContent pdl">
+<div class="wiki-content maincontent"><h2 id="HL7-HL7Component">HL7
Component</h2><p>The <strong>HL7</strong> component is used for working with
the HL7 MLLP protocol and <a shape="rect" class="external-link"
href="http://www.hl7.org/implement/standards/product_brief.cfm?product_id=185";
rel="nofollow">HL7 v2 messages</a> using the <a shape="rect"
class="external-link" href="http://hl7api.sourceforge.net"; rel="nofollow">HAPI
library</a>.</p><p>This component supports the following:</p><ul
class="alternate"><li>HL7 MLLP codec for <a shape="rect" class="external-link"
href="http://mina.apache.org/";>Mina</a></li><li>HL7 MLLP codec for <a
shape="rect" href="netty4.html">Netty4</a> from <strong>Camel
2.15</strong> onwards</li><li><a shape="rect" href="type-converter.html">Type
Converter</a> from/to HAPI and String</li><li>HL7 DataFormat using the HAPI
library</li><li class="confluence-link">Even more ease-of-use as it's
integrated well with the <a shape="rect" href="mina2.html">
camel-mina2</a> component.</li></ul><p>Maven users will need to add the
following dependency to their <code>pom.xml</code> for this component:</p><div
class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
<script class="theme: Default; brush: xml; gutter: false"
type="syntaxhighlighter"><![CDATA[<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-hl7</artifactId>
@@ -94,7 +94,7 @@
<!-- use the same version as your Camel core version -->
</dependency>
]]></script>
-</div></div><h3 id="HL7-HL7MLLPprotocol">HL7 MLLP protocol</h3><p>HL7 is often
used with the HL7 MLLP protocol, which is a text based TCP socket based
protocol. This component ships with a Mina Codec that conforms to the MLLP
protocol so you can easily expose an HL7 listener accepting HL7 requests over
the TCP transport layer. To expose a HL7 listener service, the <a shape="rect"
href="mina2.html">camel-mina2</a> component is used with the
<code>HL7MLLPCodec</code> as codec.</p><p>The HL7 MLLP codec has the following
options:</p><div class="confluenceTableSmall"><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p>Name</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Default Value</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>startByte</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>0
x0b</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>The
start byte spanning the HL7 payload.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>endByte1</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>0x1c</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>The first end byte spanning the
HL7 payload.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>endByte2</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>0x0d</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The 2nd end byte spanning the HL7
payload.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>charset</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>JVM Default</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The encoding (a <a shape="rect"
class="external-link"
href="http://docs.oracle.com/javase/6/docs/api/java/nio/charset
/Charset.html" rel="nofollow">charset name</a>) to use for the codec. If not
provided, Camel will use the <a shape="rect" class="external-link"
href="http://docs.oracle.com/javase/6/docs/api/java/nio/charset/Charset.html#defaultCharset()"
rel="nofollow">JVM default Charset</a>.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><code>produceString</code></td><td colspan="1"
rowspan="1" class="confluenceTd"><code>true</code></td><td colspan="1"
rowspan="1" class="confluenceTd"><strong>(Camel 2.14.1)</strong> If true, the
codec creates a string using the defined charset. If false, the codec sends a
plain byte array into the route, so that the HL7 Data Format can determine the
actual charset from the HL7 message content.</td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><code>convertLFtoCR</code></td><td colspan="1"
rowspan="1" class="confluenceTd"><code>false</code></td><td colspan="1"
rowspan="1" class="confluenceTd">Will convert <code>\n</code> to <code>\r
</code> (<code>0x0d</code>, 13 decimal) as HL7 stipulates <code>\r</code> as
segment terminators. The HAPI library requires the use of
<code>\r</code>.</td></tr></tbody></table></div></div><h4
id="HL7-ExposinganHL7listener">Exposing an HL7 listener</h4><p>In the Spring
XML file, we configure a mina2 endpoint to listen for HL7 requests using TCP on
port <code>8888</code>:</p><div class="code panel pdl" style="border-width:
1px;"><div class="codeContent panelContent pdl">
+</div></div><h3 id="HL7-HL7MLLPprotocol">HL7 MLLP protocol</h3><p>HL7 is often
used with the HL7 MLLP protocol, which is a text based TCP socket based
protocol. This component ships with a Mina and Netty4 Codec that conforms to
the MLLP protocol so you can easily expose an HL7 listener accepting HL7
requests over the TCP transport layer. To expose a HL7 listener service, the <a
shape="rect" href="mina2.html">camel-mina2</a> or <a shape="rect"
href="netty4.html">camel-netty4</a> component is used with the
<code>HL7MLLPCodec</code> (mina2) or
<code>HL7MLLPConfig</code> (Netty4) as codec.</p><p>The HL7 MLLP
codec has the following options:</p><div class="confluenceTableSmall"><div
class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1"
rowspan="1" class="confluenceTh"><p>Name</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Default Value</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th></tr><tr><td colsp
an="1" rowspan="1" class="confluenceTd"><p><code>startByte</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>0x0b</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>The start byte spanning the HL7
payload.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>endByte1</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>0x1c</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The first end byte spanning the HL7
payload.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>endByte2</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>0x0d</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The 2nd end byte spanning the HL7
payload.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>charset</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>JVM Default</p></td><td colspan="1"
rowspan="1" class="c
onfluenceTd"><p>The encoding (a <a shape="rect" class="external-link"
href="http://docs.oracle.com/javase/6/docs/api/java/nio/charset/Charset.html";
rel="nofollow">charset name</a>) to use for the codec. If not provided, Camel
will use the <a shape="rect" class="external-link"
href="http://docs.oracle.com/javase/6/docs/api/java/nio/charset/Charset.html#defaultCharset()"
rel="nofollow">JVM default Charset</a>.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><code>produceString</code></td><td colspan="1"
rowspan="1" class="confluenceTd"><code>true</code></td><td colspan="1"
rowspan="1" class="confluenceTd"><strong>(Camel 2.14.1)</strong> If true, the
codec creates a string using the defined charset. If false, the codec sends a
plain byte array into the route, so that the HL7 Data Format can determine the
actual charset from the HL7 message content.</td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><code>convertLFtoCR</code></td><td colspan="1"
rowspan="1"
class="confluenceTd"><code>false</code></td><td colspan="1" rowspan="1"
class="confluenceTd">Will convert <code>\n</code> to <code>\r</code>
(<code>0x0d</code>, 13 decimal) as HL7 stipulates <code>\r</code> as segment
terminators. The HAPI library requires the use of
<code>\r</code>.</td></tr></tbody></table></div></div><h4
id="HL7-ExposinganHL7listenerusingMina">Exposing an HL7 listener using
Mina</h4><p>In the Spring XML file, we configure a mina2 endpoint to listen for
HL7 requests using TCP on port <code>8888</code>:</p><div class="code panel
pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: xml; gutter: false"
type="syntaxhighlighter"><![CDATA[ <endpoint id="hl7listener"
uri="mina2:tcp://localhost:8888?sync=true&amp;codec=#hl7codec"/>
]]></script>
</div></div><p><strong>sync=true</strong> indicates that this listener is
synchronous and therefore will return a HL7 response to the caller. The HL7
codec is setup with <strong>codec=#hl7codec</strong>. Note that
<code>hl7codec</code> is just a Spring bean ID, so it could be named
<code>mygreatcodecforhl7</code> or whatever. The codec is also set up in the
Spring XML file:</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeContent panelContent pdl">
![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}