svn commit: r1185353 - in /camel/branches/camel-2.8.x: ./ components/camel-cxf/src/main/java/org/apache/camel/component/cxf/CxfPayload.java

[dkulp]

Author: dkulp
Date: Mon Oct 17 20:22:50 2011
New Revision: 1185353

URL: http://svn.apache.org/viewvc?rev=1185353&view=rev
Log:
Merged revisions 1185302 via svnmerge from 
https://svn.apache.org/repos/asf/camel/trunk

........
  r1185302 | dkulp | 2011-10-17 13:38:04 -0400 (Mon, 17 Oct 2011) | 1 line
  
  Add some javadocs to note streaming issues
........

Modified:
    camel/branches/camel-2.8.x/   (props changed)
    
camel/branches/camel-2.8.x/components/camel-cxf/src/main/java/org/apache/camel/component/cxf/CxfPayload.java

Propchange: camel/branches/camel-2.8.x/
            ('svn:mergeinfo' removed)

Propchange: camel/branches/camel-2.8.x/
------------------------------------------------------------------------------
Binary property 'svnmerge-integrated' - no diff available.

Modified: 
camel/branches/camel-2.8.x/components/camel-cxf/src/main/java/org/apache/camel/component/cxf/CxfPayload.java
URL: 
http://svn.apache.org/viewvc/camel/branches/camel-2.8.x/components/camel-cxf/src/main/java/org/apache/camel/component/cxf/CxfPayload.java?rev=1185353&r1=1185352&r2=1185353&view=diff
==============================================================================
--- 
camel/branches/camel-2.8.x/components/camel-cxf/src/main/java/org/apache/camel/component/cxf/CxfPayload.java
 (original)
+++ 
camel/branches/camel-2.8.x/components/camel-cxf/src/main/java/org/apache/camel/component/cxf/CxfPayload.java
 Mon Oct 17 20:22:50 2011
@@ -119,7 +119,10 @@ public class CxfPayload<T> {
     }
 
     /**
-     * Gets the body as a List of source objects
+     * Gets the body as a List of source objects.   If possible, the Source 
objects
+     * will likely be StaxSource or similar that allows streaming.   If you 
plan to 
+     * modify or use the Source, be careful that the result is still usable by
+     * the Camel runtime.
      * @return
      */
     public List<Source> getBodySources() {
@@ -130,6 +133,13 @@ public class CxfPayload<T> {
         return headers;
     }
     
+    /**
+     * Returns the contents as a String
+     * Important notes:
+     *   1) This requires the message to be fully loaded breaking the streaming
+     *   2) For large messages, the result can be a VERY large String and 
require
+     *   large amounts of memory.
+     */
     public String toString() {
         XmlConverter converter = new XmlConverter();
         StringBuilder buf = new StringBuilder();