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 2016/03/29 19:42:57 UTC
[01/23] isis-site git commit: ISIS-1287: updating docs for 1.12.0
Repository: isis-site
Updated Branches:
refs/heads/asf-site 576957917 -> 09aecf2c3
http://git-wip-us.apache.org/repos/asf/isis-site/blob/09aecf2c/content/index.html
----------------------------------------------------------------------
diff --git a/content/index.html b/content/index.html
index 243f16f..b149ee9 100644
--- a/content/index.html
+++ b/content/index.html
@@ -670,7 +670,7 @@ And I must say this: "Great Support from the development team"</p>
<div class="large-12 medium-12 columns">
<br/>
<br/>
- <p>The above screenshot shows the <code>ToDoItem</code> entity; an (optional) XML layout file provides metadata dividing the object members into rows, columns and tabs. Apache Isis also supports view models as well as entities, so you can also create dashboards and support for similar use cases:</p>
+ <p>The above screenshot shows the <code>ToDoItem</code> entity; an (optional) XML layout file provides metadata dividing the object members into rows, columns and tabs. Apache Isis also supports view models as well as entities, so you can also create dashboards, home pages and similar:</p>
</div>
</div>
@@ -694,7 +694,7 @@ And I must say this: "Great Support from the development team"</p>
mvn archetype:generate \
-D archetypeGroupId=org.apache.isis.archetype \
-D archetypeArtifactId=simpleapp-archetype \
- -D archetypeVersion=1.11.1 \
+ -D archetypeVersion=1.12.0 \
-D groupId=com.mycompany \
-D artifactId=myapp \
-D version=1.0-SNAPSHOT \
http://git-wip-us.apache.org/repos/asf/isis-site/blob/09aecf2c/content/isis-in-pictures.html
----------------------------------------------------------------------
diff --git a/content/isis-in-pictures.html b/content/isis-in-pictures.html
index 09e5241..15c2250 100644
--- a/content/isis-in-pictures.html
+++ b/content/isis-in-pictures.html
@@ -636,7 +636,7 @@ table.CodeRay td.code>pre{padding:0}
<td class="content">
<div class="paragraph">
<p>The remaining screenshots on this page are for v1.10.0 of the framework, which precedes the more recent support
-for tabbed views introduced in 1.12.0-SNAPSHOT.</p>
+for tabbed views introduced in v1.12.0.</p>
</div>
</td>
</tr>
http://git-wip-us.apache.org/repos/asf/isis-site/blob/09aecf2c/content/migration-notes.html
----------------------------------------------------------------------
diff --git a/content/migration-notes.html b/content/migration-notes.html
index 60d3fc1..e301dce 100644
--- a/content/migration-notes.html
+++ b/content/migration-notes.html
@@ -506,7 +506,98 @@ table.CodeRay td.code>pre{padding:0}
<h2 id="_migration-notes_1.11.0-to-1.12.0">From v1.11.0 to 1.12.0</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>Apache Isis 1.12.0-SNAPSHOT is still in development.</p>
+<p>Existing projects written against v1.11.x should run against v1.12.0 with few if any changes. If you <strong>do</strong> encounter
+any difficulties then let us know via the <a href="support.html">users mailing list</a>, so we can support you and document
+issues here.</p>
+</div>
+<div class="sect2">
+<h3 id="_dynamic_xml_layouts">Dynamic XML Layouts</h3>
+<div class="paragraph">
+<p>The major new feature in 1.12.0 is <a href="ugfun.html#_ugfun_object-layout_dynamic_xml">dynamic XML layouts</a>, providing
+much enhanced support for custom layouts.</p>
+</div>
+<div class="paragraph">
+<p>The new <code>Xxx.layout.xml</code> file is optional; without it domain objects will
+continue to be rendered as before, using metadata from annotations (<a href="rgant.html#_rgant_DomainObjectLayout"><code>@DomainObjectLayout</code></a>,
+<a href="rgant.html#_rgant_PropertyLayout"><code>@PropertyLayout</code></a>, <a href="rgant.html#_rgant_CollectionLayout"><code>@CollectionLayout</code></a>,
+<a href="rgant.html#_rgant_ActionLayout"><code>@ActionLayout</code></a>, <a href="rgant.html#_rgant_MemberOrder"><code>@MemberOrder</code></a> and
+<a href="rgant.html#_rgant_MemberGroupLayout"><code>@MemberGroupLayout</code></a>), and also from any <a href="ugfun.html#_ugfun_object-layout_dynamic"><code>Xxx.layout.json</code></a>
+file that might already exist. There is therefore no requirement to move to the new more flexible XML-based layout.</p>
+</div>
+<div class="paragraph">
+<p>If you do want to start using the new format, then you will find that 1.12.0 provides a mixin action (available in
+prototype mode only) called "download XML layout". This will allow you to download the current layout file for the
+object being rendered. This can then be saved alongside the class' Java source file. Once a <code>Xxx.layout.xml</code> file
+is present, any existing <code>Xxx.layout.json</code> file will be ignored; any annotations though will continue to be honoured.</p>
+</div>
+<div class="paragraph">
+<p>If you wish to migrate all your domain objects to use XML layouts, this can be done using the "download layouts (XML)"
+(on the "Prototyping" menu), as a single zip file. This can then be unzipped into the <code>src/main/java</code> directory.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_mixins">Mixins</h3>
+<div class="paragraph">
+<p>(As mentioned above), 1.12.0 provides a number of new mixin actions and properties:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="rgcms.html#_rgcms_classes_mixins_Object_clearHints">clear hints</a> action</p>
+</li>
+<li>
+<p><a href="rgcms.html#_rgcms_classes_mixins_Object_downloadLayoutXml">download Layout XML</a> action (prototype mode)</p>
+</li>
+<li>
+<p><a href="rgcms.html#_rgcms_classes_mixins_Object_rebuildMetamodel">rebuild metamodel</a> action (prototype mode)</p>
+</li>
+<li>
+<p><a href="rgcms.html#_rgcms_classes_mixins_Persistable_datanucleusXxx">id and version</a> properties (for domain entities only)</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>These are in addition to the <a href="rgcms.html#_rgcms_classes_mixins_Persistable_downloadJdoMetadata">download JDO metadata</a> mixin action (prototype mode) provided in earlier versions of the framework.</p>
+</div>
+<div class="paragraph">
+<p>The properties are grouped in a "metadata" fieldset, and the mixin actions associated with that fieldset. If the
+domain object is a view model rather than an entity (that is, has no id or version) then the actions will instead be rendered
+as top-level actions.</p>
+</div>
+<div class="paragraph">
+<p>Most of these mixin object members are visible only in prototype mode, though some are visible in production mode and
+so potentially visible to end-users. If you wish to suppress these members from the view, you can either use <a href="#ugsec.adoc">security</a>,
+or alternatively you can write <a href="rgcms.html#_rgcms_classes_super_AbstractSubscriber">subscriber</a>s to veto the visibility
+of these members by subscribing to their respective domain events.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_jaxb_view_models_are_editable">JAXB view models are editable</h3>
+<div class="paragraph">
+<p>All <a href="rgant.html#_rgant_XmlRootElement"><code>@XmlRootElement</code></a> view models are now implicitly editable. Therefore any
+view models that should be read-only should have editing attribute disabled using <a href="rgant.html#_rgant_DomainObject_editing"><code>@DomainObject#editing()</code></a> (or use a <a href="rgcms.html#_rgcms_classes_super_AbstractSubscriber">subscriber</a> to veto editability).</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="__code_domainobjectcontainer_code_domain_service"><code>DomainObjectContainer</code> domain service</h3>
+<div class="paragraph">
+<p>The <a href="rgsvc.html#_rgsvc_api_DomainObjectContainer"><code>DomainObjectContainer</code></a>domain service has been deprecated, with
+its methods moved to a new set of more fine-grained domain services, such as
+<a href="rgsvc.html#_rgsvc_api_RepositoryService"><code>RepositoryService</code></a> and
+<a href="rgsvc.html#_rgsvc_api_MessageService"><code>MessageService</code></a>.</p>
+</div>
+<div class="paragraph">
+<p>The <code>DomainObjectContainer</code> service will continue to be supported until Apache Isis v2.0.0, but in the meantime, consider
+changing existing application code to use these new domain services.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_removal_of_the_code_self_host_code_profile">Removal of the <code>self-host</code> profile</h3>
+<div class="paragraph">
+<p>The <code>self-host</code> profile has been removed from the <a href="ug.html#_ug_getting-started_simpleapp-archetype">SimpleApp archetype</a>.
+Instead, run the application using either the <code>org.apache.isis.WebServer</code> main class, or <code>mvn jetty:run</code>, or build the
+WAR and deploy to a servlet container such as Tomcat.</p>
+</div>
</div>
<div class="sect2">
<h3 id="__code_isis_viewer_wicket_disablemodaldialogs_code_removed"><code>isis.viewer.wicket.disableModalDialogs</code> removed</h3>
@@ -2004,6 +2095,11 @@ into the new <code>org.isisaddons.module.settings:isis-module-settings-dom</code
<ul class="sectlevel1">
<li><a href="#_migration-notes_1.11.0-to-1.12.0">From v1.11.0 to 1.12.0</a>
<ul class="sectlevel2">
+<li><a href="#_dynamic_xml_layouts">Dynamic XML Layouts</a></li>
+<li><a href="#_mixins">Mixins</a></li>
+<li><a href="#_jaxb_view_models_are_editable">JAXB view models are editable</a></li>
+<li><a href="#__code_domainobjectcontainer_code_domain_service"><code>DomainObjectContainer</code> domain service</a></li>
+<li><a href="#_removal_of_the_code_self_host_code_profile">Removal of the <code>self-host</code> profile</a></li>
<li><a href="#__code_isis_viewer_wicket_disablemodaldialogs_code_removed"><code>isis.viewer.wicket.disableModalDialogs</code> removed</a></li>
</ul>
</li>
http://git-wip-us.apache.org/repos/asf/isis-site/blob/09aecf2c/content/release-notes.html
----------------------------------------------------------------------
diff --git a/content/release-notes.html b/content/release-notes.html
index 9c57d50..07809b0 100644
--- a/content/release-notes.html
+++ b/content/release-notes.html
@@ -526,7 +526,7 @@ table.CodeRay td.code>pre{padding:0}
<p>Components</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>Notes</p>
+<p>Release notes</p>
</div></div></td>
<td class="tableblock halign-right valign-top"><p class="tableblock">Features</p></td>
<td class="tableblock halign-right valign-top"><p class="tableblock">Improves</p></td>
@@ -534,24 +534,22 @@ table.CodeRay td.code>pre{padding:0}
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#r1.12.0">1.12.0</a></p></td>
-<td class="tableblock halign-left valign-top"></td>
-<td class="tableblock halign-left valign-top"><div></div></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">29-mar-2016</p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p><code>1.12.0-SNAPSHOT</code> is still in development</p>
+<p><a href="https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311171&version=12327483">Release notes for v1.12.0</a></p>
</div></div></td>
-<td class="tableblock halign-right valign-top"></td>
-<td class="tableblock halign-right valign-top"></td>
-<td class="tableblock halign-right valign-top"></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>Dynamic XML layouts</p>
+</div></div></td>
+<td class="tableblock halign-right valign-top"><p class="tableblock">7</p></td>
+<td class="tableblock halign-right valign-top"><p class="tableblock">21</p></td>
+<td class="tableblock halign-right valign-top"><p class="tableblock">21</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#r1.11.1">1.11.1</a></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">17-jan-2016</p></td>
-<td class="tableblock halign-left valign-top"><div><div class="ulist">
-<ul>
-<li>
-<p><a href="https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311171&version=12334640">1.11.1</a></p>
-</li>
-</ul>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><a href="https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311171&version=12334640">Release notes for v1.11.1</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p>Re-release under Java 1.7 (using toolchains plugin).</p>
@@ -563,12 +561,8 @@ table.CodeRay td.code>pre{padding:0}
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#r1.11.0">1.11.0</a></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">02-jan-2016</p></td>
-<td class="tableblock halign-left valign-top"><div><div class="ulist">
-<ul>
-<li>
-<p><a href="https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311171&version=12333974">1.11.0</a></p>
-</li>
-</ul>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><a href="https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311171&version=12333974">Release notes for v1.11.0</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p>More flexible REST API, view models using JAXB.</p>
@@ -580,12 +574,8 @@ table.CodeRay td.code>pre{padding:0}
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#r1.10.0">1.10.0</a></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">10-nov-2015</p></td>
-<td class="tableblock halign-left valign-top"><div><div class="ulist">
-<ul>
-<li>
-<p><a href="https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311171&version=12333354">1.10.0</a></p>
-</li>
-</ul>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><a href="https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311171&version=12333354">Release notes for 1.10.0</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p>New domain services, multi-tenancy support and mixins.</p>
@@ -597,12 +587,8 @@ table.CodeRay td.code>pre{padding:0}
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#r1.9.0">1.9.0</a></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">1-sep-2015</p></td>
-<td class="tableblock halign-left valign-top"><div><div class="ulist">
-<ul>
-<li>
-<p><a href="https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311171&version=12332806">1.9.0</a></p>
-</li>
-</ul>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><a href="https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311171&version=12332806">Release notes for 1.9.0</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p>AppManifest, Restful Objects representations and other "under-the-cover" improvements.</p>
@@ -984,7 +970,7 @@ table.CodeRay td.code>pre{padding:0}
</div>
</div>
<div class="sect1">
-<h2 id="r1.12.0">1.12.0-SNAPSHOT</h2>
+<h2 id="r1.12.0">1.12.0</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="r1.12.0">1.12.0</h3>
@@ -1010,44 +996,27 @@ layout XML and rebuild the metamodel for a given domain entity. There is also a
functionality). In all cases these mixins can be hidden using either security or by writing a <a href="rgcms.html#_rgcms_classes_super_AbstractSubscriber">subscriber</a> to veto the visibility of the
corresponding domain event.</p>
</div>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-<div class="paragraph">
-<p>Apache Isis 1.12.0-SNAPSHOT is currently being voted on for release; expectation is that it will be released by end of March 2016.</p>
-</div>
-</td>
-</tr>
-</table>
-</div>
<div class="sect3">
<h4 id="_new_feature">New Feature</h4>
<div class="ulist">
<ul>
<li>
-<p><a href="https://issues.apache.org/jira/browse/ISIS-1351">ISIS-1351</a> - Extend ConfigurationService to list all configuration properties in the UI</p>
+<p><a href="https://issues.apache.org/jira/browse/ISIS-1351">ISIS-1351</a> - Extend <a href="rgsvc.html#_rgsvc_api_ConfigurationService"><code>ConfigurationService</code></a> to list all configuration properties in the UI</p>
</li>
<li>
-<p><a href="https://issues.apache.org/jira/browse/ISIS-1326">ISIS-1326</a> - Add a link to a "quotes" page on the main website.</p>
-</li>
-<li>
-<p><a href="https://issues.apache.org/jira/browse/ISIS-1325">ISIS-1325</a> - New SessionManagementService</p>
+<p><a href="https://issues.apache.org/jira/browse/ISIS-1325">ISIS-1325</a> - New <a href="rgsvc.html#_rgsvc_api_SessionManagementService"><code>SessionManagementService</code></a></p>
</li>
<li>
<p><a href="https://issues.apache.org/jira/browse/ISIS-1317">ISIS-1317</a> - Allow single domain object class to be invalidated through a mixin.</p>
</li>
<li>
-<p><a href="https://issues.apache.org/jira/browse/ISIS-1313">ISIS-1313</a> - Enhancement to xsd goal of the isis-maven-plugin to ignore/include the Isis common schemas.</p>
+<p><a href="https://issues.apache.org/jira/browse/ISIS-1313">ISIS-1313</a> - Enhancement to <a href="rgmvn.html#_rgmvn_xsd">xsd</a> goal of the isis-maven-plugin to ignore/include the Isis common schemas.</p>
</li>
<li>
-<p><a href="https://issues.apache.org/jira/browse/ISIS-1292">ISIS-1292</a> - Extend MetaModel service to surface packages, classes etc (as used by the security module).</p>
+<p><a href="https://issues.apache.org/jira/browse/ISIS-1292">ISIS-1292</a> - Extend <a href="rgsvc.html#_rgsvc_api_MetaModelService"><code>MetaModelService</code></a> to surface packages, classes etc (as used by the security module).</p>
</li>
<li>
-<p><a href="https://issues.apache.org/jira/browse/ISIS-993">ISIS-993</a> - Show different object members on multiple tabs</p>
+<p><a href="https://issues.apache.org/jira/browse/ISIS-993">ISIS-993</a> - Show different object members on multiple tabs (<a href="rgfun.html#_ugfun_object-layout_dynamic_xml">dynamic XML layouts</a>)</p>
</li>
<li>
<p><a href="https://issues.apache.org/jira/browse/ISIS-784">ISIS-784</a> - Change Wicket viewer to get rid of edit mode, instead allow individual fields to be edited by clicking on them (similar to the way that JIRA works).</p>
@@ -1063,7 +1032,7 @@ corresponding domain event.</p>
<p><a href="https://issues.apache.org/jira/browse/ISIS-1333">ISIS-1333</a> - Remove self-host profile from the archetype</p>
</li>
<li>
-<p><a href="https://issues.apache.org/jira/browse/ISIS-1332">ISIS-1332</a> - Factor out a HintStore service, so that this is pluggable.</p>
+<p><a href="https://issues.apache.org/jira/browse/ISIS-1332">ISIS-1332</a> - Factor out a <a href="rgsvc.html#_rgsvc_spi_HintStore"><code>HintStore</code></a> service, so that this is pluggable.</p>
</li>
<li>
<p><a href="https://issues.apache.org/jira/browse/ISIS-1330">ISIS-1330</a> - Add CSS classes for table cells and for collections to make it easier to fine tune pages using CSS.</p>
@@ -1075,28 +1044,28 @@ corresponding domain event.</p>
<p><a href="https://issues.apache.org/jira/browse/ISIS-1327">ISIS-1327</a> - Change the view mode of the select2 (value drop down) to be a simple text field.</p>
</li>
<li>
-<p><a href="https://issues.apache.org/jira/browse/ISIS-1324">ISIS-1324</a> - Allow multiple different views of same collection in a layout</p>
+<p><a href="https://issues.apache.org/jira/browse/ISIS-1324">ISIS-1324</a> - Allow multiple different views of same collection in a layout (<a href="rgfun.html#_ugfun_object-layout_dynamic_xml">dynamic XML layouts</a>)</p>
</li>
<li>
-<p><a href="https://issues.apache.org/jira/browse/ISIS-1323">ISIS-1323</a> - Deprecate @CollectionLayout#renderType, since is duplicated by …​</p>
+<p><a href="https://issues.apache.org/jira/browse/ISIS-1323">ISIS-1323</a> - Deprecate @CollectionLayout#renderType, since is duplicated by <a href="rgant.html#_rgant_CollectionLayout_defaultView"><code>@CollectionLayout#defaultView()</code></a></p>
</li>
<li>
<p><a href="https://issues.apache.org/jira/browse/ISIS-1322">ISIS-1322</a> - Mixins not exposing the mixedin object in events (for subscribers to veto).</p>
</li>
<li>
-<p><a href="https://issues.apache.org/jira/browse/ISIS-1321">ISIS-1321</a> - Extend MetaModel service to allow CSV of metamodel to be downloaded.</p>
+<p><a href="https://issues.apache.org/jira/browse/ISIS-1321">ISIS-1321</a> - Extend <a href="rgsvc.html#_rgsvc_api_MetaModelService"><code>MetaModelService</code></a> to allow CSV of metamodel to be downloaded.</p>
</li>
<li>
-<p><a href="https://issues.apache.org/jira/browse/ISIS-1320">ISIS-1320</a> - Move ContentMappingService to applib (and simplify)</p>
+<p><a href="https://issues.apache.org/jira/browse/ISIS-1320">ISIS-1320</a> - Move <a href="rgsvc.html#_rgsvc_spi_ContentMappingService"><code>ContentMappingService</code></a> to applib (and simplify)</p>
</li>
<li>
-<p><a href="https://issues.apache.org/jira/browse/ISIS-1312">ISIS-1312</a> - Improve JaxbServiceDefault#xsd(…​) to correctly reference the Isis common schema imports.</p>
+<p><a href="https://issues.apache.org/jira/browse/ISIS-1312">ISIS-1312</a> - Improve <a href="rgsvc.html#_rgsvc_api_JaxbService"><code>JaxbServiceDefault#xsd(…​)</code></a> to correctly reference the Isis common schema imports.</p>
</li>
<li>
<p><a href="https://issues.apache.org/jira/browse/ISIS-1300">ISIS-1300</a> - Allow the enablement of the WicketSource plugin to be configurable, and disabled by default</p>
</li>
<li>
-<p><a href="https://issues.apache.org/jira/browse/ISIS-1299">ISIS-1299</a> - @ViewModel and @XmlRootElement view models should automatically support isCloneable.</p>
+<p><a href="https://issues.apache.org/jira/browse/ISIS-1299">ISIS-1299</a> - <a href="rgant.html#_rgant_ViewModel"><code>@ViewModel</code></a> and <a href="rgant.html#_rgant_XmlRootElement"><code>@XmlRootElement</code></a> view models should automatically support isCloneable.</p>
</li>
<li>
<p><a href="https://issues.apache.org/jira/browse/ISIS-1298">ISIS-1298</a> - Fix deprecated annotation use for ViewModel.Cloneable#clone</p>
@@ -1108,16 +1077,16 @@ corresponding domain event.</p>
<p><a href="https://issues.apache.org/jira/browse/ISIS-1240">ISIS-1240</a> - Derive icon from service when not provided</p>
</li>
<li>
-<p><a href="https://issues.apache.org/jira/browse/ISIS-1239">ISIS-1239</a> - For wicket ui, use a cookie or similar to remember the hint from last time.</p>
+<p><a href="https://issues.apache.org/jira/browse/ISIS-1239">ISIS-1239</a> - For wicket ui, use a cookie or similar to remember the hint from last time (<a href="rgfun.html#_ugfun_object-layout_dynamic_xml">dynamic XML layouts</a>)</p>
</li>
<li>
-<p><a href="https://issues.apache.org/jira/browse/ISIS-1228">ISIS-1228</a> - Reorganizing/splitting out DomainObjectContainer service.</p>
+<p><a href="https://issues.apache.org/jira/browse/ISIS-1228">ISIS-1228</a> - Reorganizing/splitting out <a href="rgant.html#_rgant_DomainObjectContainer"><code>@DomainObjectContainer</code></a> service.</p>
</li>
<li>
-<p><a href="https://issues.apache.org/jira/browse/ISIS-1048">ISIS-1048</a> - Make view model URLs more secure, eg through a private key.</p>
+<p><a href="https://issues.apache.org/jira/browse/ISIS-1048">ISIS-1048</a> - Make view model URLs more secure, eg through a private key (<a href="rgsvc.html#_rgsvc_spi_UrlEncodingService"><code>UrlEncodingService</code></a>).</p>
</li>
<li>
-<p><a href="https://issues.apache.org/jira/browse/ISIS-1037">ISIS-1037</a> - Support layout.xml as well as layout.json</p>
+<p><a href="https://issues.apache.org/jira/browse/ISIS-1037">ISIS-1037</a> - Support layout.xml as well as layout.json (<a href="rgfun.html#_ugfun_object-layout_dynamic_xml">dynamic XML layouts</a>)</p>
</li>
<li>
<p><a href="https://issues.apache.org/jira/browse/ISIS-806">ISIS-806</a> - In Wicket viewer, shouldn’t be possible to invoke an action if editing a form.</p>
@@ -1130,7 +1099,7 @@ corresponding domain event.</p>
<div class="ulist">
<ul>
<li>
-<p><a href="https://issues.apache.org/jira/browse/ISIS-1348">ISIS-1348</a> - Bug with SoapEndpointPublishingRule when multiple endpoints.</p>
+<p><a href="https://issues.apache.org/jira/browse/ISIS-1348">ISIS-1348</a> - Bug with <a href="ugtst.html#_ugtst_unit-test-support_soap-fake-server-junit-rule">SoapEndpointPublishingRule</a> when multiple endpoints.</p>
</li>
<li>
<p><a href="https://issues.apache.org/jira/browse/ISIS-1347">ISIS-1347</a> - Missing annotation in SimpleObject</p>
@@ -1154,10 +1123,10 @@ corresponding domain event.</p>
<p><a href="https://issues.apache.org/jira/browse/ISIS-1319">ISIS-1319</a> - Input dialog for action label for mandatory parameter not shown when the parameter is an view model</p>
</li>
<li>
-<p><a href="https://issues.apache.org/jira/browse/ISIS-1318">ISIS-1318</a> - contributed actions/mixins breaks publishing; also flush any pending actions to be published as the result of doing a wrapped action via the WrapperFactory</p>
+<p><a href="https://issues.apache.org/jira/browse/ISIS-1318">ISIS-1318</a> - contributed actions/mixins breaks publishing; also flush any pending actions to be published as the result of doing a wrapped action via the <a href="rgsvc.html#_rgsvc_api_WrapperFactory"><code>WrapperFactory</code></a></p>
</li>
<li>
-<p><a href="https://issues.apache.org/jira/browse/ISIS-1315">ISIS-1315</a> - Can’t generate swagger specs, where actions are contributed.</p>
+<p><a href="https://issues.apache.org/jira/browse/ISIS-1315">ISIS-1315</a> - Can’t generate <a href="rgmvn.html#_rgmvn_swagger">swagger</a> specs, where actions are contributed.</p>
</li>
<li>
<p><a href="https://issues.apache.org/jira/browse/ISIS-1314">ISIS-1314</a> - Filename parameter label missing for DTO mixins</p>
@@ -1166,7 +1135,7 @@ corresponding domain event.</p>
<p><a href="https://issues.apache.org/jira/browse/ISIS-1311">ISIS-1311</a> - Mixins for Persistable metadata causes exception when rendering.</p>
</li>
<li>
-<p><a href="https://issues.apache.org/jira/browse/ISIS-1310">ISIS-1310</a> - DomainObjectContainter#titleOf(..) does not resolve @Title annotated on private field</p>
+<p><a href="https://issues.apache.org/jira/browse/ISIS-1310">ISIS-1310</a> - DomainObjectContainer#titleOf(..) does not resolve @Title annotated on private field</p>
</li>
<li>
<p><a href="https://issues.apache.org/jira/browse/ISIS-1309">ISIS-1309</a> - Disabled no-arg "are you sure" actions still show the prompt to be shown..</p>
@@ -5008,7 +4977,7 @@ category of UI events (so that titles, icons and CSS classes can be provided by
<div class="fallback-toc">
<ul class="sectlevel1">
<li><a href="#_summary">Summary</a></li>
-<li><a href="#r1.12.0">1.12.0-SNAPSHOT</a>
+<li><a href="#r1.12.0">1.12.0</a>
<ul class="sectlevel2">
<li><a href="#r1.12.0">1.12.0</a>
<ul class="sectlevel3">
http://git-wip-us.apache.org/repos/asf/isis-site/blob/09aecf2c/content/screencasts.html
----------------------------------------------------------------------
diff --git a/content/screencasts.html b/content/screencasts.html
index c2cb766..113544f 100644
--- a/content/screencasts.html
+++ b/content/screencasts.html
@@ -555,7 +555,7 @@ table.CodeRay td.code>pre{padding:0}
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>Dynamic XML layouts (v.1.12.0-SNAPSHOT)<br></p>
+<p>Dynamic XML layouts (v.1.12.0)<br></p>
</div>
<div class="paragraph">
<p><em>Describing how the layout of domain objects can be customized using the Bootstrap 3 grid system.</em></p>
[20/23] isis-site git commit: ISIS-1287: updating docs for 1.12.0
Posted by da...@apache.org.
http://git-wip-us.apache.org/repos/asf/isis-site/blob/09aecf2c/content/guides/rgant.html
----------------------------------------------------------------------
diff --git a/content/guides/rgant.html b/content/guides/rgant.html
index b7a7328..889c4a2 100644
--- a/content/guides/rgant.html
+++ b/content/guides/rgant.html
@@ -4086,14 +4086,610 @@ wrapping the target object using the <a href="rgsvc.html#_rgsvc_api_WrapperFacto
</tr>
</table>
</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_rgant-CollectionLayout">6. <code>@CollectionLayout</code></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The <code>@CollectionLayout</code> annotation applies to collections, collecting together all UI hints within a single
+annotation. It is also possible to apply the annotation to actions of domain services that are acting as contributed collections.</p>
+</div>
+<div class="paragraph">
+<p>The table below summarizes the annotation’s attributes.</p>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<caption class="title">Table 11. <code>@CollectionLayout</code> attributes</caption>
+<colgroup>
+<col style="width: 25%;">
+<col style="width: 25%;">
+<col style="width: 50%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Attribute</th>
+<th class="tableblock halign-left valign-top">Values (default)</th>
+<th class="tableblock halign-left valign-top">Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgant-CollectionLayout_cssClass"><code>cssClass()</code></a></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Any string valid as a CSS class</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>the css class that a collection should have, to allow more targetted styling in <a href="rgcfg.html#_rgcfg_application-specific_application-css"><code>application.css</code></a></p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgant-CollectionLayout_defaultView"><code>defaultView()</code></a></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>table</code>, <code>excel</code>, <code>calendar</code>, <code>map</code>, …​</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>Which view is selected by default, if multiple views are available.</p>
+</div>
+<div class="paragraph">
+<p>See (non-ASF) <a href="http://isisaddons.org">Isis Addons</a> for further views.</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgant-CollectionLayout_describedAs"><code>describedAs()</code></a></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">String.</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>description of this collection, eg to be rendered in a tooltip.</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgant-CollectionLayout_hidden"><code>hidden()</code></a></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>EVERYWHERE</code>, <code>OBJECT_FORMS</code>, <code>NOWHERE</code><br>
+(<code>NOWHERE</code>)</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>indicates where (in the UI) the collection should be hidden from the user.</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgant-CollectionLayout_named">named()</a></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">String.</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>to override the name inferred from the collection’s name in code.<br></p>
+</div>
+<div class="paragraph">
+<p>A typical use case is if the desired name is a reserved Java keyword, such as <code>default</code> or <code>package</code>.</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">namedEscaped()</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code>,<code>false</code> (<code>true</code>)</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>whether to HTML escape the name of this property.</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgant-CollectionLayout_paged"><code>paged()</code></a></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Positive integer</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>the page size for instances of this class when rendered within a table.</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgant-CollectionLayout_render"><code>render()</code></a></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>EAGERLY</code>, <code>LAZILY</code><br>
+(<code>LAZILY</code>)</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>whether the collection should be (eagerly) rendered open or (lazily) rendered closed</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgant-CollectionLayout_sortedBy"><code>sortedBy()</code></a></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Subclass of <code>java.util.Comparator</code> for element type</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>indicates that the elements in the <code>java.util.SortedSet</code> collection should be sorted according to a specified <code>Comparator</code> rather than their natural sort order.</p>
+</div></div></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p>For example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="directive">public</span> <span class="type">class</span> <span class="class">ToDoItem</span> {
+ <span class="annotation">@CollectionLayout</span>(
+ cssClass=<span class="string"><span class="delimiter">"</span><span class="content">x-key</span><span class="delimiter">"</span></span>,
+ named=<span class="string"><span class="delimiter">"</span><span class="content">Todo items that are <i>dependencies</i> of this item.</span><span class="delimiter">"</span></span>,
+ namedEscaped=<span class="predefined-constant">false</span>,
+ describedAs=<span class="string"><span class="delimiter">"</span><span class="content">Other todo items that must be completed before this one</span><span class="delimiter">"</span></span>,
+ labelPosition=LabelPosition.LEFT,
+ render=EAGERLY)
+ <span class="directive">public</span> <span class="predefined-type">SortedSet</span><ToDoItem> getDependencies() { ... }
+ ...
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>As an alternative to using the <code>@CollectionLayout</code> annotation, a dynamic layout using <a href="ugfun.html#_ugfun_object-layout_dynamic"><code>.layout.json</code></a> file can be specified; for example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="javascript"><span class="string"><span class="delimiter">"</span><span class="content">dependencies</span><span class="delimiter">"</span></span>: {
+ <span class="key"><span class="delimiter">"</span><span class="content">collectionLayout</span><span class="delimiter">"</span></span>: {
+ <span class="key"><span class="delimiter">"</span><span class="content">cssClass</span><span class="delimiter">"</span></span>: <span class="string"><span class="delimiter">"</span><span class="content">x-key</span><span class="delimiter">"</span></span>,
+ <span class="key"><span class="delimiter">"</span><span class="content">named</span><span class="delimiter">"</span></span>: <span class="string"><span class="delimiter">"</span><span class="content">Todo items that are <i>dependencies</i> of this item.</span><span class="delimiter">"</span></span>,
+ <span class="key"><span class="delimiter">"</span><span class="content">namedEscaped</span><span class="delimiter">"</span></span>: <span class="predefined-constant">false</span>,
+ <span class="key"><span class="delimiter">"</span><span class="content">describedAs</span><span class="delimiter">"</span></span>: <span class="string"><span class="delimiter">"</span><span class="content">Other todo items that must be completed before this one</span><span class="delimiter">"</span></span>,
+ <span class="key"><span class="delimiter">"</span><span class="content">labelPosition</span><span class="delimiter">"</span></span>: <span class="string"><span class="delimiter">"</span><span class="content">LEFT</span><span class="delimiter">"</span></span>,
+ <span class="key"><span class="delimiter">"</span><span class="content">render</span><span class="delimiter">"</span></span>: <span class="string"><span class="delimiter">"</span><span class="content">EAGERLY</span><span class="delimiter">"</span></span>
+ }
+}</code></pre>
+</div>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>The annotation is one of a handful (others including <a href="#_rgant-Collection"><code>@Collection</code></a>, <a href="#_rgant-Property"><code>@Property</code></a> and <a href="#_rgant-PropertyLayout"><code>@PropertyLayout</code></a>) that can also be applied to the field, rather than the getter method. This is specifically
+so that boilerplate-busting tools such as <a href="https://projectlombok.org/">Project Lombok</a> can be used.</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2">
+<h3 id="_rgant-CollectionLayout_cssClass">6.1. <code>cssClass()</code></h3>
+<div class="paragraph">
+<p>The <code>cssClass()</code> attribute can be used to render additional CSS classes in the HTML (a wrapping <code><div></code>) that represents the collection. <a href="rgcfg.html#_rgcfg_application-specific_application-css">Application-specific CSS</a> can then be used to target and adjust the UI representation of that particular element.</p>
+</div>
+<div class="paragraph">
+<p>This attribute can also be applied to <a href="#_rgant-DomainObjectLayout_cssClass">domain objects</a>, <a href="#_rgant-ViewModelLayout_cssClass">view models</a>, <a href="#_rgant-ActionLayout_cssClass">actions</a>, <a href="#_rgant-PropertyLayout_cssClass">properties</a> and <a href="#_rgant-ParameterLayout_cssClass">parameters</a>.</p>
+</div>
+<div class="paragraph">
+<p>For example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="directive">public</span> <span class="type">class</span> <span class="class">ToDoItem</span> {
+ <span class="annotation">@CollectionLayout</span>(
+ cssClass=<span class="string"><span class="delimiter">"</span><span class="content">x-important</span><span class="delimiter">"</span></span>
+ )
+ <span class="directive">public</span> <span class="predefined-type">SortedSet</span><ToDoItem> getDependencies() { ... }
+ ...
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>As an alternative to using the annotation, the dynamic <a href="ugfun.html#_ugfun_object-layout_dynamic"><code>.layout.json</code></a>
+can be used instead, eg:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="javascript"><span class="string"><span class="delimiter">"</span><span class="content">dependencies</span><span class="delimiter">"</span></span>: {
+ <span class="key"><span class="delimiter">"</span><span class="content">collectionLayout</span><span class="delimiter">"</span></span>: { <span class="key"><span class="delimiter">"</span><span class="content">cssClass</span><span class="delimiter">"</span></span>: <span class="string"><span class="delimiter">"</span><span class="content">x-important</span><span class="delimiter">"</span></span> }
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_rgant-CollectionLayout_defaultView">6.2. <code>defaultView()</code></h3>
+<div class="paragraph">
+<p>The <a href="ugvw.html">Wicket viewer</a> allows additional views to be configured to render collections of objects; at the time of writing thesee include the (non-ASF) (non-ASF) <a href="http://isisaddons.org">Isis Addons</a>' (non-ASF) <a href="http://github.com/isisaddons/isis-wicket-excel">excel</a> view, the <a href="http://github.com/isisaddons/isis-wicket-fullcalendar2">fullcalendar2</a> view, and the <a href="http://github.com/isisaddons/isis-wicket-gmap3">gmap3</a> view. If the objects to be rendered have the correct "shape", then the appropriate view will be made available. For example, objects with a date can be rendered using <code>calendar</code>; objects with locations can be rendered using <code>map</code>.</p>
+</div>
+<div class="paragraph">
+<p>The <code>defaultView()</code> attribute is used to select which of these views should be used by default for a given collection.</p>
+</div>
+<div class="paragraph">
+<p>For example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="directive">public</span> <span class="type">class</span> <span class="class">BusRoute</span> {
+ <span class="annotation">@CollectionLayout</span>(
+ defaultView=<span class="string"><span class="delimiter">"</span><span class="content">map</span><span class="delimiter">"</span></span>
+ )
+ <span class="directive">public</span> <span class="predefined-type">SortedSet</span><BusStop> getStops() { ... }
+ ...
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>As an alternative to using the annotation, the dynamic <a href="ugfun.html#_ugfun_object-layout_dynamic"><code>.layout.json</code></a>
+can be used instead, eg:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="javascript"><span class="string"><span class="delimiter">"</span><span class="content">dependencies</span><span class="delimiter">"</span></span>: {
+ <span class="key"><span class="delimiter">"</span><span class="content">collectionLayout</span><span class="delimiter">"</span></span>: {
+ <span class="key"><span class="delimiter">"</span><span class="content">defaultView</span><span class="delimiter">"</span></span>: <span class="string"><span class="delimiter">"</span><span class="content">map</span><span class="delimiter">"</span></span>
+ }
+}</code></pre>
+</div>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>This attribute takes precedence over any value for the <a href="#_rgant-CollectionLayout_render"><code>@CollectionLayout#render()</code></a> attribute. For example, if the
+<code>defaultView</code> attribute is defined to "table", then the table will be show even if <code>render</code> is set to <code>LAZILY</code>.</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_rgant-CollectionLayout_describedAs">6.3. <code>describedAs()</code></h3>
+<div class="paragraph">
+<p>The <code>describedAs()</code> attribute is used to provide a short description of the collection to the user. In the <a href="ugvw.html">Wicket viewer</a> it is displayed as a 'tool tip'.</p>
+</div>
+<div class="paragraph">
+<p>The <code>describedAs()</code> attribute can also be specified for <a href="#_rgant-PropertyLayout_describedAs">properties</a>, <a href="#_rgant-ActionLayout_describedAs">actions</a>, <a href="#_rgant-ParameterLayout_describedAs">parameters</a>, <a href="#_rgant-DomainObjectLayout_describedAs">domain objects</a> and <a href="#_rgant-ViewModelLayout_describedAs">view models</a>.</p>
+</div>
+<div class="paragraph">
+<p>For example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="directive">public</span> <span class="type">class</span> <span class="class">ToDoItem</span> {
+ <span class="annotation">@CollectionLayout</span>(
+ describedAs=<span class="string"><span class="delimiter">"</span><span class="content">Other todo items that must be completed before this one</span><span class="delimiter">"</span></span>
+ )
+ <span class="directive">public</span> <span class="predefined-type">SortedSet</span><ToDoItem> getDependencies() { ... }
+ ...
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>As an alternative to using the annotation, the dynamic <a href="ugfun.html#_ugfun_object-layout_dynamic"><code>.layout.json</code></a>
+can be used instead, eg:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="javascript"><span class="string"><span class="delimiter">"</span><span class="content">dependencies</span><span class="delimiter">"</span></span>: {
+ <span class="key"><span class="delimiter">"</span><span class="content">collectionLayout</span><span class="delimiter">"</span></span>: {
+ <span class="key"><span class="delimiter">"</span><span class="content">describedAs</span><span class="delimiter">"</span></span>: <span class="string"><span class="delimiter">"</span><span class="content">Other todo items that must be completed before this one</span><span class="delimiter">"</span></span>
+ }
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_rgant-CollectionLayout_hidden">6.4. <code>hidden()</code></h3>
+<div class="paragraph">
+<p>The <code>hidden()</code> attribute indicates where (in the UI) the collection should be hidden from the user. This attribute can also be applied to <a href="#_rgant-ActionLayout_hidden">actions</a> and <a href="#_rgant-PropertyLayout_hidden">properties</a>.</p>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>It is also possible to use <a href="#_rgant-Collection_hidden"><code>@Collection#hidden()</code></a> to hide an action at the domain layer. Both options are provided with a view that in the future the view-layer semantics may be under the control of (expert) users, whereas domain-layer semantics should never be overridden or modified by the user.</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>For example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="directive">public</span> <span class="type">class</span> <span class="class">ToDoItem</span> {
+ <span class="annotation">@CollectionLayout</span>(
+ hidden=Where.EVERYWHERE
+ <span class="directive">public</span> <span class="predefined-type">SortedSet</span><ToDoItem> getDependencies() { ... }
+ ...
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The acceptable values for the <code>where</code> parameter are:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>Where.EVERYWHERE</code> or <code>Where.ANYWHERE</code><br></p>
+<div class="paragraph">
+<p>The collection should be hidden everywhere.</p>
+</div>
+</li>
+<li>
+<p><code>Where.ANYWHERE</code><br></p>
+<div class="paragraph">
+<p>Synonym for everywhere.</p>
+</div>
+</li>
+<li>
+<p><code>Where.OBJECT_FORMS</code><br></p>
+<div class="paragraph">
+<p>The collection should be hidden when displayed within an object form.</p>
+</div>
+</li>
+<li>
+<p><code>Where.NOWHERE</code><br></p>
+<div class="paragraph">
+<p>The collection should not be hidden.</p>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The other values of the <code>Where</code> enum have no meaning for a collection.</p>
+</div>
+<div class="paragraph">
+<p>As an alternative to using the annotation, the dynamic <a href="ugfun.html#_ugfun_object-layout_dynamic"><code>.layout.json</code></a>
+can be used instead, eg:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="javascript"><span class="string"><span class="delimiter">"</span><span class="content">dependencies</span><span class="delimiter">"</span></span>: {
+ <span class="key"><span class="delimiter">"</span><span class="content">collectionLayout</span><span class="delimiter">"</span></span>: { <span class="key"><span class="delimiter">"</span><span class="content">hidden</span><span class="delimiter">"</span></span>: <span class="string"><span class="delimiter">"</span><span class="content">EVERYWHERE</span><span class="delimiter">"</span></span> }
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_rgant-CollectionLayout_named">6.5. <code>named()</code></h3>
+<div class="paragraph">
+<p>The <code>named()</code> attribute explicitly specifies the collection’s name, overriding the name that would normally be inferred from the Java source code. This attribute can also be specified for <a href="#_rgant-ActionLayout_named">actions</a>, <a href="#_rgant-PropertyLayout_named">properties</a>, <a href="#_rgant-ParameterLayout_named">parameters</a>, <a href="#_rgant-DomainObjectLayout_named">domain objects</a>, <a href="#_rgant-ViewModelLayout_named">view models</a> and <a href="#_rgant-DomainServiceLayout_named">domain services</a>.</p>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>Following the <a href="http://en.wikipedia.org/wiki/Don%27t_repeat_yourself">don’t repeat yourself</a> principle, we recommend that you only use this attribute when the desired name cannot be used in Java source code. Examples of that include a name that would be a reserved Java keyword (eg "package"), or a name that has punctuation, eg apostrophes.</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>By default the name is HTML escaped. To allow HTML markup, set the related <code>namedEscaped()</code> attribute to <code>false</code>.</p>
+</div>
+<div class="paragraph">
+<p>For example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="directive">public</span> <span class="type">class</span> <span class="class">ToDoItem</span> {
+ <span class="annotation">@CollectionLayout</span>(
+ named=<span class="string"><span class="delimiter">"</span><span class="content">Todo items that are <i>dependencies</i> of this item</span><span class="delimiter">"</span></span>,
+ namedEscaped=<span class="predefined-constant">false</span>
+ )
+ <span class="directive">public</span> <span class="predefined-type">SortedSet</span><ToDoItem getDependencies() { ... }
+ ...
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>As an alternative to using the annotation, the dynamic <a href="ugfun.html#_ugfun_object-layout_dynamic"><code>.layout.json</code></a>
+can be used instead, eg:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="javascript"><span class="string"><span class="delimiter">"</span><span class="content">dependencies</span><span class="delimiter">"</span></span>: {
+ <span class="key"><span class="delimiter">"</span><span class="content">collectionLayout</span><span class="delimiter">"</span></span>: {
+ <span class="key"><span class="delimiter">"</span><span class="content">named</span><span class="delimiter">"</span></span>: <span class="string"><span class="delimiter">"</span><span class="content">Todo items that are <i>dependencies</i> of this item</span><span class="delimiter">"</span></span>,
+ <span class="key"><span class="delimiter">"</span><span class="content">namedEscaped</span><span class="delimiter">"</span></span>: <span class="predefined-constant">false</span>,
+ }
+}</code></pre>
+</div>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>The framework also provides a separate, powerful mechanism for <a href="ugbtb.html#_ugbtb_i18n">internationalization</a>.</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_rgant-CollectionLayout_paged">6.6. <code>paged()</code></h3>
+<div class="paragraph">
+<p>The <code>paged()</code> attribute specifies the number of rows to display in a (parented) collection. This attribute can also be applied to <a href="#_rgant-DomainObjectLayout_paged">domain objects</a> and <a href="#_rgant-ViewModelLayout_paged">view models</a>.</p>
+</div>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title="Warning"></i>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>The <a href="ugvro.html">RestfulObjects viewer</a> currently does not support paging. The <a href="ugvw.html">Wicket viewer</a> <em>does</em> support paging, but note that the paging is performed client-side rather than server-side.</p>
+</div>
+<div class="paragraph">
+<p>We therefore recommend that large collections should instead be modelled as actions (to allow filtering to be applied to limit the number of rows).</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>For example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="directive">public</span> <span class="type">class</span> <span class="class">Order</span> {
+ <span class="annotation">@CollectionLayout</span>(paged=<span class="integer">15</span>)
+ <span class="directive">public</span> <span class="predefined-type">SortedSet</span><OrderLine> getDetails() {...}
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>It is also possible to specify a global default for the page size of standalone collections, using the <a href="rgcfg.html#_rgcfg_configuring-core">configuration property</a> <code>isis.viewer.paged.parented</code>.</p>
+</div>
<div class="paragraph">
-<p>Unresolved directive in rgant.adoc - include::_rgant-Collectionlayout.adoc[leveloffset=+1]
-:leveloffset: +1</p>
+<p>As an alternative to using the annotation, the dynamic <a href="ugfun.html#_ugfun_object-layout_dynamic"><code>.layout.json</code></a>
+can be used instead, eg:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="javascript"><span class="string"><span class="delimiter">"</span><span class="content">details</span><span class="delimiter">"</span></span>: {
+ <span class="key"><span class="delimiter">"</span><span class="content">collectionLayout</span><span class="delimiter">"</span></span>: {
+ <span class="key"><span class="delimiter">"</span><span class="content">paged</span><span class="delimiter">"</span></span>: <span class="integer">15</span>
+ }
+}</code></pre>
</div>
</div>
</div>
+<div class="sect2">
+<h3 id="_rgant-CollectionLayout_render">6.7. <code>render()</code></h3>
+<div class="paragraph">
+<p>The <code>render()</code> attribute specifies that the collection be rendered either "eagerly" (shown open, displaying its contents) or "lazily" (shown closed, hiding its contents). The terminology here is based on the similar concept of lazy loading of collections in the domain/persistence layer boundary (except that the rendering relates to the presentation/domain layer boundary).</p>
</div>
-<h1 id="_rgant-Column" class="sect0"><code>@Column</code> (<code>javax.jdo</code>)</h1>
+<div class="paragraph">
+<p>For example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="directive">public</span> <span class="type">class</span> <span class="class">Order</span> {
+ <span class="annotation">@CollectionLayout</span>(render=RenderType.EAGERLY)
+ <span class="directive">public</span> <span class="predefined-type">SortedSet</span><LineItem> getDetails() { ... }
+ ...
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>As an alternative to using the annotation, the dynamic <a href="ugfun.html#_ugfun_object-layout_dynamic"><code>.layout.json</code></a>
+can be used instead, eg:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="javascript"><span class="string"><span class="delimiter">"</span><span class="content">details</span><span class="delimiter">"</span></span>: {
+ <span class="key"><span class="delimiter">"</span><span class="content">collectionLayout</span><span class="delimiter">"</span></span>: {
+ <span class="key"><span class="delimiter">"</span><span class="content">render</span><span class="delimiter">"</span></span>: <span class="string"><span class="delimiter">"</span><span class="content">EAGERLY</span><span class="delimiter">"</span></span>
+ }
+}</code></pre>
+</div>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>Note that <a href="ugfun.html#_ugfun_how-tos_contributed-members">contributed collections</a> (which, under the covers are just action invocations against a domain service) are always rendered eagerly.</p>
+</div>
+<div class="paragraph">
+<p>Also, if a <a href="#_rgant-CollectionLayout_defaultView"><code>@CollectionLayout#defaultView()</code></a> attribute has been specified then that will take precedence over the value of the <code>render()</code> attribute.</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_rgant-CollectionLayout_sortedBy">6.8. <code>sortedBy()</code></h3>
+<div class="paragraph">
+<p>The <code>sortedBy()</code> attribute specifies that the collection be ordered using the specified comparator, rather than the natural ordering of the entity (as would usually be the case).</p>
+</div>
+<div class="paragraph">
+<p>For example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="directive">public</span> <span class="type">class</span> <span class="class">ToDoItem</span> <span class="directive">implements</span> <span class="predefined-type">Comparable</span><ToDoItem> { <i class="conum" data-value="1"></i><b>(1)</b>
+ <span class="directive">public</span> <span class="directive">static</span> <span class="type">class</span> <span class="class">DependenciesComparator</span> <i class="conum" data-value="2"></i><b>(2)</b>
+ <span class="directive">implements</span> <span class="predefined-type">Comparator</span><ToDoItem> {
+ <span class="annotation">@Override</span>
+ <span class="directive">public</span> <span class="type">int</span> compare(ToDoItem p, ToDoItem q) {
+ <span class="keyword">return</span> ORDERING_BY_DESCRIPTION <i class="conum" data-value="3"></i><b>(3)</b>
+ .compound(Ordering.<ToDoItem>natural())
+ .compare(p, q);
+ }
+ }
+ <span class="annotation">@CollectionLayout</span>(sortedBy=DependenciesComparator.class) <i class="conum" data-value="4"></i><b>(4)</b>
+ <span class="directive">public</span> <span class="predefined-type">SortedSet</span><ToDoItem> getDependencies() { ... }
+ ...
+}</code></pre>
+</div>
+</div>
+<div class="colist arabic">
+<table>
+<tr>
+<td><i class="conum" data-value="1"></i><b>1</b></td>
+<td>the class has a natural ordering (implementation not shown)</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="2"></i><b>2</b></td>
+<td>declaration of the comparator class</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="3"></i><b>3</b></td>
+<td>ordering defined as being by the object’s <code>description</code> property (not shown), and then by the natural ordering of the class</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="4"></i><b>4</b></td>
+<td>specify the comparator to use</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>When the <code>dependencies</code> collection is rendered, the elements are sorted by the <code>description</code> property first:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<a class="image" href="images/reference-annotations/CollectionLayout/sortedby-dependencies.png"><img src="images/reference-annotations/CollectionLayout/sortedby-dependencies.png" alt="sortedby dependencies" width="720px"></a>
+</div>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>Note that this screenshot shows an earlier version of the <a href="ugvw.html">Wicket viewer</a> UI (specifically, pre 1.8.0).</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Without this annotation, the order would have been inverted (because the natural ordering places items not completed before those items that have been completed.</p>
+</div>
+<div class="paragraph">
+<p>As an alternative to using the annotation, the dynamic <a href="ugfun.html#_ugfun_object-layout_dynamic"><code>.layout.json</code></a>
+can be used instead, eg:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="javascript"><span class="string"><span class="delimiter">"</span><span class="content">dependencies</span><span class="delimiter">"</span></span>: {
+ <span class="key"><span class="delimiter">"</span><span class="content">collectionLayout</span><span class="delimiter">"</span></span>: {
+ <span class="key"><span class="delimiter">"</span><span class="content">sortedBy</span><span class="delimiter">"</span></span>: <span class="string"><span class="delimiter">"</span><span class="content">com.mycompany.myapp.dom.ToDoItem.DependenciesComparator</span><span class="delimiter">"</span></span>
+ }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_rgant-Column">7. <code>@Column</code> (<code>javax.jdo</code>)</h2>
+<div class="sectionbody">
<div class="paragraph">
<p>The JDO <code>@javax.jdo.annotation.Column</code> provides metadata describing how JDO/DataNucleus should persist the property to a database RDBMS table column (or equivalent concept for other persistence stores).</p>
</div>
@@ -4120,9 +4716,8 @@ wrapping the target object using the <a href="rgsvc.html#_rgsvc_api_WrapperFacto
<div class="paragraph">
<p>This section identifies which attributes of <code>@Column</code> are recognized and used by Apache Isis.</p>
</div>
-<div class="sect1">
-<h2 id="_nullability">1. Nullability</h2>
-<div class="sectionbody">
+<div class="sect2">
+<h3 id="_nullability">7.1. Nullability</h3>
<div class="paragraph">
<p>The <code>allowsNull()</code> attribute is used to specify if a property is mandatory or is optional.</p>
</div>
@@ -4147,10 +4742,8 @@ wrapping the target object using the <a href="rgsvc.html#_rgsvc_api_WrapperFacto
<p>In the vast majority of cases you should be fine just to add the <code>@Column#allowsNull()</code> attribute to the getter. But see the documentation for <a href="#_rgant-Property_optionality"><code>@Property#optionality()</code></a> attribute for discussion on one or two minor edge cases.</p>
</div>
</div>
-</div>
-<div class="sect1">
-<h2 id="_length_for_code_string_code_s">2. Length for <code>String</code>s</h2>
-<div class="sectionbody">
+<div class="sect2">
+<h3 id="_length_for_code_string_code_s">7.2. Length for <code>String</code>s</h3>
<div class="paragraph">
<p>The <code>length()</code> attribute is used to specify the length of <code>java.lang.String</code> property types as they map to <code>varchar(n)</code> columns.</p>
</div>
@@ -4175,10 +4768,8 @@ wrapping the target object using the <a href="rgsvc.html#_rgsvc_api_WrapperFacto
<p>Isis also provides <a href="#_rgant-Property_maxLength"><code>@Property#maxLength()</code></a> attribute. If both are specified, Apache Isis will check when it initializes for any contradictions, and will fail-fast with an appropriate error message in the log if there are.</p>
</div>
</div>
-</div>
-<div class="sect1">
-<h2 id="_length_scale_for_code_bigdecimal_code_s">3. Length/scale for <code>BigDecimal</code>s</h2>
-<div class="sectionbody">
+<div class="sect2">
+<h3 id="_length_scale_for_code_bigdecimal_code_s">7.3. Length/scale for <code>BigDecimal</code>s</h3>
<div class="paragraph">
<p>The <code>length()</code> and <code>scale()</code> attributes are used to infer the precision/scale of <code>java.math.BigDecimal</code> property types as they map to <code>decimal(n,p)</code> columns.</p>
</div>
@@ -4200,15 +4791,13 @@ wrapping the target object using the <a href="rgsvc.html#_rgsvc_api_WrapperFacto
<p>If both are specified, Apache Isis will check when it initializes for any contradictions, and will fail-fast with an appropriate error message in the log if there are.</p>
</div>
</div>
-</div>
-<div class="sect1">
-<h2 id="_hints_and_tips">4. Hints and Tips</h2>
-<div class="sectionbody">
+<div class="sect2">
+<h3 id="_hints_and_tips">7.4. Hints and Tips</h3>
<div class="paragraph">
<p>This seems to be a good place to describe some additional common mappings that use <code>@Column</code>. Unlike the sections above, the attributes specified in these hints and tips aren’t actually part of Apache Isis metamodel.</p>
</div>
-<div class="sect2">
-<h3 id="_mapping_foreign_keys">4.1. Mapping foreign keys</h3>
+<div class="sect3">
+<h4 id="_mapping_foreign_keys">7.4.1. Mapping foreign keys</h4>
<div class="paragraph">
<p>The <code>name()</code> attribute can be used to override the name of the column. References to other objects are generally mapped as foreign key columns. If there are multiple references to a given type, then you will want to override the name that JDO/DataNucleus would otherwise default.</p>
</div>
@@ -4230,10 +4819,8 @@ wrapping the target object using the <a href="rgsvc.html#_rgsvc_api_WrapperFacto
</div>
</div>
</div>
-</div>
-<div class="sect1">
-<h2 id="_mapping_code_blob_code_s_and_code_clob_code_s">5. Mapping <code>Blob</code>s and <code>Clob</code>s</h2>
-<div class="sectionbody">
+<div class="sect2">
+<h3 id="_mapping_code_blob_code_s_and_code_clob_code_s">7.5. Mapping <code>Blob</code>s and <code>Clob</code>s</h3>
<div class="paragraph">
<p>Isis provides custom value types for <a href="rgcms.html#_rgcms_classes_value-types_Blob"><code>Blob</code></a>s and <a href="rgcms.html#_rgcms_classes_value-types_Clob"><code>Clob</code></a>s. These value types have multiple internal fields, meaning that they corresponding to multiple columns in the database. Mapping this correctly requires using <code>@Column</code> within JDO’s <code>@Persistent</code> annotation.</p>
</div>
@@ -4276,8 +4863,9 @@ wrapping the target object using the <a href="rgsvc.html#_rgsvc_api_WrapperFacto
</div>
</div>
</div>
+</div>
<div class="sect1">
-<h2 id="_rgant-Digits">6. <code>@Digits</code> (<code>javax</code>)</h2>
+<h2 id="_rgant-Digits">8. <code>@Digits</code> (<code>javax</code>)</h2>
<div class="sectionbody">
<div class="paragraph">
<p>The <code>@javax.validation.constraints.Digits</code> annotation is recognized by Apache Isis as a means to specify the precision for properties and action parameters of type <code>java.math.BigDecimal</code>.</p>
@@ -4323,7 +4911,7 @@ wrapping the target object using the <a href="rgsvc.html#_rgsvc_api_WrapperFacto
</div>
</div>
<div class="sect1">
-<h2 id="_rgant-Discriminator">7. <code>@Discriminator</code> (<code>javax.jdo</code>)</h2>
+<h2 id="_rgant-Discriminator">9. <code>@Discriminator</code> (<code>javax.jdo</code>)</h2>
<div class="sectionbody">
<div class="paragraph">
<p>The <code>@javax.jdo.annotation.Discriminator</code> is used by JDO/DataNucleus to specify how to discriminate between subclasses of an inheritance hierarchy.</p>
@@ -4427,7 +5015,7 @@ wrapping the target object using the <a href="rgsvc.html#_rgsvc_api_WrapperFacto
</div>
</div>
<div class="sect1">
-<h2 id="_rgant-DomainObject">8. <code>@DomainObject</code></h2>
+<h2 id="_rgant-DomainObject">10. <code>@DomainObject</code></h2>
<div class="sectionbody">
<div class="paragraph">
<p>The <code>@DomainObject</code> annotation applies to domain objects, collecting together all domain semantics within a single annotation.</p>
@@ -4436,7 +5024,7 @@ wrapping the target object using the <a href="rgsvc.html#_rgsvc_api_WrapperFacto
<p>The table below summarizes the annotation’s attributes.</p>
</div>
<table class="tableblock frame-all grid-all spread">
-<caption class="title">Table 11. <code>@DomainObject</code> attributes</caption>
+<caption class="title">Table 12. <code>@DomainObject</code> attributes</caption>
<colgroup>
<col style="width: 25%;">
<col style="width: 25%;">
@@ -4601,7 +5189,7 @@ wrapping the target object using the <a href="rgsvc.html#_rgsvc_api_WrapperFacto
</table>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainObject_auditing">8.1. <code>auditing()</code></h3>
+<h3 id="_rgant-DomainObject_auditing">10.1. <code>auditing()</code></h3>
<div class="paragraph">
<p>The <code>auditing()</code> attribute indicates that if the object is modified, then each of its changed properties should be submitted to the <a href="rgsvc.html#_rgsvc_spi_AuditingService"><code>AuditingService</code></a>, if one has been configured.</p>
</div>
@@ -4653,7 +5241,7 @@ wrapping the target object using the <a href="rgsvc.html#_rgsvc_api_WrapperFacto
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainObject_autoCompleteRepository">8.2. <code>autoCompleteRepository()</code></h3>
+<h3 id="_rgant-DomainObject_autoCompleteRepository">10.2. <code>autoCompleteRepository()</code></h3>
<div class="paragraph">
<p>The <code>autoCompleteRepository()</code> attribute nominates a single method on a domain service as the fallback means for lookuping up instances of the domain object using a simple string.</p>
</div>
@@ -4712,7 +5300,7 @@ wrapping the target object using the <a href="rgsvc.html#_rgsvc_api_WrapperFacto
</table>
</div>
<div class="sect3">
-<h4 id="__code_autocompleteaction_code">8.2.1. <code>autoCompleteAction()</code></h4>
+<h4 id="__code_autocompleteaction_code">10.2.1. <code>autoCompleteAction()</code></h4>
<div class="paragraph">
<p>As noted above, by default the method invoked on the repository is assumed to be called "autoComplete". The optional <code>autoCompleteAction()</code> attribute allows the method on the repository to be overridden.</p>
</div>
@@ -4759,7 +5347,7 @@ wrapping the target object using the <a href="rgsvc.html#_rgsvc_api_WrapperFacto
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainObject_bounded">8.3. <code>bounded()</code></h3>
+<h3 id="_rgant-DomainObject_bounded">10.3. <code>bounded()</code></h3>
<div class="paragraph">
<p>Some domain classes are immutable to the user, and moreover have only a fixed number of instances. Often these are "reference" ("standing") data, or lookup data/pick lists. Typical examples could include categories, countries, states, and tax or interest rate tables.</p>
</div>
@@ -4804,7 +5392,7 @@ wrapping the target object using the <a href="rgsvc.html#_rgsvc_api_WrapperFacto
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainObject_createdLifecycleEvent">8.4. createdLifecycleEvent()</h3>
+<h3 id="_rgant-DomainObject_createdLifecycleEvent">10.4. createdLifecycleEvent()</h3>
<div class="paragraph">
<p>Whenever a domain object is instantiated or otherwise becomes known to the framework, a "created" lifecycle event is fired. This is typically when the <a href="rgsvc.html#_rgsvc_api_DomainObjectContainer"><code>DomainObjectContainer</code></a>'s <a href="rgsvc.html#_rgsvc_api_DomainObjectContainer_object-creation-api"><code>newTransientInstance()</code></a> is called;
it will also happen if the object is simply instantiated with <code>new(…​)</code>, and then the container’s
@@ -4849,7 +5437,7 @@ attribute is available for other lifecycle events.</p>
<p>The benefit is that subscribers can be more targeted as to the events that they subscribe to.</p>
</div>
<div class="sect3">
-<h4 id="_subscribers_3">8.4.1. Subscribers</h4>
+<h4 id="_subscribers_3">10.4.1. Subscribers</h4>
<div class="paragraph">
<p>Subscribers (which must be domain services) subscribe using either the <a href="https://github.com/google/guava">Guava</a> API
or (if the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> has been appropriately configured)
@@ -4899,7 +5487,7 @@ using the <a href="http://www.axonframework.org/">Axon Framework</a> API. The e
</div>
</div>
<div class="sect3">
-<h4 id="_default_doop_and_noop_events_3">8.4.2. Default, Doop and Noop events</h4>
+<h4 id="_default_doop_and_noop_events_3">10.4.2. Default, Doop and Noop events</h4>
<div class="paragraph">
<p>If the <code>createdLifecycleEvent</code> attribute is not explicitly specified (is left as its default value, <code>ObjectCreatedEvent.Default</code>),
then the framework will, by default, post an event.</p>
@@ -4920,7 +5508,7 @@ then no event will be posted.</p>
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainObject_editing">8.5. <code>editing()</code></h3>
+<h3 id="_rgant-DomainObject_editing">10.5. <code>editing()</code></h3>
<div class="paragraph">
<p>The <code>editing()</code> attribute determines whether a domain object’s properties and collections are not editable (are read-only).</p>
</div>
@@ -5004,7 +5592,7 @@ then no event will be posted.</p>
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainObject_loadedLifecycleEvent">8.6. loadedLifecycleEvent()</h3>
+<h3 id="_rgant-DomainObject_loadedLifecycleEvent">10.6. loadedLifecycleEvent()</h3>
<div class="paragraph">
<p>Whenever a persistent domain object is loaded from the database, a "loaded" lifecycle event is fired.</p>
</div>
@@ -5047,7 +5635,7 @@ attribute is available for other lifecycle events.</p>
<p>The benefit is that subscribers can be more targeted as to the events that they subscribe to.</p>
</div>
<div class="sect3">
-<h4 id="_subscribers_4">8.6.1. Subscribers</h4>
+<h4 id="_subscribers_4">10.6.1. Subscribers</h4>
<div class="paragraph">
<p>Subscribers (which must be domain services) subscribe using either the <a href="https://github.com/google/guava">Guava</a> API
or (if the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> has been appropriately configured)
@@ -5097,7 +5685,7 @@ using the <a href="http://www.axonframework.org/">Axon Framework</a> API. The e
</div>
</div>
<div class="sect3">
-<h4 id="_default_doop_and_noop_events_4">8.6.2. Default, Doop and Noop events</h4>
+<h4 id="_default_doop_and_noop_events_4">10.6.2. Default, Doop and Noop events</h4>
<div class="paragraph">
<p>If the <code>loadedLifecycleEvent</code> attribute is not explicitly specified (is left as its default value, <code>ObjectLoadedEvent.Default</code>),
then the framework will, by default, post an event.</p>
@@ -5118,7 +5706,7 @@ then no event will be posted.</p>
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainObject_nature">8.7. <code>nature()</code></h3>
+<h3 id="_rgant-DomainObject_nature">10.7. <code>nature()</code></h3>
<div class="paragraph">
<p>The <code>nature()</code> attribute is used to characterize the domain object as either an entity (part of the domain layer) or as a view model (part of the application layer). If the domain object should be thought of as an entity, it also captures how the persistence of that entity is managed.</p>
</div>
@@ -5217,7 +5805,7 @@ then no event will be posted.</p>
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainObject_persistedLifecycleEvent">8.8. persistedLifecycleEvent()</h3>
+<h3 id="_rgant-DomainObject_persistedLifecycleEvent">10.8. persistedLifecycleEvent()</h3>
<div class="paragraph">
<p>Whenever a (just created, still transient) domain object has been saved (INSERTed in)to the database, a "persisted" lifecycle
event is fired.</p>
@@ -5275,7 +5863,7 @@ attribute is available for other lifecycle events.</p>
<p>The benefit is that subscribers can be more targeted as to the events that they subscribe to.</p>
</div>
<div class="sect3">
-<h4 id="_subscribers_5">8.8.1. Subscribers</h4>
+<h4 id="_subscribers_5">10.8.1. Subscribers</h4>
<div class="paragraph">
<p>Subscribers (which must be domain services) subscribe using either the <a href="https://github.com/google/guava">Guava</a> API
or (if the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> has been appropriately configured)
@@ -5325,7 +5913,7 @@ using the <a href="http://www.axonframework.org/">Axon Framework</a> API. The e
</div>
</div>
<div class="sect3">
-<h4 id="_default_doop_and_noop_events_5">8.8.2. Default, Doop and Noop events</h4>
+<h4 id="_default_doop_and_noop_events_5">10.8.2. Default, Doop and Noop events</h4>
<div class="paragraph">
<p>If the <code>persistedLifecycleEvent</code> attribute is not explicitly specified (is left as its default value, <code>ObjectPersistedEvent.Default</code>),
then the framework will, by default, post an event.</p>
@@ -5346,7 +5934,7 @@ then no event will be posted.</p>
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainObject_persistingLifecycleEvent">8.9. persistingLifecycleEvent()</h3>
+<h3 id="_rgant-DomainObject_persistingLifecycleEvent">10.9. persistingLifecycleEvent()</h3>
<div class="paragraph">
<p>Whenever a (just created, still transient) domain object is about to be saved (INSERTed in)to the database, a "persisting" lifecycle
event is fired.</p>
@@ -5407,7 +5995,7 @@ attribute is available for other lifecycle events.</p>
<p>The benefit is that subscribers can be more targeted as to the events that they subscribe to.</p>
</div>
<div class="sect3">
-<h4 id="_subscribers_6">8.9.1. Subscribers</h4>
+<h4 id="_subscribers_6">10.9.1. Subscribers</h4>
<div class="paragraph">
<p>Subscribers (which must be domain services) subscribe using either the <a href="https://github.com/google/guava">Guava</a> API
or (if the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> has been appropriately configured)
@@ -5457,7 +6045,7 @@ using the <a href="http://www.axonframework.org/">Axon Framework</a> API. The e
</div>
</div>
<div class="sect3">
-<h4 id="_default_doop_and_noop_events_6">8.9.2. Default, Doop and Noop events</h4>
+<h4 id="_default_doop_and_noop_events_6">10.9.2. Default, Doop and Noop events</h4>
<div class="paragraph">
<p>If the <code>persistingLifecycleEvent</code> attribute is not explicitly specified (is left as its default value, <code>ObjectPersistingEvent.Default</code>),
then the framework will, by default, post an event.</p>
@@ -5478,7 +6066,7 @@ then no event will be posted.</p>
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainObject_objectType">8.10. <code>objectType()</code></h3>
+<h3 id="_rgant-DomainObject_objectType">10.10. <code>objectType()</code></h3>
<div class="paragraph">
<p>The <code>objectType()</code> attribute is used to provide a unique alias for the object’s class name.</p>
</div>
@@ -5556,7 +6144,7 @@ then no event will be posted.</p>
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainObject_publishing">8.11. <code>publishing()</code></h3>
+<h3 id="_rgant-DomainObject_publishing">10.11. <code>publishing()</code></h3>
<div class="paragraph">
<p>The <code>publishing()</code> attribute determines whether and how a modified object instance is published via the registered implementation of a <a href="rgsvc.html#_rgsvc_spi_PublishingService"><code>PublishingService</code></a>). This attribute is also supported for <a href="#_rgant-Action_publishing">actions</a>, where it controls whether action invocations are published as events.</p>
</div>
@@ -5610,7 +6198,7 @@ then no event will be posted.</p>
</table>
</div>
<div class="sect3">
-<h4 id="__code_publishingpayloadfactory_code_2">8.11.1. <code>publishingPayloadFactory()</code></h4>
+<h4 id="__code_publishingpayloadfactory_code_2">10.11.1. <code>publishingPayloadFactory()</code></h4>
<div class="paragraph">
<p>The (optional) related <code>publishingPayloadFactory()</code> specifies the class to use to create the (payload of the) event to be published by the publishing factory.</p>
</div>
@@ -5620,7 +6208,7 @@ then no event will be posted.</p>
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainObject_removingLifecycleEvent">8.12. removingLifecycleEvent()</h3>
+<h3 id="_rgant-DomainObject_removingLifecycleEvent">10.12. removingLifecycleEvent()</h3>
<div class="paragraph">
<p>Whenever a (persistent) domain object is about to be removed (DELETEd) from the database, a "removing"
lifecycle event is fired.</p>
@@ -5681,7 +6269,7 @@ attribute is available for other lifecycle events.</p>
<p>The benefit is that subscribers can be more targeted as to the events that they subscribe to.</p>
</div>
<div class="sect3">
-<h4 id="_subscribers_7">8.12.1. Subscribers</h4>
+<h4 id="_subscribers_7">10.12.1. Subscribers</h4>
<div class="paragraph">
<p>Subscribers (which must be domain services) subscribe using either the <a href="https://github.com/google/guava">Guava</a> API
or (if the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> has been appropriately configured)
@@ -5731,7 +6319,7 @@ using the <a href="http://www.axonframework.org/">Axon Framework</a> API. The e
</div>
</div>
<div class="sect3">
-<h4 id="_default_doop_and_noop_events_7">8.12.2. Default, Doop and Noop events</h4>
+<h4 id="_default_doop_and_noop_events_7">10.12.2. Default, Doop and Noop events</h4>
<div class="paragraph">
<p>If the <code>removingLifecycleEvent</code> attribute is not explicitly specified (is left as its default value, <code>ObjectRemovingEvent.Default</code>),
then the framework will, by default, post an event.</p>
@@ -5752,7 +6340,7 @@ then no event will be posted.</p>
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainObject_updatingLifecycleEvent">8.13. updatingLifecycleEvent()</h3>
+<h3 id="_rgant-DomainObject_updatingLifecycleEvent">10.13. updatingLifecycleEvent()</h3>
<div class="paragraph">
<p>Whenever a (persistent) domain object has been modified and is about to be updated to the database, an "updating"
lifecycle event is fired.</p>
@@ -5813,7 +6401,7 @@ attribute is available for other lifecycle events.</p>
<p>The benefit is that subscribers can be more targeted as to the events that they subscribe to.</p>
</div>
<div class="sect3">
-<h4 id="_subscribers_8">8.13.1. Subscribers</h4>
+<h4 id="_subscribers_8">10.13.1. Subscribers</h4>
<div class="paragraph">
<p>Subscribers (which must be domain services) subscribe using either the <a href="https://github.com/google/guava">Guava</a> API
or (if the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> has been appropriately configured)
@@ -5863,7 +6451,7 @@ using the <a href="http://www.axonframework.org/">Axon Framework</a> API. The e
</div>
</div>
<div class="sect3">
-<h4 id="_default_doop_and_noop_events_8">8.13.2. Default, Doop and Noop events</h4>
+<h4 id="_default_doop_and_noop_events_8">10.13.2. Default, Doop and Noop events</h4>
<div class="paragraph">
<p>If the <code>updatingLifecycleEvent</code> attribute is not explicitly specified (is left as its default value, <code>ObjectUpdatingEvent.Default</code>),
then the framework will, by default, post an event.</p>
@@ -5884,7 +6472,7 @@ then no event will be posted.</p>
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainObject_updatedLifecycleEvent">8.14. updatedLifecycleEvent()</h3>
+<h3 id="_rgant-DomainObject_updatedLifecycleEvent">10.14. updatedLifecycleEvent()</h3>
<div class="paragraph">
<p>Whenever a (persistent) domain object has been modified and has been updated in the database, an "updated" lifecycle
event is fired.</p>
@@ -5941,7 +6529,7 @@ attribute is available for other lifecycle events.</p>
<p>The benefit is that subscribers can be more targeted as to the events that they subscribe to.</p>
</div>
<div class="sect3">
-<h4 id="_subscribers_9">8.14.1. Subscribers</h4>
+<h4 id="_subscribers_9">10.14.1. Subscribers</h4>
<div class="paragraph">
<p>Subscribers (which must be domain services) subscribe using either the <a href="https://github.com/google/guava">Guava</a> API
or (if the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> has been appropriately configured)
@@ -5991,7 +6579,7 @@ using the <a href="http://www.axonframework.org/">Axon Framework</a> API. The e
</div>
</div>
<div class="sect3">
-<h4 id="_default_doop_and_noop_events_9">8.14.2. Default, Doop and Noop events</h4>
+<h4 id="_default_doop_and_noop_events_9">10.14.2. Default, Doop and Noop events</h4>
<div class="paragraph">
<p>If the <code>updatedLifecycleEvent</code> attribute is not explicitly specified (is left as its default value, <code>ObjectUpdatedEvent.Default</code>),
then the framework will, by default, post an event.</p>
@@ -6014,7 +6602,7 @@ then no event will be posted.</p>
</div>
</div>
<div class="sect1">
-<h2 id="_rgant-DomainObjectLayout">9. <code>@DomainObjectLayout</code></h2>
+<h2 id="_rgant-DomainObjectLayout">11. <code>@DomainObjectLayout</code></h2>
<div class="sectionbody">
<div class="paragraph">
<p>The <code>@DomainObjectLayout</code> annotation applies to domain classes, collecting together all UI hints within a single annotation.</p>
@@ -6037,7 +6625,7 @@ then no event will be posted.</p>
<p>The table below summarizes the annotation’s attributes.</p>
</div>
<table class="tableblock frame-all grid-all spread">
-<caption class="title">Table 12. <code>@DomainObjectLayout</code> attributes</caption>
+<caption class="title">Table 13. <code>@DomainObjectLayout</code> attributes</caption>
<colgroup>
<col style="width: 25%;">
<col style="width: 25%;">
@@ -6171,7 +6759,7 @@ then no event will be posted.</p>
</table>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainObjectLayout_bookmarking">9.1. <code>bookmarking()</code></h3>
+<h3 id="_rgant-DomainObjectLayout_bookmarking">11.1. <code>bookmarking()</code></h3>
<div class="paragraph">
<p>The <code>bookmarking()</code> attribute indicates that an entity is automatically bookmarked. This attribute is also supported for <a href="#_rgant-Action_bookmarking">domain objects</a>.</p>
</div>
@@ -6259,7 +6847,7 @@ then no event will be posted.</p>
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainObjectLayout_cssClass">9.2. <code>cssClass()</code></h3>
+<h3 id="_rgant-DomainObjectLayout_cssClass">11.2. <code>cssClass()</code></h3>
<div class="paragraph">
<p>The <code>cssClass()</code> attribute can be used to render additional CSS classes in the HTML (a wrapping <code><div></code>) that represents the domain object. <a href="rgcfg.html#_rgcfg_application-specific_application-css">Application-specific CSS</a> can then be used to target and adjust the UI representation of that particular element.</p>
</div>
@@ -6294,7 +6882,7 @@ to be rendered as the icon for classes.</p>
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainObjectLayout_cssClassFa">9.3. <code>cssClassFa()</code></h3>
+<h3 id="_rgant-DomainObjectLayout_cssClassFa">11.3. <code>cssClassFa()</code></h3>
<div class="paragraph">
<p>The <code>cssClassFa()</code> attribute is used to specify the name of a <a href="http://fortawesome.github.io/Font-Awesome/icons/">Font Awesome icon</a> name, to be rendered as the domain object’s icon.</p>
</div>
@@ -6339,7 +6927,7 @@ member so that it can be styled in an application-specific way.</p>
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainObjectLayout_cssClassUiEvent">9.4. cssClassUiEvent()</h3>
+<h3 id="_rgant-DomainObjectLayout_cssClassUiEvent">11.4. cssClassUiEvent()</h3>
<div class="paragraph">
<p>Whenever a domain object is to be rendered, the framework fires off an CSS class UI event to obtain a CSS class to use
in any wrapping <code><div></code>s and <code><span></code>s that render the domain object. This is as an alternative to implementing
@@ -6401,7 +6989,7 @@ attribute is available for titles and icons.</p>
<p>The benefit is that subscribers can be more targeted as to the events that they subscribe to.</p>
</div>
<div class="sect3">
-<h4 id="_subscribers_10">9.4.1. Subscribers</h4>
+<h4 id="_subscribers_10">11.4.1. Subscribers</h4>
<div class="paragraph">
<p>Subscribers (which must be domain services) subscribe using either the <a href="https://github.com/google/guava">Guava</a> API
or (if the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> has been appropriately configured)
@@ -6454,7 +7042,7 @@ using the <a href="http://www.axonframework.org/">Axon Framework</a> API. The e
</div>
</div>
<div class="sect3">
-<h4 id="_default_doop_and_noop_events_10">9.4.2. Default, Doop and Noop events</h4>
+<h4 id="_default_doop_and_noop_events_10">11.4.2. Default, Doop and Noop events</h4>
<div class="paragraph">
<p>If the <code>cssClassUiEvent</code> attribute is not explicitly specified (is left as its default value, <code>CssClassUiEvent.Default</code>),
then the framework will, by default, post an event.</p>
@@ -6474,7 +7062,7 @@ then no event will be posted.</p>
</div>
</div>
<div class="sect3">
-<h4 id="_raising_events_programmatically_3">9.4.3. Raising events programmatically</h4>
+<h4 id="_raising_events_programmatically_3">11.4.3. Raising events programmatically</h4>
<div class="paragraph">
<p>Normally events are only raised for interactions through the UI. However, events can be raised programmatically either
by calling the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> API directly, or as a result
@@ -6484,7 +7072,7 @@ of calling the <a href="rgsvc.html#_rgsvc_api_DomainObjectContainer"><code>Domai
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainObjectLayout_describedAs">9.5. <code>describedAs()</code></h3>
+<h3 id="_rgant-DomainObjectLayout_describedAs">11.5. <code>describedAs()</code></h3>
<div class="paragraph">
<p>The <code>describedAs()</code> attribute is used to provide a short description of the domain object to the user. In the <a href="ugvw.html">Wicket viewer</a> it is displayed as a 'tool tip'. The attribute can also be specified for <a href="#_rgant-CollectionLayout_describedAs">collections</a>, <a href="#_rgant-PropertyLayout_describedAs">properties</a>, <a href="#_rgant-ActionLayout_describedAs">actions</a>, <a href="#_rgant-ParameterLayout_describedAs">parameters</a> and <a href="#_rgant-ViewModelLayout_describedAs">view models</a>.</p>
</div>
@@ -6502,7 +7090,7 @@ of calling the <a href="rgsvc.html#_rgsvc_api_DomainObjectContainer"><code>Domai
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainObjectLayout_iconUiEvent">9.6. iconUiEvent()</h3>
+<h3 id="_rgant-DomainObjectLayout_iconUiEvent">11.6. iconUiEvent()</h3>
<div class="paragraph">
<p>Whenever a domain object is to be rendered, the framework fires off an icon UI event to obtain an icon (name) for the
object (if possible). This is as an alternative to implementing
@@ -6564,7 +7152,7 @@ attribute is available for titles and CSS classes.</p>
<p>The benefit is that subscribers can be more targeted as to the events that they subscribe to.</p>
</div>
<div class="sect3">
-<h4 id="_subscribers_11">9.6.1. Subscribers</h4>
+<h4 id="_subscribers_11">11.6.1. Subscribers</h4>
<div class="paragraph">
<p>Subscribers (which must be domain services) subscribe using either the <a href="https://github.com/google/guava">Guava</a> API
or (if the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> has been appropriately configured)
@@ -6617,7 +7205,7 @@ using the <a href="http://www.axonframework.org/">Axon Framework</a> API. The e
</div>
</div>
<div class="sect3">
-<h4 id="_default_doop_and_noop_events_11">9.6.2. Default, Doop and Noop events</h4>
+<h4 id="_default_doop_and_noop_events_11">11.6.2. Default, Doop and Noop events</h4>
<div class="paragraph">
<p>If the <code>iconUiEvent</code> attribute is not explicitly specified (is left as its default value, <code>IconUiEvent.Default</code>),
then the framework will, by default, post an event.</p>
@@ -6637,7 +7225,7 @@ then no event will be posted.</p>
</div>
</div>
<div class="sect3">
-<h4 id="_raising_events_programmatically_4">9.6.3. Raising events programmatically</h4>
+<h4 id="_raising_events_programmatically_4">11.6.3. Raising events programmatically</h4>
<div class="paragraph">
<p>Normally events are only raised for interactions through the UI. However, events can be raised programmatically either
by calling the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> API directly, or as a result
@@ -6647,7 +7235,7 @@ of calling the <a href="rgsvc.html#_rgsvc_api_DomainObjectContainer"><code>Domai
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainObjectLayout_named">9.7. <code>named()</code></h3>
+<h3 id="_rgant-DomainObjectLayout_named">11.7. <code>named()</code></h3>
<div class="paragraph">
<p>The <code>named()</code> attribute explicitly specifies the domain object’s name, overriding the name that would normally be inferred from the Java source code. The attribute can also be specified for <a href="#_rgant-ActionLayout_named">actions</a>, <a href="#_rgant-CollectionLayout_named">collections</a>, <a href="#_rgant-PropertyLayout_named">properties</a>, <a href="#_rgant-ParameterLayout_named">parameters</a>, <a href="#_rgant-ViewModelLayout_named">view models</a> and <a href="#_rgant-DomainServiceLayout_named">domain services</a>.</p>
</div>
@@ -6697,7 +7285,7 @@ of calling the <a href="rgsvc.html#_rgsvc_api_DomainObjectContainer"><code>Domai
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainObjectLayout_paged">9.8. <code>paged()</code></h3>
+<h3 id="_rgant-DomainObjectLayout_paged">11.8. <code>paged()</code></h3>
<div class="paragraph">
<p>The <code>paged()</code> attribute specifies the number of rows to display in a standalone collection, as returned from an action invocation. This attribute can also be applied to <a href="#_rgant-CollectionLayout_paged">collections</a> and <a href="#_rgant-ViewModelLayout_paged">view models</a>.</p>
</div>
@@ -6734,7 +7322,7 @@ of calling the <a href="rgsvc.html#_rgsvc_api_DomainObjectContainer"><code>Domai
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainObjectLayout_plural">9.9. <code>plural()</code></h3>
+<h3 id="_rgant-DomainObjectLayout_plural">11.9. <code>plural()</code></h3>
<div class="paragraph">
<p>When Apache Isis displays a standalone collection of several objects, it will label the collection using the plural form of the object type.</p>
</div>
@@ -6757,7 +7345,7 @@ of calling the <a href="rgsvc.html#_rgsvc_api_DomainObjectContainer"><code>Domai
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainObjectLayout_titleUiEvent">9.10. titleUiEvent()</h3>
+<h3 id="_rgant-DomainObjectLayout_titleUiEvent">11.10. titleUiEvent()</h3>
<div class="paragraph">
<p>Whenever a domain object is to be rendered, the framework fires off a title UI event to obtain a title for the object.
This is as an alternative to implementing <a href="rgcms.html#_rgcms_methods_reserved_title"><code>title()</code></a> reserved method, or
@@ -6819,7 +7407,7 @@ attribute is available for icon names and CSS classes.</p>
<p>The benefit is that subscribers can be more targeted as to the events that they subscribe to.</p>
</div>
<div class="sect3">
-<h4 id="_subscribers_12">9.10.1. Subscribers</h4>
+<h4 id="_subscribers_12">11.10.1. Subscribers</h4>
<div class="paragraph">
<p>Subscribers (which must be domain services) subscribe using either the <a href="https://github.com/google/guava">Guava</a> API
or (if the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> has been appropriately configured)
@@ -6873,7 +7461,7 @@ actually specify the title to be used.</p>
</div>
</div>
<div class="sect3">
-<h4 id="_default_doop_and_noop_events_12">9.10.2. Default, Doop and Noop events</h4>
+<h4 id="_default_doop_and_noop_events_12">11.10.2. Default, Doop and Noop events</h4>
<div class="paragraph">
<p>If the <code>titleUiEvent</code> attribute is not explicitly specified (is left as its default value, <code>TitleUiEvent.Default</code>),
then the framework will, by default, post an event.</p>
@@ -6893,7 +7481,7 @@ thn no event will be posted.</p>
</div>
</div>
<div class="sect3">
-<h4 id="_raising_events_programmatically_5">9.10.3. Raising events programmatically</h4>
+<h4 id="_raising_events_programmatically_5">11.10.3. Raising events programmatically</h4>
<div class="paragraph">
<p>Normally events are only raised for interactions through the UI. However, events can be raised programmatically either
by calling the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> API directly, or as a result
@@ -6905,7 +7493,7 @@ of calling the <a href="rgsvc.html#_rgsvc_api_DomainObjectContainer"><code>Domai
</div>
</div>
<div class="sect1">
-<h2 id="_rgant-DomainService">10. <code>@DomainService</code></h2>
+<h2 id="_rgant-DomainService">12. <code>@DomainService</code></h2>
<div class="sectionbody">
<div class="paragraph">
<p>The <code>@DomainService</code> annotation indicates that the (concrete) class should be automatically instantiated as a domain service.</p>
@@ -6918,7 +7506,7 @@ discovered automatically on the CLASSPATH.</p>
<p>The table below summarizes the annotation’s attributes.</p>
</div>
<table class="tableblock frame-all grid-all spread">
-<caption class="title">Table 13. <code>@DomainService</code> attributes</caption>
+<caption class="title">Table 14. <code>@DomainService</code> attributes</caption>
<colgroup>
<col style="width: 25%;">
<col style="width: 25%;">
@@ -6971,7 +7559,7 @@ discovered automatically on the CLASSPATH.</p>
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainService_nature">10.1. <code>nature()</code></h3>
+<h3 id="_rgant-DomainService_nature">12.1. <code>nature()</code></h3>
<div class="paragraph">
<p>By default, a domain service’s actions will be rendered in the application menu bar <em>and</em> be contributed <em>and</em> appear in the REST API <em>and</em> (of course) be available to invoke programmatically wherever that domain service is injected. This is great for initial prototyping, but later on you may prefer to add a little more structure. This is the purpose of the <code>nature()</code> attribute: to indicates the intent of (all of) the actions defined within the domain service.</p>
</div>
@@ -7102,7 +7690,7 @@ discovered automatically on the CLASSPATH.</p>
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainService_repositoryFor">10.2. <code>repositoryFor()</code></h3>
+<h3 id="_rgant-DomainService_repositoryFor">12.2. <code>repositoryFor()</code></h3>
<div class="paragraph">
<p>The <code>repositoryFor()</code> attribute is intended for domain services (probably with a <a href="#_rgant-DomainService_nature"><code>nature=DOMAIN</code></a>) that are intended to act as repositories for domain entities.</p>
</div>
@@ -7128,7 +7716,7 @@ discovered automatically on the CLASSPATH.</p>
</div>
</div>
<div class="sect1">
-<h2 id="_rgant-DomainServiceLayout">11. <code>@DomainServiceLayout</code></h2>
+<h2 id="_rgant-DomainServiceLayout">13. <code>@DomainServiceLayout</code></h2>
<div class="sectionbody">
<div class="paragraph">
<p>The <code>@DomainServiceLayout</code> annotation applies to domain services, collecting together all view layout semantics within a single annotation.</p>
@@ -7151,7 +7739,7 @@ discovered automatically on the CLASSPATH.</p>
<p>The table below summarizes the annotation’s attributes.</p>
</div>
<table class="tableblock frame-all grid-all spread">
-<caption class="title">Table 14. <code>@DomainServiceLayout</code> attributes</caption>
+<caption class="title">Table 15. <code>@DomainServiceLayout</code> attributes</caption>
<colgroup>
<col style="width: 25%;">
<col style="width: 25%;">
@@ -7219,7 +7807,7 @@ discovered automatically on the CLASSPATH.</p>
</table>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainServiceLayout_menuBar">11.1. <code>menuBar()</code></h3>
+<h3 id="_rgant-DomainServiceLayout_menuBar">13.1. <code>menuBar()</code></h3>
<div class="paragraph">
<p>The <code>menuBar()</code> attribute is a hint to specify where on the application menu a domain service’s actions should be rendered.</p>
</div>
@@ -7278,7 +7866,7 @@ discovered automatically on the CLASSPATH.</p>
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainServiceLayout_menuOrder">11.2. <code>menuOrder()</code></h3>
+<h3 id="_rgant-DomainServiceLayout_menuOrder">13.2. <code>menuOrder()</code></h3>
<div class="paragraph">
<p>The <code>menuOrder()</code> attribute determines the ordering of a domain service’s actions as menu items within a specified menu bar and top-level menu.</p>
</div>
@@ -7385,7 +7973,7 @@ discovered automatically on the CLASSPATH.</p>
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-DomainServiceLayout_named">11.3. <code>named()</code></h3>
+<h3 id="_rgant-DomainServiceLayout_named">13.3. <code>named()</code></h3>
<div class="paragraph">
<p>The <code>named()</code> attribute explicitly specifies the domain service’s name, overriding the name that would normally be inferred from the Java source code. This attribute can also be specified for <a href="#_rgant-ActionLayout_named">actions</a>, <a href="#_rgant-CollectionLayout_named">collections</a>, <a href="#_rgant-PropertyLayout_named">properties</a>, <a href="#_rgant-ParameterLayout_named">parameters</a>, <a href="#_rgant-DomainObjectLayout_named">domain objects</a> and <a href="#_rgant-ViewModelLayout_named">view models</a>.</p>
</div>
@@ -7421,7 +8009,7 @@ discovered automatically on the CLASSPATH.</p>
</div>
</div>
<div class="sect1">
-<h2 id="_rgant-Facets">12. <code>@Facets</code></h2>
+<h2 id="_rgant-Facets">14. <code>@Facets</code></h2>
<div class="sectionbody">
<div class="paragraph">
<p>The <code>@Facets</code> annotation allows <code>FacetFactory</code> implementations and so can be used to run install arbitrary <code>Facet`s for a type. Generally this is not needed, but can be useful for overriding a custom programming model where a `FacetFactory</code> is not typically included.</p>
@@ -7443,7 +8031,7 @@ discovered automatically on the CLASSPATH.</p>
</div>
</div>
<div class="sect1">
-<h2 id="_rgant-HomePage">13. <code>@HomePage</code></h2>
+<h2 id="_rgant-HomePage">15. <code>@HomePage</code></h2>
<div class="sectionbody">
<div class="paragraph">
<p>The <code>@HomePage</code> annotation allows a <em>single</em> (no-arg, query-only) action on a <em>single</em> domain service to be nominated as the action to invoke for the default home page. This often returns a view model that acts as some sort of dashboard, presenting key information and makeing the most commonly used actions easy to invoke.</p>
@@ -7505,7 +8093,7 @@ discovered automatically on the CLASSPATH.</p>
</div>
</div>
<div class="sect1">
-<h2 id="_rgant-Inject">14. <code>@Inject</code> (<code>javax</code>)</h2>
+<h2 id="_rgant-Inject">16. <code>@Inject</code> (<code>javax</code>)</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Apache Isis automatically injects domain services into other domain services and also into domain objects and view models. In fact, it also injects domain services into <a href="ugtst.html#_ugtst_integ-test-support">integration tests</a> and <a href="ugtst.html#_ugtst_fixture-scripts">fixture scripts</a>.</p>
@@ -7554,7 +8142,7 @@ discovered automatically on the CLASSPATH.</p>
</table>
</div>
<div class="sect2">
-<h3 id="_alternative_syntaxes">14.1. Alternative syntaxes</h3>
+<h3 id="_alternative_syntaxes">16.1. Alternative syntaxes</h3>
<div class="paragraph">
<p>Isis also supports setter-based injection:</p>
</div>
@@ -7582,7 +8170,7 @@ discovered automatically on the CLASSPATH.</p>
</div>
</div>
<div class="sect2">
-<h3 id="_injecting_collection_of_services">14.2. Injecting collection of services</h3>
+<h3 id="_injecting_collection_of_services">16.2. Injecting collection of services</h3>
<div class="paragraph">
<p>It can sometimes be useful to have declared multiple implementations of a particular domain service. For example,
you may have a module that defines an SPI service, where multiple other modules might provide implementations of that SPI
@@ -7642,7 +8230,7 @@ the event. This alternative design is used in the (non-ASF) <a href="http://git
</div>
</div>
<div class="sect2">
-<h3 id="_manually_injecting_services">14.3. Manually injecting services</h3>
+<h3 id="_manually_injecting_services">16.3. Manually injecting services</h3>
<div class="paragraph">
<p>Isis performs dependency injection when domain entities are recreated. It will also perform dependency injection if an object is created through the <code>DomainObjectContainer</code>.</p>
</div>
@@ -7714,7 +8302,7 @@ container.persist(cust);</code></pre>
</div>
</div>
<div class="sect1">
-<h2 id="_rgant-MemberGroupLayout">15. <code>@MemberGroupLayout</code></h2>
+<h2 id="_rgant-MemberGroupLayout">17. <code>@MemberGroupLayout</code></h2>
<div class="sectionbody">
<div class="paragraph">
<p>The <code>@MemberGroupLayout</code> annotation specifies how an object’s properties and collections are grouped together into columns, also specifying the relative positioning of those columns. It works in conjunction with the <a href="#_rgant-MemberOrder"><code>@MemberOrder</code></a> annotation.</p>
@@ -7742,7 +8330,7 @@ container.persist(cust);</code></pre>
</div>
</div>
<div class="sect1">
-<h2 id="_rgant-MemberOrder">16. <code>@MemberOrder</code></h2>
+<h2 id="_rgant-MemberOrder">18. <code>@MemberOrder</code></h2>
<div class="sectionbody">
<div class="paragraph">
<p>The <code>@MemberOrder</code> annotation is used to specify the relative order of domain object members, that is: properties, collections and actions. It works in conjunction with the <a href="#_rgant-MemberGroupLayout"><code>@MemberGroupLayout</code></a> annotation.</p>
@@ -7802,7 +8390,7 @@ so that boilerplate-busting tools such as <a href="https://projectlombok.org/">P
</div>
</div>
<div class="sect1">
-<h2 id="_rgant-NotPersistent">17. <code>@NotPersistent</code> (<code>javax.jdo</code>)</h2>
+<h2 id="_rgant-NotPersistent">19. <code>@NotPersistent</code> (<code>javax.jdo</code>)</h2>
<div class="sectionbody">
<div class="paragraph">
<p>The <code>@javax.jdo.annotation.NotPersistent</code> annotation is used by JDO/DataNucleus to indicate that a property should not be persisted to the database.</p>
@@ -7830,7 +8418,7 @@ so that boilerplate-busting tools such as <a href="https://projectlombok.org/">P
</div>
</div>
<div class="sect1">
-<h2 id="_rgant-MinLength">18. <code>@MinLength</code></h2>
+<h2 id="_rgant-MinLength">20. <code>@MinLength</code></h2>
<div class="sectionbody">
<div class="paragraph">
<p>The <code>@MinLength</code> annotation is used to specify the minimum number of characters in a search of an <a href="rgcms.html#_rgcms_methods_prefixes_autoComplete"><code>autoComplete…​()</code></a> supporting method.</p>
@@ -7862,7 +8450,7 @@ so that boilerplate-busting tools such as <a href="https://projectlombok.org/">P
</div>
</div>
<div class="sect1">
-<h2 id="_rgant-Parameter">19. <code>@Parameter</code></h2>
+<h2 id="_rgant-Parameter">21. <code>@Parameter</code></h2>
<div class="sectionbody">
<div class="paragraph">
<p>The <code>@Parameter</code> annotation applies to action parameters collecting together all domain semantics within a single annotation.</p>
@@ -7871,7 +8459,7 @@ so that boilerplate-busting tools such as <a href="https://projectlombok.org/">P
<p>The table below summarizes the annotation’s attributes.</p>
</div>
<table class="tableblock frame-all grid-all spread">
-<caption class="title">Table 15. <code>@Paramter</code> attributes</caption>
+<caption class="title">Table 16. <code>@Paramter</code> attributes</caption>
<colgroup>
<col style="width: 25%;">
<col style="width: 25%;">
@@ -7976,7 +8564,7 @@ so that boilerplate-busting tools such as <a href="https://projectlombok.org/">P
</table>
</div>
<div class="sect2">
-<h3 id="_rgant-Parameter_maxLength">19.1. <code>maxLength()</code></h3>
+<h3 id="_rgant-Parameter_maxLength">21.1. <code>maxLength()</code></h3>
<div class="paragraph">
<p>The <code>maxLength()</code> attribute applies only to <code>String</code> parameters, indicating the maximum number of characters that the user may enter (for example in a text field in the UI). It is ignored if applied to parameters of any other type. This attribute can also be applied to <a href="#_rgant-Property_maxLength">properties</a>.</p>
</div>
@@ -8008,7 +8596,7 @@ so that boilerplate-busting tools such as <a href="https://projectlombok.org/">P
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-Parameter_mustSatisfy">19.2. <code>mustSatisfy()</code></h3>
+<h3 id="_rgant-Parameter_mustSatisfy">21.2. <code>mustSatisfy()</code></h3>
<div class="paragraph">
<p>The <code>mustSatisfy()</code> attribute allows arbitrary validation to be applied to parameters using an (implementation of a) <code>org.apache.isis.applib.spec.Specification</code> object. The attribute is also supported on <a href="#_rgant-Property_mustSatisfy">properties</a>.</p>
</div>
@@ -8093,7 +8681,7 @@ so that boilerplate-busting tools such as <a href="https://projectlombok.org/">P
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-Parameter_optionality">19.3. <code>optionality()</code></h3>
+<h3 id="_rgant-Parameter_optionality">21.3. <code>optionality()</code></h3>
<div class="paragraph">
<p>By default, Apache Isis assumes that all parameters of an action are required (mandatory). The <code>optionality()</code> attribute allows this to be relaxed. The attribute is also supported for <a href="#_rgant-Property_optionality">properties</a>.</p>
</div>
@@ -8135,7 +8723,7 @@ so that boilerplate-busting tools such as <a href="https://projectlombok.org/">P
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-Parameter_regexPattern">19.4. <code>regexPattern()</code></h3>
+<h3 id="_rgant-Parameter_regexPattern">21.4. <code>regexPattern()</code></h3>
<div class="paragraph">
<p>There are three attributes related to enforcing regular expressions:</p>
</div>
@@ -8185,7 +8773,7 @@ the provided argument does not match the regex pattern.</p>
</div>
</div>
<div class="sect1">
-<h2 id="_rgant-ParameterLayout">20. <code>@ParameterLayout</code></h2>
+<h2 id="_rgant-ParameterLayout">22. <code>@ParameterLayout</code></h2>
<div class="sectionbody">
<div class="paragraph">
<p>The <code>@ParameterLayout</code> annotation applies to action parameters, collecting together all UI hints within a single annotation.</p>
@@ -8194,7 +8782,7 @@ the provided argument does not match the regex pattern.</p>
<p>The table below summarizes the annotation’s attributes.</p>
</div>
<table class="tableblock frame-all grid-all spread">
-<caption class="title">Table 16. <code>@ParameterLayout</code> attributes</caption>
+<caption class="title">Table 17. <code>@ParameterLayout</code> attributes</caption>
<colgroup>
<col style="width: 25%;">
<col style="width: 25%;">
@@ -8313,7 +8901,7 @@ the provided argument does not match the regex pattern.</p>
</table>
</div>
<div class="sect2">
-<h3 id="_rgant-ParameterLayout_cssClass">20.1. <code>cssClass()</code></h3>
+<h3 id="_rgant-ParameterLayout_cssClass">22.1. <code>cssClass()</code></h3>
<div class="paragraph">
<p>The <code>cssClass()</code> attribute can be used to render additional CSS classes in the HTML (a wrapping <code><div></code>) that represents the action parameter. <a href="rgcfg.html#_rgcfg_application-specific_application-css">Application-specific CSS</a> can then be used to target and adjust the UI representation of that particular element.</p>
</div>
@@ -8339,7 +8927,7 @@ the provided argument does not match the regex pattern.</p>
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-ParameterLayout_describedAs">20.2. <code>describedAs()</code></h3>
+<h3 id="_rgant-ParameterLayout_describedAs">22.2. <code>describedAs()</code></h3>
<div class="paragraph">
<p>The <code>describedAs()</code> attribute is used to provide a short description of the action parameter to the user. In the <a href="ugvw.html">Wicket viewer</a> it is displayed as a 'tool tip'. The <code>describedAs()</code> attribute can also be specified for <a href="#_rgant-CollectionLayout_describedAs">collections</a>, <a href="#_rgant-PropertyLayout_describedAs">properties</a>, <a href="#_rgant-ActionLayout_describedAs">actions</a>, <a href="#_rgant-DomainObjectLayout_describedAs">domain objects</a> and <a href="#_rgant-ViewModelLayout_describedAs">view models</a>.</p>
</div>
@@ -8375,7 +8963,7 @@ declaration.</p>
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-ParameterLayout_labelPosition">20.3. <code>labelPosition()</code></h3>
+<h3 id="_rgant-ParameterLayout_labelPosition">22.3. <code>labelPosition()</code></h3>
<div class="paragraph">
<p>The <code>labelPosition()</code> attribute determines the positioning of labels for parameters. This attribute can also be specified for <a href="#_rgant-PropertyLayout_labelPosition">properties</a>.</p>
</div>
@@ -8415,7 +9003,7 @@ declaration.</p>
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-ParameterLayout_multiLine">20.4. <code>multiLine()</code></h3>
+<h3 id="_rgant-ParameterLayout_multiLine">22.4. <code>multiLine()</code></h3>
<div class="paragraph">
<p>The <code>multiLine()</code> attribute specifies that the text field for a string parameter should span multiple lines. It is ignored for other parameter types. The attribute is also supported for <a href="#_rgant-PropertyLayout_multiLine">properties</a>.</p>
</div>
@@ -8453,7 +9041,7 @@ declaration.</p>
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-ParameterLayout_named">20.5. <code>named()</code></h3>
+<h3 id="_rgant-ParameterLayout_named">22.5. <code>named()</code></h3>
<div class="paragraph">
<p>The <code>named()</code> attribute explicitly specifies the action parameter’s name. This attribute can also be specified for <a href="#_rgant-ActionLayout_named">actions</a>, <a href="#_rgant-CollectionLayout_named">collections</a>, <a href="#_rgant-PropertyLayout_named">properties</a>, <a href="#_rgant-DomainObjectLayout_named">domain objects</a>, <a href="#_rgant-ViewModelLayout_named">view models</a> and <a href="#_rgant-DomainServiceLayout_named">domain services</a>.</p>
</div>
@@ -8505,7 +9093,7 @@ declaration.</p>
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-ParameterLayout_renderedAsDayBefore">20.6. <code>renderedAsDayBefore()</code></h3>
+<h3 id="_rgant-ParameterLayout_renderedAsDayBefore">22.6. <code>renderedAsDayBefore()</code></h3>
<div class="paragraph">
<p>The <code>renderedAsDayBefore()</code> attribute applies only to date parameters whereby the date will be rendered as the day before the value actually held in the domain object. It is ignored for parameters of other types. This attribute is also supported for <a href="#_rgant-PropertyLayout_renderedAsDayBefore">properties</a>.</p>
</div>
@@ -8539,7 +9127,7 @@ dec
<TRUNCATED>
[13/23] isis-site git commit: ISIS-1287: updating docs for 1.12.0
Posted by da...@apache.org.
http://git-wip-us.apache.org/repos/asf/isis-site/blob/09aecf2c/content/guides/rgsvc.html
----------------------------------------------------------------------
diff --git a/content/guides/rgsvc.html b/content/guides/rgsvc.html
index a644cb7..4006a6a 100644
--- a/content/guides/rgsvc.html
+++ b/content/guides/rgsvc.html
@@ -652,14 +652,13 @@ allowing you to easily mock out these services in your unit tests.</p>
JDO/DataNucleus.</p>
</div>
<div class="paragraph">
-<p>For transient objects (instantiated programmatically), the (in <code>1.12.0-SNAPSHOT</code>)
-<a href="#_rgsvc_api_FactoryService"><code>FactoryService</code></a>'s <code>instantiate()</code> method (or the deprecated
-<a href="#_rgsvc_api_DomainObjectContainer"><code>DomainObjectContainer</code></a>'s <code>newTransientInstance()</code> method)
-will automatically inject the services.</p>
+<p>For transient objects (instantiated programmatically), the <a href="#_rgsvc_api_FactoryService"><code>FactoryService</code></a>'s
+<code>instantiate()</code> method (or the deprecated <a href="#_rgsvc_api_DomainObjectContainer"><code>DomainObjectContainer</code></a>'s
+<code>newTransientInstance()</code> method) will automatically inject the services.</p>
</div>
<div class="paragraph">
-<p>Alternatively the object can be instantiated simply using <code>new</code>, then services injected using (<code>1.12.0-SNAPSHOT)
-<a href="#_rgsvc_api_ServiceRegistry">`ServiceRegistry</code></a>'s <code>injectServicesInto(…​)</code> method (or the deprecated
+<p>Alternatively the object can be instantiated simply using <code>new</code>, then services injected using
+<a href="#_rgsvc_api_ServiceRegistry"><code>ServiceRegistry</code></a>'s <code>injectServicesInto(…​)</code> method (or the deprecated
<a href="#_rgsvc_api_DomainObjectContainer"><code>DomainObjectContainer</code></a>'s <code>injectServicesInto(…​)</code> method).</p>
</div>
</div>
@@ -679,7 +678,8 @@ will automatically inject the services.</p>
</td>
<td class="content">
<div class="paragraph">
-<p>For a small number of domain services, all implementations are used (following the chain-of-responsibility pattern), not just the first one. The services in question are: <a href="#_rgsvc_spi_ContentMappingService"><code>ContentMappingService</code></a>, <a href="#_rgsvc_spi_GridSystemService"><code>GridSystemService</code></a> (<code>1.12.0-SNAPSHOT</code>), and <a href="#_rgsvc_spi_RoutingService"><code>RoutingService</code></a>.</p>
+<p>For a small number of domain services, all implementations are used (following the chain-of-responsibility pattern), not just the first one. The services in question are: <a href="#_rgsvc_spi_ContentMappingService"><code>ContentMappingService</code></a>, <a href="#_rgsvc_spi_GridSystemService"><code>GridSystemService</code></a>, and
+<a href="#_rgsvc_spi_RoutingService"><code>RoutingService</code></a>.</p>
</div>
</td>
</tr>
@@ -794,7 +794,8 @@ will automatically inject the services.</p>
<p>(Attempt to) map the returned data into the representation required by the client’s HTTP <code>Accept</code> header.</p>
</div></div></td>
<td class="tableblock halign-left valign-top"></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">(Added in <code>1.12.0-SNAPSHOT</code>) Replaces (and simplifies) the earlier <code>ContentMappingService</code> that defined an SPI using classes internal to the framework.<br>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Replaces (and simplifies) the earlier <code>ContentMappingService</code> that defined an SPI using classes internal to the
+framework.<br>
+
No default implementation.</p></td>
</tr>
@@ -841,7 +842,7 @@ a configured <code>EmailService</code></p></td>
<code>services.grid</code><br>
<code>GridSystemService</code></a></p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>(<code>1.12.0-SNAPSHOT</code>) Validates and normalizes the grid layout for a domain class (with respect to a particular grid
+<p>Validates and normalizes the grid layout for a domain class (with respect to a particular grid
system such as Bootstrap3), also providing a default grid (for those domain classes where there is no grid layout).</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>GridSystemServiceBS3</code><br>
@@ -854,7 +855,7 @@ system such as Bootstrap3), also providing a default grid (for those domain clas
<code>services.grid</code><br>
<code>GridLoaderService</code></a></p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>(<code>1.12.0-SNAPSHOT</code>) Responsible for loading a grid layout for a domain class, eg from a <code>layout.xml</code> file.</p>
+<p>Responsible for loading a grid layout for a domain class, eg from a <code>layout.xml</code> file.</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>GridLoaderServiceDefault</code><br>
<code>o.a.i.core</code><br>
@@ -866,7 +867,7 @@ system such as Bootstrap3), also providing a default grid (for those domain clas
<code>services.grid</code><br>
<code>GridService</code></a></p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>(<code>1.12.0-SNAPSHOT</code>) A facade on top of both <a href="#_rgsvc_spi_GridLoaderService"><code>GridLoaderService</code></a> and
+<p>A facade on top of both <a href="#_rgsvc_spi_GridLoaderService"><code>GridLoaderService</code></a> and
<a href="#_rgsvc_spi_GridSystemService"><code>GridSystemService</code></a>, thus being able to return normalized
grids for any domain class.</p>
</div></div></td>
@@ -880,7 +881,7 @@ grids for any domain class.</p>
<code>services.hint</code><br>
<code>HintStore</code></a></p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>(<code>1.12.0-SNAPSHOT</code>) Stores UI hints on a per-object basis. For example, the viewer remembers which tabs are selected, and for collections which view is selected (eg table or hidden), which page of a table to render, or whether "show all" (rows) is toggled.</p>
+<p>Stores UI hints on a per-object basis. For example, the viewer remembers which tabs are selected, and for collections which view is selected (eg table or hidden), which page of a table to render, or whether "show all" (rows) is toggled.</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>HintStoreUsingWicketSession</code><br>
<code>o.a.i.viewer</code><br>
@@ -1011,7 +1012,7 @@ The mapped object used will be the first non-<code>null</code> result returned b
<div class="sect3">
<h4 id="_spi">3.1.1. SPI</h4>
<div class="paragraph">
-<p>The SPI defined by this service is (as of <code>1.12.0-SNAPSHOT</code>):</p>
+<p>The SPI defined by this service is:</p>
</div>
<div class="listingblock">
<div class="content">
@@ -1034,7 +1035,7 @@ The mapped object used will be the first non-<code>null</code> result returned b
</table>
</div>
<div class="paragraph">
-<p>In versions prior to <code>1.12.0-SNAPSHOT</code>, this interface resided in a different package, internal to the
+<p>In versions prior to <code>v1.12.0</code>, this interface resided in a different package, internal to the
<a href="#ugvro.adoc">Restful Objects</a> viewer, and defined a slightly different signature that used an internal enum:</p>
</div>
<div class="listingblock">
@@ -1527,7 +1528,7 @@ implementations provided by the framework (<code>DomainObjectContainerDefault</c
</div>
</div>
<div class="sect2">
-<h3 id="_rgsvc_spi_GridSystemService">3.5. <code>GridSystemService</code> (<code>1.12.0-SNAPSHOT</code>)</h3>
+<h3 id="_rgsvc_spi_GridSystemService">3.5. <code>GridSystemService</code></h3>
<div class="paragraph">
<p>The <code>GridSystemService</code> encapsulates a single layout grid system which can be used to customize the layout
of domain objects. In particular this means being able to return a "normalized" form (validating and associating
@@ -1640,7 +1641,7 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
</div>
</div>
<div class="sect2">
-<h3 id="_rgsvc_spi_GridLoaderService">3.6. <code>GridLoaderService</code> (<code>1.12.0-SNAPSHOT</code>)</h3>
+<h3 id="_rgsvc_spi_GridLoaderService">3.6. <code>GridLoaderService</code></h3>
<div class="paragraph">
<p>The <code>GridLoaderService</code> provides the ability to load the XML layout (grid) for a domain class.</p>
</div>
@@ -1712,7 +1713,7 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
</div>
</div>
<div class="sect2">
-<h3 id="_rgsvc_spi_GridService">3.7. <code>GridService</code> (<code>1.12.0-SNAPSHOT</code>)</h3>
+<h3 id="_rgsvc_spi_GridService">3.7. <code>GridService</code></h3>
<div class="paragraph">
<p>The <code>GridService</code> provides the ability to load the XML layout (grid) for a domain class. To do this it delegates:</p>
</div>
@@ -1823,7 +1824,7 @@ object).</p>
</div>
</div>
<div class="sect2">
-<h3 id="_rgsvc_spi_HintStore">3.8. <code>HintStore</code> (<code>1.12.0-SNAPSHOT</code>)</h3>
+<h3 id="_rgsvc_spi_HintStore">3.8. <code>HintStore</code></h3>
<div class="paragraph">
<p>The <code>HintStore</code> service defines an SPI for the <a href="ugvw.html">Wicket viewer</a> to store UI hints on a per-object basis.
For example, the viewer remembers which tabs are selected, and for collections which view is selected (eg table or hidden),
@@ -1900,8 +1901,9 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
<div class="sect3">
<h4 id="_related_services_6">3.8.4. Related Services</h4>
<div class="paragraph">
-<p>The <a href="#ugvw.adoc">Wicket viewer</a> provides a "clear hints" mixin action that is for use by end-users of the application
-to clear any UI hints that have accumulated for a domain object.</p>
+<p>The <a href="#ugvw.adoc">Wicket viewer</a> exposes the <a href="rgcms.html#_rgcms_classes_mixins_Object_clearHints">"clear hints"</a>
+mixin action that is for use by end-users of the application to clear any UI hints that have accumulated for a
+domain object.</p>
</div>
</div>
</div>
@@ -3009,7 +3011,7 @@ depends on:<br>
<code>services.message</code><br>
<code>MessageService</code></a></p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>(<code>1.12.0-SNAPSHOT</code>) Methods to inform or warn the user, or to raise errors.</p>
+<p>Methods to inform or warn the user, or to raise errors.</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>FactoryService-</code><br>
<code>Default</code><br>
@@ -3022,7 +3024,7 @@ depends on:<br>
<code>services.sessmgmt</code><br>
<code>SessionManagementService</code></a></p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>(<code>1.12.0-SNAPSHOT</code>) Methods for batching long-running work (eg data migration) into multiple sessions.</p>
+<p>Methods for batching long-running work (eg data migration) into multiple sessions.</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>SessionManagementService-</code><br>
<code>Default</code><br>
@@ -3035,7 +3037,7 @@ depends on:<br>
<code>services.title</code><br>
<code>TitleService</code></a></p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>(<code>1.12.0-SNAPSHOT</code>) Methods to programmatically obtain the title or icon of a domain object.</p>
+<p>Methods to programmatically obtain the title or icon of a domain object.</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>TitleService-</code><br>
<code>Default</code><br>
@@ -3048,7 +3050,7 @@ depends on:<br>
<code>services.xactn</code><br>
<code>TransactionService</code></a></p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>(<code>1.12.0-SNAPSHOT</code>) Methods for managing transactions.</p>
+<p>Methods for managing transactions.</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>TransactionService-</code><br>
<code>Default</code><br>
@@ -3963,7 +3965,7 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
</div>
</div>
<div class="sect2">
-<h3 id="_rgsvc_api_MessageService">5.5. <code>MessageService</code> (<code>1.12.0-SNAPSHOT</code>)</h3>
+<h3 id="_rgsvc_api_MessageService">5.5. <code>MessageService</code></h3>
<div class="paragraph">
<p>The <code>MessageService</code> allows domain objects to raise information, warning or error messages. These messages can either be simple strings, or can be translated.</p>
</div>
@@ -4067,7 +4069,7 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
</div>
</div>
<div class="sect2">
-<h3 id="_rgsvc_api_SessionManagementService">5.6. <code>SessionManagementService</code> (<code>1.12.0-SNAPSHOT</code>)</h3>
+<h3 id="_rgsvc_api_SessionManagementService">5.6. <code>SessionManagementService</code></h3>
<div class="paragraph">
<p>The <code>SessionManagementService</code> provides the ability to programmatically manage sessions. The primary use case is
for fixture scripts or other routines that are invoked from the UI and which create or modify large amounts of data.
@@ -4131,7 +4133,7 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
</div>
</div>
<div class="sect2">
-<h3 id="_rgsvc_api_TitleService">5.7. <code>TitleService</code> (<code>1.12.0-SNAPSHOT</code>)</h3>
+<h3 id="_rgsvc_api_TitleService">5.7. <code>TitleService</code></h3>
<div class="paragraph">
<p>The <code>TitleService</code> provides methods to programmatically obtain the title and icon of a domain object.</p>
</div>
@@ -4222,7 +4224,7 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
</div>
</div>
<div class="sect2">
-<h3 id="_rgsvc_api_TransactionService">5.8. <code>TransactionService</code> (<code>1.12.0-SNAPSHOT</code>)</h3>
+<h3 id="_rgsvc_api_TransactionService">5.8. <code>TransactionService</code></h3>
<div class="paragraph">
<p>The <code>TransactionService</code> provides a small number of methods to allow domain objects to influence user transactions.</p>
</div>
@@ -5022,7 +5024,7 @@ configuration is required.</p>
<code>services.config</code><br>
<code>ConfigurationService</code></a></p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>(<code>1.12.0-SNAPSHOT</code>) Access configuration properties (eg from <code>isis.properties</code> file)</p>
+<p>Access configuration properties (eg from <code>isis.properties</code> file)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>ConfigurationService-</code><br>
<code>Default</code><br>
@@ -5074,7 +5076,7 @@ Supercedes methods in <a href="#_rgsvc_api_DomainObjectContainer"><code>DomainOb
<code>services.factory</code><br>
<code>FactoryService</code></a></p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>(<code>1.12.0-SNAPSHOT</code>) Methods to instantiate and initialize domain objects</p>
+<p>Methods to instantiate and initialize domain objects</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>FactoryService-</code><br>
<code>Default</code><br>
@@ -5099,7 +5101,7 @@ Supercedes methods in <a href="#_rgsvc_api_DomainObjectContainer"><code>DomainOb
<code>services.xactn</code><br>
<code>UserService</code></a></p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>(<code>1.12.0-SNAPSHOT</code>) Methods to access the currently-logged on user.</p>
+<p>Methods to access the currently-logged on user.</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>UserService-</code><br>
<code>Default</code><br>
@@ -5299,7 +5301,7 @@ instead subclass from <code>o.a.i.applib.clock.Clock</code> singleton (as descri
</div>
</div>
<div class="sect2">
-<h3 id="_rgsvc_api_ConfigurationService">7.2. <code>ConfigurationService</code> (<code>1.12.0-SNAPSHOT</code>)</h3>
+<h3 id="_rgsvc_api_ConfigurationService">7.2. <code>ConfigurationService</code></h3>
<div class="paragraph">
<p>The <code>ConfigurationService</code> allows domain objects to read the configuration properties aggregated from the various <a href="rgcfg.html#_rgcfg_configuration-files">configuration files</a>.</p>
</div>
@@ -5430,7 +5432,7 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
</td>
<td class="content">
<div class="paragraph">
-<p>(As of <code>1.12.0-SNAPSHOT</code>), the methods in this service have been moved out into a number of more fine-grained services: <a href="#_rgsvc_api_RepositoryService"><code>RepositoryService</code></a>, <a href="#_rgsvc_api_MessageService"><code>MessageService</code></a>, <a href="#_rgsvc_api_FactoryService"><code>FactoryService</code></a>, <a href="#_rgsvc_api_TitleService"><code>TitleService</code></a>, <a href="#_rgsvc_api_ConfigurationService"><code>ConfigurationService</code></a>, <a href="#_rgsvc_api_UserService"><code>UserService</code></a> and <a href="#_rgsvc_api_ServiceRegistry"><code>ServiceRegistry</code></a>.</p>
+<p>(Almost all of) the methods in this service have been moved out into a number of more fine-grained services: <a href="#_rgsvc_api_RepositoryService"><code>RepositoryService</code></a>, <a href="#_rgsvc_api_MessageService"><code>MessageService</code></a>, <a href="#_rgsvc_api_FactoryService"><code>FactoryService</code></a>, <a href="#_rgsvc_api_TitleService"><code>TitleService</code></a>, <a href="#_rgsvc_api_ConfigurationService"><code>ConfigurationService</code></a>, <a href="#_rgsvc_api_UserService"><code>UserService</code></a> and <a href="#_rgsvc_api_ServiceRegistry"><code>ServiceRegistry</code></a>.</p>
</div>
</td>
</tr>
@@ -6031,8 +6033,7 @@ validation defined by <a href="rgcms.html#_rgcms_methods_reserved_validate"><cod
</td>
<td class="content">
<div class="paragraph">
-<p>As of <code>1.12.0-SNAPSHOT</code> these methods have been deprecated; this feature should be considered experimental and
-your mileage may vary.</p>
+<p>These methods have been deprecated; this feature should be considered experimental and your mileage may vary.</p>
</div>
</td>
</tr>
@@ -6595,7 +6596,7 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
</div>
</div>
<div class="sect2">
-<h3 id="_rgsvc_api_FactoryService">7.5. <code>FactoryService</code> (<code>1.12.0-SNAPSHOT</code>)</h3>
+<h3 id="_rgsvc_api_FactoryService">7.5. <code>FactoryService</code></h3>
<div class="paragraph">
<p>The <code>FactoryService</code> collects together methods for instantiating domain objects.</p>
</div>
@@ -6843,7 +6844,7 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
</div>
</div>
<div class="sect2">
-<h3 id="_rgsvc_api_UserService">7.7. <code>UserService</code> (<code>1.12.0-SNAPSHOT</code>)</h3>
+<h3 id="_rgsvc_api_UserService">7.7. <code>UserService</code></h3>
<div class="paragraph">
<p>The <code>UserService</code> allows the domain object to obtain the identity of the user interacting with said object.</p>
</div>
@@ -8070,8 +8071,8 @@ standard JAXB functionality for generating both XMLs and XSDs from JAXB-annotate
<code>services.appfeat</code><br>
<code>ApplicationFeatureRepository</code></a></p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>(<code>1.12.0-SNAPSHOT</code>) Provides access to string representations of the features (package, class, class members) of the
-domain classes within the metamodel.</p>
+<p>Provides access to string representations of the features (package, class, class members) of the domain classes
+within the metamodel.</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>ApplicationFeatureDefault</code><br>
<code>o.a.i.core</code><br>
@@ -8083,7 +8084,7 @@ domain classes within the metamodel.</p>
<code>services.layout</code><br>
<code>LayoutService</code></a></p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>(<code>1.12.0-SNAPSHOT</code>) Provides the ability to download dynamic layout XML files, in various styles.</p>
+<p>Provides the ability to download dynamic layout XML files, in various styles.</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>LayoutServiceDefault</code><br>
<code>o.a.i.core</code><br>
@@ -8107,7 +8108,7 @@ domain classes within the metamodel.</p>
<code>services.registry</code><br>
<code>ServiceRegistry</code></a></p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>(<code>1.12.0-SNAPSHOT</code>) Methods to access and use other domain services.</p>
+<p>Methods to access and use other domain services.</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>ServiceRegistry-</code><br>
<code>Default</code><br>
@@ -8130,7 +8131,7 @@ domain classes within the metamodel.</p>
</tbody>
</table>
<div class="sect2">
-<h3 id="_rgsvc_api_ApplicationFeatureRepository">9.1. <code>ApplicationFeatureRepository</code> (<code>1.12.0-SNAPSHOT</code>)</h3>
+<h3 id="_rgsvc_api_ApplicationFeatureRepository">9.1. <code>ApplicationFeatureRepository</code></h3>
<div class="paragraph">
<p>The <code>ApplicationFeatureRepository</code> provides the access to string representations of the packages, classes and
class members (collectively: "application features") of the domain classes within the Apache Isis' internal metamodel.</p>
@@ -8198,7 +8199,7 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
</div>
</div>
<div class="sect2">
-<h3 id="_rgsvc_api_LayoutService">9.2. <code>LayoutService</code> (<code>1.12.0-SNAPSHOT</code>)</h3>
+<h3 id="_rgsvc_api_LayoutService">9.2. <code>LayoutService</code></h3>
<div class="paragraph">
<p>The <code>LayoutService</code> provides the ability to obtain the XML layout for a single domain object or for all domain
objects. This functionality is surfaced through the user interface through a related <a href="#_rgsvc_api_LayoutService_related-mixins-and-menus">mixin and menu action</a>.</p>
@@ -8367,12 +8368,11 @@ services.</p>
</tr>
<tr>
<td><i class="conum" data-value="3"></i><b>3</b></td>
-<td>(<code>1.12.0-SNAPSHOT</code>) invalidate and rebuild the internal metadata (an <code>ObjectSpecification</code>) for the specified
-domain type.</td>
+<td>invalidate and rebuild the internal metadata (an <code>ObjectSpecification</code>) for the specified domain type.</td>
</tr>
<tr>
<td><i class="conum" data-value="4"></i><b>4</b></td>
-<td>(<code>1.12.0-SNAPSHOT</code>) returns a list of representations of each of member of each domain class.</td>
+<td>returns a list of representations of each of member of each domain class.</td>
</tr>
</table>
</div>
@@ -8400,13 +8400,13 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
<div class="sect3">
<h4 id="_related_services_24">9.3.4. Related Services</h4>
<div class="paragraph">
-<p>The <code>MetaModelServiceMenu</code> (<code>1.12.0-SNAPSHOT</code>) provides a method to download all domain members as a CSV. Internally
+<p>The <code>MetaModelServiceMenu</code> provides a method to download all domain members as a CSV. Internally
this calls <code>MetaModelService#export()</code>.</p>
</div>
</div>
</div>
<div class="sect2">
-<h3 id="_rgsvc_api_ServiceRegistry">9.4. <code>ServiceRegistry</code> (<code>1.12.0-SNAPSHOT</code>)</h3>
+<h3 id="_rgsvc_api_ServiceRegistry">9.4. <code>ServiceRegistry</code></h3>
<div class="paragraph">
<p>The <code>ServiceRegistry</code> service collects together methods for accessing other domain services.</p>
</div>
@@ -8957,7 +8957,7 @@ primary benefit (apart from decoupling responsibilities) is that it ensures that
<code>services.repository</code><br>
<code>RepositoryService</code></a></p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>(<code>1.12.0-SNAPSHOT</code>) Methods to help implement repositories: query for existing objects, persist new or delete existing objects</p>
+<p>Methods to help implement repositories: query for existing objects, persist new or delete existing objects</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>RepositoryService-</code><br>
<code>Default</code><br>
@@ -9455,7 +9455,7 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
</div>
</div>
<div class="sect2">
-<h3 id="_rgsvc_api_RepositoryService">11.3. <code>RepositoryService</code> (<code>1.12.0-SNAPSHOT</code>)</h3>
+<h3 id="_rgsvc_api_RepositoryService">11.3. <code>RepositoryService</code></h3>
<div class="paragraph">
<p>The <code>RepositoryService</code> collects together methods for creating, persisting and searching for entities from the underlying persistence store. It acts as an abstraction over the JDO/DataNucleus objectstore.</p>
</div>
@@ -10627,7 +10627,7 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
<li><a href="#_registering_the_services_2">3.4.3. Registering the Services</a></li>
</ul>
</li>
-<li><a href="#_rgsvc_spi_GridSystemService">3.5. <code>GridSystemService</code> (<code>1.12.0-SNAPSHOT</code>)</a>
+<li><a href="#_rgsvc_spi_GridSystemService">3.5. <code>GridSystemService</code></a>
<ul class="sectlevel3">
<li><a href="#_spi_5">3.5.1. SPI</a></li>
<li><a href="#_implementation_4">3.5.2. Implementation</a></li>
@@ -10635,7 +10635,7 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
<li><a href="#_related_services_3">3.5.4. Related Services</a></li>
</ul>
</li>
-<li><a href="#_rgsvc_spi_GridLoaderService">3.6. <code>GridLoaderService</code> (<code>1.12.0-SNAPSHOT</code>)</a>
+<li><a href="#_rgsvc_spi_GridLoaderService">3.6. <code>GridLoaderService</code></a>
<ul class="sectlevel3">
<li><a href="#_spi_6">3.6.1. SPI</a></li>
<li><a href="#_implementation_5">3.6.2. Implementation</a></li>
@@ -10643,7 +10643,7 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
<li><a href="#_related_services_4">3.6.4. Related Services</a></li>
</ul>
</li>
-<li><a href="#_rgsvc_spi_GridService">3.7. <code>GridService</code> (<code>1.12.0-SNAPSHOT</code>)</a>
+<li><a href="#_rgsvc_spi_GridService">3.7. <code>GridService</code></a>
<ul class="sectlevel3">
<li><a href="#_spi_7">3.7.1. SPI</a></li>
<li><a href="#_implementation_6">3.7.2. Implementation</a></li>
@@ -10651,7 +10651,7 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
<li><a href="#_related_services_5">3.7.4. Related Services</a></li>
</ul>
</li>
-<li><a href="#_rgsvc_spi_HintStore">3.8. <code>HintStore</code> (<code>1.12.0-SNAPSHOT</code>)</a>
+<li><a href="#_rgsvc_spi_HintStore">3.8. <code>HintStore</code></a>
<ul class="sectlevel3">
<li><a href="#_spi_8">3.8.1. SPI</a></li>
<li><a href="#_implementation_7">3.8.2. Implementation</a></li>
@@ -10766,21 +10766,21 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
<li><a href="#_related_services_14">5.4.6. Related Services</a></li>
</ul>
</li>
-<li><a href="#_rgsvc_api_MessageService">5.5. <code>MessageService</code> (<code>1.12.0-SNAPSHOT</code>)</a>
+<li><a href="#_rgsvc_api_MessageService">5.5. <code>MessageService</code></a>
<ul class="sectlevel3">
<li><a href="#_api_and_usage">5.5.1. API and Usage</a></li>
<li><a href="#_implementation_16">5.5.2. Implementation</a></li>
<li><a href="#_registering_the_service_6">5.5.3. Registering the Service</a></li>
</ul>
</li>
-<li><a href="#_rgsvc_api_SessionManagementService">5.6. <code>SessionManagementService</code> (<code>1.12.0-SNAPSHOT</code>)</a>
+<li><a href="#_rgsvc_api_SessionManagementService">5.6. <code>SessionManagementService</code></a>
<ul class="sectlevel3">
<li><a href="#_api">5.6.1. API</a></li>
<li><a href="#_implementation_17">5.6.2. Implementation</a></li>
<li><a href="#_registering_the_service_7">5.6.3. Registering the Service</a></li>
</ul>
</li>
-<li><a href="#_rgsvc_api_TitleService">5.7. <code>TitleService</code> (<code>1.12.0-SNAPSHOT</code>)</a>
+<li><a href="#_rgsvc_api_TitleService">5.7. <code>TitleService</code></a>
<ul class="sectlevel3">
<li><a href="#_api_2">5.7.1. API</a></li>
<li><a href="#_usage_6">5.7.2. Usage</a></li>
@@ -10788,7 +10788,7 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
<li><a href="#_registering_the_service_8">5.7.4. Registering the Service</a></li>
</ul>
</li>
-<li><a href="#_rgsvc_api_TransactionService">5.8. <code>TransactionService</code> (<code>1.12.0-SNAPSHOT</code>)</a>
+<li><a href="#_rgsvc_api_TransactionService">5.8. <code>TransactionService</code></a>
<ul class="sectlevel3">
<li><a href="#_api_3">5.8.1. API</a></li>
<li><a href="#_implementation_19">5.8.2. Implementation</a></li>
@@ -10847,7 +10847,7 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
<li><a href="#_registering_the_service_12">7.1.3. Registering the Service</a></li>
</ul>
</li>
-<li><a href="#_rgsvc_api_ConfigurationService">7.2. <code>ConfigurationService</code> (<code>1.12.0-SNAPSHOT</code>)</a>
+<li><a href="#_rgsvc_api_ConfigurationService">7.2. <code>ConfigurationService</code></a>
<ul class="sectlevel3">
<li><a href="#_api_and_usage_2">7.2.1. API and Usage</a></li>
<li><a href="#_implementation_22">7.2.2. Implementation</a></li>
@@ -10892,7 +10892,7 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
<li><a href="#_related_services_18">7.4.10. Related Services</a></li>
</ul>
</li>
-<li><a href="#_rgsvc_api_FactoryService">7.5. <code>FactoryService</code> (<code>1.12.0-SNAPSHOT</code>)</a>
+<li><a href="#_rgsvc_api_FactoryService">7.5. <code>FactoryService</code></a>
<ul class="sectlevel3">
<li><a href="#_api_5">7.5.1. API</a></li>
<li><a href="#_usage_10">7.5.2. Usage</a></li>
@@ -10909,7 +10909,7 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
<li><a href="#_related_services_20">7.6.4. Related Services</a></li>
</ul>
</li>
-<li><a href="#_rgsvc_api_UserService">7.7. <code>UserService</code> (<code>1.12.0-SNAPSHOT</code>)</a>
+<li><a href="#_rgsvc_api_UserService">7.7. <code>UserService</code></a>
<ul class="sectlevel3">
<li><a href="#_api_and_usage_3">7.7.1. API and Usage</a></li>
<li><a href="#_implementation_25">7.7.2. Implementation</a></li>
@@ -10981,13 +10981,13 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
</li>
<li><a href="#_rgsvc_metadata-api">9. Metadata API</a>
<ul class="sectlevel2">
-<li><a href="#_rgsvc_api_ApplicationFeatureRepository">9.1. <code>ApplicationFeatureRepository</code> (<code>1.12.0-SNAPSHOT</code>)</a>
+<li><a href="#_rgsvc_api_ApplicationFeatureRepository">9.1. <code>ApplicationFeatureRepository</code></a>
<ul class="sectlevel3">
<li><a href="#_api_implementation_13">9.1.1. API & Implementation</a></li>
<li><a href="#_registering_the_service_22">9.1.2. Registering the Service</a></li>
</ul>
</li>
-<li><a href="#_rgsvc_api_LayoutService">9.2. <code>LayoutService</code> (<code>1.12.0-SNAPSHOT</code>)</a>
+<li><a href="#_rgsvc_api_LayoutService">9.2. <code>LayoutService</code></a>
<ul class="sectlevel3">
<li><a href="#_rgsvc_api_LayoutService_api-and-implementation">9.2.1. API & Implementation</a></li>
<li><a href="#_rgsvc_api_LayoutService_related-mixins-and-menus">9.2.2. Related Mixins and Menus</a></li>
@@ -11002,7 +11002,7 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
<li><a href="#_related_services_24">9.3.4. Related Services</a></li>
</ul>
</li>
-<li><a href="#_rgsvc_api_ServiceRegistry">9.4. <code>ServiceRegistry</code> (<code>1.12.0-SNAPSHOT</code>)</a>
+<li><a href="#_rgsvc_api_ServiceRegistry">9.4. <code>ServiceRegistry</code></a>
<ul class="sectlevel3">
<li><a href="#_api_7">9.4.1. API</a></li>
<li><a href="#_usage_14">9.4.2. Usage</a></li>
@@ -11064,7 +11064,7 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
<li><a href="#_related_services_27">11.2.4. Related Services</a></li>
</ul>
</li>
-<li><a href="#_rgsvc_api_RepositoryService">11.3. <code>RepositoryService</code> (<code>1.12.0-SNAPSHOT</code>)</a>
+<li><a href="#_rgsvc_api_RepositoryService">11.3. <code>RepositoryService</code></a>
<ul class="sectlevel3">
<li><a href="#_api_8">11.3.1. API</a></li>
<li><a href="#_usage_17">11.3.2. Usage</a>
[10/23] isis-site git commit: ISIS-1287: updating docs for 1.12.0
Posted by da...@apache.org.
http://git-wip-us.apache.org/repos/asf/isis-site/blob/09aecf2c/content/guides/tg.pdf
----------------------------------------------------------------------
diff --git a/content/guides/tg.pdf b/content/guides/tg.pdf
index 11eab15..a463158 100644
--- a/content/guides/tg.pdf
+++ b/content/guides/tg.pdf
@@ -4,8 +4,8 @@
<< /Title (Tutorials)
/Creator (Asciidoctor PDF 1.5.0.alpha.11, based on Prawn 1.3.0)
/Producer (Asciidoctor PDF 1.5.0.alpha.11, based on Prawn 1.3.0)
-/CreationDate (D:20160328135421+02'00')
-/ModDate (D:20160328135421+02'00')
+/CreationDate (D:20160329132429+01'00')
+/ModDate (D:20160329132429+01'00')
>>
endobj
2 0 obj
@@ -78,7 +78,7 @@ endobj
endobj
8 0 obj
<< /Type /Font
-/BaseFont /AAAACU+NotoSerif
+/BaseFont /AAAACI+NotoSerif
/Subtype /TrueType
/FontDescriptor 548 0 R
/FirstChar 32
@@ -2597,7 +2597,7 @@ endobj
endobj
18 0 obj
<< /Type /Font
-/BaseFont /AAAACV+NotoSerif-Bold
+/BaseFont /AAAACJ+NotoSerif-Bold
/Subtype /TrueType
/FontDescriptor 552 0 R
/FirstChar 32
@@ -3694,7 +3694,7 @@ ET
BT
191.24 460.8250000000001 Td
/F4.0 11 Tf
-<312e31312e3120> Tj
+<312e31322e3020> Tj
ET
0.000 0.000 0.000 SCN
@@ -4238,7 +4238,7 @@ endobj
endobj
38 0 obj
<< /Type /Font
-/BaseFont /AAAACW+FontAwesome
+/BaseFont /AAAACK+FontAwesome
/Subtype /TrueType
/FontDescriptor 556 0 R
/FirstChar 32
@@ -4249,7 +4249,7 @@ endobj
endobj
39 0 obj
<< /Type /Font
-/BaseFont /AAAACX+mplus1mn-regular
+/BaseFont /AAAACL+mplus1mn-regular
/Subtype /TrueType
/FontDescriptor 560 0 R
/FirstChar 32
@@ -4260,7 +4260,7 @@ endobj
endobj
40 0 obj
<< /Type /Font
-/BaseFont /AAAACY+mplus1mn-bold
+/BaseFont /AAAACM+mplus1mn-bold
/Subtype /TrueType
/FontDescriptor 564 0 R
/FirstChar 32
@@ -10408,7 +10408,7 @@ endobj
endobj
80 0 obj
<< /Type /Font
-/BaseFont /AAAACZ+mplus1mn-regular
+/BaseFont /AAAACN+mplus1mn-regular
/Subtype /TrueType
/FontDescriptor 568 0 R
/FirstChar 32
@@ -11189,7 +11189,7 @@ endobj
endobj
83 0 obj
<< /Type /Font
-/BaseFont /AAAADA+mplus-1p-regular
+/BaseFont /AAAACO+mplus-1p-regular
/Subtype /TrueType
/FontDescriptor 572 0 R
/FirstChar 32
@@ -19709,7 +19709,7 @@ ET
BT
191.24 403.9450000000002 Td
/F4.0 11 Tf
-<312e31312e3120> Tj
+<312e31322e3020> Tj
ET
0.000 0.000 0.000 SCN
@@ -25418,7 +25418,7 @@ endobj
endobj
172 0 obj
<< /Type /Font
-/BaseFont /AAAADB+NotoSerif
+/BaseFont /AAAACP+NotoSerif
/Subtype /TrueType
/FontDescriptor 576 0 R
/FirstChar 32
@@ -32452,7 +32452,7 @@ endobj
endobj
318 0 obj
<< /Type /Font
-/BaseFont /AAAADC+NotoSerif-Italic
+/BaseFont /AAAACQ+NotoSerif-Italic
/Subtype /TrueType
/FontDescriptor 580 0 R
/FirstChar 32
@@ -38654,44 +38654,41 @@ endobj
endobj
547 0 obj
<< /Length1 13368
-/Length 8399
+/Length 8400
/Filter [/FlateDecode]
>>
stream
-x��z |[Օ���=-�m��,[��Z�7-�,ɶ,y_�-^dy�cyw���cB�BHC���!dBJ�'��Ҕf�Z��ô����kiKaC3||����$Ųch���ӻ�����s�r%�BdE4�7�j��G?��3a����ྉ�O�����el��?�?���tC���;{���e��3e���ط���<����;�����p���l��������gjrf���=�L9p�������2�%�q����_C���p`��E(
-�r��}a�dN��C�AdT�0&V$�Heqr���B���Rk�:}�!Ř����i2[�Yف��r�gn^����),*.)-+����T]S[����^���C�W�6���E����_�\@$�9Il�����l!�
- ��L|p���I��(�L��(���s�Ɵ�+�v�P������ʛ#/�d��A��_���K����Wh5b���z�YV�\�~�}���+E2�����L��;eBWK�v��Ş��=�84��HB�u�����ܓ`�s�a�>��U�ӷ�2�J@VCPV��0�U�X&%��g��xAR|'Ⱥ��d�Y��z��E]���'}���?8��]t�2+�Krɓ K���F�јg��%��[�]��^�U�+yO��pu���q9����
��9�".{�� ;O7} �|�}0��=�L�s����=]�q�]\]�&73�W�k�Y��tH�2ib��呛JYY6|��"X>�Z����+ǎ!����^�#Aȹ��{�[w�m��us�O�üA�l:?����/��y��O�$� ��X��8`.P����-�#f�($�$����w]��͝{f�Ο�t�H��k��ꚡ�D��}ml�5,�I,}u۶W�O�:����O|v���Ŗ�ū���G�|��ϱ�Y="!�ץ�u�M�]X
v��mR+��*S�����v�n�٭�� ��V*�Z��vg���aۍk�Z�cd��?��,���>X�A*��c��h�i%ϙ��4��k.H���>����4Y�J�mvT�f�
EV�m�H���X5W�����{�N��>q�zdߞ
-��rC�w���]�iY�w�s�\���%�h�����11OŁ�g�6`/�'�ٶ��|��es����fWE[� �:�ݓն�2��s�3�gw����T�җ�;t�wu�T�
���6t���af6�ח��Q�dG�PYӷ�e�����)wt�X�CP�u���,`-; 7^m"���B�Mv+M�r���W�/Ӵ� 9O�54Q�k�����Y���<�%�Z���WMcS�V�%��m��,�o~
-�<���1���Do4�z-�:�������͙�Mӕ�:W�$��8#�����4
=cT�u�=uWe�g禿ߖ\X�vo��7��7�l0�c�B�2��;N-О�8�ة��3�ƂM����Z���e7�6l����� =dfAy�� W�I�
-q�sR�����LpW�dw�wm?52xvOUR~ێ#�=�:If�|ju�CF+��3�9��[�e�1I�?v�w��ު�g�����/�?��\P��*�n-6���i3d����|��p�'i�V����}�+�� �'�����A<����Y�$ꆹ)anF�� �I�ɵ~J�8�-c�ށC��$�m�N���V���莞#C�ԪAO��o]��9;��ץ��������ؚ�l/�k/P�EY~M�OVO�Vh�u]�E��z��{�J���M=S��G�9F��V���ioޜ��4[4\�F,�������P����ȡ�7?&�Y���K��skbq��s�H��t���t\vn�y�qA�������QW��SC�g�U��k_8��:S��"��j��n.���
-�k|����[q�2�(�>><�ܾ�������7/�t���4)9|�ˤ ���T����rW�K���Y�g�.A.8My�z}6��^Z��^� gV�B�6P�B�{t�Q�ƙn�Z��m����^�ƹ���
F����.���i��v,�G�[i '������X��l��yli ?EX/�8Ƴ���R"���7��WQ�#��1)L[��w�����z��8v&o��w�[ݺ�v�6[���賷���o�۸r��0��3��J<f��݊�Nl�*2x ���I36
-I��'�#��:ʨJש%�����Q �L�r�M�B�iQc�$q���?����[D9V�/:ٓE]��IO��+J����|��P^��J�g�7ԩ�K�I�+�+e̊�҂�IHUZ
�m�g�L�5�mqT�6��e�˕
-�۬P��:a�L�t��V�ڴ��:vV�u������z����eO�k���O~jr�"|?���TN75�Q�2�)�V]3�QjK�E����_X�aYTᰰu�ytȦ��$�u��>>h��p{�L[�Bg[�~�/���}�K�z�7Kk7H��5��S�;��SI�B]d���X�M��� ֖��Ʌ
-�`�]�A03�"N�w��?�
-cg��WOu��w=������'>8M��χ�?O��A�ɿ�Y��F<�c�%���ZҬQ̇"�L�?����
-�pTx�B�6+��IA���<��L��Wi� ���>�Ht�ȫlJ���1ϯ|���z��2�E���j�
-2��_�r7���p@i����iX9�O�2?��Kv �����<�����%�0�t$�6���R/cEBLڟ���}����~2���*[yj"�o?3�����������rR�ޓ��w�<r�qoT4�69��:�e�[�AN����_�K�v�u�Y��ҙ0�*u��8�4��J»z�u�{Z�Z=��}O���w��&gb�1�氚{#L��*�W� XpE���A�͏i)+; ˆ��p%��U§Wu�S�zz����1�ϫs�����Ϝ�An\0q=E"�"*�0�e���zr�63!2ۆ/鋋�S�w�9�x7tOGi
-������5�ڞ�&�($^�2��D?�����M�t���Wosa��K(|�j����^�6@�����tT�����t�Z{���*��g��:EX�7�"�52G�G�#�I� 5:u\ڸJ �
>��k��|J[:Uq�����m�7Ʃ�n� �vW _&Ssn�c�:���W� >`�( ���/����7&�9�
��đΛ�x��Y�.~��/N64��v�ѫ������~�/3��O�����WGG/����-�|���P�������z��YF�r5�և�½/��������e��>�r���$у�swM���<���^b;q��z��t3t˃��VÁ�=�tB[4_�G�ޟ�Ȯ�h�xO���[��7G�/�9Ԓܓ1��{bv��y�}K�\Z��!lI�7v
��q��d2����Գ�s��O�de�b62���7�� �75���U��M��%-ܝ/�ִ�Q ��6�lh�٤_���I�LN
-t��6�!1�)�'(y�?���ʩ�$�%�U�=������@��t碿�^[k���V��R����j�8ԛSy�����"Om��}�s}�J
���{�m�m�N)j6��Z�l2k�>�{KMi��i`�f� b�]Z���3U�\l��&�L��,6�����WMn����D���������W�:����`�:`�� �e�r{F��l@|4q_Ex��u�i�ے#ر�=/Jm�?�M*W�������֖�
-�6zy���Sk�t&�0�d�B�'���܃���I����A�"R�TՄ��qG�3E�������Y�ߌ��JD�Q�4�������P�S��K=����n������,1B|f�4!&S��k��# \o��:�Q�IcL<O��5�ʔ��������_�}@��3��+ྨ0�bҔ�8���PY}����R)"X\:��F!�pc�Z�۷����g}�d ^�oN�\�s]E̵���=�5�K6�U�2���P?/JJ���bU�9+ ���Xy'rG����q����K�G�s"��g
[�J"��7+�@"z�ey"� �Gs|>�>7���<^���EƩ2u��>�M6��|��#��0��vDl\T�T���/c���ɗ07.�ͳZ��R�`rO���D��]$�>�J��P��D������lQ�R�,�[**r�k�q��}��ʮ|7�4Ex�8>:)?��Z�`�s��5��L&@op�W~H��O�P�r�E3��4�!��Iy}ZOG����kv�nbs[�R�kl�Mbb� �HiT72
Q
-K��s<!)a[�[A*Z��Ю���i� ljl�T���:W��ʵ)M�Ҟ?pom����*��O4"MAUgQ�\��/�<�Z��z��Vo+^�R��.�!mA�5��^m�3x����wF�N�;�Q��dl\�:��.8�� ���s�Ȅ�y���z�/�ry\�-����>15��v|��S犋N���e�i&���y^|y~mO���mN��0Z�T�6�mu'&�������_�����l'W����;ӭ6K�=���o��>�89�8��7�����1Gp?�$����8�7 4�D��;����_�g���3�X���Z���'�>���f�~[Z���?X���܄����|��ؐ9v��{�m(�JM�W���@/u��p5���0�BnK1��;��q�.�4��b��O��� 3G����(�$(�>���F������w�WXn���<b.;3�F|��w�3��d~�����.���<�����Ӳ;��5V�@M�Zֹ��H�N|N�a�'��?}��Ąk�G��Mm�wV牅 �
��ϟ{��ޞ��5��ڇ�X�Yxf�{��Y�Dn�B]Y���3H����4�l��@�-|G(d1�hlmĹ��lS�����z&JU &�!Z�c�t%�`-�!�4}������ɒ��h3�b�.s����x�����Xh)e��V4�v=�U���ڲ �LHeLzkw�]�솫#l�U\ak �Y��zg:$��G+��1
-�"]�7�;na�_�����,ʿt}��P|��vze�M���Ud�[�=���*wVLLj�K�6�b�O��O<��)����h,L��ڗ]�)����P�8c�(*^�1�V��ێ1��y�J�17n/i{��q�PAGQjD�*ݡu���{l����DJ�c��8Q��F��>Wc(�tX�zaLz-�s�.��_z�=��� u�������\$k�(���֮��>>��j��e�Oχ�v<���mq����
EO�[�Jz��?:Bz���*��u��n`*�@�m�s�1��z�kK1ɺ=��P�������%�&=!>]-�����5b6� ����X�&�%[UQQ*k2���U�d7�LK�?��~p��^��z��D���۵1N�K͂��X����f�b���ӎ��.���b�������.�<�R���6,�&��<��GʹI�3ފ�7���ji3�,~��@�=���E�m.��S���0�-�5�5�j���tm�"�����T�Dk����=�W���+/�K�
��~9`FV��>�u���<��B��s��YyW��O���uY]�5���-��ۭ�w��Aߕۚ�-ly�eign|�+{X�-�mJ��Sicη�s�w�C�
8�v��rpv���0��o��7LGb��k�M�����=�9��я2�bk~�׀�
�l��hl1L�c_R�m�f�����s����_�JG�궕$�Jس�0���x�Ð`��]><}v��`�������3�>%��y�'a��]_���3q�&�
�@�1�����U�����~)(�l��!�__�е�$m7KҒ�����I�MLjK�s�"���r 撃*`.�/v!�8���5[I�+�K+��1 ���E�W��ME��X�ZSf�R�9��^_l�d��8�`'8�
�7� �.� ߯�#@t\ �C�RA��C+?�:��(���;ʦ�e�kAJ�I-�3�����
s�[__�qe-5�]�#�ҭ5�uO ��T����0�X�]��~��l��6��h��x��<�<��z�\m�s��MS�)u�-�9P`���5��$�o��T�l
t�95ю��4eVyZ�Ӛ����K+�6��l�)��C����<�)QWR�[�1�o~J<Ω`��
P�ʂ��R ������(�P<���,G|�T����]�ψ��Q�6>����V�j#�4��)#���V�GzA���GT5[���Z�c��QN�"��j�]ٍw�LMʲ�=e�B�39�C6�/�W�Ř{���OX���am�U����[{�|�_��%�{�[m7�x���L��H�q�����#ORD����g�o�蟽@?����|>�M��ӻ�[�5���~�� ~+�|���|+�C ���a:� �
v'�q��� d�oF)�nD�z�YZ.��L�*��j�����k,4.��t{"�=�8I,4�"�"�2U��CCKs����>\�p�0������˧X}>hr�r�����V�(��d FY�0
��b��0�k�,L�M[qj�F�-��K��7�djLQ�|&X�U����
-�˹t�Đ����M�Z�J��n$��o�'����s��?ӣ���:S��/�4:=�Q����z�c���"DqQ�4ͳ��=A��8�����#Ⱦ�8�oi7�@���}\f�HL�krQE��:��G�7%���
-m��)���E��q7Ҩ8>ĥ�n��wd�"=��{�G�Ѥ)!OzH��X�0���w&�<����=&�M��%<�O��"�D_L���" �����K4���|y�,ݓ��z������9b/E0�9[_)��U����V��W����W��z��U��i�w{�JU���m9�q.0��?��8�u?�c_�ȃj�4:�.�?�kX�u�ƿ#��k���!'�S9�,��=N2g�"g��˝��K�U�����O����oG�GF</�T~�y,����Q���臣'�S�1ژŘ������(]t��W�Tq����O�
-�Y)!5K��o�ϔR8�D�!��~��أ�B���M, ��̷���pñ=���
�<��=�-������6�"d��>Fs���dz��_�㶡z�s8�1�X�o/��*���h��8s
-�^��3J㼈ԜA��=H̩B�t�K�>@�E���@~�>��
-m'�!'U�,)2"1x���Yx����Q'
�Q'���g�K��<�����>c�G|�G��N"��)9��~�7�ٯ�Z9���K���_��jdG�Y�^D�u� �����0�A�cx�*p&��""9š��=�HEh�M���H��͕� ��CD���>|�U
�"� Di�us
n���F�� �H����E"$�u���5�C<J@
-�9QR!-ҡd�R�|<
���M���
-�2٠�#rB����}U)�8�P�UB��Ug
��:T�6��Є���@lhEm�u�Nԅ����gxs#Vk14j( �����"�S�t�U`��뇂�f��8�x��8�����8 s�'��q
- �<8N!)��9(ۃ���e�q.�����tx:��ᇃ�|$ÿ��Q:���x�!](����g����M|;8�T��㑨��o��\E�ǣP��Ff���x4�"_�Q:�
-����*������d[��5���Cc�M}fM�ؘ���5�i���c��F�DSh��B�h\.;�0�$�
�14 W���'�@q90z�S3�� �@����'g'5��#��&���$<��>1��������dž���ɉ���)�<��Ҙ4aR�@�+iP0��dž@��׀k6���H|�3#��,�5G37>�ܘ�[�:
�aJr��.�WiK#�Ȋ���5�����q��fr0��0�#,Q~8fA�H`'0�FalV�א~/�������
̌Mhf��|��� c� � �/���5s�#��1A ���y�-��ab��C���@�0e6��T0c��5�������T���7�?`b)6�M�[�, d�º�,|>��&>�J1��UN���8ܟ�c"hKP�;���i��gf��G&�I����A�Zԫ�g`l��Վ�
L� cs�Ӛ��M�N�;���f��UG@� ȝ 2�����$��0�N1���s����Ʉ��>���p��,���e,�b�
R�������Ġ�x��0�f�<
�Z��p�30R�W
-٢Y9,JV;
-|?��o~�í1�KD��0�����Bg��(�+~/m����=D�
+x��z |[Օ���=ɲl��fْ�ղ�i�eI�eɻ�x�Y^�X���B☐��i�i���I!�4�����:�0--)���Z�R���_b�|�=I��Z�����{:���ܳ\ a�YM�����~���a�BX446?�o�����"Bi�����Ϸ�D(�������^$�.B���L���?�m�q�����q��)4����<\�77�s�z��;��m���-�ς,c.\���|���}V�LpɡA\L���bn#;1x���\�w_� ���F ^$?*:F'�%�xB �H�HJV���.E�jHK���2�̖��筹6�#/��Y�r����WTVy6U����}�W�?���շ
��hx�77���9�`Nb+�#s݄5GIH%B�5\�t7Itf�ܬ�Juf�¬�p.��}%ͦԶ4��9�Yys�e◬�`�Ǘﺻ�R�ǹ@��Z�k����}��<��G_'��J�.$JB&5�-W���������#�~���`�/��.v]�|��;��X��sX����u���
���R����k"6%!�J���I� .�d��t���,ae���⮼������s����.>���%��I�%�i%���������N����塗p��~%�i+���Q�W�?���@����/��WN��tї�!�c����rM�-��Ji��5��M�����}%���>uW�D!�$���n����e�W���i�H��_9v�������1B�u�o3,���<��
�e`��y�Ύ�"�Y�w���J��
���X��EX�Zs�0b��Jv�<?ׅ����g����N�$�h��f�H�(��*N">������^ò'�ĒW�m{��䩣�=����gG�^]liY���~�ȷ8/!����#�:m*X�[��܉���\F���إ4������\�~_U`�r-�y*W6O����ȴ��>F�0�������5 ��v�� I�F[�V�mO#8����Ti��_~��&˕��������آ���˧�<�y�
�X;�W��P��G���G��tn���x'\�*��9P���~;��5x��_��fb[8��XG(9p�t��
+l�eׄ7��s����|�5'���l�\'����vV���uN]V���.����+��R���������ac�ܦ��Rm8̬����]}�BJ�b�*o���<C�w7���R=�/:�]��X��a'����Uh�b��C���n�ѭU����1��b�e�v$���k�zu4��#��i�d�1O{ɷ��g�U��ԤE`.(v�Dt������=�#�*i�F�3�H��d����q�q��欬��*[�3K�]J���xdTB���1��:�����lϳs��oK)*U������w6x1q<q�~����iwT�}����2C�&m~qV�C��l��@ UK�n2 ���T`���$�[ ��m���C�ND%�<-9�GG��O����I.h�q�÷Ǜ�P'�*�O�.�K Ce�kbf7g�~��,5$�
+Ǝ�����iy�������y)��������i�&Sz����z��'��~2���k��X'�H1އ���Hpx�a�lj������5J�n���f@�ҟ�1��\�d�sN�2�8��L"p��f�tYAo�!gۏ��92dO��kwwdW~�����9'~�l�.#�w��?��ƖDG{I~{�
+.�j�Dx�z��R���/��g�m��[W6�X�Ji�*�?��Q8r��tO�3��ysf��l�pM:�7wTe�K:l�6O�:ٵ�5�C�o~L.�vs1^%3���"Ģ���P�b7鰁�i���~����xgM������������~�J�߾p��u�,)U&Hw�ޛ�\li�~��ea{��\E�A�;||x�}5
����o^8:�R��Ssyj�QN4a��PC���Ż�V��]�\p�����l \w��>;��lAάhM�.�<�4蔡̍3�:����2}m��s!�
F����.���a��6,�G�[i '�������aq����<
+�ԃ�"�n�Y]_)����Tr{���՞�w�ƭ����;�m�o}y=z|;R�Nλl�.m�g�M���d{ݺ����y��6�\������,B�La�R�H�oEP�b%���`Ƥ d��'�#�ef:ڠ�Ъ������щ�,�b�M�B$�iQmF��D���I0s->_L�;��x#F���W�"����X��³�B�g�7ԩ�K�I�3�+�̊�҃�IHU5���g�LL�5�o�W�6��e�˕r��$W�\Z9��|L�t��V�ܴ��:vzT������b��&�El����%6����H�On��U�M
wԧ�˶U����b�b0���bX�8,�BCrG�*,%����e���,�?�^3�V&��Ɩ���?5x����������Kw����g���TG��H��24�fBA��%,ym��%��ar�<.X;i���D�������]���+��ؙ9��S+�]��r��o�N����p"��ӟ/�|�Gq6.���p��k �BЯ�4k�P#�����
+��#ܸ L
+�v�S<�6>%�,1ѧ�UZ4� j���"�F�*���cm��+�����^f��dax�_���L&�����*e'P�`,�pV���u��Ϫ���0�dj���9��a5s�)��1�)�
�nw��K�A� ������c_���L�h{��Z���������w�|�s2���#$�������$��]��\}�����d�NqZ��S�.8�*>�����Ywx���`+��@�t&�E�
+�ۨ �)�.����a���V�VOA�a�ӽ���e�ё�CA���9���S=���� \@��D'+n�}�cZ��N����h\�ĥC����y�z�WG��[�;F�yu7t�=3��4�-�&���@$SDEb%�L7�o��ܯ�J�ʱ�K����4�|�9�O���Q�J?v6��-o
����:-)�r�Ȯ2�O�,56��2���!���\����
+_����:��ױ
�æ�%��<R�0����V�y���tDXA�=�!�፩��k��E���t�$��Z.mX% ��Ƌ��Ul�H�5����N�_�6���C��k�+�/��97��ױBZAsЫ�w0o�RǗ�n�����
+qz�������,x?��'N^;���E�����MO?֗���O��'�k{\髣���{��}���P(OP�`�:d����,3���T�Â@�ޗ�t���G�2�城o��k`����;'O�w��[G/���8fh=�g:� �:��A�l��@�Z:�-���t��vE���5m�?�����*���#�wǏjI����=�;^��}K�\Z��>lI�6v5��q��d2����ܳ�s��O�de�b60���7f�� �75�i��&����Η^kZ�(��v64�lҀ/�B��"&':�`ǐ�q��,�������U���A�}����;�>�m*۹��z���Z-���8�k�5��;��V��$�f��][|G�}��<ߦ2��}�^o�}[sR����e�-�L����RS��oؽ�i��u���tLվ�D����:�2�ͼr����U�� �� Q�e��$�mz��յNmg+<��5��5vtق�ܞQ�&�_�Wn���k�����v�dϋ
��w��յ�|�}w}��e��4��^<������ڃ�)��;�4Y�к���J,sc���cRo��� ]%g�j�jv�"yWTY¸,��������oe�N)�ۨk���l��ze�����`�Ih3�|�:w"�!�O����JɵJu��7�G�(�(�5$�'y\��AiLQ��K��Oӯ��>�OԚ o.��s_�����k���_��>�G�V*�,.��z��Z��o-��[~Z��>r2��7`�
칮"
��@w����%��y�W`���&�%p�E�2۔�yw��`�����#PH��C�(�_RΥb��) ���-&��ՙ�|�/>��,���b8>�@��A{W/���ʣ�YZ\I��Ѥ��t�>_�֞��J�p;2.>:J�HQЗ�A���K���^��V�g0�'��z�"\�.z�P�I�� km�N����a�B�"�[",v�k �L9}��®|7��ty4x�(!&� ��Z�`���Jԟ��F@�w�V~H��O�P�2��0��4� ��HY}zOG����LKN<�nRs[�B
�ml�Mfb� �H�T70Q
+K��sR̶©��T(�t�]{�������J��uΣ�ʹ)]��^0pom���f�2��O�Bu����|���O��N���=[Ӫ��,q)]Q�RPe�6���{W�;3O+����&��NDp[��Wx�dD%���F~]ĺ�/�p#����k��Լc��gO�3>&�~6���� �� x�d�=�Ƿ9hg�h�BQ2�X�Օ�����w��R�v2��\�C���̰X͵�䲃��������T~��c�����ȓ�sz(l���$А�gX�g����8CY�sky�w����.V���mI�w.�`�{�s7۪
+,�}�����(:-IW����%����Ⱦj�
+�5�`®���̒x*�!GH?ϓ9����I����x�No-���z\Iw\a�y�\ò�P������i���� S�SO���� ^�
+��c��Zn����q"j2�(ɰΝ�N/D�wr[�?�U��{}'&�+>"�nj���:_$H���O~��Ӎ����X�9��>��Z��3��S?�NH�&qS媪�4&�A2$�榣l`k5ڬ�;B!��@ck%έ�g��^����0Q�L4��1�\C�3%k����V��?�uO�45W����r���e�%��Ĭef��LK(u ��1�+��Znĭ-���TƤ�v����n��ö]e�u�2�E!�w�C�r)[�<=�+��3$:����&�$)�8�֬�K�%��y�ogTuY�ijIqeV�9��sد���cc�r�Z�Q�|2�p�~�A�Va���kfcQ�־��,�����R���� Ҙ�̹�ڽ�6�I�OP���B��q{i�}��
+;��"#�v��=CT��cm��77J�g���
7��yj}i���� b3jɞ�w)�������Oz�k��/��� a_߄!��v������V��.KBFĶ� 6��x�K�<�o(*��\re��f��:����
{��օ��� �������q�E,���� �C�*Oz��D�Ą�X��HH�P��4B ,|��c���S�bQFG+-)p��QB�A��3-�O��x�����{
S���c�o��:|N�{"UfBB&��=���KL;�g�tr��ަ;`�s��0P�Jy2B�a)0YXWύ .`�m����>��|�,�ۭ��&S�϶�W�4ѣM>_T��r\2�\��3��_�Z3,6�������c}��?AK��K�Bz���Q��B����`d�C/�X�oʂ�+t��?7p؞�w��랸D�W�Xr:�\b����n���g
+�����la��.�:��\��Ún)S:d�*+s�͟��n�(l�����>�y�}�<�a:��\\�૫6�g7�i7� t�(��*�$~
�����ȏF��t>8.�U` ���m��?�<�P�����l��n[i���=+ �!����9 &������g�
+��NO��)(�9��S@\�}b�����j=]`2�p �#ί+N��[e
�^뗂JW����u
+]J�6�8=%���ё�Ĥ���>,rX�`.�`.����b2��q[��X����¸��h92P~�^d�G�n*2���Ԛ2�����1%X��b�${��;�YWm0�Y�v � �~���2��
+�'Z� w�)��$��Q>5.5yr-���F�����w�7L�.]}��n���dVu�{�K��H�=�TS�ު�<c�vA��݂�u��,
+�Q���vx�����s����Z7Mզ�U�t�B�
�R�8[�R�����ў�P�ػ����K�ZWR�/�۔��V��
M'd��-�$mi}oq���4�k��)�8����C�*
�J%��n�*ek�xB�w�c2�� �S�q}�V���k-m<n7:�����F�iR�RG6/ϭԏ�|3�ˏ�j�[_����5��E� ��x�r��6��f7���EJfgr�l�_*�ǚz���OX���ai�U��,�[{�<�_��9�{�[m7�x���L��H�v�xc�%TG��<ď,+���$����?{�~&��? ��|�P'�w��zk��%u
z� �A�Vn����V.��@����tl�N�H�;A��/ߌV$H8��4� /��B�/ȕY:e,���5=�_���Xh\|]�rGq{���8h��2y�e�|����j���}�Z�daF����3�[��O��|��Zd�i}[k�\^��IO���a���a��0�k��L�M[�*�F��́�s��7�hlLU�|�_�� ���
���*�t�X�����M[L
+��n$��o�%���e�r��?ӣ���*K��/��Z�Q����z�c���"����t�����A��8�����#Ⱦ�8�oi7�@���}\f�HD�kJqe��:E�G�7%��rM&��)�튈<"P)�)n�A~ |�KU�b���heF��=���ܣN��C����#7���w&�,�4��=)&�M1��|�E�������F> )\93�dri���&�ni�;��u��=����s�^�`~s��R�O����VgdT���{҉w��JeŴ�R�����6����8\��m���DZ�4�F�hEџ�5,�Z܋���N�5RN撏�ש\j���'���s�����Nq_�H����#��<���=�{;2!r0�y~����먬�cQ_DGG�G_�^���<�;��������.��[�;���W��������D'DW��J�IR�<����$�
Y���+h����B^X�.bYἇ`�
�G]p�c�p����n8���f��h �^x��q!�
8Q=�1���e8�E����
�����͏9��"��z���f�ˁ3��u��?�tH�D�׃D�㠛_R'�j/z�s��1����T=2s$HO<�����?Sg��RD<��9�(�:�>�`>C^B��q�E���3�8�q?Bu�}�Gɐ�����?�~-���i��^�����*����W#;҈8�"⬻O�5E]Ň���X��3�+4�� �!(E��E*F;o���/G�6o�BňO�`�"��?��;`�j�!u J3���hp���6���� E�h5h"�#�7��P"�Cϑ���i��@ǔ����ЭeB�hD&�LȔ9�
+��
ّj�|�GN�ʠƩ�
+�
+��&�:k`mԡz�5 �&Ԍ��bC+jC�u�.���=171b��@���q�-�,rL1�K7\ƙ�~(8�a?�(='� ='aN��$`� 8N!>��)$���8�b[p����<8�Eq��E -�>�����q����y(�wp<I���H�Fd�����q>�&��BJ����(THз~i�$��Ѩ�l�� �pp<u�/�(�R��Ky�&��G��g�9��u����z�D�I]26�nbnͨ�f���7�Q'��� 7���0��� :�L= Ch
��&4���I�P\������{5 ��u��G����Iu���� ��$<5 O5�O�������1�4��!4�h�nrbrv~
+ ���F&��Fu��:�0�J��L��!�7�����t}3������:�d�U�
�37f��N
d���\x7��K�U�)���
+dE�̨���i���zT=9�|���(?���$
��F�06 +�kH��V���c���fF�&Գ��
>]�Z���q d���g�깉ᑉY𘠄�~u�����0���Yv�s f��2p�u*�15���
��ofxvv��l��0
���&��Sf 2if]q>_ ���d��@�*�&v|�O�1��9(yǎ���X�3�s�#��$�`�L e-�U�306���jG�&f������i���d����,u�sL��# e ��bx�g}��a�e��������d��z�a|8l�~�irz�<@1c��TVQ�\adPl<_�VH�N��j����+�lQ��%���|��������%�xl{��G��3�a��������[D�
endstream
endobj
548 0 obj
<< /Type /FontDescriptor
-/FontName /AAAACU+NotoSerif
+/FontName /AAAACI+NotoSerif
/FontFile2 547 0 R
/FontBBox [-212 -250 1246 1047]
/Flags 6
@@ -38722,40 +38719,44 @@ endobj
/Filter [/FlateDecode]
>>
stream
-x��zxו��3#Y�mY���$[�[�e=��eY�����0`���X��B � !B�%�<��4��m���$���f6KIi�o7dӤ��l7_
-��gF2�6��
3�ܙs~�q�=g�#��ȉ8h�?�7����v���x8�y�Ӎo�� �5�&��~?w������m#�;�!A)B�322�'j�A��
cC��I�3py�5-ן���oa|ƽ��3�>�a�����ߊ��>�<7�
d�� Bֳ0�#/B�p�E���D�LRq�)���OK�d
-E��D�D*�g#�!U�U�<�V�7�``4��-�B�;�E.����J���-����?�M����H8�"�A!-�'=e�ۥ&���ى�x���V�ׅ�*�=�ӗٔ�W�r�8�&��v��L"�����,�o��
Ia Qr�� �q�K$~]�c��W���}���k�(�=w~y�Lx{���'����8�7���_0�*���I^;a�� �TBp���ij�*�WM
˫�����/����gNҗ�����3�dxu�����~FK#h�p�z���s�d����=�*�\�5ke��Cъ;G:T��M����
^Ku���0r�7�:��ey�R7!�o^����q���<��BȿĒ;����G���_Qnλ (�� �s��nWP��U@P��;_߹�'�<�M?ݷ�����BK] Pg��̯+��K�ҿ{;{˟{K�Z��-���^~����~v����g �Q�( �u�E��e�$��nHb�;��&e���<���j��"˺��*�h��g��f�p6�I�u
<��k\ͣq�Dq�_�U����N@eb��|I�31�u\)#-i;�siQ�ƣ���K�b�洹b�X{gM��ƑΒ�jS`����7�R���z��}�����0����=�О���^�9����l��m `cC����EV���!ՙ����&��2��1w�3�7V�)v���X�6.�{W�rM��_m��``�����[*��SUe������;���J���"�XW�͉�v����mm�����[5U��Ƿ�6�0zWk�Lw�<��s[���kU�k�����4�
--6���Z�[�=>��L�Zr��V�Sλ��M5�s�瞧��/t����)�u��$����J�[����5�¿_�~ov�ʖ,��ڪl�2K`��4J�9K��7�I��� �[�̢p��{u���s���T�)�Y!']�Q�Q��B���*o�Ow7�y}�����F�7�E�xw���i)F�-zo�8W������5nZ*�?1������κ�®��m�g��Av��[0�\A
-��Ա�t�|��Hi_mW�^�Y��XI馗f�~�����_�0jV�������9eGև�-�8�u��>�J�Q?:0����u���?x�>�f
-��*�=M���E9z��}��o^:�D"W�/�`�4��V����,��vB;�Yq����O�����u��WOC� ��A�шh�K��&:'p��l�L�d%�s-/#CL�ݹ�h���c;�7�
�w��f����]���%���K5��
-�R�BZ��
-g����P�[��3��"<[�~E����;jw��}�ۛC=�*������F�e�~��)v��Vd��._i���.���C�E��r�B�*o�Ձ^��W>�K'V���xF���= q"��.�"�D�ϭ��U��d[�>��6��v�o>=>����}��5����@����Wb��(����A.�f��$��=5<�����S��+��.�C|�X����%w���o?��O��DN^��EK���f����d�
B�!��x�A
Å��06�)�[��k���1� v`�N��SH-~=� �Zqt�K��f�kX�_�Ԛ���ݭ��0�[�h�\.�f�T��1��3�*�D� !][b�^��`
h�xj�Z������闵����
�I�� xK�Ȏ�l>'R�LR�d
-%ҩVC�oeW撺h��-��]�?�5딛sD�\����b6ͯ{ �[��.���\�6��*�n�*#��1_^}G�?�O����-�+��b͍u����@MMO��]o���B�9y̯� �LLf�g��uB5�vW+�Y����_��>ӵ�%�zz�3%ڊ�2�7Z��P���~}q�.ݥ��m��.+{�$��=n,_�2U8U��vw������zƷ��^�)���x.���j/%s�p)bȜ�������wG��0�$�'��?�O^87;=z|�G|}���g [|b)R��V�Ds��Z͊_0��o@.H5j�ob߽E0�Ա^+�J����+�dq�e^k��L�Ba�I�6���y�a���2��*/�z�]q��(��u�''5F��kl��������X7X���Mٔ��o �?b��r�ew�Kb�� >�o��?���c��"/��һ��� �
-rj��_%e]������t1R��d]�!�(�$�o�L���3���7�Rv�(��v��D��X/|� K\ӳx�͙9}~��GI�s�9�f�u;L�����X���6�b�Y���^�ެ��"�d�u+s),A���U���L����j,UYd�vf��#li��2 �}7����Oŷ*D��h�4B��"5�iꦯ�f܉k�*���@Q^��He\�P_�q���9=y)ƪoK�O����{7�hXc��:����ќOV�D_�����ѿÜ3'1>���L�;���h7��_ۻ��tk--}kl��җ���x�r�&a���}g";Z��q �,ʏԥ�/����[a�\��˞�|��i}U�*��������o}�
��K�t�q:dj���}s�y�`q2�IrfK�,vCa�03�_��V��vQb�:��l��IYT���Uu�n����,����]P��F&���m멐�݅aKV\ ]
-~����+��
�ͱ�Dl1�N������Pz.�{gmy�"r<;���V�0*��,�7:vp��i��؆c���ڰ���4�59��GF��6xO�iry�쒮+m��6���:l(\����x��I�2��ڿ�8�Yk�6��XW
oi�fc%�]����g���F��c�g+&ìg!�0^>a/3gQ�Ө9��L*�\f?q��ڦj%F��n����[�3JXYZ�� ����J���#�x�s���^��o�����eL�"�`3��u�&2��@��:���.����
-�'_�Ff��L,�/���y���fR�RQ��0`r%1�@V`�]�"��!ؠ
-�g�=�p�@&��=��M�<�!�A���̑ҹ砜� �L�4�*5�c3�"NT)�kM��P. ��2K��E�rD���b"M�����DL���pA�����&��.˽��1u��yJ �'���cd
-�G�̬�r�_Ч�4�;U���U���Pow�B&�Z1pN�]q��jRW����k�T<oa,��/s_��?�S�4
-~,�t�*rh�y����r�����qvSH��L>�%����O]X�f�B�y�Y6�Hqia�[��t�^5{5~bE�o�|9N��n�J#�K"�+\�]>�S�qQW�1�Wz�KjK:�m�`������%7��������}�P~V~����?������ ���J��OV�lrѧ,�~" 7���Ntg8��muο��P�wYP���r�U� ���!)JPxpf�QM�Z���=4�jay�}UJge��8_]��^5?F?���l����=��=rt���1�ǿ8�K66z�E~��-�7�J.�œ�#ѽ��;��:����!�<8�ʼ���q����i
-����Ò��=��mI�Mv���uV���������g�s̭�U�c �ʁ*nf���K���M�6B8i8�h�pԺG\8Ȓ���<9���?�_���D*�(L�Xe+� ����I$Em!w�M�b�Q��ǏT:U{><x��j���pI���
n%/vuÂ����C`5����P�ssS�l[}o.�2m�Lƚ�7:������wvF"����/�U9�G���˽���b�s�1���N4���e4=|n����u����C�v�f�R�3���K\3S�/�7z�����7�N�M���j��X���ڭw�
-������\�[��f[�{��>:�[|��rE�K�
-�D&��{��(ZBm�Ghژ�pV"wQ��߲ ��"���6�}�'��<�]�>6!ꬥo�6���YN�Ȝ&5��ECO���ty��4�k�f�P���_��C�r|J��*߶̯9�I�V���)7�Ƭ�[6�r���y�^��L�/4�h}�|�V@��VM�T#K���H�i��^�$N�*5b���:[f�?�w|6-Mc+1�J��0�:T��;F�آ�ei
-�^]�62X�IӅ��|+�t��J`M���a��-�;T#l��6���\���U"s��X�R�_ǝ�C�K�ٹ�nYv"7��W8[����t=�x�r���Y1�7[=�̖�.�SE�"/F���m��TjS�����Fg ��s'q�k�:�0��eq�O�
-3 ���6�˝���r�1�P��!��r�Y��,簹X/�ͦb�Xl(�:��8�'>w*��'�$;����Y��X �a�l^�+%��Ȃ�N>>ޚ�j{Rv�"8$A��I�n����v/�ƋR���0��\T{XC��.�^k��Z�-S�;<ܱ� ���9��$A�P]��*�oa1竿N��,�W�����ݱ!g�B&_�閖��"5�t\|Z�gCe�q�8��c�B��t�~�3b��� "���%�m5��� "���aG�X��/��G��ou����U��w���>�h2��\�l�.DZ&�� ���.�?�?oykw=�ļ-o�����`�[ƞ�]2�BJ�{�C=��XY�Ѕ��''�ɓ��g����g��ِ?N�@�us�mUOdL�^&W�\�`&�&Ʌ���D�����G��2���CG��}�O�(����0i�6�G�<�r�`���Z�{��K�}��Neվ�=tao��F����KD$�y��ǎ�?:�fp���
p�P
�*���I�>��6l��m/fK�k�F]�M�l�
P�HKה�Y���=9P
-5�<˂��t!G�m��+V'7nZ�ڬ�p��l���K����:��*��� Q�\{�ٺ㜗~y����
%4H�!%�֡"����K����'�DO�����K
-䉘;f�K�U�Û��+Un�5x�Jf�+�O
-D�ͯN��W����zF
-�d�@]}e6}���I]���À����Ӓ._�8�o3+U��6�wYQ������������}D��&W�Ԇl*E8����NJ�]nWH�V>Tk���9:�æȭ��n��-���P]7�A�qh��37;�2X�|gw�^ �����>�f���{a��l�!#���k���n_�ds��ʑ�p�s�K_
?����g�˶�"��zt����;�D~�B����&Y��nɥ��$Wr���W�y�y��k��;��R[Q�M���Ss�9���=�Ч��K���X����\�h��M���6�*%>w��V�ē}u0Xo�oZh��;"�h�p�y�.Z��<���@_�Ϥ��:bK4Ϙ�ݭ0�9bq&���a���%~^�h�,�:_X^Z��)�視ߓ]r���r9:���U��� �#�}�̅�-�
��,�O?S�R���a�*^ZU� �W�uj!�ͥ�|�)��4��P�%�Te�4n_,̠��y�sTx�DðIiwMت,y��x�>�{�85�En�d��q�[��_�*��xQ��P�����
+���l�gbۑx�/��V?���69��0�%���b����~�m��j~&mW���ݟ�]R͝�Fl,.r�a���Q���?EoS�e���lyܘ����i��7X�W�gk��^Vx�:}<��v���m��`���e����y�ɞr�ӠK�őQB@�8 ��
-�������{j��z:�a�
�--FCymt�A���*�?]�˗u����l�edJ2x�.��(h��k���@��������Yś<�;���:1gs<�&rdZ{��*��F~��~�C��p7��B�/O~�������E�%ً?���|Ԍf�t
-��p1�H��5�C��<@��RS3ԏ��9N��'�?p���4�O)M)ϥ��W����0՞z�[|5��,�4����
�
�g3����#s�r�ゟe�3�3�
-�1��|B��
:O��,��*�MlAn8�6�8�p���CG;�p��#��h?��x�^�t�
\=�p�7(�݇��AH9�&�����)�?�Bp��si9��7(��Eݜ"�����=�#���Dfj�8Q�'�!=G�8��� �B}�Z�����B~�BdYa�K]��~��U�ɩ�A��fb��o�B�-t�̟N����_K)C����8K� S� �� �l|X�8��!|�@D��8AP�A��rt�ux��<\��R�4�O_O`��#�4?��о�
-�,Fɿ�>��n��5e��QJ��J�D�GH�� .��)�
-�\d@Fd�~6�[��p 'TEn���b �����R��P=j@�� "���6��r'Z��h�B+�*���,�\��],L1;o�t��h_�μ�|,I'