Author: buildbot
Date: Mon Apr 15 10:19:03 2013
New Revision: 858520
Log:
Production update by buildbot for camel
Modified:
websites/production/camel/content/cache/main.pageCache
websites/production/camel/content/camel-2110-release.html
websites/production/camel/content/type-converter.html
Modified: websites/production/camel/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/camel/content/camel-2110-release.html
==============================================================================
--- websites/production/camel/content/camel-2110-release.html (original)
+++ websites/production/camel/content/camel-2110-release.html Mon Apr 15
10:19:03 2013
@@ -151,7 +151,7 @@
<h2><a shape="rect"
name="Camel2.11.0Release-Importantchangestoconsiderwhenupgrading"></a>Important
changes to consider when upgrading</h2>
-<ul><li>Spring 3.0.x support is @deprecated and some of the camel-spring
components require Spring 3.1 onwards.</li><li>Apache Camel Karaf features now
uses Spring version range "[3.1,4)" as Spring 3.1 is now required as minimum
Spring version.</li><li><tt>camel-mina2</tt> now uses
<tt>OrderedThreadPoolExecutor</tt> by default. There is a new option
<tt>orderedThreadPoolExecutor</tt> you can configure it to <tt>false</tt> to
revert back to unordered if needed. If using SSL etc. then ordered is required
to be used.</li><li><tt>camel-netty</tt> now uses
<tt>OrderedMemoryAwareThreadPoolExecutor</tt> by default. There is a new option
<tt>orderedThreadPoolExecutor</tt> you can configure it to false to revert back
to unordered if needed. If using SSL etc. then ordered is required to be
used.</li><li>The default value of the <tt>delay</tt> option on <a shape="rect"
href="timer.html" title="Timer">Timer</a> has been changed from <tt>0</tt> to
<tt>1000</tt></li><li>The default value
of the <tt>convertLFtoCR</tt> option of the <a shape="rect" href="hl7.html"
title="HL7">HL7</a> MLLP codec has been changed from <tt>true</tt> to
<tt>false</tt>. Likewise, the <a shape="rect" href="hl7.html"
title="HL7">HL7</a> DataFormat and TypeConverter do not perform this conversion
anymore.</li><li>The <a shape="rect" href="simple.html"
title="Simple">Simple</a> language has limited its support for the escape
character to only new line, carriage return and tab characters. This makes it
easier to use back-slash characters in the <a shape="rect" href="simple.html"
title="Simple">Simple</a> language without double escaping
etc.</li><li><tt>camel-netty</tt> now requires <tt>commons-pool</tt> as
dependency.</li><li>The <tt>maximumQueueSize</tt> of <a shape="rect"
class="external-link"
href="http://camel.apache.org/threading-model.html";>Thread Pools</a> and <a
shape="rect" class="external-link"
href="http://camel.apache.org/threading-model.html";>Thread Pool Profiles</a>
with
values 0 or negative now means disable the worker queue, and use
direct-handover. If you want an unbounded queue size, then set the
<tt>maximumQueueSize</tt> to <tt>Integer.MAX_VALUE</tt> which was what the
previous code did.</li><li>Custom assigned id's on Camel <a shape="rect"
href="routes.html" title="Routes">Routes</a> is now validated on starting the
routes, that they must be unique within the same
CamelContext.</li><li><tt>camel-blueprint</tt> now requires Apache Aries 1.0,
and OSGi 4.3.0.</li><li>Removed @deprecated classes form <tt>camel-spring</tt>
in the <tt>org.apache.camel.component</tt> package which was causing
split-package issue with OSGi. Component authors who are using these
@deprecated classes, should migrate to use equivalent classes from
<tt>camel-core</tt> in the same package.</li><li>The default Spring version is
upgraded from 3.0.7 to 3.1.3 out of the box.</li><li>Camel now validates <a
shape="rect" href="seda.html" title="SEDA">SEDA</a> and <a shape=
"rect" href="vm.html" title="VM">VM</a> endpoints using same queue name, that
if any queue size is in use, that size must match. As well Camel logs at INFO
level when starting up the queues and the sizes. This allows end users to
easily spot any issues if mistakenly using different queue sizes for the same
queue names.</li><li>The <a shape="rect" href="zookeeper.html"
title="Zookeeper">Zookeeper endpoint</a> <tt>awaitExistence</tt> option has
been marked as @deprecated and is removed from it's documentation as it's usage
would have no effect in the current codebase.</li><li>Marked the 2 classes in
the <tt>junit4</tt> package from <tt>camel-test-spring</tt> component as
@deprecated, and refer to use the classes from the <tt>spring</tt> package
instead.</li><li>If using <a shape="rect" href="xslt.html"
title="XSLT">XSLT</a> with includes, then mind that if not explicit defined
file: or classpath: as prefix in xsl:include, then Camel will now use the same
as configured on the e
ndpoint. Before "classpath:" was always used as fallback, despite endpoint
could have been configured with "file:".</li><li><tt>camel-scala</tt> has been
upgraded to Scala 2.10.1, there is a <tt>camel-scala_2.9</tt> module that is
built against Scala 2.9.2. Though <tt>camel-scala_2.9</tt> is deprecated and
expected to be removed in the next bigger release (eg Camel
2.12/3.0).</li><li><tt>camel-gae</tt> now longer has Spring dependency, and we
removed class
<tt>org.apache.camel.component.gae.context.GaeSpringCamelContext</tt>.</li><li><tt>camel-jackson</tt>
has upgraded from Jackson 1.x to 2.x.</li></ul>
+<ul><li>Spring 3.0.x support is @deprecated and some of the camel-spring
components require Spring 3.1 onwards.</li><li>Apache Camel Karaf features now
uses Spring version range "[3.1,4)" as Spring 3.1 is now required as minimum
Spring version.</li><li><tt>camel-mina2</tt> now uses
<tt>OrderedThreadPoolExecutor</tt> by default. There is a new option
<tt>orderedThreadPoolExecutor</tt> you can configure it to <tt>false</tt> to
revert back to unordered if needed. If using SSL etc. then ordered is required
to be used.</li><li><tt>camel-netty</tt> now uses
<tt>OrderedMemoryAwareThreadPoolExecutor</tt> by default. There is a new option
<tt>orderedThreadPoolExecutor</tt> you can configure it to false to revert back
to unordered if needed. If using SSL etc. then ordered is required to be
used.</li><li>The default value of the <tt>delay</tt> option on <a shape="rect"
href="timer.html" title="Timer">Timer</a> has been changed from <tt>0</tt> to
<tt>1000</tt></li><li>The default value
of the <tt>convertLFtoCR</tt> option of the <a shape="rect" href="hl7.html"
title="HL7">HL7</a> MLLP codec has been changed from <tt>true</tt> to
<tt>false</tt>. Likewise, the <a shape="rect" href="hl7.html"
title="HL7">HL7</a> DataFormat and TypeConverter do not perform this conversion
anymore.</li><li>The <a shape="rect" href="simple.html"
title="Simple">Simple</a> language has limited its support for the escape
character to only new line, carriage return and tab characters. This makes it
easier to use back-slash characters in the <a shape="rect" href="simple.html"
title="Simple">Simple</a> language without double escaping
etc.</li><li><tt>camel-netty</tt> now requires <tt>commons-pool</tt> as
dependency.</li><li>The <tt>maximumQueueSize</tt> of <a shape="rect"
class="external-link"
href="http://camel.apache.org/threading-model.html";>Thread Pools</a> and <a
shape="rect" class="external-link"
href="http://camel.apache.org/threading-model.html";>Thread Pool Profiles</a>
with
values 0 or negative now means disable the worker queue, and use
direct-handover. If you want an unbounded queue size, then set the
<tt>maximumQueueSize</tt> to <tt>Integer.MAX_VALUE</tt> which was what the
previous code did.</li><li>Custom assigned id's on Camel <a shape="rect"
href="routes.html" title="Routes">Routes</a> is now validated on starting the
routes, that they must be unique within the same
CamelContext.</li><li><tt>camel-blueprint</tt> now requires Apache Aries 1.0,
and OSGi 4.3.0.</li><li>Removed @deprecated classes form <tt>camel-spring</tt>
in the <tt>org.apache.camel.component</tt> package which was causing
split-package issue with OSGi. Component authors who are using these
@deprecated classes, should migrate to use equivalent classes from
<tt>camel-core</tt> in the same package.</li><li>The default Spring version is
upgraded from 3.0.7 to 3.1.3 out of the box.</li><li>Camel now validates <a
shape="rect" href="seda.html" title="SEDA">SEDA</a> and <a shape=
"rect" href="vm.html" title="VM">VM</a> endpoints using same queue name, that
if any queue size is in use, that size must match. As well Camel logs at INFO
level when starting up the queues and the sizes. This allows end users to
easily spot any issues if mistakenly using different queue sizes for the same
queue names.</li><li>The <a shape="rect" href="zookeeper.html"
title="Zookeeper">Zookeeper endpoint</a> <tt>awaitExistence</tt> option has
been marked as @deprecated and is removed from it's documentation as it's usage
would have no effect in the current codebase.</li><li>Marked the 2 classes in
the <tt>junit4</tt> package from <tt>camel-test-spring</tt> component as
@deprecated, and refer to use the classes from the <tt>spring</tt> package
instead.</li><li>If using <a shape="rect" href="xslt.html"
title="XSLT">XSLT</a> with includes, then mind that if not explicit defined
file: or classpath: as prefix in xsl:include, then Camel will now use the same
as configured on the e
ndpoint. Before "classpath:" was always used as fallback, despite endpoint
could have been configured with "file:".</li><li><tt>camel-scala</tt> has been
upgraded to Scala 2.10.1, there is a <tt>camel-scala_2.9</tt> module that is
built against Scala 2.9.2. Though <tt>camel-scala_2.9</tt> is deprecated and
expected to be removed in the next bigger release (eg Camel
2.12/3.0).</li><li><tt>camel-gae</tt> now longer has Spring dependency, and we
removed class
<tt>org.apache.camel.component.gae.context.GaeSpringCamelContext</tt>.</li><li><tt>camel-jackson</tt>
has upgraded from Jackson 1.x to 2.x.</li><li><a shape="rect"
href="type-converter.html" title="Type Converter">Type Converter</a>
utilizations statistics has been disabled by default, due there is a little
performance impact under very high concurrent load. You can enable the
statistics easily as documented at <a shape="rect" href="type-converter.html"
title="Type Converter">Type Converter</a>.</li></ul>
<h2><a shape="rect" name="Camel2.11.0Release-Notice"></a>Notice</h2>
Modified: websites/production/camel/content/type-converter.html
==============================================================================
--- websites/production/camel/content/type-converter.html (original)
+++ websites/production/camel/content/type-converter.html Mon Apr 15 10:19:03
2013
@@ -117,6 +117,27 @@ Document document = message.getBody(Docu
</pre>
</div></div>
+<h4><a shape="rect"
name="TypeConverter-TypeConverterRegistryutilizationstatistics"></a>TypeConverterRegistry
utilization statistics</h4>
+
+<p>Camel can gather utilization statistics of the runtime usage of type
converters. These stats is available in JMX, and ass well from the
<tt>getStatistics()</tt> method from <tt>TypeConverterRegistry</tt>.</p>
+
+<p>From <b>Camel 2.11.0/2.10.5</b> onwards these statistics is default turned
off, as there is a little performance overhead under very high concurrent load.
To enable the statistics you can do this from java with:</p>
+<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
+<pre class="code-java">
+ CamelContext context = ...
+ context.setTypeConverterStatisticsEnabled(<span
class="code-keyword">true</span>);
+</pre>
+</div></div>
+
+<p>Or from XML DSL by:</p>
+<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
+<pre class="code-xml">
+<span class="code-tag"><camelContext xmlns=<span
class="code-quote">"http://camel.apache.org/schema/spring";</span>
typeConverterStatisticsEnabled=<span class="code-quote">"true"</span>></span>
+...
+<span class="code-tag"></camelContext></span>
+</pre>
+</div></div>
+
<h4><a shape="rect" name="TypeConverter-Addtypeconverteratruntime"></a>Add
type converter at runtime</h4>
<p>The following sample demonstrates how to add a type converter at
runtime:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
