camel-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r928022 - in /websites/production/camel/content: cache/main.pageCache camel-2150-release.html mongodb.html
Date Wed, 05 Nov 2014 12:19:25 GMT
Author: buildbot
Date: Wed Nov  5 12:19:24 2014
New Revision: 928022

Log:
Production update by buildbot for camel

Modified:
    websites/production/camel/content/cache/main.pageCache
    websites/production/camel/content/camel-2150-release.html
    websites/production/camel/content/mongodb.html

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 Wed Nov  5 12:19:24 2014
@@ -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&#160;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">&#160;</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>Provide
Configurer for user to configure the CXF conduit and CXF destination from Java code</span></li><li><span><span>Added
a DelegateEndpoint interface into Camel API</span></span></li><li>Support
to setup the SslContextParameters in the camel-restlet component</li><li>Java
DSL - Should supp
 ort nested choice in doTry .. doCatch<br clear="none"><br clear="none"></li></ul><p>Fixed
issues</p><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&#160;endpointProperty of&#160;restConfiguration
doesn't work issue</li><li>Fixed the issue that&#160;CircuitBreakerLoadBalancer
fails on async processors<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><a shape="rect" href="docker.html">camel-docer</a>
- to communicate with Docker.</li><li>camel-github</li><li>camel-jira</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><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><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-APIbreaking">API
breaking</h2><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>Guava
17.0 to 18.0</li><li>Jsch 0.1.50 to 0.1.51</li><li>S
 pring 4.0.7.RELEASE to 4.1.1.RELEASE</li><li>Spring Security 3.1.7.RELEASE to
3.2.5.RELEASE</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&#160;<code class="java color1">@BootstrapWith</code><code class="java
plain">(CamelTestContextBootstrapper.</code><code class="java keyword">class</code><code
class="java plain">)</code>&#160;if upgrading from Spring 3.x or 4.0.x to Spring
4.1 onwards, and using the camel-test-spring module.</span></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&#160;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">&#160;</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>Provide
Configurer for user to configure the CXF conduit and CXF destination from Java code</span></li><li><span><span>Added
a DelegateEndpoint interface into Camel API</span></span></li><li>Support
to setup the SslContextParameters in the camel-restlet component</li><li>Java
DSL - Should supp
 ort 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>&#160;of the inserted records in the message header<br clear="none"><br
clear="none"></li></ul><p>Fixed issues</p><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&#160;endpointProperty
of&#160;restConfiguration doesn't work issue</li><li>Fixed the issue that&#160;CircuitBreakerLoadBalancer
fails on async processors<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><a shape="rect" href="docker.html">camel-docker</a>
- to communicate with Docker.</li><li>camel-github</li><li>camel-jira</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><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><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-APIbreaking">API
breaking</h2><h2 id="Camel2.15.0Release-KnownIssues">Known Iss
 ues</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>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.1.RELEASE</li><li>Spring
Security 3.1.7.RELEASE to 3.2.5.RELEASE</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&#160;<code class="java color1">@BootstrapWith</code><code class="java
plain">(CamelTestContextBootstrapper.</code><code class="java keyword">class</code><code
class="java plain">)</code>&#160;if upgrading from Spring 3.x or 4.0.x to Spring
4.1 onwards, a
 nd using the camel-test-spring module.</span></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">
                     <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/mongodb.html
==============================================================================
--- websites/production/camel/content/mongodb.html (original)
+++ websites/production/camel/content/mongodb.html Wed Nov  5 12:19:24 2014
@@ -153,7 +153,7 @@ Object result = template.requestBodyAndH
 <script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[from(&quot;direct:insert&quot;)
     .to(&quot;mongodb:myDb?database=flights&amp;collection=tickets&amp;operation=insert&quot;);
 ]]></script>
-</div></div><p>The operation will return a WriteResult, and depending on
the <code>WriteConcern</code> or the value of the <code>invokeGetLastError</code>
option, <code>getLastError()</code> would have been called already or not. If
you want to access the ultimate result of the write operation, you need to retrieve the <code>CommandResult</code>
by calling <code>getLastError()</code> or <code>getCachedLastError()</code>
on the <code>WriteResult</code>. Then you can verify the result by calling <code>CommandResult.ok()</code>,
<code>CommandResult.getErrorMessage()</code> and/or <code>CommandResult.getException()</code>.</p><p>Note
that the new object's <code>_id</code> must be unique in the collection. If you
don't specify the value, MongoDB will automatically generate one for you. But if you do specify
it and it is not unique, the insert operation will fail (and for Camel to notice, you will
need to enable invokeGetLastError or set a WriteConcern that waits for the write result).</p
 ><p>This is not a limitation of the component, but it is how things work in MongoDB
