You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2015/07/17 18:08:42 UTC

[2/2] isis-site git commit: ISIS-1173: FixtureScriptsSpecificationProvider migration notes

ISIS-1173: FixtureScriptsSpecificationProvider migration notes


Project: http://git-wip-us.apache.org/repos/asf/isis-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis-site/commit/7c96dbb3
Tree: http://git-wip-us.apache.org/repos/asf/isis-site/tree/7c96dbb3
Diff: http://git-wip-us.apache.org/repos/asf/isis-site/diff/7c96dbb3

Branch: refs/heads/asf-site
Commit: 7c96dbb3fe7de850c1e6a82de3093db5a351d61c
Parents: 011f2f7
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Fri Jul 17 17:02:00 2015 +0100
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Fri Jul 17 17:02:00 2015 +0100

----------------------------------------------------------------------
 content/migration-notes.html | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/isis-site/blob/7c96dbb3/content/migration-notes.html
----------------------------------------------------------------------
diff --git a/content/migration-notes.html b/content/migration-notes.html
index a0053b4..b3840ed 100644
--- a/content/migration-notes.html
+++ b/content/migration-notes.html
@@ -841,7 +841,7 @@ isis.persistor.datanucleus.impl.datanucleus.schema.validateConstraints=true</cod
 </div>
 </div>
 <div class="sect2">
-<h3 id="_migration-notes_1.8.0-to-1.9.0_upgrading-to-java8"><code>ExceptionRecognizerCompositeForJdoObjectStore</code></h3>
+<h3 id="_migration-notes_1.8.0-to-1.9.0_exception-recognizer"><code>ExceptionRecognizerCompositeForJdoObjectStore</code></h3>
 <div class="paragraph">
 <p>The <code>ExceptionRecognizerCompositeForJdoObjectStore</code> service (an implementation of the <a href="rg.html#_rg_services-spi_manpage-ExceptionRecognizer"><code>ExceptionRecognizer</code></a> SPI) recognizes certain expected exceptions thrown by the JDO objectstore (for example, violations of uniqueness) and converts them into meaningful messages for the end-user.</p>
 </div>
@@ -914,6 +914,18 @@ isis.persistor.datanucleus.impl.datanucleus.schema.validateConstraints=true</cod
 </div>
 </div>
 <div class="sect2">
+<h3 id="_migration-notes_1.8.0-to-1.9.0_fixture-scripts-specification-provider"><code>FixtureScriptsSpecificationProvider</code></h3>
+<div class="paragraph">
+<p>The <code>FixtureScriptsSpecificationProvider</code> SPI service is an alternative to subclassing the <a href="rg.html#_rg_classes_utility_manpage-FixtureScripts"><code>FixtureScripts</code></a> domain service.  The logic that would normally be in the subclass moves to the provider service instead, and the framework instantiates a fallback default instance, <a href="rg.html#_rg_services-api_manpage-FixtureScriptsDefault"><code>FixtureScriptsDefault</code></a>.</p>
+</div>
+<div class="paragraph">
+<p>This new design is optional; if you continue to provide your own subclass then everything will continue as before.  However the new design is more flexible and involves less code.</p>
+</div>
+<div class="paragraph">
+<p>See <a href="ug.html#_ug_testing_fixture-scripts_api-and-usage">user guide</a> for further discussion.</p>
+</div>
+</div>
+<div class="sect2">
 <h3 id="_migration-notes_1.8.0-to-1.9.0_war-packaging">War packaging</h3>
 <div class="paragraph">
 <p>As discussed in <a href="ug.html#_ug_getting-started_simpleapp-archetype">SimpleApp archetype</a> and elsewhere, the <code>org.apache.isis.WebServer</code> provides the ability to run your app from an embedded jetty.  This is great for prototyping.  The class resides in the <code>isis-core-webserver</code> module, which also has the dependency on jetty.</p>
@@ -1305,7 +1317,8 @@ into the new <code>org.isisaddons.module.settings:isis-module-settings-dom</code
 <li><a href="#_in_the_parent_code_pom_xml_code_2">In the parent <code>pom.xml</code></a></li>
 </ul>
 </li>
-<li><a href="#_migration-notes_1.8.0-to-1.9.0_upgrading-to-java8"><code>ExceptionRecognizerCompositeForJdoObjectStore</code></a></li>
+<li><a href="#_migration-notes_1.8.0-to-1.9.0_exception-recognizer"><code>ExceptionRecognizerCompositeForJdoObjectStore</code></a></li>
+<li><a href="#_migration-notes_1.8.0-to-1.9.0_fixture-scripts-specification-provider"><code>FixtureScriptsSpecificationProvider</code></a></li>
 <li><a href="#_migration-notes_1.8.0-to-1.9.0_war-packaging">War packaging</a></li>
 </ul>
 </li>