svn commit: r929703 - in /websites/staging/isis/trunk: cgi-bin/ content/ content/tutorials/apacheconeu-2014.html

[bu...@apache.org]

Author: buildbot
Date: Tue Nov 18 23:12:38 2014
New Revision: 929703

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:12:38 2014
@@ -1 +1 @@
-1640452
+1640453

Propchange: websites/staging/isis/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Tue Nov 18 23:12:38 2014
@@ -1 +1 @@
-1640452
+1640453

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:12:38 2014
@@ -562,7 +562,7 @@ mvn clean install
 
 <h1>Build a domain app</h1>
 
-<p>The remainder of the tutorial provides guidance on building a domain application.  We'd rather you build your own app, but if you're not feeling inspired, you could have a go at building our petclinic app.  Here's the design:</p>
+<p>The remainder of the tutorial provides guidance on building a domain application.  We'd rather you build your own app, but if you're not feeling inspired, you could have a go at building our "petclinic" app.  Here's the design:</p>
 
 <p><img src="http://yuml.me/a070d071" alt="" /></p>
 
@@ -578,8 +578,14 @@ mvn clean install
 <p>Most domain objects in Apache Isis applications are persistent entities.</p>
 
 <ul>
-<li>rename the <code>SimpleObject</code> class</li>
-<li>rename the <code>SimpleObject</code> class' <code>name</code> property</li>
+<li>rename the <code>SimpleObject</code> class
+<ul>
+<li>eg rename to <code>Pet</code></li>
+</ul></li>
+<li>if required, rename the <code>SimpleObject</code> class' <code>name</code> property
+<ul>
+<li>for <code>Pet</code>, can leave <code>name</code> property as is</li>
+</ul></li>
 <li>specify a <a href="http://isis.apache.org/how-tos/how-to-01-040-How-to-specify-a-title-for-a-domain-entity.html">title</a></li>
 <li>specify an <a href="http://isis.apache.org/how-tos/how-to-01-070-How-to-specify-the-icon-for-a-domain-entity.html">icon</a></li>
 <li>add the <a href="http://isis.apache.org/reference/recognized-annotations/Bookmarkable.html">@Bookmarkable</a> annotation
@@ -593,17 +599,29 @@ mvn clean install
 <p>Domain services either act as factories or repositories to entities, or (more generally) can be used to "bridge across" to other domains/bounded contexts.  Most are application-scoped, but they can also be request-scoped if required.</p>
 
 <ul>
-<li>rename the <code>SimpleObjects</code> class</li>
+<li>rename the <code>SimpleObjects</code> class
+<ul>
+<li>eg rename to <code>Pets</code></li>
+</ul></li>
 <li>review <code>create</code> action (acting as a factory)
 <ul>
 <li>as per our <a href="http://isis.apache.org/how-tos/how-to-01-160-How-to-create-or-delete-objects-within-your-code.html">docs</a></li>
+<li>rename if you wish</li>
+<li>eg <code>newPet(...)</code> or <code>addPet(...)</code></li>
 </ul></li>
 <li>review <code>listAll</code> action (acting as a repository)
 <ul>
 <li>as per our <a href="http://isis.apache.org/how-tos/how-to-09-040-How-to-write-a-custom-repository.html">docs</a></li>
-<li>note the annotations on the corresponding domain class (originally called <code>SimpleObject</code>, though renamed by now)</li>
+<li>note the annotations on the corresponding domain class (originally called <code>SimpleObject</code>, though renamed by now, eg to <code>Pet</code>)</li>
+<li>rename if you wish</li>
+<li>eg <code>listPets()</code></li>
 </ul></li>
 <li>note the <code>@DomainService</code> annotation</li>
+<li>optional: add an action to a return subset of objects
+<ul>
+<li>use <code>@Query</code> annotation</li>
+<li>see for example the todo app, see <a href="https://github.com/apache/isis/blob/b3e936c9aae28754fb46c2df52b1cb9b023f9ab8/example/application/todoapp/dom/src/main/java/dom/todo/ToDoItem.java#L93">here</a> and <a href="https://github.com/apache/isis/blob/b3e936c9aae28754fb46c2df52b1cb9b023f9ab8/example/application/todoapp/dom/src/main/java/dom/todo/ToDoItems.java#L63">here</a></li>
+</ul></li>
 </ul>
 
 <h2>Fixture scripts</h2>