http://git-wip-us.apache.org/repos/asf/isis-site/blob/6ad91949/content/guides/rgcms/rgcms.html ---------------------------------------------------------------------- diff --git a/content/guides/rgcms/rgcms.html b/content/guides/rgcms/rgcms.html index 302daca..a71a277 100644 --- a/content/guides/rgcms/rgcms.html +++ b/content/guides/rgcms/rgcms.html @@ -378,10 +378,10 @@ <button type="button" class="button secondary" onclick="window.location.href="https://github.com/apache/isis/edit/master/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms.adoc"" style="float: right; font-size: small; padding: 6px; margin-top: -55px; "><i class="fa fa-pencil-square-o"></i> Edit</button> <div class="sectionbody"> <div class="paragraph"> - <p>This reference guide lists and describes various elements of the the Apache Isis Programming Model, specifically reserved and prefix <a href="#_rgcms_methods">methods</a> (such as <code>title()</code> and <code>validateâ¦â()</code>) and various utility and supporting <a href="#_rgcms_classes">classes</a>.</p> + <p>This reference guide lists and describes various elements of the the Apache Isis Programming Model, specifically reserved and prefix <a href="../rgcms/rgcms.html#_rgcms_methods">methods</a> (such as <code>title()</code> and <code>validateâ¦â()</code>) and various utility and supporting <a href="../rgcms/rgcms.html#_rgcms_classes">classes</a>.</p> </div> <div class="paragraph"> - <p>It also describes the <a href="#_rgcms_schema">XSD schema</a> defined by Apache Isis. One use case is for the JAXB serialization of view models.</p> + <p>It also describes the <a href="../rgcms/rgcms.html#_rgcms_schema">XSD schema</a> defined by Apache Isis. One use case is for the JAXB serialization of view models.</p> </div> <div class="sect2"> <h3 id="_other_guides">1.1. Other Guides</h3> @@ -432,7 +432,7 @@ <button type="button" class="button secondary" onclick="window.location.href="https://github.com/apache/isis/edit/master/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods.adoc"" style="float: right; font-size: small; padding: 6px; margin-top: -55px; "><i class="fa fa-pencil-square-o"></i> Edit</button> <div class="sectionbody"> <div class="paragraph"> - <p>The Apache Isis metamodel is built up from declaratively (ie, <a href="rgant.html#_rgant">annotations</a>) and imperatively, from "supporting" methods and other reserved methods.</p> + <p>The Apache Isis metamodel is built up from declaratively (ie, <a href="../rgant/rgant.html#_rgant">annotations</a>) and imperatively, from "supporting" methods and other reserved methods.</p> </div> <div class="paragraph"> <p>This chapter documents the supporting methods and the reserved methods. It also documents (separately) the reserved methods that act as callback hooks into the persistence lifecycle of domain entities.</p> @@ -491,7 +491,7 @@ </thead> <tbody> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_prefixes_addTo"><code>addToâ¦â()</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_addTo"><code>addToâ¦â()</code></a></p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Y</p></td> @@ -509,19 +509,19 @@ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> - <p>Directly mutable collections are not currently supported by the <a href="ugvw.html">Wicket viewer</a>.</p> + <p>Directly mutable collections are not currently supported by the <a href="../ugvw/ugvw.html">Wicket viewer</a>.</p> </div> </td> </tr> </tbody> </table> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_prefixes_removeFrom"><code>removeFromâ¦â()</code></a>`</p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_removeFrom"><code>removeFromâ¦â()</code></a>`</p> </div> </div></td> </tr> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_prefixes_autoComplete"><code>autoCompleteâ¦â()</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_autoComplete"><code>autoCompleteâ¦â()</code></a></p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Y</p></td> <td class="tableblock halign-left valign-top"></td> @@ -533,15 +533,15 @@ <p>Return a list of matching elements for a property or an action parameter.<br></p> </div> <div class="paragraph"> - <p>Alternatively, can specify for a class using <a href="rgant.html#_rgant-DomainObject_autoCompleteRepository"><code>@DomainObject</code><br> <code>#autoCompleteRepository</code></a><br></p> + <p>Alternatively, can specify for a class using <a href="../rgant/rgant.html#_rgant-DomainObject_autoCompleteRepository"><code>@DomainObject</code><br> <code>#autoCompleteRepository</code></a><br></p> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_prefixes_choices"><code>choicesâ¦â()</code></a></p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_choices"><code>choicesâ¦â()</code></a></p> </div> </div></td> </tr> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_prefixes_choices"><code>choicesâ¦â()</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_choices"><code>choicesâ¦â()</code></a></p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Y</p></td> <td class="tableblock halign-left valign-top"></td> @@ -553,12 +553,12 @@ <p>Provide list of choices for a property or action parameter.<br></p> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_prefixes_autoComplete"><code>autoCompleteâ¦â()</code></a>.</p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_autoComplete"><code>autoCompleteâ¦â()</code></a>.</p> </div> </div></td> </tr> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_prefixes_clear"><code>clearâ¦â()</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_clear"><code>clearâ¦â()</code></a></p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Y</p></td> <td class="tableblock halign-left valign-top"></td> @@ -573,12 +573,12 @@ <p>Allows business logic to be placed apart from the setter.<br></p> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_prefixes_modify"><code>modifyâ¦â()</code></a></p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_modify"><code>modifyâ¦â()</code></a></p> </div> </div></td> </tr> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_prefixes_default"><code>defaultâ¦â()</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_default"><code>defaultâ¦â()</code></a></p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Y</p></td> <td class="tableblock halign-left valign-top"></td> @@ -592,7 +592,7 @@ </div></td> </tr> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_prefixes_disable"><code>disableâ¦â()</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_disable"><code>disableâ¦â()</code></a></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Y</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Y</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Y</p></td> @@ -606,7 +606,7 @@ </div></td> </tr> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_prefixes_get"><code>getâ¦â()</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_get"><code>getâ¦â()</code></a></p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Y</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Y</p></td> @@ -618,12 +618,12 @@ <p>Access the value of a property or collection.<br></p> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_prefixes_set"><code>setâ¦â()</code></a>.</p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_set"><code>setâ¦â()</code></a>.</p> </div> </div></td> </tr> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_prefixes_hide"><code>hideâ¦â()</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_hide"><code>hideâ¦â()</code></a></p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Y</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Y</p></td> @@ -637,7 +637,7 @@ </div></td> </tr> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_prefixes_modify"><code>modifyâ¦â()</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_modify"><code>modifyâ¦â()</code></a></p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Y</p></td> <td class="tableblock halign-left valign-top"></td> @@ -652,12 +652,12 @@ <p>Allows business logic to be placed apart from the setter.<br></p> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_prefixes_clear"><code>clearâ¦â()</code></a>`.</p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_clear"><code>clearâ¦â()</code></a>`.</p> </div> </div></td> </tr> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_prefixes_removeFrom"><code>removeFromâ¦â()</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_removeFrom"><code>removeFromâ¦â()</code></a></p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Y</p></td> @@ -675,19 +675,19 @@ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> - <p>Directly mutable collections are not currently supported by the <a href="ugvw.html">Wicket viewer</a>.</p> + <p>Directly mutable collections are not currently supported by the <a href="../ugvw/ugvw.html">Wicket viewer</a>.</p> </div> </td> </tr> </tbody> </table> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_prefixes_addTo"><code>addToâ¦â()</code></a>`</p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_addTo"><code>addToâ¦â()</code></a>`</p> </div> </div></td> </tr> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_prefixes_set"><code>setâ¦â()</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_set"><code>setâ¦â()</code></a></p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Y</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Y</p></td> @@ -701,7 +701,7 @@ </div></td> </tr> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_prefixes_validate"><code>validateâ¦â()</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_validate"><code>validateâ¦â()</code></a></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Y</p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"></td> @@ -713,12 +713,12 @@ <p>Check that a proposed value of a property or a set of action parameters or a single action parameter is valid.<br></p> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_prefixes_validateAddTo"><code>validateAddToâ¦â()</code></a> and <a href="#_rgcms_methods_prefixes_validateRemoveFrom"><code>validateRemoveFromâ¦â()</code></a> to validate modifications to collections.</p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_validateAddTo"><code>validateAddToâ¦â()</code></a> and <a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_validateRemoveFrom"><code>validateRemoveFromâ¦â()</code></a> to validate modifications to collections.</p> </div> </div></td> </tr> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_prefixes_validateAddTo"><code>validate<br> AddToâ¦â()</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_validateAddTo"><code>validate<br> AddToâ¦â()</code></a></p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Y</p></td> <td class="tableblock halign-left valign-top"></td> @@ -736,19 +736,19 @@ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> - <p>Directly mutable collections are not currently supported by the <a href="ugvw.html">Wicket viewer</a>.</p> + <p>Directly mutable collections are not currently supported by the <a href="../ugvw/ugvw.html">Wicket viewer</a>.</p> </div> </td> </tr> </tbody> </table> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_prefixes_validateRemoveFrom"><code>validateRemoveFromâ¦â()</code></a>, and <a href="#_rgcms_methods_prefixes_validate"><code>validateâ¦â()</code></a> for properties and actions.</p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_validateRemoveFrom"><code>validateRemoveFromâ¦â()</code></a>, and <a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_validate"><code>validateâ¦â()</code></a> for properties and actions.</p> </div> </div></td> </tr> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_prefixes_validateRemoveFrom"><code>validate<br> RemoveFromâ¦â()</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_validateRemoveFrom"><code>validate<br> RemoveFromâ¦â()</code></a></p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Y</p></td> <td class="tableblock halign-left valign-top"></td> @@ -766,21 +766,21 @@ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> - <p>Directly mutable collections are not currently supported by the <a href="ugvw.html">Wicket viewer</a>.</p> + <p>Directly mutable collections are not currently supported by the <a href="../ugvw/ugvw.html">Wicket viewer</a>.</p> </div> </td> </tr> </tbody> </table> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_prefixes_validateAddTo"><code>validateAddToâ¦â()</code></a>, and <a href="#_rgcms_methods_prefixes_validate"><code>validateâ¦â()</code></a> for properties and actions.</p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_validateAddTo"><code>validateAddToâ¦â()</code></a>, and <a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_validate"><code>validateâ¦â()</code></a> for properties and actions.</p> </div> </div></td> </tr> </tbody> </table> <div class="sect3"> - <h4 id="_rgcms_methods_prefixes_addTo">2.1.1. <code>addToâ¦â()</code></h4> + <h4 id="_rgcms_methods_prefixes_addTo">2.1.1. <code>addToâ¦â()</code> (deprecated)</h4> <button type="button" class="button secondary" onclick="window.location.href="https://github.com/apache/isis/edit/master/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_prefixes_addTo.adoc"" style="float: right; font-size: small; padding: 6px; margin-top: -55px; "><i class="fa fa-pencil-square-o"></i> Edit</button> <div class="paragraph"> <p>The <code>addToâ¦â()</code> supporting method is called whenever an object is added to a collection. Its purpose is to allow additional business logic to be performed.</p> @@ -792,7 +792,7 @@ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> - <p>Directly mutable collections are not currently supported by the <a href="ugvw.html">Wicket viewer</a>. The suggested workaround is to simply define an action.</p> + <p>Directly mutable collections are not currently supported by the <a href="../ugvw/ugvw.html">Wicket viewer</a>. The suggested workaround is to simply define an action.</p> </div> </td> </tr> </tbody> @@ -830,7 +830,7 @@ </table> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_prefixes_removeFrom"><code>removeFromâ¦â()</code></a>`</p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_removeFrom"><code>removeFromâ¦â()</code></a>`</p> </div> </div> <div class="sect3"> @@ -846,7 +846,7 @@ <td class="icon"> <i class="fa icon-tip" title="Tip"></i> </td> <td class="content"> <div class="paragraph"> - <p>If the number of candidate objects is comparatively small, then use <a href="#_rgcms_methods_prefixes_choices"><code>choicesâ¦â()</code></a> supporting method instead.</p> + <p>If the number of candidate objects is comparatively small, then use <a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_choices"><code>choicesâ¦â()</code></a> supporting method instead.</p> </div> </td> </tr> </tbody> @@ -908,7 +908,7 @@ </tr> <tr> <td><i class="conum" data-value="2"></i><b>2</b></td> - <td>the <a href="rgant.html#_rgant-MinLength"><code>@MinLength</code></a> annotation specifies the minimum number of characters that must be entered before a search is performed for matching objects</td> + <td>the <a href="../rgant/rgant.html#_rgant-MinLength"><code>@MinLength</code></a> annotation specifies the minimum number of characters that must be entered before a search is performed for matching objects</td> </tr> </tbody> </table> @@ -950,7 +950,7 @@ <tbody> <tr> <td><i class="conum" data-value="1"></i><b>1</b></td> - <td>the <a href="rgant.html#_rgant-MinLength"><code>@MinLength</code></a> annotation specifies the minimum number of characters that must be entered before a search is performed for matching objects</td> + <td>the <a href="../rgant/rgant.html#_rgant-MinLength"><code>@MinLength</code></a> annotation specifies the minimum number of characters that must be entered before a search is performed for matching objects</td> </tr> </tbody> </table> @@ -961,7 +961,7 @@ <h4 id="_rgcms_methods_prefixes_choices">2.1.3. <code>choicesâ¦â()</code></h4> <button type="button" class="button secondary" onclick="window.location.href="https://github.com/apache/isis/edit/master/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_prefixes_choices.adoc"" style="float: right; font-size: small; padding: 6px; margin-top: -55px; "><i class="fa fa-pencil-square-o"></i> Edit</button> <div class="paragraph"> - <p>The <code>choicesâ¦â()</code> supporting method is called for both action parameters and for properties, to find objects from a drop-down list box. Unlike <a href="#_rgcms_methods_prefixes_autoComplete"><code>autoCompleteâ¦â()</code></a>, the use case is when the number of objects is comparatively small and can be selected from a drop-down without any additional filtering.</p> + <p>The <code>choicesâ¦â()</code> supporting method is called for both action parameters and for properties, to find objects from a drop-down list box. Unlike <a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_autoComplete"><code>autoCompleteâ¦â()</code></a>, the use case is when the number of objects is comparatively small and can be selected from a drop-down without any additional filtering.</p> </div> <div class="paragraph"> <p>The signature of the supporting method depends on whether it is for an action parameter or a property.</p> @@ -1019,7 +1019,7 @@ </div> </div> <div class="paragraph"> - <p>This functionality is actually implemented as a <a href="ugfun.html#_ugfun_how-tos_contributed-members">contributed action</a>, so the code for this is:</p> + <p>This functionality is actually implemented as a <a href="../ugfun/ugfun.html#_ugfun_how-tos_contributed-members">contributed action</a>, so the code for this is:</p> </div> <div class="listingblock"> <div class="content"> @@ -1130,11 +1130,24 @@ </div> </div> <div class="sect3"> - <h4 id="_rgcms_methods_prefixes_clear">2.1.4. <code>clearâ¦â()</code></h4> + <h4 id="_rgcms_methods_prefixes_clear">2.1.4. <code>clearâ¦â()</code> (deprecated)</h4> <button type="button" class="button secondary" onclick="window.location.href="https://github.com/apache/isis/edit/master/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_prefixes_clear.adoc"" style="float: right; font-size: small; padding: 6px; margin-top: -55px; "><i class="fa fa-pencil-square-o"></i> Edit</button> <div class="paragraph"> <p>The <code>clearâ¦â()</code> supporting method is calledâââinstead of the setterâââwhenever an (optional) property is to be set to <code>null</code>. Its purpose is to allow additional business logic to be performed.</p> </div> + <div class="admonitionblock note"> + <table> + <tbody> + <tr> + <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> + <td class="content"> + <div class="paragraph"> + <p>DataNucleus' smart handling of setters means that this supporting methods are in essence redundant, and so should be considered deprecated.</p> + </div> </td> + </tr> + </tbody> + </table> + </div> <div class="paragraph"> <p>For example:</p> </div> @@ -1168,7 +1181,7 @@ </table> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_prefixes_modify"><code>modifyâ¦â()</code></a>`</p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_modify"><code>modifyâ¦â()</code></a>`</p> </div> </div> <div class="sect3"> @@ -1178,7 +1191,7 @@ <p>The <code>defaultâ¦â()</code> supporting method is called for action parameters to return the initial argument value. This may be some sensible default (eg todayâs date, or 0 or 1), orâââfor an action that is modifying the state of an objectâââmight default to the current value of a corresponding property.</p> </div> <div class="paragraph"> - <p>The method is <em>also</em> called for properties in the case when an object is newly instantiated using <a href="rgsvc.html#_rgsvc_api_DomainObjectContainer"><code>DomainObjectContainer#newTransientInstance(â¦â)</code></a>. This is a much less common use case. If a default is not specified then properties are initialized to a default based on their type (eg 0 or <code>false</code>).</p> + <p>The method is <em>also</em> called for properties in the case when an object is newly instantiated using <a href="../rgsvc/rgsvc.html#_rgsvc_api_DomainObjectContainer"><code>DomainObjectContainer#newTransientInstance(â¦â)</code></a>. This is a much less common use case. If a default is not specified then properties are initialized to a default based on their type (eg 0 or <code>false</code>).</p> </div> <div class="paragraph"> <p>The signature of the supporting method depends on whether it is for an action parameter or a property.</p> @@ -1240,7 +1253,7 @@ </table> </div> <div class="paragraph"> - <p>Defaults are also supported (of course) for <a href="ugfun.html#_ugfun_how-tos_contributed-members">contributed actions</a>. For example, here is a contributed action for updating category/subcategory of the (non-ASF) <a href="http://github.com/isisaddons/isis-app-todoapp">Isis addons' todoapp</a>:</p> + <p>Defaults are also supported (of course) for <a href="../ugfun/ugfun.html#_ugfun_how-tos_contributed-members">contributed actions</a>. For example, here is a contributed action for updating category/subcategory of the (non-ASF) <a href="http://github.com/isisaddons/isis-app-todoapp">Isis addons' todoapp</a>:</p> </div> <div class="listingblock"> <div class="content"> @@ -1319,7 +1332,7 @@ <p>There are, in fact, two other ways to set properties of a newly instantiated object to default values.</p> </div> <div class="paragraph"> - <p>The first is to use the <a href="#_rgcms_methods_lifecycle_created"><code>created()</code></a> callback, called by the framework when <a href="rgsvc.html#_rgsvc_api_DomainObjectContainer"><code>DomainObjectContainer#newTransientInstance(â¦â)</code></a> is called. This method is called after any dependencies have been injected into the service.</p> + <p>The first is to use the <a href="../rgcms/rgcms.html#_rgcms_methods_lifecycle_created"><code>created()</code></a> callback, called by the framework when <a href="../rgsvc/rgsvc.html#_rgsvc_api_DomainObjectContainer"><code>DomainObjectContainer#newTransientInstance(â¦â)</code></a> is called. This method is called after any dependencies have been injected into the service.</p> </div> <div class="paragraph"> <p>The second is more straightforward: simply initialize properties in the constructor. However, this cannot use any injected services as they will not have been initialized.</p> @@ -1340,7 +1353,7 @@ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> - <p>Directly mutable collections are not currently supported by the <a href="ugvw.html">Wicket viewer</a>; they are always implicitly disabled.</p> + <p>Directly mutable collections are not currently supported by the <a href="../ugvw/ugvw.html">Wicket viewer</a>; they are always implicitly disabled.</p> </div> </td> </tr> </tbody> @@ -1350,7 +1363,7 @@ <p>Typically modification/invocation is vetoed based on the state of the domain object being interacted with, though it could be any reason at all (eg the current date/time of the interaction, or the state of some other related data such as stock levels, or the identity of the calling user).</p> </div> <div class="paragraph"> - <p>The reason for vetoing a modification/invocation is normally returned as a string. However, Apache Isis' <a href="ugbtb.html#_ugbtb_i18n">i18n support</a> extends this so that reasons can be internationalized.</p> + <p>The reason for vetoing a modification/invocation is normally returned as a string. However, Apache Isis' <a href="../ugbtb/ugbtb.html#_ugbtb_i18n">i18n support</a> extends this so that reasons can be internationalized.</p> </div> <div class="paragraph"> <p>The signature of the supporting method is simply:</p> @@ -1426,7 +1439,7 @@ <p>In the case of actions, the framework will also search for supporting method that has the exact same parameter types as the action itself. Enabling <code>isis.reflector.validator.noParamsOnly</code> configuration property switches this off, so that the framework will only search for supporting method with no parameters.</p> </div> <div class="paragraph"> - <p>Note that enabling this configuration property in effect means that <a href="#_rgcms_classes_mixins">mixins</a> must be used instead of <a href="ugbtb.html#_ugbtb_decoupling_contributions">contributed services</a> (because contributed actions are the one case where the value of a parameter to a supporting method may be non-null).</p> + <p>Note that enabling this configuration property in effect means that <a href="../ugfun/ugfun.html#_ugfun_building-blocks_types-of-domain-objects_mixins">mixins</a> must be used instead of <a href="../ugfun/ugfun.html#_ugfun_programming-model_domain-services_contributions">contributed services</a> (because contributed actions are the one case where the value of a parameter to a supporting method may be non-null).</p> </div> </td> </tr> </tbody> @@ -1449,7 +1462,7 @@ <p>Any methods "left over" that <em>do</em> use one of the Apache Isis prefixes, are interpreted to be orphaned. Apache Isis "fails-fast" and will not boot, instead printing an error message to the log so that the issue can be easily diagnosed.</p> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_prefixes_set"><code>setâ¦â()</code></a>.</p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_set"><code>setâ¦â()</code></a>.</p> </div> </div> <div class="sect3"> @@ -1459,7 +1472,7 @@ <p>The <code>hideâ¦â()</code> supporting method is called for properties, collections and actions. It allows the property/collection to be completely hidden from view.</p> </div> <div class="paragraph"> - <p>Itâs comparatively rare for properties or collections to be imperatively hidden from view, but actions are sometimes hidden or shown visible (as opposed to being just <a href="#_rgcms_methods_prefixes_disable">disabled</a>, ie greyed out).</p> + <p>Itâs comparatively rare for properties or collections to be imperatively hidden from view, but actions are sometimes hidden or shown visible (as opposed to being just <a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_disable">disabled</a>, ie greyed out).</p> </div> <div class="paragraph"> <p>The signature of the supporting method is simply:</p> @@ -1520,7 +1533,7 @@ <p>In the case of actions, the framework will also search for supporting method that has the exact same parameter types as the action itself. Enabling <code>isis.reflector.validator.noParamsOnly</code> configuration property switches this off, so that the framework will only search for supporting method with no parameters.</p> </div> <div class="paragraph"> - <p>Note that enabling this configuration property in effect means that <a href="#_rgcms_classes_mixins">mixins</a> must be used instead of <a href="ugbtb.html#_ugbtb_decoupling_contributions">contributed services</a> (because contributed actions are the one case where the value of a parameter to a supporting method may be non-null).</p> + <p>Note that enabling this configuration property in effect means that <a href="../ugfun/ugfun.html#_ugfun_building-blocks_types-of-domain-objects_mixins">mixins</a> must be used instead of <a href="../ugfun/ugfun.html#_ugfun_programming-model_domain-services_contributions">contributed services</a> (because contributed actions are the one case where the value of a parameter to a supporting method may be non-null).</p> </div> </td> </tr> </tbody> @@ -1528,11 +1541,24 @@ </div> </div> <div class="sect3"> - <h4 id="_rgcms_methods_prefixes_modify">2.1.9. <code>modifyâ¦â()</code></h4> + <h4 id="_rgcms_methods_prefixes_modify">2.1.9. <code>modifyâ¦â()</code> (deprecated)</h4> <button type="button" class="button secondary" onclick="window.location.href="https://github.com/apache/isis/edit/master/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_prefixes_modify.adoc"" style="float: right; font-size: small; padding: 6px; margin-top: -55px; "><i class="fa fa-pencil-square-o"></i> Edit</button> <div class="paragraph"> <p>The <code>modifyâ¦â()</code> supporting method is calledâââinstead of the setterâââwhenever a property has been set to be set to a new value. Its purpose is to allow additional business logic to be performed.</p> </div> + <div class="admonitionblock note"> + <table> + <tbody> + <tr> + <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> + <td class="content"> + <div class="paragraph"> + <p>DataNucleus' smart handling of setters means that this supporting methods are in essence redundant, and so should be considered deprecated.</p> + </div> </td> + </tr> + </tbody> + </table> + </div> <div class="paragraph"> <p>For example:</p> </div> @@ -1572,11 +1598,11 @@ </table> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_prefixes_clear"><code>clearâ¦â()</code></a>`</p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_clear"><code>clearâ¦â()</code></a>`</p> </div> </div> <div class="sect3"> - <h4 id="_rgcms_methods_prefixes_removeFrom">2.1.10. <code>removeFromâ¦â()</code></h4> + <h4 id="_rgcms_methods_prefixes_removeFrom">2.1.10. <code>removeFromâ¦â()</code> (deprecated)</h4> <button type="button" class="button secondary" onclick="window.location.href="https://github.com/apache/isis/edit/master/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_prefixes_removeFrom.adoc"" style="float: right; font-size: small; padding: 6px; margin-top: -55px; "><i class="fa fa-pencil-square-o"></i> Edit</button> <div class="paragraph"> <p>The <code>removeFromâ¦â()</code> supporting method is called whenever an object is removed from a collection. Its purpose is to allow additional business logic to be performed.</p> @@ -1588,7 +1614,7 @@ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> - <p>Directly mutable collections are not currently supported by the <a href="ugvw.html">Wicket viewer</a>. The suggested workaround is to simply define an action.</p> + <p>Directly mutable collections are not currently supported by the <a href="../ugvw/ugvw.html">Wicket viewer</a>. The suggested workaround is to simply define an action.</p> </div> </td> </tr> </tbody> @@ -1626,7 +1652,7 @@ </table> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_prefixes_addTo"><code>addToâ¦â()</code></a>`</p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_addTo"><code>addToâ¦â()</code></a>`</p> </div> </div> <div class="sect3"> @@ -1636,7 +1662,7 @@ <p>The <code>setâ¦â()</code> prefix is simply the normal JavaBean setter prefix that denotes writeable properties or collections.</p> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_prefixes_get"><code>getâ¦â()</code></a>.</p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_get"><code>getâ¦â()</code></a>.</p> </div> </div> <div class="sect3"> @@ -1646,7 +1672,7 @@ <p>The <code>validateâ¦â()</code> supporting method is called for properties, actions and action parameters. It allows the proposed new value for a property to be rejected, or the proposed argument of an action parameter to be rejected, or to reject a whole set of action arguments for an actio invocation.</p> </div> <div class="paragraph"> - <p>The reason for vetoing a modification/invocation is normally returned as a string. However, Apache Isis' <a href="ugbtb.html#_ugbtb_i18n">i18n support</a> extends this so that reasons can be internationalized if required.</p> + <p>The reason for vetoing a modification/invocation is normally returned as a string. However, Apache Isis' <a href="../ugbtb/ugbtb.html#_ugbtb_i18n">i18n support</a> extends this so that reasons can be internationalized if required.</p> </div> <div class="sect4"> <h5 id="_action_parameter">Action Parameter</h5> @@ -1781,7 +1807,7 @@ </div> </div> <div class="sect3"> - <h4 id="_rgcms_methods_prefixes_validateAddTo">2.1.13. <code>validateAddToâ¦â()</code></h4> + <h4 id="_rgcms_methods_prefixes_validateAddTo">2.1.13. <code>validateAddToâ¦â()</code> (deprecated)</h4> <button type="button" class="button secondary" onclick="window.location.href="https://github.com/apache/isis/edit/master/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_prefixes_validateAddTo.adoc"" style="float: right; font-size: small; padding: 6px; margin-top: -55px; "><i class="fa fa-pencil-square-o"></i> Edit</button> <div class="paragraph"> <p>The <code>validateAddToâ¦â()</code> supporting method is called whenever an object is to be added to a collection. Its purpose is to validate the proposed object and possibly veto the change.</p> @@ -1793,7 +1819,7 @@ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> - <p>Directly mutable collections are not currently supported by the <a href="ugvw.html">Wicket viewer</a>. The suggested workaround is to simply define an action.</p> + <p>Directly mutable collections are not currently supported by the <a href="../ugvw/ugvw.html">Wicket viewer</a>. The suggested workaround is to simply define an action.</p> </div> </td> </tr> </tbody> @@ -1808,7 +1834,7 @@ </div> </div> <div class="paragraph"> - <p>where the returned string is the reason the collection modification invocation is vetoed (or <code>null</code> if not vetoed). Apache Isis' <a href="ugbtb.html#_ugbtb_i18n">i18n support</a> extends this so that reasons can be internationalized if required.</p> + <p>where the returned string is the reason the collection modification invocation is vetoed (or <code>null</code> if not vetoed). Apache Isis' <a href="../ugbtb/ugbtb.html#_ugbtb_i18n">i18n support</a> extends this so that reasons can be internationalized if required.</p> </div> <div class="paragraph"> <p>For example:</p> @@ -1827,11 +1853,11 @@ </div> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_prefixes_addTo"><code>addToâ¦â()</code></a> and <a href="#_rgcms_methods_prefixes_validateRemoveFrom"><code>validateRemoveFromâ¦â()</code></a>`</p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_addTo"><code>addToâ¦â()</code></a> and <a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_validateRemoveFrom"><code>validateRemoveFromâ¦â()</code></a>`</p> </div> </div> <div class="sect3"> - <h4 id="_rgcms_methods_prefixes_validateRemoveFrom">2.1.14. <code>validateRemoveFromâ¦â()</code></h4> + <h4 id="_rgcms_methods_prefixes_validateRemoveFrom">2.1.14. <code>validateRemoveFromâ¦â()</code> (deprecated)</h4> <button type="button" class="button secondary" onclick="window.location.href="https://github.com/apache/isis/edit/master/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_prefixes_validateRemoveFrom.adoc"" style="float: right; font-size: small; padding: 6px; margin-top: -55px; "><i class="fa fa-pencil-square-o"></i> Edit</button> <div class="paragraph"> <p>The <code>validateRemoveFromâ¦â()</code> supporting method is called whenever an object is to be removed from a collection. Its purpose is to validate the proposed object removal and possibly veto the change.</p> @@ -1843,7 +1869,7 @@ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> - <p>Directly mutable collections are not currently supported by the <a href="ugvw.html">Wicket viewer</a>. The suggested workaround is to simply define an action.</p> + <p>Directly mutable collections are not currently supported by the <a href="../ugvw/ugvw.html">Wicket viewer</a>. The suggested workaround is to simply define an action.</p> </div> </td> </tr> </tbody> @@ -1858,7 +1884,7 @@ </div> </div> <div class="paragraph"> - <p>where the returned string is the reason the collection modification invocation is vetoed (or <code>null</code> if not vetoed). Apache Isis' <a href="ugbtb.html#_ugbtb_i18n">i18n support</a> extends this so that reasons can be internationalized if required.</p> + <p>where the returned string is the reason the collection modification invocation is vetoed (or <code>null</code> if not vetoed). Apache Isis' <a href="../ugbtb/ugbtb.html#_ugbtb_i18n">i18n support</a> extends this so that reasons can be internationalized if required.</p> </div> <div class="paragraph"> <p>For example:</p> @@ -1877,7 +1903,7 @@ </div> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_prefixes_removeFrom"><code>removeFromâ¦â()</code></a> and <a href="#_rgcms_methods_prefixes_validateAddTo"><code>validateAddToâ¦â()</code></a>`</p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_removeFrom"><code>removeFromâ¦â()</code></a> and <a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_validateAddTo"><code>validateAddToâ¦â()</code></a>`</p> </div> </div> </div> @@ -1903,19 +1929,19 @@ </thead> <tbody> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_reserved_cssClass"><code>cssClass()</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_reserved_cssClass"><code>cssClass()</code></a></p></td> <td class="tableblock halign-left valign-top"> <div> <div class="paragraph"> - <p>Provides a CSS class for this object instance. In conjunction with <a href="rgcfg.html#_rgcfg_application-specific_application-css"><code>application.css</code></a>, can therefore provide custom styling of an object instance wherever it is rendered.<br></p> + <p>Provides a CSS class for this object instance. In conjunction with <a href="../rgcfg/rgcfg.html#_rgcfg_application-specific_application-css"><code>application.css</code></a>, can therefore provide custom styling of an object instance wherever it is rendered.<br></p> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_reserved_title"><code>title()</code></a> and <a href="#_rgcms_methods_reserved_iconName"><code>iconName()</code></a>.</p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_reserved_title"><code>title()</code></a> and <a href="../rgcms/rgcms.html#_rgcms_methods_reserved_iconName"><code>iconName()</code></a>.</p> </div> </div></td> </tr> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_reserved_disable"><code>disable(â¦â)</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_reserved_disable"><code>disable(â¦â)</code></a></p></td> <td class="tableblock halign-left valign-top"> <div> <div class="paragraph"> @@ -1924,7 +1950,7 @@ </div></td> </tr> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_reserved_getId"><code>getId()</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_reserved_getId"><code>getId()</code></a></p></td> <td class="tableblock halign-left valign-top"> <div> <div class="paragraph"> @@ -1936,7 +1962,7 @@ </div></td> </tr> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_reserved_hide"><code>hide(â¦â)</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_reserved_hide"><code>hide(â¦â)</code></a></p></td> <td class="tableblock halign-left valign-top"> <div> <div class="paragraph"> @@ -1945,31 +1971,31 @@ </div></td> </tr> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_reserved_iconName"><code>iconName()</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_reserved_iconName"><code>iconName()</code></a></p></td> <td class="tableblock halign-left valign-top"> <div> <div class="paragraph"> <p>Provides the name of the image to render, usually alongside the title, to represent the object. If not provided, then the class name is used to locate an image.<br></p> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_reserved_title"><code>title()</code></a> and <a href="#_rgcms_methods_reserved_cssClass"><code>cssClass()</code></a></p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_reserved_title"><code>title()</code></a> and <a href="../rgcms/rgcms.html#_rgcms_methods_reserved_cssClass"><code>cssClass()</code></a></p> </div> </div></td> </tr> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_reserved_title"><code>title()</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_reserved_title"><code>title()</code></a></p></td> <td class="tableblock halign-left valign-top"> <div> <div class="paragraph"> <p>Provides a title for the object.<br></p> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_reserved_iconName"><code>iconName()</code></a> and <a href="#_rgcms_methods_reserved_cssClass"><code>cssClass()</code></a></p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_reserved_iconName"><code>iconName()</code></a> and <a href="../rgcms/rgcms.html#_rgcms_methods_reserved_cssClass"><code>cssClass()</code></a></p> </div> </div></td> </tr> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_reserved_validate"><code>validate()</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_reserved_validate"><code>validate()</code></a></p></td> <td class="tableblock halign-left valign-top"> <div> <div class="paragraph"> @@ -1986,10 +2012,10 @@ <p>The <code>cssClass()</code> returns a CSS class for a particular object instance.</p> </div> <div class="paragraph"> - <p>The <a href="ugvw.html">Wicket viewer</a> wraps the objectâs representation in a containing <code><div></code> with the class added. This is done both for rendering the object either in a table or when rendering the object on its own page.</p> + <p>The <a href="../ugvw/ugvw.html">Wicket viewer</a> wraps the objectâs representation in a containing <code><div></code> with the class added. This is done both for rendering the object either in a table or when rendering the object on its own page.</p> </div> <div class="paragraph"> - <p>In conjunction with <a href="rgcfg.html#_rgcfg_application-specific_application-css"><code>application.css</code></a>, can therefore provide custom styling of an object instance wherever it is rendered.<br></p> + <p>In conjunction with <a href="../rgcfg/rgcfg.html#_rgcfg_application-specific_application-css"><code>application.css</code></a>, can therefore provide custom styling of an object instance wherever it is rendered.<br></p> </div> <div class="paragraph"> <p>For example, the (non-ASF) <a href="http://github.com/isisaddons/isis-app-todoapp">Isis addons' todoapp</a> uses this technique to add a strikethrough for completed todo items. This is shown on the home page:</p> @@ -2013,7 +2039,7 @@ </div> </div> <div class="paragraph"> - <p>In the <a href="rgcfg.html#_rgcfg_application-specific_application-css">application.css</a>, the following styles were then added:</p> + <p>In the <a href="../rgcfg/rgcfg.html#_rgcfg_application-specific_application-css">application.css</a>, the following styles were then added:</p> </div> <div class="listingblock"> <div class="content"> @@ -2026,7 +2052,7 @@ </div> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_reserved_title"><code>title()</code></a> and <a href="#_rgcms_methods_reserved_iconName"><code>iconName()</code></a>.</p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_reserved_title"><code>title()</code></a> and <a href="../rgcms/rgcms.html#_rgcms_methods_reserved_iconName"><code>iconName()</code></a>.</p> </div> </div> <div class="sect3"> @@ -2036,7 +2062,7 @@ <p>One use case that Apache Isis supports is that of a domain object with a lifecycle whereby at some stage it should become immutable: all its properties/collections should be disabled, and/or its actions become not invokable.</p> </div> <div class="paragraph"> - <p>It would be painful to have to write a separate <a href="#_rgcms_methods_prefixes_disable"><code>disableâ¦â()</code></a> method for each and every member, so instead Isis allows a single <code>disableâ¦â(â¦â)</code> method to be implemented that is applied to all members.</p> + <p>It would be painful to have to write a separate <a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_disable"><code>disableâ¦â()</code></a> method for each and every member, so instead Isis allows a single <code>disableâ¦â(â¦â)</code> method to be implemented that is applied to all members.</p> </div> <div class="paragraph"> <p>The signature of the method is:</p> @@ -2050,7 +2076,7 @@ <p>where <code>Identifier.Type</code> is part of the Isis applib (nested static class of <code>o.a.i.applib.Identifier</code>) to distinguish between an interaction with an action, a property or an action.</p> </div> <div class="paragraph"> - <p>Note that Apache Isis' <a href="ugbtb.html#_ugbtb_i18n">i18n support</a> extends this so that the returned reason can also be internationalized.</p> + <p>Note that Apache Isis' <a href="../ugbtb/ugbtb.html#_ugbtb_i18n">i18n support</a> extends this so that the returned reason can also be internationalized.</p> </div> <div class="paragraph"> <p>For example:</p> @@ -2065,7 +2091,7 @@ </div> </div> <div class="paragraph"> - <p>See also the similar methods to <a href="#_rgcms_methods_reserved_hide"><code>hide()</code></a> object members en-masse.</p> + <p>See also the similar methods to <a href="../rgcms/rgcms.html#_rgcms_methods_reserved_hide"><code>hide()</code></a> object members en-masse.</p> </div> <div class="sect4"> <h5 id="_alternatives_2">Alternatives</h5> @@ -2152,10 +2178,10 @@ </div> <div class="ulist"> <ul> - <li> <p>as the value of <code>Bookmark#getObjectType()</code> and in the <code>toString()</code> value of <code>Bookmark</code> (see <a href="rgsvc.html#_rgsvc_api_BookmarkService"><code>BookmarkService</code></a>)</p> </li> - <li> <p>in the serialization of <code>OidDto</code> in the <a href="#_rgcms_schema-cmd">command</a> and <a href="#_rgcms_schema-ixn">interaction</a> schemas</p> </li> - <li> <p>in the URLs of the <a href="ugvro.html">RestfulObjects viewer</a></p> </li> - <li> <p>in the URLs of the <a href="ugvw.html">Wicket viewer</a> (specifically, for bookmarked actions)</p> </li> + <li> <p>as the value of <code>Bookmark#getObjectType()</code> and in the <code>toString()</code> value of <code>Bookmark</code> (see <a href="../rgsvc/rgsvc.html#_rgsvc_api_BookmarkService"><code>BookmarkService</code></a>)</p> </li> + <li> <p>in the serialization of <code>OidDto</code> in the <a href="../rgcms/rgcms.html#_rgcms_schema-cmd">command</a> and <a href="../rgcms/rgcms.html#_rgcms_schema-ixn">interaction</a> schemas</p> </li> + <li> <p>in the URLs of the <a href="../ugvro/ugvro.html">RestfulObjects viewer</a></p> </li> + <li> <p>in the URLs of the <a href="../ugvw/ugvw.html">Wicket viewer</a> (specifically, for bookmarked actions)</p> </li> </ul> </div> <div class="sect4"> @@ -2180,8 +2206,8 @@ </div> <div class="olist arabic"> <ol class="arabic"> - <li> <p><a href="rgant.html#_rgant_DomainService_objectType"><code>@DomainService#objectType()</code></a></p> </li> - <li> <p><a href="#_rgcms_methods_reserved_getId"><code>getId()</code></a></p> </li> + <li> <p><a href="../rgant/rgant.html#_rgant_DomainService_objectType"><code>@DomainService#objectType()</code></a></p> </li> + <li> <p><a href="../rgcms/rgcms.html#_rgcms_methods_reserved_getId"><code>getId()</code></a></p> </li> <li> <p>The fully qualified class name.</p> </li> </ol> </div> @@ -2195,7 +2221,7 @@ <p>This might be obvious, but to make explicit: we recommend that you always specify an object type for your domain services.</p> </div> <div class="paragraph"> - <p>Otherwise, if you refactor your code (change class name or move package), then any externally held references to the OID of the service will break. At best this will require a data migration in the database; at worst it could cause external clients accessing data through the <a href="ugvro.html">Restful Objects</a> viewer to break.</p> + <p>Otherwise, if you refactor your code (change class name or move package), then any externally held references to the OID of the service will break. At best this will require a data migration in the database; at worst it could cause external clients accessing data through the <a href="../ugvro/ugvro.html">Restful Objects</a> viewer to break.</p> </div> </td> </tr> </tbody> @@ -2223,7 +2249,7 @@ <p>One use case that Apache Isis supports is that of a domain object with a lifecycle whereby at some stage some number of the objectâs members should be hidden. For example, for an object that at some stage is logically immutable, we might want to make all its properties/collections unmodifiable and hide all its actions.</p> </div> <div class="paragraph"> - <p>While we could write a separate <a href="#_rgcms_methods_prefixes_hide"><code>hideâ¦â()</code></a> method for each and every action, this could become painful. So instead Isis allows a single <code>hideâ¦â(â¦â)</code> method to be implemented that is applied to all members.</p> + <p>While we could write a separate <a href="../rgcms/rgcms.html#_rgcms_methods_prefixes_hide"><code>hideâ¦â()</code></a> method for each and every action, this could become painful. So instead Isis allows a single <code>hideâ¦â(â¦â)</code> method to be implemented that is applied to all members.</p> </div> <div class="paragraph"> <p>The signature of the method is:</p> @@ -2247,7 +2273,7 @@ </div> </div> <div class="paragraph"> - <p>See also the similar method to <a href="#_rgcms_methods_reserved_disable"><code>disable()</code></a> object members en-masse.</p> + <p>See also the similar method to <a href="../rgcms/rgcms.html#_rgcms_methods_reserved_disable"><code>disable()</code></a> object members en-masse.</p> </div> <div class="sect4"> <h5 id="_alternatives_3">Alternatives</h5> @@ -2255,7 +2281,7 @@ <p>An alternative designâââand one that could be easily argued is actually more flexibleâââis to leverage domain events with vetoing subscribers.</p> </div> <div class="paragraph"> - <p>There is further discussion on this approach in <a href="#_rgcms_methods_reserved_disable">here</a>.</p> + <p>There is further discussion on this approach in <a href="../rgcms/rgcms.html#_rgcms_methods_reserved_disable">here</a>.</p> </div> </div> </div> @@ -2263,7 +2289,7 @@ <h4 id="_rgcms_methods_reserved_iconName">2.2.5. <code>iconName()</code></h4> <button type="button" class="button secondary" onclick="window.location.href="https://github.com/apache/isis/edit/master/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_iconName.adoc"" style="float: right; font-size: small; padding: 6px; margin-top: -55px; "><i class="fa fa-pencil-square-o"></i> Edit</button> <div class="paragraph"> - <p>Every object is represented by an icon; this is based on the domain objectâs simple name. The <a href="ugvw.html">Wicket viewer</a> searches for the image in the same package as the <code>.class</code> file for the domain object or in the <code>images</code> package. It will find any matching name and one of the followign suffexes <code>png</code>, <code>gif</code>, <code>jpeg</code>, <code>jpg</code>, <code>svg</code>. If none is found, then <code>Default.png</code> will be used as fallback.</p> + <p>Every object is represented by an icon; this is based on the domain objectâs simple name. The <a href="../ugvw/ugvw.html">Wicket viewer</a> searches for the image in the same package as the <code>.class</code> file for the domain object or in the <code>images</code> package. It will find any matching name and one of the followign suffexes <code>png</code>, <code>gif</code>, <code>jpeg</code>, <code>jpg</code>, <code>svg</code>. If none is found, then <code>Default.png</code> will be used as fallback.</p> </div> <div class="paragraph"> <p>The <code>iconName()</code> allows the icon that to be used to change for individual object instances. These are usually quite subtle, for example to reflect the particular status of an object. The value returned by the <code>iconName()</code> method is added as a suffix to the base icon name.</p> @@ -2298,7 +2324,7 @@ </div> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_reserved_title"><code>title()</code></a> and <a href="#_rgcms_methods_reserved_cssClass"><code>cssClass()</code></a></p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_reserved_title"><code>title()</code></a> and <a href="../rgcms/rgcms.html#_rgcms_methods_reserved_cssClass"><code>cssClass()</code></a></p> </div> </div> <div class="sect3"> @@ -2319,7 +2345,7 @@ </div> </div> <div class="paragraph"> - <p>Note that Apache Isis' <a href="ugbtb.html#_ugbtb_i18n">i18n support</a> extends this so that titles can also be internationalized.</p> + <p>Note that Apache Isis' <a href="../ugbtb/ugbtb.html#_ugbtb_i18n">i18n support</a> extends this so that titles can also be internationalized.</p> </div> <div class="paragraph"> <p>For example, the (non-ASF) <a href="http://github.com/isisaddons/isis-app-todoapp">Isis addons' todoapp</a> uses this technique to add an overlay for todo items that have been completed:</p> @@ -2349,7 +2375,7 @@ <tbody> <tr> <td><i class="conum" data-value="1"></i><b>1</b></td> - <td>simple <a href="#_rgcms_classes_utility_TitleBuffer">tility class</a> to help construct the title string</td> + <td>simple <a href="../rgcms/rgcms.html#_rgcms_classes_utility_TitleBuffer">tility class</a> to help construct the title string</td> </tr> <tr> <td><i class="conum" data-value="2"></i><b>2</b></td> @@ -2357,7 +2383,7 @@ </tr> <tr> <td><i class="conum" data-value="3"></i><b>3</b></td> - <td>using the <a href="rgsvc.html#_rgsvc_api_WrapperFactory"><code>WrapperFactory</code></a> to determine if the <code>dueBy</code> field is visible for this user â¦â</td> + <td>using the <a href="../rgsvc/rgsvc.html#_rgsvc_api_WrapperFactory"><code>WrapperFactory</code></a> to determine if the <code>dueBy</code> field is visible for this user â¦â</td> </tr> <tr> <td><i class="conum" data-value="4"></i><b>4</b></td> @@ -2370,10 +2396,10 @@ <p>As the example above shows, the implementation can be as complex as you like.</p> </div> <div class="paragraph"> - <p>In many cases, though, you may be able to use the <a href="rgant.html#_rgant-Title"><code>@Title</code></a> annotation.</p> + <p>In many cases, though, you may be able to use the <a href="../rgant/rgant.html#_rgant-Title"><code>@Title</code></a> annotation.</p> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_reserved_iconName"><code>iconName()</code></a> and <a href="#_rgcms_methods_reserved_cssClass"><code>cssClass()</code></a></p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_reserved_iconName"><code>iconName()</code></a> and <a href="../rgcms/rgcms.html#_rgcms_methods_reserved_cssClass"><code>cssClass()</code></a></p> </div> </div> <div class="sect3"> @@ -2407,7 +2433,7 @@ <p>where the returned string is the reason that the invocation is vetoed.</p> </div> <div class="paragraph"> - <p>Note that Apache Isis' <a href="ugbtb.html#_ugbtb_i18n">i18n support</a> extends this so that the returned reason can also be internationalized.</p> + <p>Note that Apache Isis' <a href="../ugbtb/ugbtb.html#_ugbtb_i18n">i18n support</a> extends this so that the returned reason can also be internationalized.</p> </div> </div> </div> @@ -2428,8 +2454,8 @@ </div> <div class="ulist"> <ul> - <li> <p>in Isis 1.9.0 and earlier, you may therefore want to consider using the JDO API directly to set up a lifecycle listener; see <a href="#_rgcms_methods_lifecycle_jdo-api">here</a> for further discussion.</p> </li> - <li> <p>alternatively, you can use a subscriber for the <a href="#_rgcms_classes_lifecycleevent">lifecycle event</a>s fired in Isis.</p> </li> + <li> <p>in Isis 1.9.0 and earlier, you may therefore want to consider using the JDO API directly to set up a lifecycle listener; see <a href="../rgcms/rgcms.html#_rgcms_methods_lifecycle_jdo-api">here</a> for further discussion.</p> </li> + <li> <p>alternatively, you can use a subscriber for the <a href="../rgcms/rgcms.html#_rgcms_classes_lifecycleevent">lifecycle event</a>s fired in Isis.</p> </li> </ul> </div> </td> </tr> @@ -2455,16 +2481,16 @@ </thead> <tbody> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_lifecycle_created"><code>created()</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_lifecycle_created"><code>created()</code></a></p></td> <td class="tableblock halign-left valign-top"> <div> <div class="paragraph"> - <p>called when an object has just been created using <a href="rgsvc.html#_rgsvc_api_DomainObjectContainer"><code>newTransientInstance()</code></a></p> + <p>called when an object has just been created using <a href="../rgsvc/rgsvc.html#_rgsvc_api_DomainObjectContainer"><code>newTransientInstance()</code></a></p> </div> </div></td> </tr> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_lifecycle_loaded"><code>loaded()</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_lifecycle_loaded"><code>loaded()</code></a></p></td> <td class="tableblock halign-left valign-top"> <div> <div class="paragraph"> @@ -2473,7 +2499,7 @@ </div></td> </tr> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_lifecycle_persisted"><code>persisted()</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_lifecycle_persisted"><code>persisted()</code></a></p></td> <td class="tableblock halign-left valign-top"> <div> <div class="paragraph"> @@ -2482,7 +2508,7 @@ </div></td> </tr> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_lifecycle_persisting"><code>persisting()</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_lifecycle_persisting"><code>persisting()</code></a></p></td> <td class="tableblock halign-left valign-top"> <div> <div class="paragraph"> @@ -2491,7 +2517,7 @@ </div></td> </tr> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_lifecycle_removed"><code>removed()</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_lifecycle_removed"><code>removed()</code></a></p></td> <td class="tableblock halign-left valign-top"> <div> <div class="paragraph"> @@ -2500,7 +2526,7 @@ </div></td> </tr> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_lifecycle_removing"><code>removing()</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_lifecycle_removing"><code>removing()</code></a></p></td> <td class="tableblock halign-left valign-top"> <div> <div class="paragraph"> @@ -2509,7 +2535,7 @@ </div></td> </tr> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_lifecycle_updated"><code>updated()</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_lifecycle_updated"><code>updated()</code></a></p></td> <td class="tableblock halign-left valign-top"> <div> <div class="paragraph"> @@ -2518,7 +2544,7 @@ </div></td> </tr> <tr> - <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgcms_methods_lifecycle_updating"><code>updating()</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgcms/rgcms.html#_rgcms_methods_lifecycle_updating"><code>updating()</code></a></p></td> <td class="tableblock halign-left valign-top"> <div> <div class="paragraph"> @@ -2551,7 +2577,7 @@ <td class="tableblock halign-left valign-top"> <div> <div class="paragraph"> - <p>Replaced by <a href="#_rgcms_methods_lifecycle_removed"><code>removed()</code></a></p> + <p>Replaced by <a href="../rgcms/rgcms.html#_rgcms_methods_lifecycle_removed"><code>removed()</code></a></p> </div> </div></td> </tr> @@ -2560,7 +2586,7 @@ <td class="tableblock halign-left valign-top"> <div> <div class="paragraph"> - <p>Replaced by <a href="#_rgcms_methods_lifecycle_removing"><code>removing()</code></a></p> + <p>Replaced by <a href="../rgcms/rgcms.html#_rgcms_methods_lifecycle_removing"><code>removing()</code></a></p> </div> </div></td> </tr> @@ -2591,7 +2617,7 @@ <td class="tableblock halign-left valign-top"> <div> <div class="paragraph"> - <p>Replaced by <a href="#_rgcms_methods_lifecycle_persisted"><code>persisted()</code></a></p> + <p>Replaced by <a href="../rgcms/rgcms.html#_rgcms_methods_lifecycle_persisted"><code>persisted()</code></a></p> </div> </div></td> </tr> @@ -2600,7 +2626,7 @@ <td class="tableblock halign-left valign-top"> <div> <div class="paragraph"> - <p>Replaced by <a href="#_rgcms_methods_lifecycle_persisting"><code>persisting()</code></a></p> + <p>Replaced by <a href="../rgcms/rgcms.html#_rgcms_methods_lifecycle_persisting"><code>persisting()</code></a></p> </div> </div></td> </tr> @@ -2609,7 +2635,7 @@ <div class="sect3"> <h4 id="_rgcms_methods_reserved_created">2.3.1. <code>created()</code></h4> <div class="paragraph"> - <p>The <code>created()</code> lifecycle callback method is called when an object has just been created using <a href="rgsvc.html#_rgsvc_api_DomainObjectContainer"><code>newTransientInstance()</code></a></p> + <p>The <code>created()</code> lifecycle callback method is called when an object has just been created using <a href="../rgsvc/rgsvc.html#_rgsvc_api_DomainObjectContainer"><code>newTransientInstance()</code></a></p> </div> <div class="admonitionblock tip"> <table> @@ -2618,7 +2644,7 @@ <td class="icon"> <i class="fa icon-tip" title="Tip"></i> </td> <td class="content"> <div class="paragraph"> - <p>Alternatively, consider using a <a href="rgsvc.html#_rgsvc_api_EventBusService">event bus</a> <a href="#_rgcms_classes_super_AbstractSubscriber">subscriber</a> on the <a href="#_rgcms_classes_lifecycleevent_ObjectCreatedEvent"><code>ObjectCreatedEvent</code></a>.</p> + <p>Alternatively, consider using a <a href="../rgsvc/rgsvc.html#_rgsvc_api_EventBusService">event bus</a> <a href="../rgcms/rgcms.html#_rgcms_classes_super_AbstractSubscriber">subscriber</a> on the <a href="../rgcms/rgcms.html#_rgcms_classes_lifecycleevent_ObjectCreatedEvent"><code>ObjectCreatedEvent</code></a>.</p> </div> </td> </tr> </tbody> @@ -2637,7 +2663,7 @@ <td class="icon"> <i class="fa icon-tip" title="Tip"></i> </td> <td class="content"> <div class="paragraph"> - <p>Alternatively, consider using a <a href="rgsvc.html#_rgsvc_api_EventBusService">event bus</a> <a href="#_rgcms_classes_super_AbstractSubscriber">subscriber</a> on the <a href="#_rgcms_classes_lifecycleevent_ObjectLoadedEvent"><code>ObjectLoadedEvent</code></a>.</p> + <p>Alternatively, consider using a <a href="../rgsvc/rgsvc.html#_rgsvc_api_EventBusService">event bus</a> <a href="../rgcms/rgcms.html#_rgcms_classes_super_AbstractSubscriber">subscriber</a> on the <a href="../rgcms/rgcms.html#_rgcms_classes_lifecycleevent_ObjectLoadedEvent"><code>ObjectLoadedEvent</code></a>.</p> </div> </td> </tr> </tbody> @@ -2650,7 +2676,7 @@ <p>The <code>persisted()</code> lifecycle callback method is called when object has just been persisted from the object store.</p> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_lifecycle_persisting"><code>persisting()</code></a>.</p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_lifecycle_persisting"><code>persisting()</code></a>.</p> </div> <div class="admonitionblock tip"> <table> @@ -2659,7 +2685,7 @@ <td class="icon"> <i class="fa icon-tip" title="Tip"></i> </td> <td class="content"> <div class="paragraph"> - <p>Alternatively, consider using a <a href="rgsvc.html#_rgsvc_api_EventBusService">event bus</a> <a href="#_rgcms_classes_super_AbstractSubscriber">subscriber</a> on the <a href="#_rgcms_classes_lifecycleevent_ObjectPersistedEvent"><code>ObjectPersistedEvent</code></a>.</p> + <p>Alternatively, consider using a <a href="../rgsvc/rgsvc.html#_rgsvc_api_EventBusService">event bus</a> <a href="../rgcms/rgcms.html#_rgcms_classes_super_AbstractSubscriber">subscriber</a> on the <a href="../rgcms/rgcms.html#_rgcms_classes_lifecycleevent_ObjectPersistedEvent"><code>ObjectPersistedEvent</code></a>.</p> </div> </td> </tr> </tbody> @@ -2672,7 +2698,7 @@ <p>The <code>persisting()</code> lifecycle callback method is called when a (not-yet-persistent) object is just about to be persisted from the object store</p> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_lifecycle_persisted"><code>persisted()</code></a>.</p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_lifecycle_persisted"><code>persisted()</code></a>.</p> </div> <div class="admonitionblock tip"> <table> @@ -2681,7 +2707,7 @@ <td class="icon"> <i class="fa icon-tip" title="Tip"></i> </td> <td class="content"> <div class="paragraph"> - <p>Alternatively, consider using a <a href="rgsvc.html#_rgsvc_api_EventBusService">event bus</a> <a href="#_rgcms_classes_super_AbstractSubscriber">subscriber</a> on the <a href="#_rgcms_classes_lifecycleevent_ObjectPersistingEvent"><code>ObjectPersistingEvent</code></a>.</p> + <p>Alternatively, consider using a <a href="../rgsvc/rgsvc.html#_rgsvc_api_EventBusService">event bus</a> <a href="../rgcms/rgcms.html#_rgcms_classes_super_AbstractSubscriber">subscriber</a> on the <a href="../rgcms/rgcms.html#_rgcms_classes_lifecycleevent_ObjectPersistingEvent"><code>ObjectPersistingEvent</code></a>.</p> </div> </td> </tr> </tbody> @@ -2694,7 +2720,7 @@ <p>The <code>removed()</code> lifecycle callback method is called when a (persistent) object has just been deleted from the object store</p> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_lifecycle_removing"><code>removing()</code></a>.</p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_lifecycle_removing"><code>removing()</code></a>.</p> </div> <div class="admonitionblock tip"> <table> @@ -2703,7 +2729,7 @@ <td class="icon"> <i class="fa icon-tip" title="Tip"></i> </td> <td class="content"> <div class="paragraph"> - <p>Alternatively, consider using a <a href="rgsvc.html#_rgsvc_api_EventBusService">event bus</a> <a href="#_rgcms_classes_super_AbstractSubscriber">subscriber</a> on the <a href="#_rgcms_classes_lifecycleevent_ObjectRemovedEvent"><code>ObjectRemovedEvent</code></a>.</p> + <p>Alternatively, consider using a <a href="../rgsvc/rgsvc.html#_rgsvc_api_EventBusService">event bus</a> <a href="../rgcms/rgcms.html#_rgcms_classes_super_AbstractSubscriber">subscriber</a> on the <a href="../rgcms/rgcms.html#_rgcms_classes_lifecycleevent_ObjectRemovedEvent"><code>ObjectRemovedEvent</code></a>.</p> </div> </td> </tr> </tbody> @@ -2716,7 +2742,7 @@ <p>The <code>removing()</code> lifecycle callback method is called when a (persistent) object is just about to be deleted from the object store</p> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_lifecycle_removed"><code>removed()</code></a>.</p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_lifecycle_removed"><code>removed()</code></a>.</p> </div> <div class="admonitionblock tip"> <table> @@ -2725,7 +2751,7 @@ <td class="icon"> <i class="fa icon-tip" title="Tip"></i> </td> <td class="content"> <div class="paragraph"> - <p>Alternatively, consider using a <a href="rgsvc.html#_rgsvc_api_EventBusService">event bus</a> <a href="#_rgcms_classes_super_AbstractSubscriber">subscriber</a> on the <a href="#_rgcms_classes_lifecycleevent_ObjectRemovingEvent"><code>ObjectRemovingEvent</code></a>.</p> + <p>Alternatively, consider using a <a href="../rgsvc/rgsvc.html#_rgsvc_api_EventBusService">event bus</a> <a href="../rgcms/rgcms.html#_rgcms_classes_super_AbstractSubscriber">subscriber</a> on the <a href="../rgcms/rgcms.html#_rgcms_classes_lifecycleevent_ObjectRemovingEvent"><code>ObjectRemovingEvent</code></a>.</p> </div> </td> </tr> </tbody> @@ -2738,7 +2764,7 @@ <p>The <code>updated()</code> lifecycle callback method is called when a (persistent) object has just been updated in the object store</p> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_lifecycle_updating"><code>updating()</code></a>.</p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_lifecycle_updating"><code>updating()</code></a>.</p> </div> <div class="admonitionblock tip"> <table> @@ -2747,7 +2773,7 @@ <td class="icon"> <i class="fa icon-tip" title="Tip"></i> </td> <td class="content"> <div class="paragraph"> - <p>Alternatively, consider using a <a href="rgsvc.html#_rgsvc_api_EventBusService">event bus</a> <a href="#_rgcms_classes_super_AbstractSubscriber">subscriber</a> on the <a href="#_rgcms_classes_lifecycleevent_ObjectUpdatedEvent"><code>ObjectUpdatedEvent</code></a>.</p> + <p>Alternatively, consider using a <a href="../rgsvc/rgsvc.html#_rgsvc_api_EventBusService">event bus</a> <a href="../rgcms/rgcms.html#_rgcms_classes_super_AbstractSubscriber">subscriber</a> on the <a href="../rgcms/rgcms.html#_rgcms_classes_lifecycleevent_ObjectUpdatedEvent"><code>ObjectUpdatedEvent</code></a>.</p> </div> </td> </tr> </tbody> @@ -2760,7 +2786,7 @@ <p>The <code>updating()</code> lifecycle callback method is called when a (persistent) object is just about to be updated in the object store</p> </div> <div class="paragraph"> - <p>See also <a href="#_rgcms_methods_lifecycle_updated"><code>updated()</code></a>.</p> + <p>See also <a href="../rgcms/rgcms.html#_rgcms_methods_lifecycle_updated"><code>updated()</code></a>.</p> </div> <div class="admonitionblock tip"> <table> @@ -2769,7 +2795,7 @@ <td class="icon"> <i class="fa icon-tip" title="Tip"></i> </td> <td class="content"> <div class="paragraph"> - <p>Alternatively, consider using a <a href="rgsvc.html#_rgsvc_api_EventBusService">event bus</a> <a href="#_rgcms_classes_super_AbstractSubscriber">subscriber</a> on the <a href="#_rgcms_classes_lifecycleevent_ObjectUpdatingEvent"><code>ObjectUpdatingEvent</code></a>.</p> + <p>Alternatively, consider using a <a href="../rgsvc/rgsvc.html#_rgsvc_api_EventBusService">event bus</a> <a href="../rgcms/rgcms.html#_rgcms_classes_super_AbstractSubscriber">subscriber</a> on the <a href="../rgcms/rgcms.html#_rgcms_classes_lifecycleevent_ObjectUpdatingEvent"><code>ObjectUpdatingEvent</code></a>.</p> </div> </td> </tr> </tbody> @@ -2796,7 +2822,7 @@ </table> </div> <div class="paragraph"> - <p>You can gain access to the relevant JDO API using the <a href="rgsvc.html#_rgsvc_api_IsisJdoSupport"><code>IsisJdoSupport</code></a> domain service.</p> + <p>You can gain access to the relevant JDO API using the <a href="../rgsvc/rgsvc.html#_rgsvc_api_IsisJdoSupport"><code>IsisJdoSupport</code></a> domain service.</p> </div> <div class="paragraph"> <p>For example:</p> @@ -2842,7 +2868,7 @@ </tr> <tr> <td><i class="conum" data-value="3"></i><b>3</b></td> - <td>use the injected <a href="rgsvc.html#_rgsvc_api_IsisJdoSupport"><code>IsisJdoSupport</code></a> service to obtain the <code>PersistenceManager</code>.</td> + <td>use the injected <a href="../rgsvc/rgsvc.html#_rgsvc_api_IsisJdoSupport"><code>IsisJdoSupport</code></a> service to obtain the <code>PersistenceManager</code>.</td> </tr> </tbody> </table> @@ -2859,7 +2885,7 @@ <button type="button" class="button secondary" onclick="window.location.href="https://github.com/apache/isis/edit/master/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_classes.adoc"" style="float: right; font-size: small; padding: 6px; margin-top: -55px; "><i class="fa fa-pencil-square-o"></i> Edit</button> <div class="sectionbody"> <div class="paragraph"> - <p>This chapter describes the usage of various classes and interfaces that are not otherwise associated with <a href="#rgsvc.adoc">domain services</a>, <a href="ugfun.html#_ugfun_object-layout">object layout</a> or <a href="rgcfg.html#_rgcfg">configuration</a>.</p> + <p>This chapter describes the usage of various classes and interfaces that are not otherwise associated with <a href="../rgsvc/rg
<TRUNCATED>