Changes between Version 2 and Version 3 of GROUP_TEMPLATES_R1

Timestamp:

05/21/09 12:11:15 (16 years ago)

Author:

jani

Comment:

--

GROUP_TEMPLATES_R1

@@ -40 +40 @@
  * Create another page and apply the newly created template to it.
 = Design =
-^(Describe your design here.)^
+The goal of this revision is to make the templating library simplier. For example, in the previous revision it was possible 
+to have a derived object with local changes, which greatly increased complexity. 
+Also, instead of having useTemplate() and locked() properties, an enumeration TemplateMode should be introduced, with the following elements:
+ * USE_TEMPLATE - the value from the template is used
+ * LOCKED - the own value is used and it cannot be modified
+ * CUSTOM - the own value is used and it can be modified.
+Also, when setting a value to a mutable object, for instance Frame, it should be set to all children recursevly - for example backgroundStyle(), borderStyle(), contentLocation(), etc.
+Setting a value to a mutable object, actually does not change its mode in its own TemplateSupport - instead it is only changed in the children. This should insure that there cannot be derived mutable objects.
+ 
+A new interface Templatable should be added, which contains the templateSupport() property. All classes need template support should implement this interface.
+
+Class TemplateField should be rafactored in a way that the TemplateMode enumeration is used.
+
+Class TemplateValueField should be refactored in the following way:
+ * value() should always return ownValue() if the object is a mutable
+ * derivedValue() should only return immutables
+ 
+Class TemplateListField should be refactored in a way that either the ownList or derivedList is returned, depending on the mode.
+
+Class TemplateSupport should be rafactored in a way that the TemplateMode enumeration is used.
+
+Updated UML class diagram:
+
+[[Image(source:branches/private/jani/sophie2-platform/doc/uml-design-diagrams/TemplateR1ClassDiagram.png)]]
+
+Unit test: [source:/trunk/sophie2-platform/modules/org.sophie2.base.model.book/src/test/java/org/sophie2/base/model/book/template/TemplateTest.java TemplateTest]
+
+Integration test: [source:/branches/private/jani/sophie2-platform/modules/org.sophie2.base.model.book/src/test/java/org/sophie2/base/model/book/template/TemplateIntegrationTest.java TemplateIntegrationTest]
+
+Demo: [source:/branches/private/jani/sophie2-platform/modules/org.sophie2.base.model.book/src/test/java/org/sophie2/base/model/book/template/TemplateDemo.java TemplateDemo]
 
 = Implementation =