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 2017/09/25 08:33:54 UTC
[06/24] isis-site git commit: ISIS-1712 - updates docs,
replace references to isisaddons and catalog.incode.org with
platform.incode.org
http://git-wip-us.apache.org/repos/asf/isis-site/blob/e5dcb0be/content/guides/ugtst/ugtst.html
----------------------------------------------------------------------
diff --git a/content/guides/ugtst/ugtst.html b/content/guides/ugtst/ugtst.html
index a1d4121..d22b70d 100644
--- a/content/guides/ugtst/ugtst.html
+++ b/content/guides/ugtst/ugtst.html
@@ -506,7 +506,7 @@ CustomerRepository customers;</code></pre>
<p>One way to do this is to use random (or fake) values for any insignificant data. This in effect tells the reader that "any value will do". Moreover, if it turns out that any data won’t do, and that there’s some behaviour that is sensitive to the value, then the test will start to flicker, passing and then failing depending on inputs. This is A Good Thing™.</p>
</div>
<div class="paragraph">
- <p>Apache Isis does not, itself, ship with a fake data library. However, the <a href="http://github.com/isisaddons/isis-module-fakedata">Isis addons' fakedata</a> module (non-ASF) does provide exactly this capability.</p>
+ <p>Apache Isis does not, itself, ship with a fake data library. However, the (non-ASF) <a href="http://platform.incode.org" target="_blank">Incode Platform</a>'s fakedata module (non-ASF) does provide exactly this capability.</p>
</div>
<div class="admonitionblock tip">
<table>
@@ -531,7 +531,7 @@ CustomerRepository customers;</code></pre>
<p>Sometimes, though, a feature will take longer to implement than your iteration cycle. In such a case, how do you use continuous integration to keep everyone working on the mainline without revealing a half-implemented feature on your releases? One option is to use <a href="http://martinfowler.com/bliki/FeatureToggle.html">feature toggle</a>s.</p>
</div>
<div class="paragraph">
- <p>Apache Isis does not, itself, ship with a feature toggle library. However, the <a href="http://github.com/isisaddons/isis-module-togglz">Isis addons' togglz</a> module (non-ASF) does provide exactly this capability.</p>
+ <p>Apache Isis does not, itself, ship with a feature toggle library. However, the (non-ASF) <a href="http://platform.incode.org" target="_blank">Incode Platform</a>'s togglz module does provide exactly this capability.</p>
</div>
<div class="paragraph">
<p>With all that said, let’s look in detail at the testing features provided by Apache Isis.</p>
@@ -882,7 +882,7 @@ CustomerRepository customers;</code></pre>
<td class="icon"> <i class="fa icon-tip" title="Tip"></i> </td>
<td class="content">
<div class="paragraph">
- <p>The (non-ASF) <a href="http://github.com/isisaddons/isis-module-publishmq">Isis addons' publishmq</a> module provides a full example of how to integrate and test an Apache Isis application with a (faked out) external system.</p>
+ <p>The (non-ASF) <a href="http://platform.incode.org" target="_blank">Incode Platform</a>'s publishmq module provides a full example of how to integrate and test an Apache Isis application with a (faked out) external system.</p>
</div> </td>
</tr>
</tbody>
@@ -2678,7 +2678,7 @@ Feature: <span class="predefined-type">List</span> and Create New Simple Objects
<td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
<td class="content">
<div class="paragraph">
- <p>As of 1.14.0, this configuration has been replaced to use mavenmixins.</p>
+ <p>As of <code>1.14.0</code>, this configuration has been replaced to use mavenmixins.</p>
</div> </td>
</tr>
</tbody>
@@ -2799,10 +2799,10 @@ Feature: <span class="predefined-type">List</span> and Create New Simple Objects
<p>There are two ways in which you can provide a <code>FixtureScripts</code> service.</p>
</div>
<div class="paragraph">
- <p>The original (pre-1.9.0) approach is to subclass subclass <code>FixtureScripts</code> domain service, with your subclass specifying which package to search for. Various other settings can also be provided, and - being a custom class - you can also add in additional actions. A common example is to provide a "one-shot" action to recreate a standard demo set of objects.</p>
+ <p>The original (pre-<code>1.9.0</code>) approach is to subclass subclass <code>FixtureScripts</code> domain service, with your subclass specifying which package to search for. Various other settings can also be provided, and - being a custom class - you can also add in additional actions. A common example is to provide a "one-shot" action to recreate a standard demo set of objects.</p>
</div>
<div class="paragraph">
- <p>As of 1.9.0 there is an alternative design. Instead of subclassing <code>FixtureScripts</code> you instead implement the <a href="../rgsvc/rgsvc.html#_rgsvc_testing_FixtureScriptsSpecificationProvider"><code>FixtureScriptsSpecificationProvider</code></a> SPI. (As its name suggests), this provides a <code>FixtureScriptsSpecification</code> object that contains the same information as would otherwise have been in the <code>FixtureScripts</code> subclass.</p>
+ <p>As of <code>1.9.0</code> there is an alternative design. Instead of subclassing <code>FixtureScripts</code> you instead implement the <a href="../rgsvc/rgsvc.html#_rgsvc_testing_FixtureScriptsSpecificationProvider"><code>FixtureScriptsSpecificationProvider</code></a> SPI. (As its name suggests), this provides a <code>FixtureScriptsSpecification</code> object that contains the same information as would otherwise have been in the <code>FixtureScripts</code> subclass.</p>
</div>
<div class="paragraph">
<p>The actual implementation of the <code>FixtureScripts</code> service is then provided by the framework itself, namely the <a href="../rgsvc/rgsvc.html#_rgsvc_testing_FixtureScriptsDefault"><code>FixtureScriptsDefault</code></a> domain service, annotated to be rendered on the secondary "Prototyping" menu. This uses the <code>FixtureScriptsSpecificationProvider</code> to adjust itself accordinly.</p>
@@ -2854,10 +2854,10 @@ Feature: <span class="predefined-type">List</span> and Create New Simple Objects
</table>
</div>
<div class="paragraph">
- <p>The benefit of this design - decoupling the responsibilities of the superclass and the subclass - is that it ensures that there is always an instance of <code>FixtureScripts</code> available, even if the application itself doesn’t provide one. Some of the (non-ASF) <a href="http://www.isisaddons.org">Isis Addons</a> modules (eg <a href="http://github.com/isisaddons/isis-module-security">Isis addons' security</a> module) expect there to be a <code>FixtureScripts</code> service for seeding data, which has caused some confusion.</p>
+ <p>The benefit of this design - decoupling the responsibilities of the superclass and the subclass - is that it ensures that there is always an instance of <code>FixtureScripts</code> available, even if the application itself doesn’t provide one. .</p>
</div>
<div class="paragraph">
- <p>By way of comparison, if using the older pre-1.9.0 approach then you would create a subclass:</p>
+ <p>By way of comparison, if using the older pre-<code>1.9.0</code> approach then you would create a subclass:</p>
</div>
<div class="listingblock">
<div class="content">
@@ -3036,7 +3036,7 @@ Feature: <span class="predefined-type">List</span> and Create New Simple Objects
</tr>
<tr>
<td><i class="conum" data-value="2"></i><b>2</b></td>
- <td>a hard-coded list of values for the names. Note that the <a href="http://github.com/isisaddons/isis-module-fakedata">Isis addons' fakedata</a> module (non-ASF) could also have been used</td>
+ <td>a hard-coded list of values for the names. Note that the (non-ASF) <a href="http://platform.incode.org" target="_blank">Incode Platform</a>'s fakedata module could also have been used</td>
</tr>
<tr>
<td><i class="conum" data-value="3"></i><b>3</b></td>
@@ -3285,7 +3285,7 @@ Feature: <span class="predefined-type">List</span> and Create New Simple Objects
<p>The first is to take advantage of a new <code>MultipleExecutionStrategy</code>, namely <code>EXECUTE_ONCE_BY_VALUE</code>. Under this strategy the determination as to whether to run a given fixture script is by comparing the fixture script against all others that have run. If all fixture scripts implement value semantics, then they can effectively determine whether they need to run or not.</p>
</div>
<div class="paragraph">
- <p>This strategy was introduced in order to better support the <code>ExcelFixture</code> fixture script (provided by the (non-ASF) <a href="http://github.com/isisaddons/isis-module-excel">Isis addons' excel</a> module. The <code>ExcelFixture</code> takes an Excel spreadsheet and loads up each row. For those cases where we wish to ensure that the same spreadsheet is not loaded more than once, the <code>IGNORE</code> strategy would have required that a trivial subclass of <code>ExcelFixture</code> is created for each and every spreadsheet. The <code>EXECUTE_ONCE_BY_VALUE</code> on the other hand delegates the determination to the value semantics of the <code>ExcelFixture</code>, which is based on the contents of the spreadsheet.</p>
+ <p>This strategy was introduced in order to better support the <code>ExcelFixture</code> fixture script (provided by the (non-ASF) <a href="http://platform.incode.org" target="_blank">Incode Platform</a>'s excel module. The <code>ExcelFixture</code> takes an Excel spreadsheet and loads up each row. For those cases where we wish to ensure that the same spreadsheet is not loaded more than once, the <code>IGNORE</code> strategy would have required that a trivial subclass of <code>ExcelFixture</code> is created for each and every spreadsheet. The <code>EXECUTE_ONCE_BY_VALUE</code> on the other hand delegates the determination to the value semantics of the <code>ExcelFixture</code>, which is based on the contents of the spreadsheet.</p>
</div>
<div class="admonitionblock note">
<table>