[jboss-svn-commits] JBL Code SVN: r12435 - labs/jbossesb/trunk/product/core/rosetta/src/org/jboss/soa/esb/message.

[jboss-svn-commits at lists.jboss.org]

Author: mark.little at jboss.com
Date: 2007-06-09 15:13:39 -0400 (Sat, 09 Jun 2007)
New Revision: 12435

Modified:
   labs/jbossesb/trunk/product/core/rosetta/src/org/jboss/soa/esb/message/Body.java
Log:
http://jira.jboss.com/jira/browse/JBESB-612

Modified: labs/jbossesb/trunk/product/core/rosetta/src/org/jboss/soa/esb/message/Body.java
===================================================================
--- labs/jbossesb/trunk/product/core/rosetta/src/org/jboss/soa/esb/message/Body.java	2007-06-09 19:13:22 UTC (rev 12434)
+++ labs/jbossesb/trunk/product/core/rosetta/src/org/jboss/soa/esb/message/Body.java	2007-06-09 19:13:39 UTC (rev 12435)
@@ -79,8 +79,11 @@
 	 * Add the specified Object to the body.
 	 * 
 	 * @param name
-	 *            The name of the object. MUST be unique within this body.  If null,
-     *            the object will be stored under the {@link Body#DEFAULT_LOCATION default name}.
+	 *            The name of the object. MUST be unique within this body. If null
+	 *            then an exception will be thrown. This is to make sure that some
+	 *            computational errors don't arbitrarily resolve to data within the message body that could
+	 *            then be misinterpreted. If someone wants to go with the default name
+	 *            then they can either use add(value) or explicitly use the default name.
 	 * @param value
 	 *            The Object to add.
 	 */
@@ -100,8 +103,11 @@
 	 * Get the specified Object, or <code>null</code> if not present.
 	 * 
 	 * @param name
-	 *            the name of the Object to retrieve.  If null,
-     *            the object will be looked for under the {@link Body#DEFAULT_LOCATION default name}.
+	 *            the name of the Object to retrieve.  If null
+	 *            then an exception will be thrown. This is to make sure that some
+	 *            computational errors don't arbitrarily resolve to data within the message body that could
+	 *            then be misinterpreted. If someone wants to go with the default name
+	 *            then they can either use add(value) or explicitly use the default name.
 	 * @return the Object.
 	 */