for higher throughput. If you are using a custom <code>_id</code>, you are expected
to ensure at the application level that is unique (and this is a good practice too).</p><h4
id="MongoDB-save">save</h4><p>The save operation is equivalent to an <em>upsert</em>
(UPdate, inSERT) operation, where the record will be updated, and if it doesn't exist, it
will be inserted, all in one atomic operation. MongoDB will perform the matching based on
the _id field.</p><p>Beware that in case of an update, the object is replaced
entirely and the usage of <a shape="rect" class="external-link" href="http://www.mongodb.org/display/DOCS/Updating#Updating-ModifierOperations"
rel="nofollow">MongoDB's $modifiers</a> is not permitted. Therefore, if you want
to manipulate the object if it already exists, you have two options:</p><ol><li>perform
a query to retrieve the entire object first along with all its fields (may not be
  efficient), alter it inside Camel and then save it.</li><li>use the update operation
with <a shape="rect" class="external-link" href="http://www.mongodb.org/display/DOCS/Updating#Updating-ModifierOperations"
rel="nofollow">$modifiers</a>, which will execute the update at the server-side instead.
You can enable the upsert flag, in which case if an insert is required, MongoDB will apply
the $modifiers to the filter query object and insert the result.</li></ol><p>For
example:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
+</div></div><p>The operation will return a WriteResult, and depending on
the <code>WriteConcern</code> or the value of the <code>invokeGetLastError</code>
option, <code>getLastError()</code> would have been called already or not. If
you want to access the ultimate result of the write operation, you need to retrieve the <code>CommandResult</code>
by calling <code>getLastError()</code> or <code>getCachedLastError()</code>
on the <code>WriteResult</code>. Then you can verify the result by calling <code>CommandResult.ok()</code>,
<code>CommandResult.getErrorMessage()</code> and/or <code>CommandResult.getException()</code>.</p><p>Note
that the new object's <code>_id</code> must be unique in the collection. If you
don't specify the value, MongoDB will automatically generate one for you. But if you do specify
it and it is not unique, the insert operation will fail (and for Camel to notice, you will
need to enable invokeGetLastError or set a WriteConcern that waits for the write result).</p
 ><p>This is not a limitation of the component, but it is how things work in MongoDB
for higher throughput. If you are using a custom <code>_id</code>, you are expected
to ensure at the application level that is unique (and this is a good practice too).</p><p>Since
Camel <strong>2.15</strong>: OID(s) of the inserted record(s) is stored in the
message header under&#160;<code>CamelMongoOid</code> key (<code>MongoDbConstants.OID</code>
constant). The value stored is&#160;<code>org.bson.types.ObjectId</code> for
single insert or <code>java.util.List&lt;org.bson.types.ObjectId&gt;</code>
if multiple records have been inserted.</p><h4 id="MongoDB-save">save</h4><p>The
save operation is equivalent to an <em>upsert</em> (UPdate, inSERT) operation,
where the record will be updated, and if it doesn't exist, it will be inserted, all in one
atomic operation. MongoDB will perform the matching based on the _id field.</p><p>Beware
that in case of an update, the object is replaced entirely and the u
 sage of <a shape="rect" class="external-link" href="http://www.mongodb.org/display/DOCS/Updating#Updating-ModifierOperations"
rel="nofollow">MongoDB's $modifiers</a> is not permitted. Therefore, if you want
to manipulate the object if it already exists, you have two options:</p><ol><li>perform
a query to retrieve the entire object first along with all its fields (may not be efficient),
alter it inside Camel and then save it.</li><li>use the update operation with
<a shape="rect" class="external-link" href="http://www.mongodb.org/display/DOCS/Updating#Updating-ModifierOperations"
rel="nofollow">$modifiers</a>, which will execute the update at the server-side instead.
You can enable the upsert flag, in which case if an insert is required, MongoDB will apply
the $modifiers to the filter query object and insert the result.</li></ol><p>For
example:</p><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[from(&quot;direct:insert&quot;)
     .to(&quot;mongodb:myDb?database=flights&amp;collection=tickets&amp;operation=save&quot;);
 ]]></script>



Mime
View raw message