commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From joe...@apache.org
Subject svn commit: r928453 - /commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/ObjectUtils.java
Date Sun, 28 Mar 2010 17:04:59 GMT
Author: joehni
Date: Sun Mar 28 17:04:59 2010
New Revision: 928453

URL: http://svn.apache.org/viewvc?rev=928453&view=rev
Log:
Improve javadoc

Modified:
    commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/ObjectUtils.java

Modified: commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/ObjectUtils.java
URL: http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/ObjectUtils.java?rev=928453&r1=928452&r2=928453&view=diff
==============================================================================
--- commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/ObjectUtils.java (original)
+++ commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/ObjectUtils.java Sun
Mar 28 17:04:59 2010
@@ -344,7 +344,13 @@ public class ObjectUtils {
     }
 
     /**
-     * Clone an object if possible.
+     * Clone an object if possible. This method is similar to {@link #clone(Object)}, but
will
+     * return the provided instance as return value instead of <code>null</code>
if the instance
+     * is not cloneable. This is convenient in case the caller will use different
+     * implementations (e.g. of a service) and some of the instances do not allow concurrent
+     * processing or have state. In such a case the implementation can simply provide a proper
+     * clone implementation and the caller has not to take care, it will simply call this
method
+     * here.
      * 
      * @param <T> the type of the object
      * @param o the object to clone



Mime
View raw message