You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by rd...@apache.org on 2002/12/01 23:38:27 UTC
cvs commit: jakarta-commons/beanutils/src/java/org/apache/commons/beanutils BeanUtils.java PropertyUtils.java
rdonkin 2002/12/01 14:38:27
Modified: beanutils/src/java/org/apache/commons/beanutils
BeanUtils.java PropertyUtils.java
Log:
Improved java docs so that users are less likely to mistake the way that copyProperties is supposed to work.
Revision Changes Path
1.28 +8 -6 jakarta-commons/beanutils/src/java/org/apache/commons/beanutils/BeanUtils.java
Index: BeanUtils.java
===================================================================
RCS file: /home/cvs/jakarta-commons/beanutils/src/java/org/apache/commons/beanutils/BeanUtils.java,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -r1.27 -r1.28
--- BeanUtils.java 19 Nov 2002 20:20:08 -0000 1.27
+++ BeanUtils.java 1 Dec 2002 22:38:27 -0000 1.28
@@ -178,9 +178,11 @@
* silently ignored.</p>
*
* <p>If the origin "bean" is actually a <code>Map</code>, it is assumed
- * to contain String-valued simple property names as the keys, pointing at
+ * to contain String-valued <strong>simple</strong> property names as the keys, pointing at
* the corresponding property values that will be converted (if necessary)
- * and set in the destination bean.</p>
+ * and set in the destination bean. <strong>Note</strong> that this method
+ * is intended to perform a "shallow copy" of the properties and so complex
+ * properties (for example, nested ones) will not be copied.</p>
*
* <p>This method differs from <code>populate()</code>, which
* was primarily designed for populating JavaBeans from the map of request
1.35 +8 -6 jakarta-commons/beanutils/src/java/org/apache/commons/beanutils/PropertyUtils.java
Index: PropertyUtils.java
===================================================================
RCS file: /home/cvs/jakarta-commons/beanutils/src/java/org/apache/commons/beanutils/PropertyUtils.java,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -r1.34 -r1.35
--- PropertyUtils.java 26 Nov 2002 21:28:46 -0000 1.34
+++ PropertyUtils.java 1 Dec 2002 22:38:27 -0000 1.35
@@ -232,9 +232,11 @@
* the destination bean.</p>
*
* <p>If the origin "bean" is actually a <code>Map</code>, it is assumed
- * to contain String-valued simple property names as the keys, pointing
+ * to contain String-valued <strong>simple</strong> property names as the keys, pointing
* at the corresponding property values that will be set in the destination
- * bean.</p>
+ * bean.<strong>Note</strong> that this method is intended to perform
+ * a "shallow copy" of the properties and so complex properties
+ * (for example, nested ones) will not be copied.</p>
*
* @param dest Destination bean whose properties are modified
* @param orig Origin bean whose properties are retrieved
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>