Changes between Version 4 and Version 5 of MappingDecorator

Timestamp:

2011-02-14T10:24:19+01:00 (13 years ago)

Author:

jvelde

Comment:

--

MappingDecorator

@@ -2 +2 @@
 You can customize the way entities are added, updated or removed by the database logic by adding decorator classes. Start by adding a decorator your your entity:
 
-`<entity name="Example" decorator="decorators.ExampleDecorator">`[[BR]][[BR]]This will put a template decorator '!ExampleDecorator.java' in a package 'decorators' in your Java source folder. If you open this file, you will notice three functions:[[BR]][[BR]]`public int add(List<E> entities)public int update(List<E> entities)public int remove(List<E> entities)`[[BR]][[BR]]Each of these functions can be customized with new pre-, post- and database action behaviour, in a sequential layout:[[BR]][[BR]]`// add your pre-processing here// here we call the standard 'add'int count = super.add(entities);// add your post-processing here// if you throw an exception the previous add will be rolled back`
+{{{
+<entity name="Example" decorator="decorators.ExampleDecorator">
+}}}
+
+This will put a template decorator '!ExampleDecorator.java' in a package 'decorators' in your Java source folder. If you open this file, you will notice three functions:
+
+{{{
+public int add(List<E> entities)
+public int update(List<E> entities)
+public int remove(List<E> entities)
+}}}
+
+Each of these functions can be customized with new pre-, post- and database action behaviour, in a sequential layout:
+
+{{{
+// add your pre-processing here
+
+// here we call the standard 'add'
+int count = super.add(entities);
+
+// add your post-processing here
+// if you throw an exception the previous add will be rolled back
+}}}
 
 == Example ==
-For example, change the value of the field 'name' by turning it into uppercase before adding:[[BR]][[BR]]`public int add(List<E> entities) throws DatabaseException{    try{        for (Entity e : entities){                    e.set("name", e.get("name").toString().toUpperCase());            }    } catch (ParseException pe) {        throw new DatabaseException(pe);    }        int count = super.add(entities);        return count;}`
+For example, change the value of the field 'name' by turning it into uppercase before adding:
+
+{{{
+public int add(List<E> entities) throws DatabaseException{
+    try{
+        for (Entity e : entities){
+            e.set("name", e.get("name").toString().toUpperCase());
+        }
+    } catch (ParseException pe) {
+        throw new DatabaseException(pe);
+    }
+    int count = super.add(entities);
+    return count;
+}
+}}}
 
 Remember the functions get a list of entities which can be adressed in the most low-level form (org.molgenis.util.Entity) as shown in the example. However, usually you want to use the generated class for this decorator to use its field functions, so the previous example becomes:
 
-` for (``Example`` e : entities){``    ``e.setName(e.getName().toUpperCase());``}`
+{{{
+for (Example e : entities){
+    e.setName(e.getName().toUpperCase());
+}
+}}}
 
 Which makes more sense!