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/12/22 23:40:48 UTC
[3/3] isis-site git commit: ISIS-1243: reworking the ugbtb (beyond
the basics) guide a little, breaking out and renaming the techniques chapter
ISIS-1243: reworking the ugbtb (beyond the basics) guide a little, breaking out and renaming the techniques chapter
Project: http://git-wip-us.apache.org/repos/asf/isis-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis-site/commit/2f52444a
Tree: http://git-wip-us.apache.org/repos/asf/isis-site/tree/2f52444a
Diff: http://git-wip-us.apache.org/repos/asf/isis-site/diff/2f52444a
Branch: refs/heads/asf-site
Commit: 2f52444a3b389e35a24608ae92381d4c6ae93e53
Parents: cbbf4df
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Tue Dec 22 22:38:29 2015 +0000
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Tue Dec 22 22:38:29 2015 +0000
----------------------------------------------------------------------
content/guides/cg.html | 4 +-
content/guides/rgant.html | 40 +-
content/guides/rgcfg.html | 4 +-
content/guides/rgcms.html | 18 +-
content/guides/rgsvc.html | 36 +-
content/guides/ugbtb.html | 3164 ++++++++++++++++++++--------------------
content/guides/ugfun.html | 24 +-
content/guides/ugsec.html | 2 +-
content/guides/ugtst.html | 2 +-
content/powered-by.html | 2 +-
10 files changed, 1652 insertions(+), 1644 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis-site/blob/2f52444a/content/guides/cg.html
----------------------------------------------------------------------
diff --git a/content/guides/cg.html b/content/guides/cg.html
index 3cd6c9c..92d5faa 100644
--- a/content/guides/cg.html
+++ b/content/guides/cg.html
@@ -2472,7 +2472,7 @@ generate <a href="http://swagger.io">Swagger</a> spec files to describe the publ
<h3 id="_cg_isis-maven-plugin_xsd">5.4. <code>xsd</code> goal (<code>1.11.0-SNAPSHOT</code>)</h3>
<div class="paragraph">
<p>The <code>xsd</code> goal of the <code>isis-maven-plugin</code> uses the <a href="rgsvc.html#_rgsvc_api_JaxbService"><code>JaxbService</code></a> to
-generate XSD schemas from any JAXB-annotated <a href="ugbtb.html#_ugbtb_more-advanced_view-models">view model/DTOs</a>.</p>
+generate XSD schemas from any JAXB-annotated <a href="ugbtb.html#_ugbtb_view-models">view model/DTOs</a>.</p>
</div>
<div class="paragraph">
<p>This is instead of and preferable to using the JAXB <a href="https://jaxb.java.net/2.2.4/docs/schemagen.html">schemagen</a>
@@ -2489,7 +2489,7 @@ objects into <code>OidDto</code>s (as defined by the Apache Isis <a href="rgcms.
<p><code>appManifest</code> - fully qualified class name for the app manifest used to bootstrap the application (see discussion above)</p>
</li>
<li>
-<p><code>jaxbClasses</code> - a list of <a href="rg.html#_ugbtb_more-advanced_view-models_jaxb">JAXB-annotated view model</a> classes;</p>
+<p><code>jaxbClasses</code> - a list of <a href="rg.html#_ugbtb_view-models_jaxb">JAXB-annotated view model</a> classes;</p>
</li>
<li>
<p><code>output</code> - (optional) subdirectory under the <code>target</code> directory to generate the XSDs<br></p>
http://git-wip-us.apache.org/repos/asf/isis-site/blob/2f52444a/content/guides/rgant.html
----------------------------------------------------------------------
diff --git a/content/guides/rgant.html b/content/guides/rgant.html
index 4c8a2a4..ba3eadd 100644
--- a/content/guides/rgant.html
+++ b/content/guides/rgant.html
@@ -2026,7 +2026,7 @@ post-execute).</p>
</td>
<td class="content">
<div class="paragraph">
-<p>If background <code>Command</code>s are used, then an external scheduler, using <a href="ugbtb.html#_ugbtb_more-advanced_headless-access_BackgroundCommandExecution">headless access</a>, must also be configured.</p>
+<p>If background <code>Command</code>s are used, then an external scheduler, using <a href="ugbtb.html#_ugbtb_headless-access_BackgroundCommandExecution">headless access</a>, must also be configured.</p>
</div>
</td>
</tr>
@@ -2142,7 +2142,7 @@ should then also be persisted (the default), or not persisted, or only if hinted
<p>For persisted commands, the <code>commandExecuteIn()</code> attribute determines whether the <code>Command</code> should be executed in the foreground (the default) or executed in the background.</p>
</div>
<div class="paragraph">
-<p>Background execution means that the command is not executed immediately, but is available for a configured <a href="rgsvc.html#_rgsvc_spi_BackgroundCommandService"><code>BackgroundCommandService</code></a> to execute, eg by way of an in-memory scheduler such as Quartz. See <a href="ugbtb.html#_ugbtb_more-advanced_headless-access_BackgroundCommandExecution">here</a> for further information on this topic.</p>
+<p>Background execution means that the command is not executed immediately, but is available for a configured <a href="rgsvc.html#_rgsvc_spi_BackgroundCommandService"><code>BackgroundCommandService</code></a> to execute, eg by way of an in-memory scheduler such as Quartz. See <a href="ugbtb.html#_ugbtb_headless-access_BackgroundCommandExecution">here</a> for further information on this topic.</p>
</div>
<div class="paragraph">
<p>For example:</p>
@@ -3332,7 +3332,7 @@ can be used instead, eg:</p>
</td>
<td class="content">
<div class="paragraph">
-<p>The framework also provides a separate, powerful mechanism for <a href="ugbtb.html#_ugbtb_more-advanced_i18n">internationalization</a>.</p>
+<p>The framework also provides a separate, powerful mechanism for <a href="ugbtb.html#_ugbtb_i18n">internationalization</a>.</p>
</div>
</td>
</tr>
@@ -4481,7 +4481,7 @@ can be used instead, eg:</p>
</td>
<td class="content">
<div class="paragraph">
-<p>The framework also provides a separate, powerful mechanism for <a href="ugbtb.html#_ugbtb_more-advanced_i18n">internationalization</a>.</p>
+<p>The framework also provides a separate, powerful mechanism for <a href="ugbtb.html#_ugbtb_i18n">internationalization</a>.</p>
</div>
</td>
</tr>
@@ -5757,7 +5757,7 @@ then no event will be posted.</p>
</ul>
</div>
<div class="paragraph">
-<p>Equivalent to annotating with <a href="#_rgant-Mixin"><code>@Mixin</code></a>. For further discussion on using mixins, see <a href="ugbtb.html#_ugbtb_more-advanced_decoupling_mixins">mixins</a> in the user guide.</p>
+<p>Equivalent to annotating with <a href="#_rgant-Mixin"><code>@Mixin</code></a>. For further discussion on using mixins, see <a href="ugbtb.html#_ugbtb_decoupling_mixins">mixins</a> in the user guide.</p>
</div>
<div class="ulist">
<ul>
@@ -6940,8 +6940,8 @@ the domain object using the event’s API.</p>
<td class="content">
<div class="paragraph">
<p>The feature was originally introduced so that <a href="#_rgant-XmlRootElement"><code>@XmlRootElement</code></a>-annotated
-<a href="ugbtb.html#_ugbtb_more-advanced_view-models">view model</a>s could be kept as minimal as possible, just defining the data.
-UI events allow subscribers to provide UI hints, while <a href="ugbtb.html#_ugbtb_more-advanced_decoupling_mixins">mixin</a>s can be used to provide the behaviour.</p>
+<a href="ugbtb.html#_ugbtb_view-models">view model</a>s could be kept as minimal as possible, just defining the data.
+UI events allow subscribers to provide UI hints, while <a href="ugbtb.html#_ugbtb_decoupling_mixins">mixin</a>s can be used to provide the behaviour.</p>
</div>
</td>
</tr>
@@ -7103,8 +7103,8 @@ the domain object using the event’s API.</p>
<td class="content">
<div class="paragraph">
<p>The feature was originally introduced so that <a href="#_rgant-XmlRootElement"><code>@XmlRootElement</code></a>-annotated
-<a href="ugbtb.html#_ugbtb_more-advanced_view-models">view model</a>s could be kept as minimal as possible, just defining the data.
-UI events allow subscribers to provide UI hints, while <a href="ugbtb.html#_ugbtb_more-advanced_decoupling_mixins">mixin</a>s can be used to provide the behaviour.</p>
+<a href="ugbtb.html#_ugbtb_view-models">view model</a>s could be kept as minimal as possible, just defining the data.
+UI events allow subscribers to provide UI hints, while <a href="ugbtb.html#_ugbtb_decoupling_mixins">mixin</a>s can be used to provide the behaviour.</p>
</div>
</td>
</tr>
@@ -7269,7 +7269,7 @@ of calling the <a href="rgsvc.html#_rgsvc_api_DomainObjectContainer"><code>Domai
</td>
<td class="content">
<div class="paragraph">
-<p>The framework also provides a separate, powerful mechanism for <a href="ugbtb.html#_ugbtb_more-advanced_i18n">internationalization</a>.</p>
+<p>The framework also provides a separate, powerful mechanism for <a href="ugbtb.html#_ugbtb_i18n">internationalization</a>.</p>
</div>
</td>
</tr>
@@ -7358,8 +7358,8 @@ the domain object using the event’s API.</p>
<td class="content">
<div class="paragraph">
<p>The feature was originally introduced so that <a href="#_rgant-XmlRootElement"><code>@XmlRootElement</code></a>-annotated
-<a href="ugbtb.html#_ugbtb_more-advanced_view-models">view model</a>s could be kept as minimal as possible, just defining the data.
-UI events allow subscribers to provide UI hints, while <a href="ugbtb.html#_ugbtb_more-advanced_decoupling_mixins">mixin</a>s can be used to provide the behaviour.</p>
+<a href="ugbtb.html#_ugbtb_view-models">view model</a>s could be kept as minimal as possible, just defining the data.
+UI events allow subscribers to provide UI hints, while <a href="ugbtb.html#_ugbtb_decoupling_mixins">mixin</a>s can be used to provide the behaviour.</p>
</div>
</td>
</tr>
@@ -9077,7 +9077,7 @@ declaration.</p>
</td>
<td class="content">
<div class="paragraph">
-<p>The framework also provides a separate, powerful mechanism for <a href="ugbtb.html#_ugbtb_more-advanced_i18n">internationalization</a>.</p>
+<p>The framework also provides a separate, powerful mechanism for <a href="ugbtb.html#_ugbtb_i18n">internationalization</a>.</p>
</div>
</td>
</tr>
@@ -9296,7 +9296,7 @@ declaration.</p>
<p>The <code>@javax.annotation.PostConstruct</code> annotation, as defined in <a href="https://jcp.org/en/jsr/detail?id=250">JSR-250</a>, is recognized by Apache Isis as a callback method on domain services to be called just after they have been constructed, in order that they initialize themselves.</p>
</div>
<div class="paragraph">
-<p>It is also recognized for <a href="ugbtb.html#_ugbtb_more-advanced_view-models">view models</a> (eg annotated with <a href="#_rgant-ViewModel"><code>@ViewModel</code></a>).</p>
+<p>It is also recognized for <a href="ugbtb.html#_ugbtb_view-models">view models</a> (eg annotated with <a href="#_rgant-ViewModel"><code>@ViewModel</code></a>).</p>
</div>
<div class="paragraph">
<p>For the default application-scoped (singleton) domain services, this means that the method, if present, is called during the bootstrapping of the application. For <a href="#_rgant-RequestScoped"><code>@RequestScoped</code></a> domain services, the method is called at the beginning of the request.</p>
@@ -10916,7 +10916,7 @@ can be used instead, eg:</p>
</td>
<td class="content">
<div class="paragraph">
-<p>The framework also provides a separate, powerful mechanism for <a href="ugbtb.html#_ugbtb_more-advanced_i18n">internationalization</a>.</p>
+<p>The framework also provides a separate, powerful mechanism for <a href="ugbtb.html#_ugbtb_i18n">internationalization</a>.</p>
</div>
</td>
</tr>
@@ -11457,7 +11457,7 @@ for symmetry with domain objects that have been annotated using <a href="#_rgant
</td>
<td class="content">
<div class="paragraph">
-<p>The framework also provides a separate, powerful mechanism for <a href="ugbtb.html#_ugbtb_more-advanced_i18n">internationalization</a>.</p>
+<p>The framework also provides a separate, powerful mechanism for <a href="ugbtb.html#_ugbtb_i18n">internationalization</a>.</p>
</div>
</td>
</tr>
@@ -11552,7 +11552,7 @@ provided by the <a href="rgsvc.html#_rgsvc_api_BookmarkService"><code>BookmarkSe
<p>This annotation therefore allows view models/DTOs to have references to persistent entities; a common idiom.</p>
</div>
<div class="paragraph">
-<p>For a more complete discussion of writing JAXB view models/DTOs, see <a href="ugbtb.html#_ugbtb_more-advanced_view-models">this topic</a>
+<p>For a more complete discussion of writing JAXB view models/DTOs, see <a href="ugbtb.html#_ugbtb_view-models">this topic</a>
in the user guide.</p>
</div>
</div>
@@ -11562,7 +11562,7 @@ in the user guide.</p>
<div class="sectionbody">
<div class="paragraph">
<p>The <code>@XmlRootElement</code> annotation (<code>1.11.0-SNAPSHOT</code>) provides an alternative way to define a
-<a href="rg.html#_ugbtb_more-advanced_view-models">view model</a>, in particular one intended to act as a DTO for use within
+<a href="rg.html#_ugbtb_view-models">view model</a>, in particular one intended to act as a DTO for use within
<a href="ugvro.html">RestfulObjects viewer</a>, or which contains arbitrarily complex state.</p>
</div>
<div class="paragraph">
@@ -11661,12 +11661,12 @@ implementation (eg which maps XML strings to a GUID, say) can be configured usin
the DTO "clean", just focused on specifying the data contract.</p>
</div>
<div class="paragraph">
-<p>Behaviour can therefore be provided using <a href="ugbtb.html#_ugbtb_more-advanced_decoupling_mixins">mixins</a> (annotated with
+<p>Behaviour can therefore be provided using <a href="ugbtb.html#_ugbtb_decoupling_mixins">mixins</a> (annotated with
<a href="#_rgant-Mixin"><code>@Mixin</code></a>), while <a href="rgcms.html#_rgcms_classes_uievent">UI events</a> can be used
to obtain title, icons and so on.</p>
</div>
<div class="paragraph">
-<p>For a more complete discussion of writing JAXB view models/DTOs, see <a href="ugbtb.html#_ugbtb_more-advanced_view-models">this topic</a>
+<p>For a more complete discussion of writing JAXB view models/DTOs, see <a href="ugbtb.html#_ugbtb_view-models">this topic</a>
in the user guide.</p>
</div>
</div>
http://git-wip-us.apache.org/repos/asf/isis-site/blob/2f52444a/content/guides/rgcfg.html
----------------------------------------------------------------------
diff --git a/content/guides/rgcfg.html b/content/guides/rgcfg.html
index dcea480..296466f 100644
--- a/content/guides/rgcfg.html
+++ b/content/guides/rgcfg.html
@@ -1545,7 +1545,7 @@ FQCN (<code><em>guava</em></code>)</p></td>
<p>Whether to force the <code>TranslationService</code> into either read or write mode.<br></p>
</div>
<div class="paragraph">
-<p>See <a href="ugbtb.html#_ugbtb_more-advanced_i18n">i18n support</a> to learn more about the translation service.</p>
+<p>See <a href="ugbtb.html#_ugbtb_i18n">i18n support</a> to learn more about the translation service.</p>
</div></div></td>
</tr>
<tr>
@@ -1710,7 +1710,7 @@ frustrating to have to annotate every property.</p>
<p>DataNucleus will for itself also and read the <code>META-INF/persistence.xml</code>; at a minimum this defines the name of the "persistence unit". n theory it could also hold mappings, though in Apache Isis we tend to use annotations instead.</p>
</div>
<div class="paragraph">
-<p>Furthermore, DataNucleus will search for various other XML mapping files, eg <code>mappings.jdo</code>. A full list can be found <a href="http://www.datanucleus.org/products/datanucleus/jdo/metadata.html">here</a>. The metadata in these XML can be used to override the annotations of annotated entities; see <a href="ugbtb.html#_ugbtb_more-advanced_overriding-jdo-annotations">Overriding JDO Annotatons</a> for further discussion.</p>
+<p>Furthermore, DataNucleus will search for various other XML mapping files, eg <code>mappings.jdo</code>. A full list can be found <a href="http://www.datanucleus.org/products/datanucleus/jdo/metadata.html">here</a>. The metadata in these XML can be used to override the annotations of annotated entities; see <a href="ugbtb.html#_ugbtb_other-techniques_overriding-jdo-annotations">Overriding JDO Annotatons</a> for further discussion.</p>
</div>
<div class="sect2">
<h3 id="_rgcfg_configuring-datanucleus_properties">6.1. Configuration Properties</h3>
http://git-wip-us.apache.org/repos/asf/isis-site/blob/2f52444a/content/guides/rgcms.html
----------------------------------------------------------------------
diff --git a/content/guides/rgcms.html b/content/guides/rgcms.html
index 3a5fd2c..d518e96 100644
--- a/content/guides/rgcms.html
+++ b/content/guides/rgcms.html
@@ -1436,7 +1436,7 @@ RemoveFrom…​()</code></a></p></td>
<p>Typically modification/invocation is vetoed based on the state of the domain object being interacted with, though it could be any reason at all (eg the current date/time of the interaction, or the state of some other related data such as stock levels, or the identity of the calling user).</p>
</div>
<div class="paragraph">
-<p>The reason for vetoing a modification/invocation is normally returned as a string. However, Apache Isis' <a href="ugbtb.html#_ugbtb_more-advanced_i18n">i18n support</a> extends this so that reasons can be internationalized.</p>
+<p>The reason for vetoing a modification/invocation is normally returned as a string. However, Apache Isis' <a href="ugbtb.html#_ugbtb_i18n">i18n support</a> extends this so that reasons can be internationalized.</p>
</div>
<div class="sect4">
<h5 id="_actions">Actions</h5>
@@ -1725,7 +1725,7 @@ RemoveFrom…​()</code></a></p></td>
<p>The <code>validate…​()</code> supporting method is called for properties, actions and action parameters. It allows the proposed new value for a property to be rejected, or the proposed argument of an action parameter to be rejected, or to reject a whole set of action arguments for an actio invocation.</p>
</div>
<div class="paragraph">
-<p>The reason for vetoing a modification/invocation is normally returned as a string. However, Apache Isis' <a href="ugbtb.html#_ugbtb_more-advanced_i18n">i18n support</a> extends this so that reasons can be internationalized if required.</p>
+<p>The reason for vetoing a modification/invocation is normally returned as a string. However, Apache Isis' <a href="ugbtb.html#_ugbtb_i18n">i18n support</a> extends this so that reasons can be internationalized if required.</p>
</div>
<div class="sect4">
<h5 id="_action_parameter">Action Parameter</h5>
@@ -1860,7 +1860,7 @@ RemoveFrom…​()</code></a></p></td>
</div>
</div>
<div class="paragraph">
-<p>where the returned string is the reason the collection modification invocation is vetoed (or <code>null</code> if not vetoed). Apache Isis' <a href="ugbtb.html#_ugbtb_more-advanced_i18n">i18n support</a> extends this so that reasons can be internationalized if required.</p>
+<p>where the returned string is the reason the collection modification invocation is vetoed (or <code>null</code> if not vetoed). Apache Isis' <a href="ugbtb.html#_ugbtb_i18n">i18n support</a> extends this so that reasons can be internationalized if required.</p>
</div>
<div class="paragraph">
<p>For example:</p>
@@ -1910,7 +1910,7 @@ RemoveFrom…​()</code></a></p></td>
</div>
</div>
<div class="paragraph">
-<p>where the returned string is the reason the collection modification invocation is vetoed (or <code>null</code> if not vetoed). Apache Isis' <a href="ugbtb.html#_ugbtb_more-advanced_i18n">i18n support</a> extends this so that reasons can be internationalized if required.</p>
+<p>where the returned string is the reason the collection modification invocation is vetoed (or <code>null</code> if not vetoed). Apache Isis' <a href="ugbtb.html#_ugbtb_i18n">i18n support</a> extends this so that reasons can be internationalized if required.</p>
</div>
<div class="paragraph">
<p>For example:</p>
@@ -2076,7 +2076,7 @@ RemoveFrom…​()</code></a></p></td>
<p>where <code>Identifier.Type</code> is part of the Isis applib (nested static class of <code>o.a.i.applib.Identifier</code>) to distinguish between an interaction with an action, a property or an action.</p>
</div>
<div class="paragraph">
-<p>Note that Apache Isis' <a href="ugbtb.html#_ugbtb_more-advanced_i18n">i18n support</a> extends this so that the returned reason can also be internationalized.</p>
+<p>Note that Apache Isis' <a href="ugbtb.html#_ugbtb_i18n">i18n support</a> extends this so that the returned reason can also be internationalized.</p>
</div>
<div class="paragraph">
<p>For example:</p>
@@ -2293,7 +2293,7 @@ RemoveFrom…​()</code></a></p></td>
</div>
</div>
<div class="paragraph">
-<p>Note that Apache Isis' <a href="ugbtb.html#_ugbtb_more-advanced_i18n">i18n support</a> extends this so that titles can also be internationalized.</p>
+<p>Note that Apache Isis' <a href="ugbtb.html#_ugbtb_i18n">i18n support</a> extends this so that titles can also be internationalized.</p>
</div>
<div class="paragraph">
<p>For example, the (non-ASF) <a href="http://github.com/isisaddons/isis-app-todoapp">Isis addons' todoapp</a> uses this technique to add an overlay for todo items that have been completed:</p>
@@ -2379,7 +2379,7 @@ RemoveFrom…​()</code></a></p></td>
<p>where the returned string is the reason that the invocation is vetoed.</p>
</div>
<div class="paragraph">
-<p>Note that Apache Isis' <a href="ugbtb.html#_ugbtb_more-advanced_i18n">i18n support</a> extends this so that the returned reason can also be internationalized.</p>
+<p>Note that Apache Isis' <a href="ugbtb.html#_ugbtb_i18n">i18n support</a> extends this so that the returned reason can also be internationalized.</p>
</div>
</div>
</div>
@@ -4725,7 +4725,7 @@ by <code>disableXxX()</code> and <code>validateXxx()</code> methods:</p>
<i class="fa icon-important" title="Important"></i>
</td>
<td class="content">
-TODO - see <a href="ugbtb.html#_ugbtb_more-advanced_i18n">user guide, i18n</a>.
+TODO - see <a href="ugbtb.html#_ugbtb_i18n">user guide, i18n</a>.
</td>
</tr>
</table>
@@ -4919,7 +4919,7 @@ the current timestamp whenever it is modified in a transaction.</p>
<div class="paragraph">
<p>The <code>Dto</code> role interface (<code>1.11.0-SNAPSHOT</code>) is intended to be implemented by JAXB-annotated view models, that is, annotated using
<a href="rgant.html#_rgant-XmlRootElement"><code>@XmlRootElement</code></a>. It enables the ability to download the XML and
-XSD schema of those objects using two <a href="ugbtb.html#_ugbtb_more-advanced_decoupling_mixins">mixins</a>,
+XSD schema of those objects using two <a href="ugbtb.html#_ugbtb_decoupling_mixins">mixins</a>,
<code>Dto_downloadXml</code> and <code>Dto_downloadXsd</code>.</p>
</div>
<div class="paragraph">
http://git-wip-us.apache.org/repos/asf/isis-site/blob/2f52444a/content/guides/rgsvc.html
----------------------------------------------------------------------
diff --git a/content/guides/rgsvc.html b/content/guides/rgsvc.html
index a962bb4..41f988a 100644
--- a/content/guides/rgsvc.html
+++ b/content/guides/rgsvc.html
@@ -2632,7 +2632,7 @@ container.persistIfNotAlready(cust);</code></pre>
</tr>
<tr>
<td><i class="conum" data-value="2"></i><b>2</b></td>
-<td>ditto, but with translatable string, for <a href="ugbtb.html#_ugbtb_more-advanced_i18n">i18n support</a>.</td>
+<td>ditto, but with translatable string, for <a href="ugbtb.html#_ugbtb_i18n">i18n support</a>.</td>
</tr>
<tr>
<td><i class="conum" data-value="3"></i><b>3</b></td>
@@ -4192,7 +4192,7 @@ a persistent entity). The enum indicates whether these schemas should be includ
<div class="paragraph">
<p>This service is provided as a convenience for applications, but is also used internally by the framework to
<a href="rgant.html#_rgant-XmlRootElement"><code>@XmlRootElement</code></a>-annotated
-<a href="ugbtb.html#_ugbtb_more-advanced_view-models">view models</a>. The functionality to download XML and XSD schemas is also
+<a href="ugbtb.html#_ugbtb_view-models">view models</a>. The functionality to download XML and XSD schemas is also
exposed in the UI through mixins to <a href="rgcms.html#_rgcms_classes_roles_Dto"><code>Dto</code></a> interface.</p>
</div>
</div>
@@ -4214,7 +4214,7 @@ further in this <a href="ugfun.html#_ugfun_how-tos_replacing-default-service-imp
<div class="sect2">
<h3 id="_rgsvc_api_MementoService">2.16. <code>MementoService</code></h3>
<div class="paragraph">
-<p>The <code>MementoService</code> was originally introduced to simplify the implementation of <a href="ugbtb.html#_ugbtb_more-advanced_view-models">ViewModel</a>s which are required by the framework to return string representation of all of their backing state, moreover which is safe for use within a URL.</p>
+<p>The <code>MementoService</code> was originally introduced to simplify the implementation of <a href="ugbtb.html#_ugbtb_view-models">ViewModel</a>s which are required by the framework to return string representation of all of their backing state, moreover which is safe for use within a URL.</p>
</div>
<div class="paragraph">
<p>However, it can also be used to create a memento of arbitrary objects. Indeed, it is used internally by the core implementation of <a href="#_rgsvc_api_BackgroundService"><code>BackgroundService</code></a> to capture the state of action invocations so that they can be executed by a background process.</p>
@@ -4652,7 +4652,7 @@ Scratchpad scratchpad;</code></pre>
</div>
</div>
<div class="paragraph">
-<p>A more complex example could use a <a href="ugbtb.html#_ugbtb_more-advanced_view-models">view model</a> to enable bulk updates to a set of objects. The view model’s job is to gather track of the items to be updated:</p>
+<p>A more complex example could use a <a href="ugbtb.html#_ugbtb_view-models">view model</a> to enable bulk updates to a set of objects. The view model’s job is to gather track of the items to be updated:</p>
</div>
<div class="listingblock">
<div class="content">
@@ -4856,7 +4856,7 @@ further in this <a href="ugfun.html#_ugfun_how-tos_replacing-default-service-imp
<tr>
<td><i class="conum" data-value="1"></i><b>1</b></td>
<td>Generate a Swagger spec for use by third-party clients, ie public use. This specification is restricted only to
-<a href="ugbtb.html#_ugbtb_more-advanced_view-models">view model</a>s and to domain services with a <a href="rgant.html#_rgant_DomainService_nature">nature</a> of <code>VIEW_REST_ONLY</code>.</td>
+<a href="ugbtb.html#_ugbtb_view-models">view model</a>s and to domain services with a <a href="rgant.html#_rgant_DomainService_nature">nature</a> of <code>VIEW_REST_ONLY</code>.</td>
</tr>
<tr>
<td><i class="conum" data-value="2"></i><b>2</b></td>
@@ -5860,7 +5860,7 @@ then this can be activated by updating the <code>pom.xml</code> and updating the
</div>
<div class="paragraph">
<p>If menu items or contributions are not required in the UI, these can be suppressed either using security or by
-implementing a <a href="ugbtb.html#_ugbtb_more-advanced_decoupling_vetoing-visibility">vetoing subscriber</a>.</p>
+implementing a <a href="ugbtb.html#_ugbtb_decoupling_vetoing-visibility">vetoing subscriber</a>.</p>
</div>
</div>
<div class="sect3">
@@ -5947,7 +5947,7 @@ implementing a <a href="ugbtb.html#_ugbtb_more-advanced_decoupling_vetoing-visib
<div class="sect3">
<h4 id="__internal_spi">3.2.2. "Internal" SPI</h4>
<div class="paragraph">
-<p>The <code>BackgroundCommandExecution</code> (in isis-core) is an abstract template class for <a href="ugbtb.html#_ugbtb_more-advanced_headless-access_AbstractIsisSessionTemplate">headless access</a>, that defines an abstract hook method to obtain background `Command`s to be executed:</p>
+<p>The <code>BackgroundCommandExecution</code> (in isis-core) is an abstract template class for <a href="ugbtb.html#_ugbtb_headless-access_AbstractIsisSessionTemplate">headless access</a>, that defines an abstract hook method to obtain background `Command`s to be executed:</p>
</div>
<div class="listingblock">
<div class="content">
@@ -6023,7 +6023,7 @@ then this can be activated by updating the <code>pom.xml</code> and updating the
</div>
<div class="paragraph">
<p>If contributions are not required in the UI, these can be suppressed either using security or by implementing a
-<a href="ugbtb.html#_ugbtb_more-advanced_decoupling_vetoing-visibility">vetoing subscriber</a>.</p>
+<a href="ugbtb.html#_ugbtb_decoupling_vetoing-visibility">vetoing subscriber</a>.</p>
</div>
</div>
<div class="sect3">
@@ -6247,7 +6247,7 @@ then this can be activated by updating the <code>pom.xml</code> and updating the
</div>
<div class="paragraph">
<p>If contributions are not required in the UI, these can be suppressed either using security or by implementing a
-<a href="ugbtb.html#_ugbtb_more-advanced_decoupling_vetoing-visibility">vetoing subscriber</a>.</p>
+<a href="ugbtb.html#_ugbtb_decoupling_vetoing-visibility">vetoing subscriber</a>.</p>
</div>
</div>
<div class="sect3">
@@ -6448,13 +6448,13 @@ entity into (two different versions of) a <code>ToDoItemDto</code> (JAXB annota
<div class="ulist">
<ul>
<li>
-<p>first is to solve the problem at the domain layer by defining a regular Apache Isis <a href="ugbtb.html#_ugbtb_more-advanced_view-models">view model</a>. This is then surfaced over the RO viewer. <br></p>
+<p>first is to solve the problem at the domain layer by defining a regular Apache Isis <a href="ugbtb.html#_ugbtb_view-models">view model</a>. This is then surfaced over the RO viewer. <br></p>
<div class="paragraph">
<p>If the underlying entities change, then care must be taken to ensure that structure of the view model nevertheless is unchanged.</p>
</div>
</li>
<li>
-<p>a second option is to solve the problem at the persistence layer, but defining a (SQL) view in the database and then <a href="ugbtb.html#_ugbtb_more-advanced_mapping-rdbms-views">mapping this</a> to a (read-only) entity. Again this is surfaced by the RO viewer. <br></p>
+<p>a second option is to solve the problem at the persistence layer, but defining a (SQL) view in the database and then <a href="ugbtb.html#_ugbtb_other-techniques_mapping-rdbms-views">mapping this</a> to a (read-only) entity. Again this is surfaced by the RO viewer. <br></p>
<div class="paragraph">
<p>If the underlying tables change (as the result of a change in their corresponding domain entities) then once more the view must be refactored so that it still presents the same structure.</p>
</div>
@@ -7338,7 +7338,7 @@ primary benefit (apart from decoupling responsibilities) is that it ensures that
</td>
<td class="content">
<div class="paragraph">
-<p>For the "big picture" and further details on Apache Isis' i18n support, see <a href="ugbtb.html#_ugbtb_more-advanced_i18n">here</a>.</p>
+<p>For the "big picture" and further details on Apache Isis' i18n support, see <a href="ugbtb.html#_ugbtb_i18n">here</a>.</p>
</div>
</td>
</tr>
@@ -7611,7 +7611,7 @@ then this can be activated by updating the <code>pom.xml</code> and updating the
<div class="paragraph">
<p>The modules also provide services that contribute to the UI. If contributions are not required in the UI, these can be
suppressed either using security or by implementing a
-<a href="ugbtb.html#_ugbtb_more-advanced_decoupling_vetoing-visibility">vetoing subscriber</a>.</p>
+<a href="ugbtb.html#_ugbtb_decoupling_vetoing-visibility">vetoing subscriber</a>.</p>
</div>
</div>
<div class="sect3">
@@ -7886,7 +7886,7 @@ default implementation of <code>RoutingService</code> service is automatically r
</td>
<td class="content">
<div class="paragraph">
-<p>For the "big picture" and further details on Apache Isis' i18n support, see <a href="ugbtb.html#_ugbtb_more-advanced_i18n">here</a>.</p>
+<p>For the "big picture" and further details on Apache Isis' i18n support, see <a href="ugbtb.html#_ugbtb_i18n">here</a>.</p>
</div>
</td>
</tr>
@@ -7945,7 +7945,7 @@ default implementation of <code>RoutingService</code> service is automatically r
<p>The framework also provides a supporting <code>TranslationServicePoMenu</code> provides menu items under the "Prototyping" secondary menu for controlling this service and downloading <code>.pot</code> files for translation.</p>
</div>
<div class="paragraph">
-<p>For more details on the implementation, see <a href="ugbtb.html#_ugbtb_more-advanced_i18n">i18n support</a>.</p>
+<p>For more details on the implementation, see <a href="ugbtb.html#_ugbtb_i18n">i18n support</a>.</p>
</div>
</div>
<div class="sect3">
@@ -7956,7 +7956,7 @@ default implementation of <code>RoutingService</code> service is automatically r
implementation of <code>TranslationService</code> service (along with the supporting menu service) are automatically registered and injected (it is annotated with <code>@DomainService</code>) so no further configuration is required.</p>
</div>
<div class="paragraph">
-<p>If the menu items are not required then these can be suppressed either using security or by implementing a <a href="ugbtb.html#_ugbtb_more-advanced_decoupling_vetoing-visibility">vetoing subscriber</a>.</p>
+<p>If the menu items are not required then these can be suppressed either using security or by implementing a <a href="ugbtb.html#_ugbtb_decoupling_vetoing-visibility">vetoing subscriber</a>.</p>
</div>
<div class="paragraph">
<p>To use an alternative implementation, use
@@ -7987,7 +7987,7 @@ further in this <a href="ugfun.html#_ugfun_how-tos_replacing-default-service-imp
</td>
<td class="content">
<div class="paragraph">
-<p>For the "big picture" and further details on Apache Isis' i18n support, see <a href="ugbtb.html#_ugbtb_more-advanced_i18n">here</a>.</p>
+<p>For the "big picture" and further details on Apache Isis' i18n support, see <a href="ugbtb.html#_ugbtb_i18n">here</a>.</p>
</div>
</td>
</tr>
@@ -8051,7 +8051,7 @@ further in this <a href="ugfun.html#_ugfun_how-tos_replacing-default-service-imp
<h3 id="_rgsvc_spi_UrlEncodingService">3.18. <code>UrlEncodingService</code> (<code>1.11.0-SNAPSHOT</code>)</h3>
<div class="paragraph">
<p>The <code>UrlEncodingService</code> (<code>1.11.0-SNAPSHOT</code>) defines a consistent way to convert strings to/from a form safe for use
-within a URL. The service is used by the framework to map <a href="ugbtb.html#_ugbtb_more-advanced_view-models">view model</a>
+within a URL. The service is used by the framework to map <a href="ugbtb.html#_ugbtb_view-models">view model</a>
mementos (derived from the state of the view model itself) into a form that can be used as a view model. When the
framework needs to recreate the view model (for example to invoke an action on it), this URL is converted back into a
view model memento, from which the view model can then be hydrated.</p>