Changes between Version 10 and Version 11 of PRO_LIB_UTILS_R0

Timestamp:

12/10/08 13:54:42 (17 years ago)

Author:

orliin

Comment:

--

PRO_LIB_UTILS_R0

@@ -25 +25 @@
 
 = Design =
- * Assign
+ * Assign - public static <T extends !ProObject> void assign(T dest, T source)
+The assign() method should copy the values of all properties of the source !ProObject to the destionation !ProObject. It should be a "smart" copy, so for each property should be decided how to be copied.
+
+Implementation can just call a private assign() method that works for a particular property and can decide how to copy it.
+
+ * Clone - public static <T extends !ProObject> T clone(T src)
+The clone() method should make a new !ProObject instance which is a copy of the original object. The properties in the new instance have their values assigned from the original object.
+
+Implementation can just make a new !ProObject instance and then call the assign() method to copy all property values from the original to the new instance.
+
+ * Single property assign - private static <T extends !ProObject> void assign(!ProObject dest, !ProObject source, String propId)
 The assign() method should take care about property types and annotations to decide what to do when trying to copy data. Here are all the cases:
 ||property types||relation/annotation||value class||value action||comment||
@@ -46 +56 @@
 ||!AutoListProperty ||   --> ||  -->     ||none      ||do nothing||
 
-Implementation should just add these cases to the assign() method in the !ProUtil class.
-
- * Cloning
-The clone() method should make a new !ProObject instance which is a copy of the original object. The properties in the new instance are assigned their values via the assign() method.
+ * New annotation - @Shared
+A new annotation should be created. This annotation is for the smart copying of objects. If a property is marked as @Shared, this means that the value it holds should be the same for all objects using this property. In other words, when copying such property the new property should hold a reference to the value, not a clone of the value.
 
  * Tests
-org.sophie2.core.prolib.util.ProUtilTest.java
+org.sophie2.core.prolib.util.!ProUtilTest
 
 = Implementation =