Author: buildbot
Date: Tue Nov 18 23:06:59 2014
New Revision: 929702
Log:
Staging update by buildbot for isis
Modified:
websites/staging/isis/trunk/cgi-bin/ (props changed)
websites/staging/isis/trunk/content/ (props changed)
websites/staging/isis/trunk/content/tutorials/apacheconeu-2014.html
Propchange: websites/staging/isis/trunk/cgi-bin/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Tue Nov 18 23:06:59 2014
@@ -1 +1 @@
-1640449
+1640452
Propchange: websites/staging/isis/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Tue Nov 18 23:06:59 2014
@@ -1 +1 @@
-1640449
+1640452
Modified: websites/staging/isis/trunk/content/tutorials/apacheconeu-2014.html
==============================================================================
--- websites/staging/isis/trunk/content/tutorials/apacheconeu-2014.html
(original)
+++ websites/staging/isis/trunk/content/tutorials/apacheconeu-2014.html Tue Nov
18 23:06:59 2014
@@ -624,7 +624,7 @@ mvn clean install
<h2>Actions</h2>
-<p>Most business functionality is implemented using actions... basically a
<code>public</code> method accepting domain classes and primitives as its
parameter types.</p>
+<p>Most business functionality is implemented using actions... basically a
<code>public</code> method accepting domain classes and primitives as its
parameter types. The action can return a domain entity, or a collection of
entities, or a primitive/String/value, or void. If a domain entity is returned
then that object is rendered immediately; if a collection is returned then the
Wicket viewer renders a table. Such collections are sometimes called
"standalone" collections.</p>
<ul>
<li>write an action to update the domain property (originally called
<code>SimpleObject#name</code>, though renamed by now)</li>
@@ -670,6 +670,8 @@ mvn clean install
<h2>Value properties</h2>
+<p>Domain entities have state: either values (primitives, strings) or
references to other entities. In this section we explore adding some value
properties</p>
+
<ul>
<li>add some <a
href="http://isis.apache.org/how-tos/how-to-01-030-How-to-add-a-property-to-a-domain-entity.html";>value
properties</a>; also:
<ul>
@@ -680,8 +682,8 @@ mvn clean install
<li>use <a
href="http://isis.apache.org/components/objectstores/jdo/mapping-bigdecimals.html";>bigdecimals</a>
properties</li>
<li>use <a
href="http://isis.apache.org/components/objectstores/jdo/mapping-blobs.html";>blob/clobs</a>
properties</li>
<li>specify whether <a
href="http://isis.apache.org/components/objectstores/jdo/mapping-mandatory-and-optional-properties.html";>optional
or mandatory</a></li>
+<li>enums (eg as used in the example Todo app, see <a
href="https://github.com/apache/isis/blob/b3e936c9aae28754fb46c2df52b1cb9b023f9ab8/example/application/todoapp/dom/src/main/java/dom/todo/ToDoItem.java#L207";>here</a>
and <a
href="https://github.com/apache/isis/blob/b3e936c9aae28754fb46c2df52b1cb9b023f9ab8/example/application/todoapp/dom/src/main/java/dom/todo/ToDoItem.java#L266";>here</a></li>
</ul></li>
-<li>TODO: enums</li>
<li>update the corresponding domain service for creating new instances
<ul>
<li>for all non-optional properties will either need to prompt for a value, or
calculate some suitable default</li>
@@ -698,6 +700,8 @@ mvn clean install
<h2>Reference properties</h2>
+<p>Domain entities can also reference other domain entities. These references
may be either scalar (single-valued) or vector (multi-valued). In this section
we focus on scalar reference properties.</p>
+
<ul>
<li>add some <a
href="http://isis.apache.org/how-tos/how-to-01-030-How-to-add-a-property-to-a-domain-entity.html";>reference
properties</a></li>
<li>update the corresponding domain service</li>
@@ -712,12 +716,16 @@ mvn clean install
<h2>Usability: Defaults</h2>
+<p>Quick detour: often we want to set up defaults to go with choices. A
sensible default can really improve the usability of the app.</p>
+
<ul>
<li>Add <a
href="http://isis.apache.org/how-tos/how-to-03-050-How-to-specify-default-values-for-an-action-parameter.html";>defaults</a>
for action parameters</li>
</ul>
<h2>Collections</h2>
+<p>Returning back to references, Isis also supports vector (multi-valued)
references to another object instances... in other words collections. We
sometimes called these "parented" collections (to distinguish from a
"standalone" collection as returned from an action)</p>
+
<ul>
<li>Ensure that all domain classes implement <code>java.lang.Comparable</code>
<ul>
