You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by bu...@apache.org on 2013/06/13 09:27:14 UTC
svn commit: r865516 - in /websites/staging/isis/trunk: cgi-bin/ content/
content/applib-guide/how-tos/about.html
content/getting-started/editor-templates.html
content/getting-started/quickstart-archetype.html
Author: buildbot
Date: Thu Jun 13 07:27:13 2013
New Revision: 865516
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/applib-guide/how-tos/about.html
websites/staging/isis/trunk/content/getting-started/editor-templates.html
websites/staging/isis/trunk/content/getting-started/quickstart-archetype.html
Propchange: websites/staging/isis/trunk/cgi-bin/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Thu Jun 13 07:27:13 2013
@@ -1 +1 @@
-1492280
+1492551
Propchange: websites/staging/isis/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Thu Jun 13 07:27:13 2013
@@ -1 +1 @@
-1492280
+1492551
Modified: websites/staging/isis/trunk/content/applib-guide/how-tos/about.html
==============================================================================
--- websites/staging/isis/trunk/content/applib-guide/how-tos/about.html (original)
+++ websites/staging/isis/trunk/content/applib-guide/how-tos/about.html Thu Jun 13 07:27:13 2013
@@ -252,6 +252,9 @@
</h1>
</div>
+<p><div class="note">
+A lot of the programming conventions described in these how-tos are encapsulated in the <a href="../../editor-templates.html">Eclipse templates</a>. If you use Eclipse, do install these first; they will save a lot of time.</div></p>
+
<h2>How to write a basic Domain Entity or Service</h2>
<p>Domain entities are instances of some class, usually (the vast majority)
Modified: websites/staging/isis/trunk/content/getting-started/editor-templates.html
==============================================================================
--- websites/staging/isis/trunk/content/getting-started/editor-templates.html (original)
+++ websites/staging/isis/trunk/content/getting-started/editor-templates.html Thu Jun 13 07:27:13 2013
@@ -252,18 +252,24 @@
</h1>
</div>
-<p>The following Java editor templates (for Eclipse) provide snippets to speed up w
-riting domain objects and unit testing:</p>
+<p>The following Java editor templates (for Eclipse) provide snippets to speed up writing domain objects and unit testing</p>
<ul>
-<li><code>Windows > Preferences > Java > Editor > Templates</code>
-<ul>
<li><a href="resources/isis-templates.xml">Isis domain object snippets</a></li>
<li><a href="resources/junit4-templates.xml">JUnit snippets</a></li>
<li><a href="resources/jmock2-templates.xml">JMock templates</a></li>
-</ul></li>
</ul>
+<p>To install, go to <code>Windows > Preferences > Java > Editor > Templates</code> and choose <code>Import</code>.</p>
+
+<p>Each of these template defined in these teamplate files has a common prefix so you can easily find them.</p>
+
+<p>For example, the Isis templates all have the prefix "<code>is</code>"; simply enter "is" and press ctrl+space to get the list of templates starting with "is" where you will find those related to Isis.</p>
+
+<p>Similarly, the JUnit templates are prefixed "<code>ju</code>".</p>
+
+<p>And the JMock templates are prefixed "<code>jm</code>".</p>
+
</div>
Modified: websites/staging/isis/trunk/content/getting-started/quickstart-archetype.html
==============================================================================
--- websites/staging/isis/trunk/content/getting-started/quickstart-archetype.html (original)
+++ websites/staging/isis/trunk/content/getting-started/quickstart-archetype.html Thu Jun 13 07:27:13 2013
@@ -333,7 +333,13 @@ mvn jetty:run
<p>The app itself is configured to run using shiro security, as configured in the <code>WEB-INF/shiro.ini</code> config file. To log in, use <code>sven/pass</code>.</p>
-<h3>App Structure</h3>
+<h3>Modifying the App</h3>
+
+<p>Once you are familiar with the generated app, you'll want to start modifying it. There is plenty of guidance on this site (check out the <a href="../documentation.html">getting started</a> section first).</p>
+
+<p>If you use Eclipse, do also install the <a href="../editor-templates.html">Eclipse templates</a>; these will help you follow the Isis naming conventions. </p>
+
+<h4>App Structure</h4>
<p>As noted above, the generated app is a very simple application consisting of a single domain object for tracking to-do items. The intention is not to showcase all of Isis' capabilities; rather it is to allow you to very easily modify the generated application (eg rename <code>ToDoItem</code> to <code>Customer</code>) without having to waste time deleting lots of generated code.</p>
@@ -342,8 +348,9 @@ mvn jetty:run
<tr><td>myapp</td><td>The parent (aggregator) module</td></tr>
<tr><td>myapp-dom</td><td>The domain object model, consisting of <tt>ToDoItem</tt> and <tt>ToDoItems</tt> (repository) interface.</td></tr>
<tr><td>myapp-fixture</td><td>Domain object fixtures used for initializing the system when being demo'ed or for unit testing.</td></tr>
+<tr><td>myapp-integtests</td><td>End-to-end <a href="../core/integtestsupport.html">integration tests</a>, that exercise from the UI through to the database</td></tr>
<tr><td>myapp-objstore-jdo</td><td>Implementation of <tt>ToDoItems</tt> repository, using JDO objectstore.</td></tr>
-<tr><td>myapp-viewer-webapp</td><td>Run as a webapp (from <tt>web.xml</tt>) using either the Wicket viewer or the RestfulObjects viewer</td></tr>
+<tr><td>myapp-webapp</td><td>Run as a webapp (from <tt>web.xml</tt>) using either the Wicket viewer or the RestfulObjects viewer</td></tr>
</table>
<p>If you run into issues, please don't hesitate to ask for help on the <a href="../support.html">users mailing list</a>.</p>