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 2014/10/14 07:38:41 UTC
svn commit: r925697 - in /websites/staging/isis/trunk: cgi-bin/ content/
content/components/objectstores/jdo/non-ui/
content/components/objectstores/jdo/services/
Author: buildbot
Date: Tue Oct 14 05:38:41 2014
New Revision: 925697
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/components/objectstores/jdo/non-ui/background-command-execution-jdo.html
websites/staging/isis/trunk/content/components/objectstores/jdo/services/background-command-service-jdo.html
websites/staging/isis/trunk/content/components/objectstores/jdo/services/event-bus-service-jdo.html
websites/staging/isis/trunk/content/components/objectstores/jdo/services/exception-recognizers-jdo.html
websites/staging/isis/trunk/content/components/objectstores/jdo/services/publishing-service-jdo.html
websites/staging/isis/trunk/content/components/objectstores/jdo/services/settings-services-jdo.html
websites/staging/isis/trunk/content/documentation.html
Propchange: websites/staging/isis/trunk/cgi-bin/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Tue Oct 14 05:38:41 2014
@@ -1 +1 @@
-1631624
+1631626
Propchange: websites/staging/isis/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Tue Oct 14 05:38:41 2014
@@ -1 +1 @@
-1631624
+1631626
Modified: websites/staging/isis/trunk/content/components/objectstores/jdo/non-ui/background-command-execution-jdo.html
==============================================================================
--- websites/staging/isis/trunk/content/components/objectstores/jdo/non-ui/background-command-execution-jdo.html (original)
+++ websites/staging/isis/trunk/content/components/objectstores/jdo/non-ui/background-command-execution-jdo.html Tue Oct 14 05:38:41 2014
@@ -423,9 +423,15 @@
</h1>
</div>
-<p>The <code>BackgroundCommandExecutionFromBackgroundCommandServiceJdo</code> is a concrete subclass of <a href="../../../../reference/non-ui/background-command-execution.html">BackgroundCommandExecution</a>. The intended use is for the class to be instantiated regularly (eg every 10 seconds) by a scheduler such as <a href="http://quartz.org">Quartz</a>) to poll for <code>Command</code>s to be executed, and then execute them. As you might imagine, this implementation queries for <code>Command</code>s persisted by the JDO implementations of <a href="../services/command-service-jdo.html">CommandService</a> and <a href="../services/background-command-service-jdo.html">BackgroundCommandService</a>, using the <code>BackgroundCommandServiceJdoRepository</code>.</p>
+<p><div class="note">
+In 1.6.0 this implementation was released as part of <em>org.apache.isis.core:isis-module-command-jdo:1.6.0</em> and was also released as an <a href="http://github.com/isisaddons/isis-module-command">Isis addon</a> module. <strong>In 1.7.0+ only the <a href="http://github.com/isisaddons/isis-module-command">Isis addon</a> implementation is released.</strong>
+</div></p>
-<p>The diagram below shows how the inheritance hierarchy for this class:</p>
+<p>The <code>BackgroundCommandExecutionFromBackgroundCommandServiceJdo</code> is a concrete subclass of <a href="../../../../reference/non-ui/background-command-execution.html">BackgroundCommandExecution</a>. The intended use is for the class to be instantiated regularly (eg every 10 seconds) by a scheduler such as <a href="http://quartz.org">Quartz</a>) to poll for <code>Command</code>s to be executed, and then execute them. </p>
+
+<p>As you might imagine, this implementation queries for <code>Command</code>s persisted by the JDO implementations of <a href="../services/command-service-jdo.html">CommandService</a> and <a href="../services/background-command-service-jdo.html">BackgroundCommandService</a>, using the <code>BackgroundCommandServiceJdoRepository</code>.</p>
+
+<p>The diagram below shows the inheritance hierarchy for this class:</p>
<p><img src="http://yuml.me/363b335f" alt="" /></p>
Modified: websites/staging/isis/trunk/content/components/objectstores/jdo/services/background-command-service-jdo.html
==============================================================================
--- websites/staging/isis/trunk/content/components/objectstores/jdo/services/background-command-service-jdo.html (original)
+++ websites/staging/isis/trunk/content/components/objectstores/jdo/services/background-command-service-jdo.html Tue Oct 14 05:38:41 2014
@@ -423,6 +423,9 @@
</h1>
</div>
+<p><div class="note">
+In 1.6.0 this implementation was released as part of <em>org.apache.isis.core:isis-module-command-jdo:1.6.0</em> and was also released as an <a href="http://github.com/isisaddons/isis-module-command">Isis addon</a> module. <strong>In 1.7.0+ only the <a href="http://github.com/isisaddons/isis-module-command">Isis addon</a> implementation is released.</strong></div></p>
+
<p>The JDO objectstore provides an implementation of the applib <a href="../../../../reference/services/background-service.html">BackgroundCommandService</a> that persists the command data into a <code>CommandJdo</code> entity. This is mapped to an <code>IsisCommand</code> table.</p>
<p>There are two further services that can be used:</p>
Modified: websites/staging/isis/trunk/content/components/objectstores/jdo/services/event-bus-service-jdo.html
==============================================================================
--- websites/staging/isis/trunk/content/components/objectstores/jdo/services/event-bus-service-jdo.html (original)
+++ websites/staging/isis/trunk/content/components/objectstores/jdo/services/event-bus-service-jdo.html Tue Oct 14 05:38:41 2014
@@ -423,11 +423,17 @@
</h1>
</div>
+<h2>1.6.0+</h2>
+
+<p>This service implementation is the default and is automatically registered using <code>@DomainService</code>. No further configuration is necessary.</p>
+
+<h2>1.5.0 and previous</h2>
+
<p>To use the <a href="../../../../reference/services/event-bus-service.html">EventBusService</a> with the JDO Object Store, the JDO-specific implementation should be registered.</p>
<p>The JDO implementation does not provide any additional functionality, but is aware of the lifecycle of domain entities and so ensures that objects are not interacted with while they are being rehydrated by the object store.</p>
-<h2>Register the Service</h2>
+<h4>Register the Service</h4>
<p>Register this service like any other service, in <code>isis.properties</code>:</p>
Modified: websites/staging/isis/trunk/content/components/objectstores/jdo/services/exception-recognizers-jdo.html
==============================================================================
--- websites/staging/isis/trunk/content/components/objectstores/jdo/services/exception-recognizers-jdo.html (original)
+++ websites/staging/isis/trunk/content/components/objectstores/jdo/services/exception-recognizers-jdo.html Tue Oct 14 05:38:41 2014
@@ -425,16 +425,24 @@
<p>The JDO objectstore provides a number of implementations of the applib <a href="../../../../reference/services/exception-recognizers.html">ExceptionRecognizer</a> API that will recognize SQL constraint exceptions and convert them into user-friendly error messages. The <code>ExceptionRecognizerCompositeForJdoObjectStore</code> wraps these up into a single implementation.</p>
-<h3>Register the Service</h3>
+<h2>Register the Service</h2>
-<p>Register like any other service in <code>isis.properties</code>:</p>
+<p>These service must be registered in <code>isis.properties</code>:</p>
<pre><code>isis.services=...,\
org.apache.isis.objectstore.jdo.applib.service.exceprecog.ExceptionRecognizerCompositeForJdoObjectStore,\
...
</code></pre>
-<p>Alternatively, create your own implementations, for example based upon the vagaries of the JDBC driver in use. More than one implementation of <code>ExceptionRecognizer</code> can be registered; all we be checked if an exception is thrown.</p>
+<p>(In many cases this will be the only service registered in <code>isis.properties</code>).</p>
+
+<h2>Checking for additional exceptions.</h2>
+
+<p>If you want to recognize and handle additional exceptions (for example to capture error messages specific to the JDBC driver you might be using), then the recommended approach is to:
+* create a fine-grained implementation of <code>ExceptionRecognizer</code> for the particular error message (there are some convenience implementations of the interface that you can subclass from if required)
+* register your implementation in <code>isis.properties</code>. More than one implementation of <code>ExceptionRecognizer</code> can be registered; all we be checked if an exception is thrown.</p>
+
+<p>Alternatively, if you prefer to register just a single <code>ExceptionRecognizer</code> service class, you could create a composite implementation that bundles up your fine-grained implementation; see the above <code>ExceptionRecognizerCompositeForJdoObjectStore</code> for inspiration.</p>
Modified: websites/staging/isis/trunk/content/components/objectstores/jdo/services/publishing-service-jdo.html
==============================================================================
--- websites/staging/isis/trunk/content/components/objectstores/jdo/services/publishing-service-jdo.html (original)
+++ websites/staging/isis/trunk/content/components/objectstores/jdo/services/publishing-service-jdo.html Tue Oct 14 05:38:41 2014
@@ -423,6 +423,9 @@
</h1>
</div>
+<p><div class="note">
+In 1.6.0 this implementation was released as part of <em>org.apache.isis.core:isis-module-publishing-jdo:1.6.0</em> and was also released as an <a href="http://github.com/isisaddons/isis-module-publishing">Isis addon</a> module. <strong>In 1.7.0+ only the <a href="http://github.com/isisaddons/isis-module-publishing">Isis addon</a> implementation is released.</strong></div></p>
+
<p>The JDO objectstore provides a simple implementation of the applib <a href="../../../../reference/services/publishing-service.html">PublishingService</a> that simply persists the event data into a <code>PublishedEvent</code> entity.</p>
<p>Along with the event data, the <code>PublishedEvent</code> also includes a status property with two values: <code>QUEUED</code> and <code>PROCESSED</code>. The service also acts as a repository to search for all unprocessed events.</p>
Modified: websites/staging/isis/trunk/content/components/objectstores/jdo/services/settings-services-jdo.html
==============================================================================
--- websites/staging/isis/trunk/content/components/objectstores/jdo/services/settings-services-jdo.html (original)
+++ websites/staging/isis/trunk/content/components/objectstores/jdo/services/settings-services-jdo.html Tue Oct 14 05:38:41 2014
@@ -423,6 +423,9 @@
</h1>
</div>
+<p><div class="note">
+In 1.6.0 this implementation was released as part of <em>org.apache.isis.core:isis-module-settings-jdo:1.6.0</em> and was also released as an <a href="http://github.com/isisaddons/isis-module-settings">Isis addon</a> module. <strong>In 1.7.0+ only the <a href="http://github.com/isisaddons/isis-module-settings">Isis addon</a> implementation is released.</strong></div></p>
+
<p>The JDO objectstore provides simple implementations of the two applib <a href="../../../../reference/services/settings-services.html">Settings Services</a>.</p>
<h2>Application Settings</h2>
Modified: websites/staging/isis/trunk/content/documentation.html
==============================================================================
--- websites/staging/isis/trunk/content/documentation.html (original)
+++ websites/staging/isis/trunk/content/documentation.html Tue Oct 14 05:38:41 2014
@@ -778,7 +778,7 @@ summarized <a href="./reference/services
<ul>
<li><a href="./reference/services/background-command-service.html">API</a></li>
-<li><a href="components/objectstores/jdo/services/background-command-service-jdo.html">Implementation</a></li>
+<li><a href="components/objectstores/jdo/services/command-service-jdo.html">Isis addons implementation</a> </li>
<li><a href="./reference/non-ui/background-command-execution.html">Background Execution</a> (<a href="components/objectstores/jdo/non-ui/background-command-execution-jdo.html">Impl</a>)
</div>
<div class="col-md-4"></li>