You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2015/11/19 23:45:54 UTC
[1/5] isis-site git commit: ISIS-1250, ISIS-915, ISIS-1251, ISIS-1252,
ISIS-1254, ISIS-1255
Repository: isis-site
Updated Branches:
refs/heads/asf-site d9a2c3833 -> 3970c476c
http://git-wip-us.apache.org/repos/asf/isis-site/blob/3970c476/content/help.html
----------------------------------------------------------------------
diff --git a/content/help.html b/content/help.html
index ba2bb7b..3a3af2f 100644
--- a/content/help.html
+++ b/content/help.html
@@ -46,6 +46,20 @@
<![endif]-->
+
+ <style type="text/css">
+ pre code {
+ background-color: inherit;
+ border-style: none;
+ }
+
+ pre code > span:first-child {
+ margin-left: -5px;
+ }
+
+ <style>
+
+ <!--
<style type="text/css">
/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
/*pre.CodeRay {background-color:#f7f7f8;}*/
@@ -164,6 +178,7 @@ table.CodeRay td.code>pre{padding:0}
}
<style>
+ -->
<style>
.github-fork-ribbon-wrapper.right {
@@ -242,6 +257,22 @@ table.CodeRay td.code>pre{padding:0}
margin-top: 30px;
}
+ div#doc-content a.header-link {
+ margin-left: -75px;
+ }
+
+ div#doc-content div.sect1 h2 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect3 h4 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect2 h3 {
+ margin-left: -60px;
+ }
+
div.documentation-page table.frame-all {
border-left: none;
border-right: none;
http://git-wip-us.apache.org/repos/asf/isis-site/blob/3970c476/content/how-isis-works.html
----------------------------------------------------------------------
diff --git a/content/how-isis-works.html b/content/how-isis-works.html
index 29e2a73..0278916 100644
--- a/content/how-isis-works.html
+++ b/content/how-isis-works.html
@@ -46,6 +46,20 @@
<![endif]-->
+
+ <style type="text/css">
+ pre code {
+ background-color: inherit;
+ border-style: none;
+ }
+
+ pre code > span:first-child {
+ margin-left: -5px;
+ }
+
+ <style>
+
+ <!--
<style type="text/css">
/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
/*pre.CodeRay {background-color:#f7f7f8;}*/
@@ -164,6 +178,7 @@ table.CodeRay td.code>pre{padding:0}
}
<style>
+ -->
<style>
.github-fork-ribbon-wrapper.right {
@@ -242,6 +257,22 @@ table.CodeRay td.code>pre{padding:0}
margin-top: 30px;
}
+ div#doc-content a.header-link {
+ margin-left: -75px;
+ }
+
+ div#doc-content div.sect1 h2 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect3 h4 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect2 h3 {
+ margin-left: -60px;
+ }
+
div.documentation-page table.frame-all {
border-left: none;
border-right: none;
http://git-wip-us.apache.org/repos/asf/isis-site/blob/3970c476/content/icons.html
----------------------------------------------------------------------
diff --git a/content/icons.html b/content/icons.html
index 48c10cc..1a1634e 100644
--- a/content/icons.html
+++ b/content/icons.html
@@ -46,6 +46,20 @@
<![endif]-->
+
+ <style type="text/css">
+ pre code {
+ background-color: inherit;
+ border-style: none;
+ }
+
+ pre code > span:first-child {
+ margin-left: -5px;
+ }
+
+ <style>
+
+ <!--
<style type="text/css">
/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
/*pre.CodeRay {background-color:#f7f7f8;}*/
@@ -164,6 +178,7 @@ table.CodeRay td.code>pre{padding:0}
}
<style>
+ -->
<style>
.github-fork-ribbon-wrapper.right {
@@ -242,6 +257,22 @@ table.CodeRay td.code>pre{padding:0}
margin-top: 30px;
}
+ div#doc-content a.header-link {
+ margin-left: -75px;
+ }
+
+ div#doc-content div.sect1 h2 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect3 h4 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect2 h3 {
+ margin-left: -60px;
+ }
+
div.documentation-page table.frame-all {
border-left: none;
border-right: none;
http://git-wip-us.apache.org/repos/asf/isis-site/blob/3970c476/content/index.html
----------------------------------------------------------------------
diff --git a/content/index.html b/content/index.html
index 04ab1be..b720f4f 100644
--- a/content/index.html
+++ b/content/index.html
@@ -710,7 +710,7 @@ mvn archetype:generate \
</div>
</div>
<div>
- <p align="center"><i>hover to stop scrolling</i></p>
+ <p align="center"><i>hover to stop scrolling; click arrows to resume</i></p>
</div>
</div>
<div class="large-1 medium-1 columns">
http://git-wip-us.apache.org/repos/asf/isis-site/blob/3970c476/content/introducing-apache-isis/common-use-cases/common-use-cases.html
----------------------------------------------------------------------
diff --git a/content/introducing-apache-isis/common-use-cases/common-use-cases.html b/content/introducing-apache-isis/common-use-cases/common-use-cases.html
index c71b244..b9feae3 100644
--- a/content/introducing-apache-isis/common-use-cases/common-use-cases.html
+++ b/content/introducing-apache-isis/common-use-cases/common-use-cases.html
@@ -46,6 +46,20 @@
<![endif]-->
+
+ <style type="text/css">
+ pre code {
+ background-color: inherit;
+ border-style: none;
+ }
+
+ pre code > span:first-child {
+ margin-left: -5px;
+ }
+
+ <style>
+
+ <!--
<style type="text/css">
/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
/*pre.CodeRay {background-color:#f7f7f8;}*/
@@ -164,6 +178,7 @@ table.CodeRay td.code>pre{padding:0}
}
<style>
+ -->
<style>
.github-fork-ribbon-wrapper.right {
@@ -242,6 +257,22 @@ table.CodeRay td.code>pre{padding:0}
margin-top: 30px;
}
+ div#doc-content a.header-link {
+ margin-left: -75px;
+ }
+
+ div#doc-content div.sect1 h2 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect3 h4 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect2 h3 {
+ margin-left: -60px;
+ }
+
div.documentation-page table.frame-all {
border-left: none;
border-right: none;
http://git-wip-us.apache.org/repos/asf/isis-site/blob/3970c476/content/introducing-apache-isis/isis-in-pictures/isis-in-pictures.html
----------------------------------------------------------------------
diff --git a/content/introducing-apache-isis/isis-in-pictures/isis-in-pictures.html b/content/introducing-apache-isis/isis-in-pictures/isis-in-pictures.html
index 36a7307..7c6fbdc 100644
--- a/content/introducing-apache-isis/isis-in-pictures/isis-in-pictures.html
+++ b/content/introducing-apache-isis/isis-in-pictures/isis-in-pictures.html
@@ -46,6 +46,20 @@
<![endif]-->
+
+ <style type="text/css">
+ pre code {
+ background-color: inherit;
+ border-style: none;
+ }
+
+ pre code > span:first-child {
+ margin-left: -5px;
+ }
+
+ <style>
+
+ <!--
<style type="text/css">
/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
/*pre.CodeRay {background-color:#f7f7f8;}*/
@@ -164,6 +178,7 @@ table.CodeRay td.code>pre{padding:0}
}
<style>
+ -->
<style>
.github-fork-ribbon-wrapper.right {
@@ -242,6 +257,22 @@ table.CodeRay td.code>pre{padding:0}
margin-top: 30px;
}
+ div#doc-content a.header-link {
+ margin-left: -75px;
+ }
+
+ div#doc-content div.sect1 h2 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect3 h4 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect2 h3 {
+ margin-left: -60px;
+ }
+
div.documentation-page table.frame-all {
border-left: none;
border-right: none;
http://git-wip-us.apache.org/repos/asf/isis-site/blob/3970c476/content/isis-in-pictures.html
----------------------------------------------------------------------
diff --git a/content/isis-in-pictures.html b/content/isis-in-pictures.html
index 26c5ac3..8b4d7e2 100644
--- a/content/isis-in-pictures.html
+++ b/content/isis-in-pictures.html
@@ -46,6 +46,20 @@
<![endif]-->
+
+ <style type="text/css">
+ pre code {
+ background-color: inherit;
+ border-style: none;
+ }
+
+ pre code > span:first-child {
+ margin-left: -5px;
+ }
+
+ <style>
+
+ <!--
<style type="text/css">
/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
/*pre.CodeRay {background-color:#f7f7f8;}*/
@@ -164,6 +178,7 @@ table.CodeRay td.code>pre{padding:0}
}
<style>
+ -->
<style>
.github-fork-ribbon-wrapper.right {
@@ -242,6 +257,22 @@ table.CodeRay td.code>pre{padding:0}
margin-top: 30px;
}
+ div#doc-content a.header-link {
+ margin-left: -75px;
+ }
+
+ div#doc-content div.sect1 h2 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect3 h4 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect2 h3 {
+ margin-left: -60px;
+ }
+
div.documentation-page table.frame-all {
border-left: none;
border-right: none;
http://git-wip-us.apache.org/repos/asf/isis-site/blob/3970c476/content/migration-notes.html
----------------------------------------------------------------------
diff --git a/content/migration-notes.html b/content/migration-notes.html
index d03c367..ce10485 100644
--- a/content/migration-notes.html
+++ b/content/migration-notes.html
@@ -46,6 +46,20 @@
<![endif]-->
+
+ <style type="text/css">
+ pre code {
+ background-color: inherit;
+ border-style: none;
+ }
+
+ pre code > span:first-child {
+ margin-left: -5px;
+ }
+
+ <style>
+
+ <!--
<style type="text/css">
/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
/*pre.CodeRay {background-color:#f7f7f8;}*/
@@ -164,6 +178,7 @@ table.CodeRay td.code>pre{padding:0}
}
<style>
+ -->
<style>
.github-fork-ribbon-wrapper.right {
@@ -242,6 +257,22 @@ table.CodeRay td.code>pre{padding:0}
margin-top: 30px;
}
+ div#doc-content a.header-link {
+ margin-left: -75px;
+ }
+
+ div#doc-content div.sect1 h2 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect3 h4 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect2 h3 {
+ margin-left: -60px;
+ }
+
div.documentation-page table.frame-all {
border-left: none;
border-right: none;
@@ -488,6 +519,48 @@ table.CodeRay td.code>pre{padding:0}
<div id="doc-content">
<div class="sect1">
+<h2 id="_migration-notes_1.10.0-to-1.11.0">From v1.10.0 to 1.11.0</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Existing projects written against v1.10.0 should run against v1.11.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="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>At the time of writing <code>1.11.0</code> has not been released; these notes relate to <code>1.11.0-SNAPSHOT</code>.</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2">
+<h3 id="_jaxb_view_models">JAXB view models</h3>
+<div class="paragraph">
+<p>This version recognizes classes annotated with <a href="rg.html#_rg_annotations_manpage-XmlRootElement"><code>@XmlRootElement</code></a>
+as view models. These are serialized out into XML and converted into URL.</p>
+</div>
+<div class="paragraph">
+<p>The <a href="rg.html#_rg_services-api_manpage-JaxbService"><code>JaxbService</code></a> is responsible for performing the XML conversion.
+The default implementation is located in the <code>org.apache.isis.core:isis-core-schema</code> module, specifically under the
+<code>org.apache.isis.core.schema.services</code> package.</p>
+</div>
+<div class="paragraph">
+<p>If your application is bootstrapped using an <code>AppManifest</code> (recommended; ee
+<a href="rg.html#_rg_classes_AppManifest-bootstrapping">here</a>) then the <code>JaxbService</code> will automatically be discovered and
+ registered. However, if you are still using the older <code>isis.properties</code> configuration file to explicitly register
+ services then you will need to add in this service.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
<h2 id="_migration-notes_1.9.0-to-1.10.0">From v1.9.0 to 1.10.0</h2>
<div class="sectionbody">
<div class="paragraph">
@@ -1843,6 +1916,11 @@ into the new <code>org.isisaddons.module.settings:isis-module-settings-dom</code
<div id="toc" class="toc2">
<div class="fallback-toc">
<ul class="sectlevel1">
+<li><a href="#_migration-notes_1.10.0-to-1.11.0">From v1.10.0 to 1.11.0</a>
+<ul class="sectlevel2">
+<li><a href="#_jaxb_view_models">JAXB view models</a></li>
+</ul>
+</li>
<li><a href="#_migration-notes_1.9.0-to-1.10.0">From v1.9.0 to 1.10.0</a>
<ul class="sectlevel2">
<li><a href="#_remove_references_to_code_isis_viewer_wicket_code_parent_pom">Remove references to <code>isis-viewer-wicket</code> parent pom.</a></li>
http://git-wip-us.apache.org/repos/asf/isis-site/blob/3970c476/content/more-thanks.html
----------------------------------------------------------------------
diff --git a/content/more-thanks.html b/content/more-thanks.html
index 8bd26dc..1de1e4a 100644
--- a/content/more-thanks.html
+++ b/content/more-thanks.html
@@ -46,6 +46,20 @@
<![endif]-->
+
+ <style type="text/css">
+ pre code {
+ background-color: inherit;
+ border-style: none;
+ }
+
+ pre code > span:first-child {
+ margin-left: -5px;
+ }
+
+ <style>
+
+ <!--
<style type="text/css">
/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
/*pre.CodeRay {background-color:#f7f7f8;}*/
@@ -164,6 +178,7 @@ table.CodeRay td.code>pre{padding:0}
}
<style>
+ -->
<style>
.github-fork-ribbon-wrapper.right {
@@ -242,6 +257,22 @@ table.CodeRay td.code>pre{padding:0}
margin-top: 30px;
}
+ div#doc-content a.header-link {
+ margin-left: -75px;
+ }
+
+ div#doc-content div.sect1 h2 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect3 h4 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect2 h3 {
+ margin-left: -60px;
+ }
+
div.documentation-page table.frame-all {
border-left: none;
border-right: none;
http://git-wip-us.apache.org/repos/asf/isis-site/blob/3970c476/content/powered-by.html
----------------------------------------------------------------------
diff --git a/content/powered-by.html b/content/powered-by.html
index f656a16..87c86dd 100644
--- a/content/powered-by.html
+++ b/content/powered-by.html
@@ -46,6 +46,20 @@
<![endif]-->
+
+ <style type="text/css">
+ pre code {
+ background-color: inherit;
+ border-style: none;
+ }
+
+ pre code > span:first-child {
+ margin-left: -5px;
+ }
+
+ <style>
+
+ <!--
<style type="text/css">
/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
/*pre.CodeRay {background-color:#f7f7f8;}*/
@@ -164,6 +178,7 @@ table.CodeRay td.code>pre{padding:0}
}
<style>
+ -->
<style>
.github-fork-ribbon-wrapper.right {
@@ -242,6 +257,22 @@ table.CodeRay td.code>pre{padding:0}
margin-top: 30px;
}
+ div#doc-content a.header-link {
+ margin-left: -75px;
+ }
+
+ div#doc-content div.sect1 h2 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect3 h4 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect2 h3 {
+ margin-left: -60px;
+ }
+
div.documentation-page table.frame-all {
border-left: none;
border-right: none;
http://git-wip-us.apache.org/repos/asf/isis-site/blob/3970c476/content/release-notes.html
----------------------------------------------------------------------
diff --git a/content/release-notes.html b/content/release-notes.html
index 58502a1..263eed1 100644
--- a/content/release-notes.html
+++ b/content/release-notes.html
@@ -46,6 +46,20 @@
<![endif]-->
+
+ <style type="text/css">
+ pre code {
+ background-color: inherit;
+ border-style: none;
+ }
+
+ pre code > span:first-child {
+ margin-left: -5px;
+ }
+
+ <style>
+
+ <!--
<style type="text/css">
/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
/*pre.CodeRay {background-color:#f7f7f8;}*/
@@ -164,6 +178,7 @@ table.CodeRay td.code>pre{padding:0}
}
<style>
+ -->
<style>
.github-fork-ribbon-wrapper.right {
@@ -242,6 +257,22 @@ table.CodeRay td.code>pre{padding:0}
margin-top: 30px;
}
+ div#doc-content a.header-link {
+ margin-left: -75px;
+ }
+
+ div#doc-content div.sect1 h2 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect3 h4 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect2 h3 {
+ margin-left: -60px;
+ }
+
div.documentation-page table.frame-all {
border-left: none;
border-right: none;
http://git-wip-us.apache.org/repos/asf/isis-site/blob/3970c476/content/resources/templates/asciidoc-templates-idea.xml
----------------------------------------------------------------------
diff --git a/content/resources/templates/asciidoc-templates-idea.xml b/content/resources/templates/asciidoc-templates-idea.xml
deleted file mode 100644
index b4031a9..0000000
--- a/content/resources/templates/asciidoc-templates-idea.xml
+++ /dev/null
@@ -1,365 +0,0 @@
-<templateSet group="AsciiDoc">
- <template name="adtbl3" value=".$tableCaption$ [cols="1a,1a,1a", options="header"] |=== | $cell1header$ | $cell2header$ | $cell3header$ | $cell1row1$ | $cell2row1$ | $cell3row1$ | | | |===" description="Table with three columns" toReformat="false" toShortenFQNames="true">
- <variable name="tableCaption" expression="" defaultValue=""Table caption"" alwaysStopAt="true" />
- <variable name="cell1header" expression="" defaultValue=""Header Cell 1"" alwaysStopAt="true" />
- <variable name="cell2header" expression="" defaultValue=""Header Cell 2"" alwaysStopAt="true" />
- <variable name="cell3header" expression="" defaultValue="" alwaysStopAt="true" />
- <variable name="cell1row1" expression="" defaultValue=""Row 1 Cell 1"" alwaysStopAt="true" />
- <variable name="cell2row1" expression="" defaultValue=""Row 1 Cell 2"" alwaysStopAt="true" />
- <variable name="cell3row1" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adadmtip" value="[TIP] ==== $END$ ==== " description="Tip admonition" toReformat="false" toShortenFQNames="true">
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adadmnote" value="[NOTE] ==== $END$ ==== " description="Note admonition" toReformat="false" toShortenFQNames="true">
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adadmimportant" value="[IMPORTANT] ==== $END$ ==== " description="Important admonition" toReformat="false" toShortenFQNames="true">
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adadmwarning" value="[WARNING] ==== $END$ ==== " description="Warning admonition" toReformat="false" toShortenFQNames="true">
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adimgfile" value="image::{_imagesdir}$INCLUDED$/$FILE$.png[width="$END$$WIDTH$px",link="{_imagesdir}$INCLUDED$/$FILE$.png"]" description="Image link to file" toReformat="false" toShortenFQNames="true">
- <variable name="INCLUDED" expression="" defaultValue="" alwaysStopAt="true" />
- <variable name="FILE" expression="" defaultValue="" alwaysStopAt="true" />
- <variable name="WIDTH" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adimgurl" value="image::$URL$[width="$END$$WIDTH$px",link="$URL$"]" description="Image link to URL" toReformat="false" toShortenFQNames="true">
- <variable name="URL" expression="" defaultValue="" alwaysStopAt="true" />
- <variable name="WIDTH" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adlink" value="link:$URL$[$TEXT$]" description="Link to URL" toReformat="false" toShortenFQNames="true">
- <variable name="URL" expression="" defaultValue="" alwaysStopAt="true" />
- <variable name="TEXT" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adsrcjava" value="[source,java] ---- $END$ ---- " description="Source code (java)" toReformat="false" toShortenFQNames="true">
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adsrcxml" value="[source,xml] ---- $END$ ---- " description="Source code (XML)" toReformat="false" toShortenFQNames="true">
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adsrcother" value="[source,$LANG$] ---- $END$ ---- " description="Source code (None)" toReformat="false" toShortenFQNames="true">
- <variable name="LANG" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adinclude" value="include::$INCLUDED$.adoc[leveloffset=+1] " description="Include" toReformat="false" toShortenFQNames="true">
- <variable name="INCLUDED" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adlinkaddons" value="(non-ASF) link:http://isisaddons.org[Isis Addons]" description="Link to Isis Addons" toReformat="false" toShortenFQNames="true">
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adlinkaddonsmodule" value="(non-ASF) http://github.com/isisaddons/isis-module-$MODULE$[Isis addons' $MODULE$] module" description="Link to specific Isis Addons module" toReformat="false" toShortenFQNames="true">
- <variable name="MODULE" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adtodo" value="NOTE: TODO" description="TODO note" toReformat="false" toShortenFQNames="true">
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adfootnote" value=".footnote:[$END$]" description="Footnote" toReformat="false" toShortenFQNames="true">
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adlinkaddonswicket" value="(non-ASF) http://github.com/isisaddons/isis-wicket-$WICKET$[Isis addons' $WICKET$ ] wicket extension" description="Link to specific Isis Addons wicket cpt" toReformat="false" toShortenFQNames="true">
- <variable name="WICKET" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adlinkaddonsapp" value="(non-ASF) http://github.com/isisaddons/isis-app-$APP$[Isis addons' $APP$]" description="Link to specific Isis Addons app" toReformat="false" toShortenFQNames="true" deactivated="true">
- <variable name="APP" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adugsimpleapp" value="xref:ug.adoc#_ug_getting-started_simpleapp-archetype[SimpleApp archetype]" description="xref to the user guide simpleapp archetype" toReformat="false" toShortenFQNames="true">
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adyoutube" value="video::$REFERENCE$[youtube,width="$WIDTH$px",height="$END$$HEIGHT$px"]" description="Link to youtube" toReformat="false" toShortenFQNames="true">
- <variable name="REFERENCE" expression="" defaultValue="" alwaysStopAt="true" />
- <variable name="WIDTH" expression="" defaultValue="" alwaysStopAt="true" />
- <variable name="HEIGHT" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adimgfilec" value=".$CAPTION$ image::{_imagesdir}$INCLUDED$/$FILE$.png[width="$END$$WIDTH$px",link="{_imagesdir}$INCLUDED$/$FILE$.png"]" description="Image link to file with caption" toReformat="false" toShortenFQNames="true">
- <variable name="CAPTION" expression="" defaultValue="" alwaysStopAt="true" />
- <variable name="INCLUDED" expression="" defaultValue="" alwaysStopAt="true" />
- <variable name="FILE" expression="" defaultValue="" alwaysStopAt="true" />
- <variable name="WIDTH" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adimgurlc" value=".$CAPTION$ image::$URL$[width="$END$$WIDTH$px",link="$URL$"]" description="Image link to URL with caption" toReformat="false" toShortenFQNames="true">
- <variable name="CAPTION" expression="" defaultValue="" alwaysStopAt="true" />
- <variable name="URL" expression="" defaultValue="" alwaysStopAt="true" />
- <variable name="WIDTH" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adsrcjavac" value="[source,java] .$CAPTION$ ---- $END$ ---- " description="Source code (java) with caption" toReformat="false" toShortenFQNames="true">
- <variable name="CAPTION" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adsrcotherc" value="[source,$LANG$] ---- $END$ ---- " description="Source code (None) with caption" toReformat="false" toShortenFQNames="true">
- <variable name="LANG" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adsrcxmlc" value="[source,xml] .$CAPTION$ ---- $END$ ---- " description="Source code (XML) with caption" toReformat="false" toShortenFQNames="true">
- <variable name="CAPTION" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adsrcjavascript" value="[source,javascript] ---- $END$ ---- " description="Source code (Javascript)" toReformat="false" toShortenFQNames="true">
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adsrcjavascriptc" value="[source,javascript] .$CAPTION$ ---- $END$ ---- " description="Source code (javascript) with caption" toReformat="false" toShortenFQNames="true">
- <variable name="CAPTION" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adrgmp" value="xref:rg.adoc#_rg_methods_prefixes_manpage-$methodName$[`$methodName$...()`]" description="x-ref to ref guide manpage for method prefix" toReformat="false" toShortenFQNames="true">
- <variable name="methodName" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adug1" value="xref:ug.adoc#$chapter$[$DisplayText$]" description="x-ref to user guide level 1 (chapter)" toReformat="false" toShortenFQNames="true">
- <variable name="chapter" expression="" defaultValue="_ug_" alwaysStopAt="true" />
- <variable name="DisplayText" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adrgsa" value="xref:rg.adoc#_rg_services-api_manpage-$ServiceType$[`$ServiceType$`]" description="x-ref to ref guide manpage for service api" toReformat="false" toShortenFQNames="true">
- <variable name="ServiceType" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adrgmr" value="xref:rg.adoc#_rg_methods_reserved_manpage-$methodName$[`$methodName$()`]" description="x-ref to ref guide manpage for reserved method" toReformat="false" toShortenFQNames="true">
- <variable name="methodName" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adrgss" value="xref:rg.adoc#_rg_services-spi_manpage-$ServiceType$[`$ServiceType$`]" description="x-ref to ref guide manpage for service spi" toReformat="false" toShortenFQNames="true">
- <variable name="ServiceType" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adrgcv" value="xref:rg.adoc#_rg_classes_value-types_manpage-$Type$[`$Type$`]" description="x-ref to ref guide manpage for class value type" toReformat="false" toShortenFQNames="true">
- <variable name="Type" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adrgcs" value="xref:rg.adoc#_rg_classes_super_manpage-$Type$[`$Type$`]" description="x-ref to ref guide manpage for class superclass" toReformat="false" toShortenFQNames="true">
- <variable name="Type" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adrgcu" value="xref:rg.adoc#_rg_classes_utility_manpage-$Type$[`$Type$`]" description="x-ref to ref guide manpage for class utility" toReformat="false" toShortenFQNames="true">
- <variable name="Type" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adanchany" value="= anchor:$prefix$[]" description="anchor to any" toReformat="false" toShortenFQNames="true">
- <variable name="prefix" expression="" defaultValue="chapter" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adrgna" value="xref:rg.adoc#_rg_annotations_manpage-$Type$[`@$Type$`]" description="x-ref to ref guide manpage for annotation" toReformat="false" toShortenFQNames="true">
- <variable name="Type" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adug2" value="xref:ug.adoc#$chapter$_$section$[$DisplayText$]" description="x-ref to user guide level 2 (chapter section)" toReformat="false" toShortenFQNames="true">
- <variable name="chapter" expression="" defaultValue="_ug_" alwaysStopAt="true" />
- <variable name="section" expression="" defaultValue="" alwaysStopAt="true" />
- <variable name="DisplayText" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adug3" value="xref:ug.adoc#$chapter$_$section$_$subsection$[$DisplayText$]" description="x-ref to user guide level 3 (chapter section subsection)" toReformat="false" toShortenFQNames="true">
- <variable name="chapter" expression="" defaultValue="_ug_" alwaysStopAt="true" />
- <variable name="section" expression="" defaultValue="" alwaysStopAt="true" />
- <variable name="subsection" expression="" defaultValue="" alwaysStopAt="true" />
- <variable name="DisplayText" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adxrefany" value="xref:$chapter$[$DisplayText$]" description="x-ref to any" toReformat="false" toShortenFQNames="true">
- <variable name="chapter" expression="" defaultValue="" alwaysStopAt="true" />
- <variable name="DisplayText" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adrgnt" value="xref:rg.adoc#_rg_annotations_manpage-$Type$_$attribute$[`@$Type$#$attribute$()`]" description="x-ref to ref guide manpage for annotation's attribute" toReformat="false" toShortenFQNames="true">
- <variable name="Type" expression="" defaultValue="" alwaysStopAt="true" />
- <variable name="attribute" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adugvw" value="xref:ug.adoc#_ug_wicket-viewer[Wicket viewer]" description="x-ref to user guide wicket viewer" toReformat="false" toShortenFQNames="true">
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adugvro" value="xref:ug.adoc#_ug_restfulobjects-viewer[RestfulObjects viewer]" description="x-ref to user guide restfulobjects viewer" toReformat="false" toShortenFQNames="true">
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adrgntx" value="xref:rg.adoc#_rg_annotations_manpage-$Type$_$attribute$[$linkText$]" description="x-ref to ref guide manpage for annotation's attribute, overriding the link text" toReformat="false" toShortenFQNames="true">
- <variable name="Type" expression="" defaultValue="" alwaysStopAt="true" />
- <variable name="attribute" expression="" defaultValue="" alwaysStopAt="true" />
- <variable name="linkText" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adwip" value="NOTE: WIP - " description="WIP note" toReformat="false" toShortenFQNames="true">
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adyoutubec" value=".$CAPTION$ video::$REFERENCE$[youtube,width="$WIDTH$px",height="$END$$HEIGHT$px"]" description="Link to youtube with caption" toReformat="false" toShortenFQNames="true">
- <variable name="CAPTION" expression="" defaultValue="" alwaysStopAt="true" />
- <variable name="REFERENCE" expression="" defaultValue="" alwaysStopAt="true" />
- <variable name="WIDTH" expression="" defaultValue="" alwaysStopAt="true" />
- <variable name="HEIGHT" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adrg1" value="xref:rg.adoc#$chapter$[$DisplayText$]" description="x-ref to ref guide level 1 (chapter)" toReformat="false" toShortenFQNames="true">
- <variable name="chapter" expression="" defaultValue="_rg_" alwaysStopAt="true" />
- <variable name="DisplayText" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adrg2" value="xref:rg.adoc#$chapter$_$section$[$DisplayText$]" description="x-ref to ref guide level 2 (chapter section)" toReformat="false" toShortenFQNames="true">
- <variable name="chapter" expression="" defaultValue="_rg_" alwaysStopAt="true" />
- <variable name="section" expression="" defaultValue="" alwaysStopAt="true" />
- <variable name="DisplayText" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adrg3" value="xref:rg.adoc#$chapter$_$section$_$subsection$[$DisplayText$]" description="x-ref to ref guide level 3 (chapter section subsection)" toReformat="false" toShortenFQNames="true">
- <variable name="chapter" expression="" defaultValue="_rg_" alwaysStopAt="true" />
- <variable name="section" expression="" defaultValue="" alwaysStopAt="true" />
- <variable name="subsection" expression="" defaultValue="" alwaysStopAt="true" />
- <variable name="DisplayText" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adrgcfg" value="xref:rg.adoc#_rg_runtime_configuring-core[configuration property]" description="x-ref to ref guide configuration properties section" toReformat="false" toShortenFQNames="true">
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adcg" value="xref:cg.adoc#_cg[Contributors' Guide]" description="xref to contributors guide" toReformat="false" toShortenFQNames="true">
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adrg" value="xref:rg.adoc#_rg[Reference Guide]" description="xref to reference guide" toReformat="false" toShortenFQNames="true">
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adug" value="xref:ug.adoc#_ug[Users' Guide]" description="xref to user' guide" toReformat="false" toShortenFQNames="true">
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adai" value="Apache Isis " description="Apache Isis" toReformat="false" toShortenFQNames="true">
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adcg1" value="xref:cg.adoc#_cg_$chapter$[$DisplayText$]" description="x-ref to contributors guide level 1 (chapter)" toReformat="false" toShortenFQNames="true">
- <variable name="chapter" expression="" defaultValue="" alwaysStopAt="true" />
- <variable name="DisplayText" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adcg2" value="xref:cg.adoc#_cg_$chapter$_$section$[$DisplayText$]" description="x-ref to contributors guide level 2 (chapter section)" toReformat="false" toShortenFQNames="true">
- <variable name="chapter" expression="" defaultValue="" alwaysStopAt="true" />
- <variable name="section" expression="" defaultValue="" alwaysStopAt="true" />
- <variable name="DisplayText" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
- <template name="adtg1" value="xref:tg.adoc#$chapter$[$DisplayText$]" description="x-ref to tutorials level 1 (chapter)" toReformat="false" toShortenFQNames="true">
- <variable name="chapter" expression="" defaultValue="_tg_" alwaysStopAt="true" />
- <variable name="DisplayText" expression="" defaultValue="" alwaysStopAt="true" />
- <context>
- <option name="AsciiDoc" value="true" />
- </context>
- </template>
-</templateSet>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis-site/blob/3970c476/content/resources/templates/isis-asciidoc-templates-idea.xml
----------------------------------------------------------------------
diff --git a/content/resources/templates/isis-asciidoc-templates-idea.xml b/content/resources/templates/isis-asciidoc-templates-idea.xml
new file mode 100644
index 0000000..b9b0e4b
--- /dev/null
+++ b/content/resources/templates/isis-asciidoc-templates-idea.xml
@@ -0,0 +1,365 @@
+<templateSet group="Isis-AsciiDoc">
+ <template name="adtbl3" value=".$tableCaption$ [cols="1a,1a,1a", options="header"] |=== | $cell1header$ | $cell2header$ | $cell3header$ | $cell1row1$ | $cell2row1$ | $cell3row1$ | | | |===" description="Table with three columns" toReformat="false" toShortenFQNames="true">
+ <variable name="tableCaption" expression="" defaultValue=""Table caption"" alwaysStopAt="true" />
+ <variable name="cell1header" expression="" defaultValue=""Header Cell 1"" alwaysStopAt="true" />
+ <variable name="cell2header" expression="" defaultValue=""Header Cell 2"" alwaysStopAt="true" />
+ <variable name="cell3header" expression="" defaultValue="" alwaysStopAt="true" />
+ <variable name="cell1row1" expression="" defaultValue=""Row 1 Cell 1"" alwaysStopAt="true" />
+ <variable name="cell2row1" expression="" defaultValue=""Row 1 Cell 2"" alwaysStopAt="true" />
+ <variable name="cell3row1" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adadmtip" value="[TIP] ==== $END$ ==== " description="Tip admonition" toReformat="false" toShortenFQNames="true">
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adadmnote" value="[NOTE] ==== $END$ ==== " description="Note admonition" toReformat="false" toShortenFQNames="true">
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adadmimportant" value="[IMPORTANT] ==== $END$ ==== " description="Important admonition" toReformat="false" toShortenFQNames="true">
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adadmwarning" value="[WARNING] ==== $END$ ==== " description="Warning admonition" toReformat="false" toShortenFQNames="true">
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adimgfile" value="image::{_imagesdir}$INCLUDED$/$FILE$.png[width="$END$$WIDTH$px",link="{_imagesdir}$INCLUDED$/$FILE$.png"]" description="Image link to file" toReformat="false" toShortenFQNames="true">
+ <variable name="INCLUDED" expression="" defaultValue="" alwaysStopAt="true" />
+ <variable name="FILE" expression="" defaultValue="" alwaysStopAt="true" />
+ <variable name="WIDTH" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adimgurl" value="image::$URL$[width="$END$$WIDTH$px",link="$URL$"]" description="Image link to URL" toReformat="false" toShortenFQNames="true">
+ <variable name="URL" expression="" defaultValue="" alwaysStopAt="true" />
+ <variable name="WIDTH" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adlink" value="link:$URL$[$TEXT$]" description="Link to URL" toReformat="false" toShortenFQNames="true">
+ <variable name="URL" expression="" defaultValue="" alwaysStopAt="true" />
+ <variable name="TEXT" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adsrcjava" value="[source,java] ---- $END$ ---- " description="Source code (java)" toReformat="false" toShortenFQNames="true">
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adsrcxml" value="[source,xml] ---- $END$ ---- " description="Source code (XML)" toReformat="false" toShortenFQNames="true">
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adsrcother" value="[source,$LANG$] ---- $END$ ---- " description="Source code (None)" toReformat="false" toShortenFQNames="true">
+ <variable name="LANG" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adinclude" value="include::$INCLUDED$.adoc[leveloffset=+1] " description="Include" toReformat="false" toShortenFQNames="true">
+ <variable name="INCLUDED" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adlinkaddons" value="(non-ASF) link:http://isisaddons.org[Isis Addons]" description="Link to Isis Addons" toReformat="false" toShortenFQNames="true">
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adlinkaddonsmodule" value="(non-ASF) http://github.com/isisaddons/isis-module-$MODULE$[Isis addons' $MODULE$] module" description="Link to specific Isis Addons module" toReformat="false" toShortenFQNames="true">
+ <variable name="MODULE" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adtodo" value="NOTE: TODO" description="TODO note" toReformat="false" toShortenFQNames="true">
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adfootnote" value=".footnote:[$END$]" description="Footnote" toReformat="false" toShortenFQNames="true">
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adlinkaddonswicket" value="(non-ASF) http://github.com/isisaddons/isis-wicket-$WICKET$[Isis addons' $WICKET$ ] wicket extension" description="Link to specific Isis Addons wicket cpt" toReformat="false" toShortenFQNames="true">
+ <variable name="WICKET" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adlinkaddonsapp" value="(non-ASF) http://github.com/isisaddons/isis-app-$APP$[Isis addons' $APP$]" description="Link to specific Isis Addons app" toReformat="false" toShortenFQNames="true" deactivated="true">
+ <variable name="APP" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adugsimpleapp" value="xref:ug.adoc#_ug_getting-started_simpleapp-archetype[SimpleApp archetype]" description="xref to the user guide simpleapp archetype" toReformat="false" toShortenFQNames="true">
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adyoutube" value="video::$REFERENCE$[youtube,width="$WIDTH$px",height="$END$$HEIGHT$px"]" description="Link to youtube" toReformat="false" toShortenFQNames="true">
+ <variable name="REFERENCE" expression="" defaultValue="" alwaysStopAt="true" />
+ <variable name="WIDTH" expression="" defaultValue="" alwaysStopAt="true" />
+ <variable name="HEIGHT" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adimgfilec" value=".$CAPTION$ image::{_imagesdir}$INCLUDED$/$FILE$.png[width="$END$$WIDTH$px",link="{_imagesdir}$INCLUDED$/$FILE$.png"]" description="Image link to file with caption" toReformat="false" toShortenFQNames="true">
+ <variable name="CAPTION" expression="" defaultValue="" alwaysStopAt="true" />
+ <variable name="INCLUDED" expression="" defaultValue="" alwaysStopAt="true" />
+ <variable name="FILE" expression="" defaultValue="" alwaysStopAt="true" />
+ <variable name="WIDTH" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adimgurlc" value=".$CAPTION$ image::$URL$[width="$END$$WIDTH$px",link="$URL$"]" description="Image link to URL with caption" toReformat="false" toShortenFQNames="true">
+ <variable name="CAPTION" expression="" defaultValue="" alwaysStopAt="true" />
+ <variable name="URL" expression="" defaultValue="" alwaysStopAt="true" />
+ <variable name="WIDTH" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adsrcjavac" value="[source,java] .$CAPTION$ ---- $END$ ---- " description="Source code (java) with caption" toReformat="false" toShortenFQNames="true">
+ <variable name="CAPTION" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adsrcotherc" value="[source,$LANG$] ---- $END$ ---- " description="Source code (None) with caption" toReformat="false" toShortenFQNames="true">
+ <variable name="LANG" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adsrcxmlc" value="[source,xml] .$CAPTION$ ---- $END$ ---- " description="Source code (XML) with caption" toReformat="false" toShortenFQNames="true">
+ <variable name="CAPTION" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adsrcjavascript" value="[source,javascript] ---- $END$ ---- " description="Source code (Javascript)" toReformat="false" toShortenFQNames="true">
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adsrcjavascriptc" value="[source,javascript] .$CAPTION$ ---- $END$ ---- " description="Source code (javascript) with caption" toReformat="false" toShortenFQNames="true">
+ <variable name="CAPTION" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adrgmp" value="xref:rg.adoc#_rg_methods_prefixes_manpage-$methodName$[`$methodName$...()`]" description="x-ref to ref guide manpage for method prefix" toReformat="false" toShortenFQNames="true">
+ <variable name="methodName" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adug1" value="xref:ug.adoc#$chapter$[$DisplayText$]" description="x-ref to user guide level 1 (chapter)" toReformat="false" toShortenFQNames="true">
+ <variable name="chapter" expression="" defaultValue="_ug_" alwaysStopAt="true" />
+ <variable name="DisplayText" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adrgsa" value="xref:rg.adoc#_rg_services-api_manpage-$ServiceType$[`$ServiceType$`]" description="x-ref to ref guide manpage for service api" toReformat="false" toShortenFQNames="true">
+ <variable name="ServiceType" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adrgmr" value="xref:rg.adoc#_rg_methods_reserved_manpage-$methodName$[`$methodName$()`]" description="x-ref to ref guide manpage for reserved method" toReformat="false" toShortenFQNames="true">
+ <variable name="methodName" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adrgss" value="xref:rg.adoc#_rg_services-spi_manpage-$ServiceType$[`$ServiceType$`]" description="x-ref to ref guide manpage for service spi" toReformat="false" toShortenFQNames="true">
+ <variable name="ServiceType" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adrgcv" value="xref:rg.adoc#_rg_classes_value-types_manpage-$Type$[`$Type$`]" description="x-ref to ref guide manpage for class value type" toReformat="false" toShortenFQNames="true">
+ <variable name="Type" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adrgcs" value="xref:rg.adoc#_rg_classes_super_manpage-$Type$[`$Type$`]" description="x-ref to ref guide manpage for class superclass" toReformat="false" toShortenFQNames="true">
+ <variable name="Type" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adrgcu" value="xref:rg.adoc#_rg_classes_utility_manpage-$Type$[`$Type$`]" description="x-ref to ref guide manpage for class utility" toReformat="false" toShortenFQNames="true">
+ <variable name="Type" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adanchany" value="= anchor:$prefix$[]" description="anchor to any" toReformat="false" toShortenFQNames="true">
+ <variable name="prefix" expression="" defaultValue="chapter" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adrgna" value="xref:rg.adoc#_rg_annotations_manpage-$Type$[`@$Type$`]" description="x-ref to ref guide manpage for annotation" toReformat="false" toShortenFQNames="true">
+ <variable name="Type" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adug2" value="xref:ug.adoc#$chapter$_$section$[$DisplayText$]" description="x-ref to user guide level 2 (chapter section)" toReformat="false" toShortenFQNames="true">
+ <variable name="chapter" expression="" defaultValue="_ug_" alwaysStopAt="true" />
+ <variable name="section" expression="" defaultValue="" alwaysStopAt="true" />
+ <variable name="DisplayText" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adug3" value="xref:ug.adoc#$chapter$_$section$_$subsection$[$DisplayText$]" description="x-ref to user guide level 3 (chapter section subsection)" toReformat="false" toShortenFQNames="true">
+ <variable name="chapter" expression="" defaultValue="_ug_" alwaysStopAt="true" />
+ <variable name="section" expression="" defaultValue="" alwaysStopAt="true" />
+ <variable name="subsection" expression="" defaultValue="" alwaysStopAt="true" />
+ <variable name="DisplayText" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adxrefany" value="xref:$chapter$[$DisplayText$]" description="x-ref to any" toReformat="false" toShortenFQNames="true">
+ <variable name="chapter" expression="" defaultValue="" alwaysStopAt="true" />
+ <variable name="DisplayText" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adrgnt" value="xref:rg.adoc#_rg_annotations_manpage-$Type$_$attribute$[`@$Type$#$attribute$()`]" description="x-ref to ref guide manpage for annotation's attribute" toReformat="false" toShortenFQNames="true">
+ <variable name="Type" expression="" defaultValue="" alwaysStopAt="true" />
+ <variable name="attribute" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adugvw" value="xref:ug.adoc#_ug_wicket-viewer[Wicket viewer]" description="x-ref to user guide wicket viewer" toReformat="false" toShortenFQNames="true">
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adugvro" value="xref:ug.adoc#_ug_restfulobjects-viewer[RestfulObjects viewer]" description="x-ref to user guide restfulobjects viewer" toReformat="false" toShortenFQNames="true">
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adrgntx" value="xref:rg.adoc#_rg_annotations_manpage-$Type$_$attribute$[$linkText$]" description="x-ref to ref guide manpage for annotation's attribute, overriding the link text" toReformat="false" toShortenFQNames="true">
+ <variable name="Type" expression="" defaultValue="" alwaysStopAt="true" />
+ <variable name="attribute" expression="" defaultValue="" alwaysStopAt="true" />
+ <variable name="linkText" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adwip" value="NOTE: WIP - " description="WIP note" toReformat="false" toShortenFQNames="true">
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adyoutubec" value=".$CAPTION$ video::$REFERENCE$[youtube,width="$WIDTH$px",height="$END$$HEIGHT$px"]" description="Link to youtube with caption" toReformat="false" toShortenFQNames="true">
+ <variable name="CAPTION" expression="" defaultValue="" alwaysStopAt="true" />
+ <variable name="REFERENCE" expression="" defaultValue="" alwaysStopAt="true" />
+ <variable name="WIDTH" expression="" defaultValue="" alwaysStopAt="true" />
+ <variable name="HEIGHT" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adrg1" value="xref:rg.adoc#$chapter$[$DisplayText$]" description="x-ref to ref guide level 1 (chapter)" toReformat="false" toShortenFQNames="true">
+ <variable name="chapter" expression="" defaultValue="_rg_" alwaysStopAt="true" />
+ <variable name="DisplayText" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adrg2" value="xref:rg.adoc#$chapter$_$section$[$DisplayText$]" description="x-ref to ref guide level 2 (chapter section)" toReformat="false" toShortenFQNames="true">
+ <variable name="chapter" expression="" defaultValue="_rg_" alwaysStopAt="true" />
+ <variable name="section" expression="" defaultValue="" alwaysStopAt="true" />
+ <variable name="DisplayText" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adrg3" value="xref:rg.adoc#$chapter$_$section$_$subsection$[$DisplayText$]" description="x-ref to ref guide level 3 (chapter section subsection)" toReformat="false" toShortenFQNames="true">
+ <variable name="chapter" expression="" defaultValue="_rg_" alwaysStopAt="true" />
+ <variable name="section" expression="" defaultValue="" alwaysStopAt="true" />
+ <variable name="subsection" expression="" defaultValue="" alwaysStopAt="true" />
+ <variable name="DisplayText" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adrgcfg" value="xref:rg.adoc#_rg_runtime_configuring-core[configuration property]" description="x-ref to ref guide configuration properties section" toReformat="false" toShortenFQNames="true">
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adcg" value="xref:cg.adoc#_cg[Contributors' Guide]" description="xref to contributors guide" toReformat="false" toShortenFQNames="true">
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adrg" value="xref:rg.adoc#_rg[Reference Guide]" description="xref to reference guide" toReformat="false" toShortenFQNames="true">
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adug" value="xref:ug.adoc#_ug[Users' Guide]" description="xref to user' guide" toReformat="false" toShortenFQNames="true">
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adai" value="Apache Isis " description="Apache Isis" toReformat="false" toShortenFQNames="true">
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adcg1" value="xref:cg.adoc#_cg_$chapter$[$DisplayText$]" description="x-ref to contributors guide level 1 (chapter)" toReformat="false" toShortenFQNames="true">
+ <variable name="chapter" expression="" defaultValue="" alwaysStopAt="true" />
+ <variable name="DisplayText" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adcg2" value="xref:cg.adoc#_cg_$chapter$_$section$[$DisplayText$]" description="x-ref to contributors guide level 2 (chapter section)" toReformat="false" toShortenFQNames="true">
+ <variable name="chapter" expression="" defaultValue="" alwaysStopAt="true" />
+ <variable name="section" expression="" defaultValue="" alwaysStopAt="true" />
+ <variable name="DisplayText" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+ <template name="adtg1" value="xref:tg.adoc#$chapter$[$DisplayText$]" description="x-ref to tutorials level 1 (chapter)" toReformat="false" toShortenFQNames="true">
+ <variable name="chapter" expression="" defaultValue="_tg_" alwaysStopAt="true" />
+ <variable name="DisplayText" expression="" defaultValue="" alwaysStopAt="true" />
+ <context>
+ <option name="AsciiDoc" value="true" />
+ </context>
+ </template>
+</templateSet>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis-site/blob/3970c476/content/screencasts.html
----------------------------------------------------------------------
diff --git a/content/screencasts.html b/content/screencasts.html
index 0cd66cc..44412f8 100644
--- a/content/screencasts.html
+++ b/content/screencasts.html
@@ -46,6 +46,20 @@
<![endif]-->
+
+ <style type="text/css">
+ pre code {
+ background-color: inherit;
+ border-style: none;
+ }
+
+ pre code > span:first-child {
+ margin-left: -5px;
+ }
+
+ <style>
+
+ <!--
<style type="text/css">
/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
/*pre.CodeRay {background-color:#f7f7f8;}*/
@@ -164,6 +178,7 @@ table.CodeRay td.code>pre{padding:0}
}
<style>
+ -->
<style>
.github-fork-ribbon-wrapper.right {
@@ -242,6 +257,22 @@ table.CodeRay td.code>pre{padding:0}
margin-top: 30px;
}
+ div#doc-content a.header-link {
+ margin-left: -75px;
+ }
+
+ div#doc-content div.sect1 h2 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect3 h4 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect2 h3 {
+ margin-left: -60px;
+ }
+
div.documentation-page table.frame-all {
border-left: none;
border-right: none;
http://git-wip-us.apache.org/repos/asf/isis-site/blob/3970c476/content/support.html
----------------------------------------------------------------------
diff --git a/content/support.html b/content/support.html
index e1b6a5a..8aaab74 100644
--- a/content/support.html
+++ b/content/support.html
@@ -46,6 +46,20 @@
<![endif]-->
+
+ <style type="text/css">
+ pre code {
+ background-color: inherit;
+ border-style: none;
+ }
+
+ pre code > span:first-child {
+ margin-left: -5px;
+ }
+
+ <style>
+
+ <!--
<style type="text/css">
/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
/*pre.CodeRay {background-color:#f7f7f8;}*/
@@ -164,6 +178,7 @@ table.CodeRay td.code>pre{padding:0}
}
<style>
+ -->
<style>
.github-fork-ribbon-wrapper.right {
@@ -242,6 +257,22 @@ table.CodeRay td.code>pre{padding:0}
margin-top: 30px;
}
+ div#doc-content a.header-link {
+ margin-left: -75px;
+ }
+
+ div#doc-content div.sect1 h2 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect3 h4 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect2 h3 {
+ margin-left: -60px;
+ }
+
div.documentation-page table.frame-all {
border-left: none;
border-right: none;
[3/5] isis-site git commit: ISIS-1250, ISIS-915, ISIS-1251, ISIS-1252,
ISIS-1254, ISIS-1255
Posted by da...@apache.org.
http://git-wip-us.apache.org/repos/asf/isis-site/blob/3970c476/content/guides/simpleapp-archetype.html
----------------------------------------------------------------------
diff --git a/content/guides/simpleapp-archetype.html b/content/guides/simpleapp-archetype.html
index 695512d..8940b9b 100644
--- a/content/guides/simpleapp-archetype.html
+++ b/content/guides/simpleapp-archetype.html
@@ -46,6 +46,20 @@
<![endif]-->
+
+ <style type="text/css">
+ pre code {
+ background-color: inherit;
+ border-style: none;
+ }
+
+ pre code > span:first-child {
+ margin-left: -5px;
+ }
+
+ <style>
+
+ <!--
<style type="text/css">
/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
/*pre.CodeRay {background-color:#f7f7f8;}*/
@@ -164,6 +178,7 @@ table.CodeRay td.code>pre{padding:0}
}
<style>
+ -->
<style>
.github-fork-ribbon-wrapper.right {
@@ -242,6 +257,22 @@ table.CodeRay td.code>pre{padding:0}
margin-top: 30px;
}
+ div#doc-content a.header-link {
+ margin-left: -75px;
+ }
+
+ div#doc-content div.sect1 h2 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect3 h4 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect2 h3 {
+ margin-left: -60px;
+ }
+
div.documentation-page table.frame-all {
border-left: none;
border-right: none;
http://git-wip-us.apache.org/repos/asf/isis-site/blob/3970c476/content/guides/tg.html
----------------------------------------------------------------------
diff --git a/content/guides/tg.html b/content/guides/tg.html
index 4372074..f05d3b5 100644
--- a/content/guides/tg.html
+++ b/content/guides/tg.html
@@ -46,6 +46,20 @@
<![endif]-->
+
+ <style type="text/css">
+ pre code {
+ background-color: inherit;
+ border-style: none;
+ }
+
+ pre code > span:first-child {
+ margin-left: -5px;
+ }
+
+ <style>
+
+ <!--
<style type="text/css">
/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
/*pre.CodeRay {background-color:#f7f7f8;}*/
@@ -164,6 +178,7 @@ table.CodeRay td.code>pre{padding:0}
}
<style>
+ -->
<style>
.github-fork-ribbon-wrapper.right {
@@ -242,6 +257,22 @@ table.CodeRay td.code>pre{padding:0}
margin-top: 30px;
}
+ div#doc-content a.header-link {
+ margin-left: -75px;
+ }
+
+ div#doc-content div.sect1 h2 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect3 h4 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect2 h3 {
+ margin-left: -60px;
+ }
+
div.documentation-page table.frame-all {
border-left: none;
border-right: none;
[4/5] isis-site git commit: ISIS-1250, ISIS-915, ISIS-1251, ISIS-1252,
ISIS-1254, ISIS-1255
Posted by da...@apache.org.
http://git-wip-us.apache.org/repos/asf/isis-site/blob/3970c476/content/guides/rg.html
----------------------------------------------------------------------
diff --git a/content/guides/rg.html b/content/guides/rg.html
index e3050d6..7e254c4 100644
--- a/content/guides/rg.html
+++ b/content/guides/rg.html
@@ -46,6 +46,20 @@
<![endif]-->
+
+ <style type="text/css">
+ pre code {
+ background-color: inherit;
+ border-style: none;
+ }
+
+ pre code > span:first-child {
+ margin-left: -5px;
+ }
+
+ <style>
+
+ <!--
<style type="text/css">
/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
/*pre.CodeRay {background-color:#f7f7f8;}*/
@@ -164,6 +178,7 @@ table.CodeRay td.code>pre{padding:0}
}
<style>
+ -->
<style>
.github-fork-ribbon-wrapper.right {
@@ -242,6 +257,22 @@ table.CodeRay td.code>pre{padding:0}
margin-top: 30px;
}
+ div#doc-content a.header-link {
+ margin-left: -75px;
+ }
+
+ div#doc-content div.sect1 h2 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect3 h4 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect2 h3 {
+ margin-left: -60px;
+ }
+
div.documentation-page table.frame-all {
border-left: none;
border-right: none;
@@ -1004,6 +1035,26 @@ For use with <code>@ViewModel</code>. If specifying view models using <code>@Dom
<td class="tableblock halign-left valign-top"><p class="tableblock">Domain</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rg_annotations_manpage-XmlRootElement"><code>javax.xml.bind</code><br>
+<code>.annotation</code><br>
+<code>XmlRootElement</code></a></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>JAXB annotation indicating the XML root element when serialized to XML; also used by the framework for view models (whose memento is the XML), often also acting as a DTO.</p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Application</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rg_annotations_manpage-XmlJavaTypeAdapter"><code>javax.xml.bind</code><br>
+<code>.annotation</code><br>
+<code>XmlJavaTypeAdapter</code></a></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>JAXB annotation defining how to serialize an entity. Used in conjunction with the (framework provided) <code>PersistentEntityAdapter</code> class to serialize persistent entities into a canonical OID (equivalent to the <code>Bookmark</code> provided by the <a href="#_rg_services-api_manpage-BookmarkService"><code>BookmarkService</code></a>).</p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Domain</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
</tbody>
</table>
</div>
@@ -1796,7 +1847,9 @@ This annotation indicates that transient instances of this class may be created
<td class="tableblock halign-left valign-top"><p class="tableblock">subtype of <code>ActionDomainEvent</code><br>
(<code>ActionDomainEvent.Default</code>)</p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>the event type to be posted to the <a href="#_rg_services-api_manpage-EventBusService"><code>EventBusService</code></a> to broadcast the action’s business rule checking (hide, disable, validate) and its invocation (pre-execute and post-execution).</p>
+<p>the event type to be posted to the <a href="#_rg_services-api_manpage-EventBusService"><code>EventBusService</code></a> to
+broadcast the action’s business rule checking (hide, disable, validate) and its invocation (pre-execute and
+post-execute).</p>
</div></div></td>
</tr>
<tr>
@@ -2123,7 +2176,10 @@ returned object from this action is the persisted <code>Command</code> itself.</
</div>
</div>
<div class="paragraph">
-<p>The purpose of the <code>domainEvent()</code> attribute is to allows a custom subclass to be emitted instead. This attribute is also supported for <a href="#_rg_annotations_manpage-Collection_domainEvent">collections</a> and <a href="#_rg_annotations_manpage-Property_domainEvent">properties</a>.</p>
+<p>The <code>domainEvent()</code> attribute allows a custom subclass to be emitted allowing more precise subscriptions (to those
+subclasses) to be defined instead. This attribute is also supported for
+<a href="#_rg_annotations_manpage-Collection_domainEvent">collections</a> and
+<a href="#_rg_annotations_manpage-Property_domainEvent">properties</a>.</p>
</div>
<div class="paragraph">
<p>For example:</p>
@@ -2165,11 +2221,10 @@ rather than through the constructor. This substantially reduces the boilerplate
</div>
<div class="listingblock">
<div class="content">
-<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainService</span>
-<span class="directive">public</span> <span class="type">class</span> <span class="class">SomeSubscriber</span> {
- <span class="annotation">@Programmatic</span>
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainService</span>(nature=NatureOfService.DOMAIN)
+<span class="directive">public</span> <span class="type">class</span> <span class="class">SomeSubscriber</span> <span class="directive">extends</span> AbstractSubscriber {
<span class="annotation">@com</span>.google.common.eventbus.Subscribe
- <span class="directive">public</span> <span class="type">void</span> on(ActionInteractionEvent ev) {
+ <span class="directive">public</span> <span class="type">void</span> on(ActionDomainEvent ev) {
...
}
}</code></pre>
@@ -2180,9 +2235,8 @@ rather than through the constructor. This substantially reduces the boilerplate
</div>
<div class="listingblock">
<div class="content">
-<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainService</span>
-<span class="directive">public</span> <span class="type">class</span> <span class="class">SomeSubscriber</span> {
- <span class="annotation">@Programmatic</span>
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainService</span>(nature=NatureOfService.DOMAIN)
+<span class="directive">public</span> <span class="type">class</span> <span class="class">SomeSubscriber</span> <span class="directive">extends</span> AbstractSubscriber {
<span class="annotation">@com</span>.google.common.eventbus.Subscribe
<span class="directive">public</span> <span class="type">void</span> on(ToDoItem.CompletedEvent ev) {
...
@@ -2258,6 +2312,26 @@ rather than through the constructor. This substantially reduces the boilerplate
</div>
</div>
<div class="sect4">
+<h5 id="_default_doop_and_noop_events_code_1_11_0_snapshot_code">Default, Doop and Noop events (<code>1.11.0-SNAPSHOT</code>)</h5>
+<div class="paragraph">
+<p>If the <code>domainEvent</code> attribute is not explicitly specified (is left as its default value, <code>ActionDomainEvent.Default</code>),
+then the framework will, by default, post an event.</p>
+</div>
+<div class="paragraph">
+<p>If this is not required, then the <code>isis.reflector.facet.actionAnnotation.domainEvent.postForDefault</code>
+configuration property can be set to "false"; this will disable posting.</p>
+</div>
+<div class="paragraph">
+<p>On the other hand, if the <code>domainEvent</code> has been explicitly specified to some subclass, then an event will be posted.
+The framework provides <code>ActionDomainEvent.Doop</code> as such a subclass, so setting the <code>domainEvent</code> attribute to this class
+will ensure that the event to be posted, irrespective of the configuration property setting.</p>
+</div>
+<div class="paragraph">
+<p>And, conversely, the framework also provides <code>ActionDomainEvent.Noop</code>; if <code>domainEvent</code> attribute is set to this class,
+then no event will be posted.</p>
+</div>
+</div>
+<div class="sect4">
<h5 id="_raising_events_programmatically">Raising events programmatically</h5>
<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="#_rg_services-api_manpage-EventBusService"><code>EventBusService</code></a> API directly, or by emulating the UI by
@@ -3533,7 +3607,10 @@ so that boilerplate-busting tools such as <a href="https://projectlombok.org/">P
</div>
</div>
<div class="paragraph">
-<p>The purpose of the <code>domainEvent()</code> attribute is to allows a custom subclass to be emitted instead. This attribute is also supported for <a href="#_rg_annotations_manpage-Action_domainEvent">actions</a> and <a href="#_rg_annotations_manpage-Property_domainEvent">properties</a>.</p>
+<p>The <code>domainEvent()</code> attribute allows a custom subclass to be emitted allowing more precise subscriptions (to those
+subclasses) to be defined instead. This attribute is also supported for
+<a href="#_rg_annotations_manpage-Action_domainEvent">actions</a> and
+<a href="#_rg_annotations_manpage-Property_domainEvent">properties</a>.</p>
</div>
<div class="paragraph">
<p>For example:</p>
@@ -3587,11 +3664,10 @@ rather than through the constructor. This substantially reduces the boilerplate
</div>
<div class="listingblock">
<div class="content">
-<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainService</span>
-<span class="directive">public</span> <span class="type">class</span> <span class="class">SomeSubscriber</span> {
- <span class="annotation">@Programmatic</span>
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainService</span>(nature=NatureOfService.DOMAIN)
+<span class="directive">public</span> <span class="type">class</span> <span class="class">SomeSubscriber</span> <span class="directive">extends</span> AbstractSubscriber {
<span class="annotation">@com</span>.google.common.eventbus.Subscribe
- <span class="directive">public</span> <span class="type">void</span> on(CollectionInteractionEvent ev) {
+ <span class="directive">public</span> <span class="type">void</span> on(CollectionDomainEvent ev) {
...
}
}</code></pre>
@@ -3602,9 +3678,8 @@ rather than through the constructor. This substantially reduces the boilerplate
</div>
<div class="listingblock">
<div class="content">
-<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainService</span>
-<span class="directive">public</span> <span class="type">class</span> <span class="class">SomeSubscriber</span> {
- <span class="annotation">@Programmatic</span>
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainService</span>(nature=NatureOfService.DOMAIN)
+<span class="directive">public</span> <span class="type">class</span> <span class="class">SomeSubscriber</span> <span class="directive">extends</span> AbstractSubscriber {
<span class="annotation">@com</span>.google.common.eventbus.Subscribe
<span class="directive">public</span> <span class="type">void</span> on(ToDoItem.DependenciesChangedEvent ev) {
...
@@ -3680,6 +3755,26 @@ rather than through the constructor. This substantially reduces the boilerplate
</div>
</div>
<div class="sect4">
+<h5 id="_default_doop_and_noop_events_code_1_11_0_snapshot_code_2">Default, Doop and Noop events (<code>1.11.0-SNAPSHOT</code>)</h5>
+<div class="paragraph">
+<p>If the <code>domainEvent</code> attribute is not explicitly specified (is left as its default value, <code>CollectionDomainEvent.Default</code>),
+then the framework will, by default, post an event.</p>
+</div>
+<div class="paragraph">
+<p>If this is not required, then the <code>isis.reflector.facet.collectionAnnotation.domainEvent.postForDefault</code>
+configuration collection can be set to "false"; this will disable posting.</p>
+</div>
+<div class="paragraph">
+<p>On the other hand, if the <code>domainEvent</code> has been explicitly specified to some subclass, then an event will be posted.
+The framework provides <code>CollectionDomainEvent.Doop</code> as such a subclass, so setting the <code>domainEvent</code> attribute to this class
+will ensure that the event to be posted, irrespective of the configuration collection setting.</p>
+</div>
+<div class="paragraph">
+<p>And, conversely, the framework also provides <code>CollectionDomainEvent.Noop</code>; if <code>domainEvent</code> attribute is set to this class,
+then no event will be posted.</p>
+</div>
+</div>
+<div class="sect4">
<h5 id="_raising_events_programmatically_2">Raising events programmatically</h5>
<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="#_rg_services-api_manpage-EventBusService"><code>EventBusService</code></a> API directly, or by emulating the UI by
@@ -5580,6 +5675,14 @@ can be used instead, eg:</p>
</div></div></td>
</tr>
<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rg_annotations_manpage-DomainObjectLayout_cssClassUiEvent"><code>cssClassUiEvent()</code></a></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">subtype of <code>CssClassUiEvent</code><br>
+(<code>CssClassUiEvent.Default</code>)</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>the event type to be posted (<code>1.11.0-SNAPSHOT</code>) to the <a href="#_rg_services-api_manpage-EventBusService"><code>EventBusService</code></a> to obtain a CSS class for the domain object.</p>
+</div></div></td>
+</tr>
+<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rg_annotations_manpage-DomainObjectLayout_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">
@@ -5587,6 +5690,14 @@ can be used instead, eg:</p>
</div></div></td>
</tr>
<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rg_annotations_manpage-DomainObjectLayout_iconUiEvent"><code>iconUiEvent()</code></a></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">subtype of <code>IconUiEvent</code><br>
+(<code>IconUiEvent.Default</code>)</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>the event type to be posted (<code>1.11.0-SNAPSHOT</code>) to the <a href="#_rg_services-api_manpage-EventBusService"><code>EventBusService</code></a> to obtain the icon (name) for the domain object.</p>
+</div></div></td>
+</tr>
+<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rg_annotations_manpage-DomainObjectLayout_named"><code>named()</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">
@@ -5610,6 +5721,14 @@ can be used instead, eg:</p>
<p>the plural name of the class</p>
</div></div></td>
</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rg_annotations_manpage-DomainObjectLayout_titleUiEvent"><code>titleUiEvent()</code></a></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">subtype of <code>TitleUiEvent</code><br>
+(<code>TitleUiEvent.Default</code>)</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>the event type to be posted (<code>1.11.0-SNAPSHOT</code>) to the <a href="#_rg_services-api_manpage-EventBusService"><code>EventBusService</code></a> to obtain the title for the domain object.</p>
+</div></div></td>
+</tr>
</tbody>
</table>
<div class="paragraph">
@@ -5813,57 +5932,103 @@ member so that it can be styled in an application-specific way.</p>
</div>
</div>
<div class="sect3">
-<h4 id="_rg_annotations_manpage-DomainObjectLayout_describedAs">2.10.4. <code>describedAs()</code></h4>
+<h4 id="_rg_annotations_manpage-DomainObjectLayout_cssClassUiEvent">2.10.4. cssClassUiEvent() (<code>1.11.0-SNAPSHOT</code>)</h4>
<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="ug.html#_ug_wicket-viewer">Wicket viewer</a> it is displayed as a 'tool tip'. The attribute can also be specified for <a href="#_rg_annotations_manpage-CollectionLayout_describedAs">collections</a>, <a href="#_rg_annotations_manpage-PropertyLayout_describedAs">properties</a>, <a href="#_rg_annotations_manpage-ActionLayout_describedAs">actions</a>, <a href="#_rg_annotations_manpage-ParameterLayout_describedAs">parameters</a> and <a href="#_rg_annotations_manpage-ViewModelLayout_describedAs">view models</a>.</p>
-</div>
-<div class="paragraph">
-<p>For example:</p>
+<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
+<a href="#_rg_methods_reserved_manpage-cssClass"><code>cssClass()</code></a> reserved method. (If <code>cssClass()</code> is present, then
+it will take precedence).</p>
</div>
-<div class="listingblock">
-<div class="content">
-<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DescribedAs</span>(<span class="string"><span class="delimiter">"</span><span class="content">A customer who may have originally become known to us via </span><span class="delimiter">"</span></span> +
- <span class="string"><span class="delimiter">"</span><span class="content">the marketing system or who may have contacted us directly.</span><span class="delimiter">"</span></span>)
-<span class="directive">public</span> <span class="type">class</span> <span class="class">ProspectiveSale</span> {
- ...
-}</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_rg_annotations_manpage-DomainObjectLayout_named">2.10.5. <code>named()</code></h4>
<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="#_rg_annotations_manpage-ActionLayout_named">actions</a>, <a href="#_rg_annotations_manpage-CollectionLayout_named">collections</a>, <a href="#_rg_annotations_manpage-PropertyLayout_named">properties</a>, <a href="#_rg_annotations_manpage-ParameterLayout_named">parameters</a>, <a href="#_rg_annotations_manpage-ViewModelLayout_named">view models</a> and <a href="#_rg_annotations_manpage-DomainServiceLayout_named">domain services</a>.</p>
+<p>Subscribers subscribe through the <a href="#_rg_services-api_manpage-EventBusService"><code>EventBusService</code></a> using either <a href="https://github.com/google/guava">Guava</a> or <a href="http://www.axonframework.org/">Axon Framework</a> annotations and can
+optionally specify a title.</p>
</div>
-<div class="admonitionblock tip">
+<div class="admonitionblock note">
<table>
<tr>
<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
+<i class="fa icon-note" title="Note"></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>
+<p>The feature was originally introduced so that <a href="#_rg_annotations_manpage-XmlRootElement"><code>@XmlRootElement</code></a>-annotated
+<a href="ug.html#_ug_more-advanced_view-models">view model</a>s could be kept as minimal as possible, just defining the data.
+UI events allow subscribers to provide UI hints, while <a href="ug.html#_ug_more-advanced_decoupling_mixins">mixin</a>s can be used to provide the behaviour.</p>
</div>
</td>
</tr>
</table>
</div>
<div class="paragraph">
+<p>By default the event raised is <code>CssClassUiEvent.Default</code>. For example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainObjectLayout</span>
+<span class="directive">public</span> <span class="type">class</span> <span class="class">ToDoItemDto</span> {
+ ...
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The purpose of the <code>cssClassUiEvent()</code> attribute is to allows a custom subclass to be emitted instead. A similar
+attribute is available for titles and icons.</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="annotation">@DomainObjectLayout</span>(
- named=<span class="string"><span class="delimiter">"</span><span class="content">Customer</span><span class="delimiter">"</span></span>
+ iconUiEvent=ToDoItemDto.CssClassUiEvent.class
)
-<span class="directive">public</span> <span class="type">class</span> <span class="class">CustomerImpl</span> <span class="directive">implements</span> Customer{
- ...
+<span class="directive">public</span> <span class="type">class</span> <span class="class">ToDoItemDto</span> {
+ <span class="directive">public</span> <span class="directive">static</span> <span class="type">class</span> <span class="class">CssClassUiEvent</span>
+ <span class="directive">extends</span> org.apache.isis.applib.services.eventbus.CssClassUiEvent<ToDoItemDto> { }
+ ...
}</code></pre>
</div>
</div>
<div class="paragraph">
-<p>It’s also possible to specify a <a href="#_rg_annotations_manpage-DomainObjectLayout_plural">plural form</a> of the name, used by the framework when rendering a standalone collection of the domain object.</p>
+<p>The benefit is that subscribers can be more targeted as to the events that they subscribe to.</p>
+</div>
+<div class="sect4">
+<h5 id="_subscribers_3">Subscribers</h5>
+<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="#_rg_services-api_manpage-EventBusService"><code>EventBusService</code></a> has been appropriately configured)
+using the <a href="http://www.axonframework.org/">Axon Framework</a> API. The examples below use the Guava API.</p>
+</div>
+<div class="paragraph">
+<p>Subscribers can be either coarse-grained (if they subscribe to the top-level event type):</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainService</span>(nature=NatureOfService.DOMAIN)
+<span class="directive">public</span> <span class="type">class</span> <span class="class">SomeSubscriber</span> <span class="directive">extends</span> AbstractSubscriber {
+ <span class="annotation">@com</span>.google.common.eventbus.Subscribe
+ <span class="directive">public</span> <span class="type">void</span> on(CssClassUiEvent ev) {
+ <span class="keyword">if</span>(ev.getSource() <span class="keyword">instanceof</span> ToDoItemDto) { ... }
+ }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>or can be fine-grained (by subscribing to specific event subtypes):</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainService</span>(nature=NatureOfService.DOMAIN)
+<span class="directive">public</span> <span class="type">class</span> <span class="class">SomeSubscriber</span> <span class="directive">extends</span> AbstractSubscriber {
+ <span class="annotation">@com</span>.google.common.eventbus.Subscribe
+ <span class="directive">public</span> <span class="type">void</span> on(ToDoItemDto.CssClassUiEvent ev) {
+ ...
+ }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The subscriber should then use <code>CssClassUiEvent#setCssClass(…​)</code> to actually specify the CSS class to be used.</p>
</div>
<div class="admonitionblock tip">
<table>
@@ -5873,94 +6038,481 @@ member so that it can be styled in an application-specific way.</p>
</td>
<td class="content">
<div class="paragraph">
-<p>The framework also provides a separate, powerful mechanism for <a href="ug.html#_ug_more-advanced_i18n">internationalization</a>.</p>
+<p>If the AxonFramework is being used, replace <code>@com.google.common.eventbus.Subscribe</code> with <code>@org.axonframework.eventhandling.annotation.EventHandler</code>.</p>
</div>
</td>
</tr>
</table>
</div>
</div>
+<div class="sect4">
+<h5 id="_default_doop_and_noop_events">Default, Doop and Noop events</h5>
+<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>
+</div>
+<div class="paragraph">
+<p>If this is not required, then the <code>isis.reflector.facet.domainObjectLayoutAnnotation.cssClassUiEvent.postForDefault</code>
+configuration property can be set to "false"; this will disable posting.</p>
+</div>
+<div class="paragraph">
+<p>On the other hand, if the <code>cssClassUiEvent</code> has been explicitly specified to some subclass, then an event will be posted.
+The framework provides <code>CssClassUiEvent.Doop</code> as such a subclass, so setting the <code>cssClassUiEvent</code> attribute to this class
+will ensure that the event to be posted, irrespective of the configuration property setting.</p>
+</div>
+<div class="paragraph">
+<p>And, conversely, the framework also provides <code>CssClassUiEvent.Noop</code>; if <code>cssClassUiEvent</code> attribute is set to this class,
+thn no event will be posted.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_raising_events_programmatically_3">Raising events programmatically</h5>
+<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="#_rg_services-api_manpage-EventBusService"><code>EventBusService</code></a> API directly, or as a result
+of calling the <a href="#_rg_services-api_manpage-DomainObjectContainer"><code>DomainObjectContainer</code></a>'s
+<code>cssClassOf(…​)</code> method.</p>
+</div>
+</div>
+</div>
<div class="sect3">
-<h4 id="_rg_annotations_manpage-DomainObjectLayout_paged">2.10.6. <code>paged()</code></h4>
+<h4 id="_rg_annotations_manpage-DomainObjectLayout_describedAs">2.10.5. <code>describedAs()</code></h4>
<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="#_rg_annotations_manpage-CollectionLayout_paged">collections</a> and <a href="#_rg_annotations_manpage-ViewModelLayout_paged">view models</a>.</p>
+<p>The <code>describedAs()</code> attribute is used to provide a short description of the domain object to the user. In the <a href="ug.html#_ug_wicket-viewer">Wicket viewer</a> it is displayed as a 'tool tip'. The attribute can also be specified for <a href="#_rg_annotations_manpage-CollectionLayout_describedAs">collections</a>, <a href="#_rg_annotations_manpage-PropertyLayout_describedAs">properties</a>, <a href="#_rg_annotations_manpage-ActionLayout_describedAs">actions</a>, <a href="#_rg_annotations_manpage-ParameterLayout_describedAs">parameters</a> and <a href="#_rg_annotations_manpage-ViewModelLayout_describedAs">view models</a>.</p>
</div>
-<div class="admonitionblock warning">
+<div class="paragraph">
+<p>For example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DescribedAs</span>(<span class="string"><span class="delimiter">"</span><span class="content">A customer who may have originally become known to us via </span><span class="delimiter">"</span></span> +
+ <span class="string"><span class="delimiter">"</span><span class="content">the marketing system or who may have contacted us directly.</span><span class="delimiter">"</span></span>)
+<span class="directive">public</span> <span class="type">class</span> <span class="class">ProspectiveSale</span> {
+ ...
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_rg_annotations_manpage-DomainObjectLayout_iconUiEvent">2.10.6. iconUiEvent() (<code>1.11.0-SNAPSHOT</code>)</h4>
+<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
+<a href="#_rg_methods_reserved_manpage-iconName"><code>iconName()</code></a> reserved method. (If <code>iconName()</code> is present, then
+it will take precedence).</p>
+</div>
+<div class="paragraph">
+<p>Subscribers subscribe through the <a href="#_rg_services-api_manpage-EventBusService"><code>EventBusService</code></a> using either <a href="https://github.com/google/guava">Guava</a> or <a href="http://www.axonframework.org/">Axon Framework</a> annotations and can
+optionally specify a title.</p>
+</div>
+<div class="admonitionblock note">
<table>
<tr>
<td class="icon">
-<i class="fa icon-warning" title="Warning"></i>
+<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="paragraph">
-<p>The <a href="ug.html#<em>ug_restfulobjects-viewer">RestfulObjects viewer</a> currently does not support paging. The <a href="ug.html#_ug_wicket-viewer">Wicket viewer</a> _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>
+<p>The feature was originally introduced so that <a href="#_rg_annotations_manpage-XmlRootElement"><code>@XmlRootElement</code></a>-annotated
+<a href="ug.html#_ug_more-advanced_view-models">view model</a>s could be kept as minimal as possible, just defining the data.
+UI events allow subscribers to provide UI hints, while <a href="ug.html#_ug_more-advanced_decoupling_mixins">mixin</a>s can be used to provide the behaviour.</p>
</div>
</td>
</tr>
</table>
</div>
<div class="paragraph">
-<p>For example:</p>
+<p>By default the event raised is <code>IconUiEvent.Default</code>. For example:</p>
</div>
<div class="listingblock">
<div class="content">
-<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainObjectLayout</span>(paged=<span class="integer">15</span>)
-<span class="directive">public</span> <span class="type">class</span> <span class="class">Order</span> {
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainObjectLayout</span>
+<span class="directive">public</span> <span class="type">class</span> <span class="class">ToDoItemDto</span> {
...
}</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="#_rg_runtime_configuring-core">configuration property</a> <code>isis.viewer.paged.standalone</code>.</p>
+<p>The purpose of the <code>iconUiEvent()</code> attribute is to allows a custom subclass to be emitted instead. A similar
+attribute is available for titles and CSS classes.</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="annotation">@DomainObjectLayout</span>(
+ iconUiEvent=ToDoItemDto.IconUiEvent.class
+)
+<span class="directive">public</span> <span class="type">class</span> <span class="class">ToDoItemDto</span> {
+ <span class="directive">public</span> <span class="directive">static</span> <span class="type">class</span> <span class="class">IconUiEvent</span>
+ <span class="directive">extends</span> org.apache.isis.applib.services.eventbus.IconUiEvent<ToDoItemDto> { }
+ ...
+}</code></pre>
</div>
</div>
-<div class="sect3">
-<h4 id="_rg_annotations_manpage-DomainObjectLayout_plural">2.10.7. <code>plural()</code></h4>
<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>
+<p>The benefit is that subscribers can be more targeted as to the events that they subscribe to.</p>
</div>
+<div class="sect4">
+<h5 id="_subscribers_4">Subscribers</h5>
<div class="paragraph">
-<p>By default the plural name will be derived from the end of the singular name, with support for some basic English language defaults (eg using "ies" for names ending with a "y").</p>
+<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="#_rg_services-api_manpage-EventBusService"><code>EventBusService</code></a> has been appropriately configured)
+using the <a href="http://www.axonframework.org/">Axon Framework</a> API. The examples below use the Guava API.</p>
</div>
<div class="paragraph">
-<p>The <code>plural()</code> attribute allows the plural form of the class name to be specified explicitly. This attribute is also supported for <a href="#_rg_annotations_manpage-ViewModelLayout_plural">view models</a>.</p>
+<p>Subscribers can be either coarse-grained (if they subscribe to the top-level event type):</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainService</span>(nature=NatureOfService.DOMAIN)
+<span class="directive">public</span> <span class="type">class</span> <span class="class">SomeSubscriber</span> <span class="directive">extends</span> AbstractSubscriber {
+ <span class="annotation">@com</span>.google.common.eventbus.Subscribe
+ <span class="directive">public</span> <span class="type">void</span> on(IconUiEvent ev) {
+ <span class="keyword">if</span>(ev.getSource() <span class="keyword">instanceof</span> ToDoItemDto) { ... }
+ }
+}</code></pre>
+</div>
</div>
<div class="paragraph">
-<p>For example:</p>
+<p>or can be fine-grained (by subscribing to specific event subtypes):</p>
</div>
<div class="listingblock">
<div class="content">
-<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainObjectLayout</span>(plural=<span class="string"><span class="delimiter">"</span><span class="content">Children</span><span class="delimiter">"</span></span>)
-<span class="directive">public</span> <span class="type">class</span> <span class="class">Child</span> {
- ...
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainService</span>(nature=NatureOfService.DOMAIN)
+<span class="directive">public</span> <span class="type">class</span> <span class="class">SomeSubscriber</span> <span class="directive">extends</span> AbstractSubscriber {
+ <span class="annotation">@com</span>.google.common.eventbus.Subscribe
+ <span class="directive">public</span> <span class="type">void</span> on(ToDoItemDto.IconUiEvent ev) {
+ ...
+ }
}</code></pre>
</div>
</div>
+<div class="paragraph">
+<p>The subscriber should then use <code>IconUiEvent#setIconName(…​)</code> to actually specify the icon name to be used.</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>If the AxonFramework is being used, replace <code>@com.google.common.eventbus.Subscribe</code> with <code>@org.axonframework.eventhandling.annotation.EventHandler</code>.</p>
</div>
-<div class="sect2">
-<h3 id="_rg_annotations_manpage-DomainService">2.11. <code>@DomainService</code></h3>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_default_doop_and_noop_events_2">Default, Doop and Noop events</h5>
<div class="paragraph">
-<p>The <code>@DomainService</code> annotation indicates that the (concrete) class should be automatically instantiated as a domain service.</p>
+<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>
</div>
<div class="paragraph">
-<p>Domain services with this annotation do NOT need to be registered explicitly in <code>isis.properties</code>; they will be
-discovered automatically on the CLASSPATH.</p>
+<p>If this is not required, then the <code>isis.reflector.facet.domainObjectLayoutAnnotation.iconUiEvent.postForDefault</code>
+configuration property can be set to "false"; this will disable posting.</p>
</div>
<div class="paragraph">
-<p>The table below summarizes the annotation’s attributes.</p>
+<p>On the other hand, if the <code>iconUiEvent</code> has been explicitly specified to some subclass, then an event will be posted.
+The framework provides <code>IconUiEvent.Doop</code> as such a subclass, so setting the <code>iconUiEvent</code> attribute to this class
+will ensure that the event to be posted, irrespective of the configuration property setting.</p>
</div>
-<table class="tableblock frame-all grid-all spread">
-<caption class="title">Table 14. <code>@DomainService</code> attributes</caption>
-<colgroup>
-<col style="width: 25%;">
-<col style="width: 25%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
+<div class="paragraph">
+<p>And, conversely, the framework also provides <code>IconUiEvent.Noop</code>; if <code>iconUiEvent</code> attribute is set to this class,
+then no event will be posted.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_raising_events_programmatically_4">Raising events programmatically</h5>
+<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="#_rg_services-api_manpage-EventBusService"><code>EventBusService</code></a> API directly, or as a result
+of calling the <a href="#_rg_services-api_manpage-DomainObjectContainer"><code>DomainObjectContainer</code></a>'s
+<code>iconNameOf(…​)</code> method.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_rg_annotations_manpage-DomainObjectLayout_named">2.10.7. <code>named()</code></h4>
+<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="#_rg_annotations_manpage-ActionLayout_named">actions</a>, <a href="#_rg_annotations_manpage-CollectionLayout_named">collections</a>, <a href="#_rg_annotations_manpage-PropertyLayout_named">properties</a>, <a href="#_rg_annotations_manpage-ParameterLayout_named">parameters</a>, <a href="#_rg_annotations_manpage-ViewModelLayout_named">view models</a> and <a href="#_rg_annotations_manpage-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>For example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainObjectLayout</span>(
+ named=<span class="string"><span class="delimiter">"</span><span class="content">Customer</span><span class="delimiter">"</span></span>
+)
+<span class="directive">public</span> <span class="type">class</span> <span class="class">CustomerImpl</span> <span class="directive">implements</span> Customer{
+ ...
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>It’s also possible to specify a <a href="#_rg_annotations_manpage-DomainObjectLayout_plural">plural form</a> of the name, used by the framework when rendering a standalone collection of the domain object.</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>The framework also provides a separate, powerful mechanism for <a href="ug.html#_ug_more-advanced_i18n">internationalization</a>.</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_rg_annotations_manpage-DomainObjectLayout_paged">2.10.8. <code>paged()</code></h4>
+<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="#_rg_annotations_manpage-CollectionLayout_paged">collections</a> and <a href="#_rg_annotations_manpage-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="ug.html#<em>ug_restfulobjects-viewer">RestfulObjects viewer</a> currently does not support paging. The <a href="ug.html#_ug_wicket-viewer">Wicket viewer</a> _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="annotation">@DomainObjectLayout</span>(paged=<span class="integer">15</span>)
+<span class="directive">public</span> <span class="type">class</span> <span class="class">Order</span> {
+ ...
+}</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="#_rg_runtime_configuring-core">configuration property</a> <code>isis.viewer.paged.standalone</code>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_rg_annotations_manpage-DomainObjectLayout_plural">2.10.9. <code>plural()</code></h4>
+<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>
+<div class="paragraph">
+<p>By default the plural name will be derived from the end of the singular name, with support for some basic English language defaults (eg using "ies" for names ending with a "y").</p>
+</div>
+<div class="paragraph">
+<p>The <code>plural()</code> attribute allows the plural form of the class name to be specified explicitly. This attribute is also supported for <a href="#_rg_annotations_manpage-ViewModelLayout_plural">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="annotation">@DomainObjectLayout</span>(plural=<span class="string"><span class="delimiter">"</span><span class="content">Children</span><span class="delimiter">"</span></span>)
+<span class="directive">public</span> <span class="type">class</span> <span class="class">Child</span> {
+ ...
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_rg_annotations_manpage-DomainObjectLayout_titleUiEvent">2.10.10. titleUiEvent() (<code>1.11.0-SNAPSHOT</code>)</h4>
+<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="#_rg_methods_reserved_manpage-title"><code>title()</code></a> reserved method, or
+using the <a href="#_rg_annotations_manpage-Title"><code>@Title</code></a> annotation, within the class itself. (If either
+<code>title()</code> or <code>@Title</code> are present, then they will take precedence).</p>
+</div>
+<div class="paragraph">
+<p>Subscribers subscribe through the <a href="#_rg_services-api_manpage-EventBusService"><code>EventBusService</code></a> using either <a href="https://github.com/google/guava">Guava</a> or <a href="http://www.axonframework.org/">Axon Framework</a> annotations and can
+optionally specify a title.</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>The feature was originally introduced so that <a href="#_rg_annotations_manpage-XmlRootElement"><code>@XmlRootElement</code></a>-annotated
+<a href="ug.html#_ug_more-advanced_view-models">view model</a>s could be kept as minimal as possible, just defining the data.
+UI events allow subscribers to provide UI hints, while <a href="ug.html#_ug_more-advanced_decoupling_mixins">mixin</a>s can be used to provide the behaviour.</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>By default the event raised is <code>TitleUiEvent.Default</code>. For example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainObjectLayout</span>
+<span class="directive">public</span> <span class="type">class</span> <span class="class">ToDoItemDto</span> {
+ ...
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The purpose of the <code>titleUiEvent()</code> attribute is to allows a custom subclass to be emitted instead. A similar
+attribute is available for icon names and CSS classes.</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="annotation">@DomainObjectLayout</span>(
+ titleUiEvent=ToDoItemDto.TitleUiEvent.class
+)
+<span class="directive">public</span> <span class="type">class</span> <span class="class">ToDoItemDto</span> {
+ <span class="directive">public</span> <span class="directive">static</span> <span class="type">class</span> <span class="class">TitleUiEvent</span>
+ <span class="directive">extends</span> org.apache.isis.applib.services.eventbus.TitleUiEvent<ToDoItemDto> { }
+ ...
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The benefit is that subscribers can be more targeted as to the events that they subscribe to.</p>
+</div>
+<div class="sect4">
+<h5 id="_subscribers_5">Subscribers</h5>
+<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="#_rg_services-api_manpage-EventBusService"><code>EventBusService</code></a> has been appropriately configured)
+using the <a href="http://www.axonframework.org/">Axon Framework</a> API. The examples below use the Guava API.</p>
+</div>
+<div class="paragraph">
+<p>Subscribers can be either coarse-grained (if they subscribe to the top-level event type):</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainService</span>(nature=NatureOfService.DOMAIN)
+<span class="directive">public</span> <span class="type">class</span> <span class="class">SomeSubscriber</span> <span class="directive">extends</span> AbstractSubscriber {
+ <span class="annotation">@com</span>.google.common.eventbus.Subscribe
+ <span class="directive">public</span> <span class="type">void</span> on(TitleUiEvent ev) {
+ <span class="keyword">if</span>(ev.getSource() <span class="keyword">instanceof</span> ToDoItemDto) { ... }
+ }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>or can be fine-grained (by subscribing to specific event subtypes):</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainService</span>(nature=NatureOfService.DOMAIN)
+<span class="directive">public</span> <span class="type">class</span> <span class="class">SomeSubscriber</span> <span class="directive">extends</span> AbstractSubscriber {
+ <span class="annotation">@com</span>.google.common.eventbus.Subscribe
+ <span class="directive">public</span> <span class="type">void</span> on(ToDoItemDto.TitleUiEvent ev) {
+ ...
+ }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The subscriber should then use either <code>TitleUiEvent#setTranslatableTitle(…​)</code> or <code>TitleUiEvent#setTitle(…​)</code> to
+actually specify the title to be used.</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>If the AxonFramework is being used, replace <code>@com.google.common.eventbus.Subscribe</code> with <code>@org.axonframework.eventhandling.annotation.EventHandler</code>.</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_default_doop_and_noop_events_3">Default, Doop and Noop events</h5>
+<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>
+</div>
+<div class="paragraph">
+<p>If this is not required, then the <code>isis.reflector.facet.domainObjectLayoutAnnotation.titleUiEvent.postForDefault</code>
+configuration property can be set to "false"; this will disable posting.</p>
+</div>
+<div class="paragraph">
+<p>On the other hand, if the <code>titleUiEvent</code> has been explicitly specified to some subclass, then an event will be posted.
+The framework provides <code>TitleUiEvent.Doop</code> as such a subclass, so setting the <code>titleUiEvent</code> attribute to this class
+will ensure that the event to be posted, irrespective of the configuration property setting.</p>
+</div>
+<div class="paragraph">
+<p>And, conversely, the framework also provides <code>TitleUiEvent.Noop</code>; if <code>titleUiEvent</code> attribute is set to this class,
+thn no event will be posted.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_raising_events_programmatically_5">Raising events programmatically</h5>
+<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="#_rg_services-api_manpage-EventBusService"><code>EventBusService</code></a> API directly, or as a result
+of calling the <a href="#_rg_services-api_manpage-DomainObjectContainer"><code>DomainObjectContainer</code></a>'s
+<code>titleOf(…​)</code> method.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_rg_annotations_manpage-DomainService">2.11. <code>@DomainService</code></h3>
+<div class="paragraph">
+<p>The <code>@DomainService</code> annotation indicates that the (concrete) class should be automatically instantiated as a domain service.</p>
+</div>
+<div class="paragraph">
+<p>Domain services with this annotation do NOT need to be registered explicitly in <code>isis.properties</code>; they will be
+discovered automatically on the CLASSPATH.</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 14. <code>@DomainService</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>
@@ -8132,7 +8684,10 @@ so that boilerplate-busting tools such as <a href="https://projectlombok.org/">P
</div>
</div>
<div class="paragraph">
-<p>The purpose of the <code>domainEvent()</code> attribute is to allows a custom subclass to be emitted instead. This attribute is also supported for <a href="#_rg_annotations_manpage-Action_domainEvent">actions</a> and <a href="#_rg_annotations_manpage-Property_domainEvent">properties</a>.</p>
+<p>The <code>domainEvent()</code> attribute allows a custom subclass to be emitted allowing more precise subscriptions (to those
+subclasses) to be defined instead. This attribute is also supported for
+ <a href="#_rg_annotations_manpage-Action_domainEvent">actions</a> and
+ <a href="#_rg_annotations_manpage-Property_domainEvent">properties</a>.</p>
</div>
<div class="paragraph">
<p>For example:</p>
@@ -8174,7 +8729,7 @@ rather than through the constructor. This substantially reduces the boilerplate
</table>
</div>
<div class="sect4">
-<h5 id="_subscribers_3">Subscribers</h5>
+<h5 id="_subscribers_6">Subscribers</h5>
<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="#_rg_services-api_manpage-EventBusService"><code>EventBusService</code></a> has been appropriately configured) using the <a href="http://www.axonframework.org/">Axon Framework</a> API. The examples below use the Guava API.</p>
</div>
@@ -8183,16 +8738,12 @@ rather than through the constructor. This substantially reduces the boilerplate
</div>
<div class="listingblock">
<div class="content">
-<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainService</span>
-<span class="directive">public</span> <span class="type">class</span> <span class="class">SomeSubscriber</span> {
-
- <span class="annotation">@Programmatic</span>
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainService</span>(nature=NatureOfService.DOMAIN)
+<span class="directive">public</span> <span class="type">class</span> <span class="class">SomeSubscriber</span> <span class="directive">extends</span> AbstractSubscriber {
<span class="annotation">@com</span>.google.common.eventbus.Subscribe
- <span class="directive">public</span> <span class="type">void</span> on(PropertyInteractionEvent ev) {
-
+ <span class="directive">public</span> <span class="type">void</span> on(PropertyDomainEvent ev) {
...
}
-
}</code></pre>
</div>
</div>
@@ -8201,16 +8752,12 @@ rather than through the constructor. This substantially reduces the boilerplate
</div>
<div class="listingblock">
<div class="content">
-<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainService</span>
-<span class="directive">public</span> <span class="type">class</span> <span class="class">SomeSubscriber</span> {
-
- <span class="annotation">@Programmatic</span>
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainService</span>(nature=NatureOfService.DOMAIN)
+<span class="directive">public</span> <span class="type">class</span> <span class="class">SomeSubscriber</span> <span class="directive">extends</span> AbstractSubscriber {
<span class="annotation">@com</span>.google.common.eventbus.Subscribe
<span class="directive">public</span> <span class="type">void</span> on(ToDoItem.DueByChangedEvent ev) {
-
...
}
-
}</code></pre>
</div>
</div>
@@ -8282,15 +8829,35 @@ rather than through the constructor. This substantially reduces the boilerplate
</div>
</div>
<div class="sect4">
-<h5 id="_raising_events_programmatically_3">Raising events programmatically</h5>
+<h5 id="_default_doop_and_noop_events_code_1_11_0_snapshot_code_3">Default, Doop and Noop events (<code>1.11.0-SNAPSHOT</code>)</h5>
<div class="paragraph">
-<p>Normally events are only raised for interactions through the UI. However, events can be raised programmatically by
-wrapping the target object using the <a href="#_rg_services-api_manpage-WrapperFactory"><code>WrapperFactory</code></a> service.</p>
+<p>If the <code>domainEvent</code> attribute is not explicitly specified (is left as its default value, <code>PropertyDomainEvent.Default</code>),
+then the framework will, by default, post an event.</p>
</div>
+<div class="paragraph">
+<p>If this is not required, then the <code>isis.reflector.facet.propertyAnnotation.domainEvent.postForDefault</code>
+configuration property can be set to "false"; this will disable posting.</p>
</div>
+<div class="paragraph">
+<p>On the other hand, if the <code>domainEvent</code> has been explicitly specified to some subclass, then an event will be posted.
+The framework provides <code>PropertyDomainEvent.Doop</code> as such a subclass, so setting the <code>domainEvent</code> attribute to this class
+will ensure that the event to be posted, irrespective of the configuration property setting.</p>
</div>
-<div class="sect3">
-<h4 id="_rg_annotations_manpage-Property_editing">2.27.2. <code>editing()</code></h4>
+<div class="paragraph">
+<p>And, conversely, the framework also provides <code>PropertyDomainEvent.Noop</code>; if <code>domainEvent</code> attribute is set to this class,
+then no event will be posted.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_raising_events_programmatically_6">Raising events programmatically</h5>
+<div class="paragraph">
+<p>Normally events are only raised for interactions through the UI. However, events can be raised programmatically by
+wrapping the target object using the <a href="#_rg_services-api_manpage-WrapperFactory"><code>WrapperFactory</code></a> service.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_rg_annotations_manpage-Property_editing">2.27.2. <code>editing()</code></h4>
<div class="paragraph">
<p>The <code>editing()</code> attribute can be used to prevent a property from being modified or cleared, ie to make it read-only. This attribute can also be specified for <a href="#_rg_annotations_manpage-Collection_editing">collections</a>, and can also be specified for the <a href="#_rg_annotations_manpage-DomainObject_editing">domain object</a>.</p>
</div>
@@ -9853,6 +10420,146 @@ for symmetry with domain objects that have been annotated using <a href="#_rg_an
</div>
</div>
</div>
+<div class="sect2">
+<h3 id="_rg_annotations_manpage-XmlJavaTypeAdapter">2.33. <code>@XmlJavaTypeAdapter</code> (<code>jaxb</code>) (<code>1.11.0-SNAPSHOT</code>)</h3>
+<div class="paragraph">
+<p>The JAXB <code>@XmlJavaTypeAdapter</code> annotation (<code>1.11.0-SNAPSHOT</code>) is used with the framework-provided
+<code>PersistentEntityAdapter</code> to instruct JAXB to serialize references to persistent entities using the canonical
+<code>OidDto</code> complex type: the object’s type and its identifier. This is the formal XML equivalent to the <code>Bookmark</code>
+provided by the <a href="#_rg_services-api_manpage-BookmarkService"><code>BookmarkService</code></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="annotation">@XmlJavaTypeAdapter</span>(PersistentEntityAdapter.class)
+<span class="directive">public</span> <span class="type">class</span> <span class="class">ToDoItem</span> ... {
+ ...
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This annotation therefore allows view models/DTOs to have references to persistent entities; a common idiom.</p>
+</div>
+<div class="paragraph">
+<p>For a more complete discussion of writing JAXB view models/DTOs, see <a href="ug.html#_ug_more-advanced_view-models">this topic</a>
+in the user guide.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_rg_annotations_manpage-XmlRootElement">2.34. <code>@XmlRootElement</code> (<code>jaxb</code>) (<code>1.11.0-SNAPSHOT</code>)</h3>
+<div class="paragraph">
+<p>The <code>@XmlRootElement</code> annotation (<code>1.11.0-SNAPSHOT</code>) provides an alternative way to define a
+<a href="#_ug_more-advanced_view-models">view model</a>, in particular one intended to act as a DTO for use within
+<a href="ug.html#_ug_restfulobjects-viewer">RestfulObjects viewer</a>, or which contains arbitrarily complex state.</p>
+</div>
+<div class="paragraph">
+<p>A view model is a non-persisted domain object whose state is converted to/from a string memento. In the case of a
+JAXB-annotated object this memento is its XML representation. JAXB generally requires that the root element of the
+XML representation is annotated with <code>@XmlRootElement</code>. Apache Isis makes this a mandatory requirement.</p>
+</div>
+<div class="paragraph">
+<p>In comparison to using either the <a href="#_rg_classes_super_manpage-ViewModel"><code>ViewModel</code></a> interface or the
+<a href="#_rg_annotations_manpage-ViewModel"><code>@ViewModel</code></a> annotation, using <code>@XmlRootElement</code> has a couple of
+significant advantages:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>the view model can be used as a "canonical" DTO, for example when accessing data using the
+<a href="ug.html#_ug_restfulobjects-viewer">RestfulObjects viewer</a> in combination with the
+<a href="#_rg_services-spi_manpage-ContentMappingService"><code>ContentMappingService</code></a>.<br></p>
+<div class="paragraph">
+<p>This provides a stable and
+versioned API to access data in XML format using whatever client-side technology may be appropriate.</p>
+</div>
+</li>
+<li>
+<p>the XML graph can be as deep as required; in particular it can contain collections of other objects.<br></p>
+<div class="paragraph">
+<p>In contrast, if the <code>@ViewModel</code> annotation is used then only the state of the properties (not collections) is captured.
+If using <code>ViewModel</code> interface then arbitrary state (including that of collections), however the programmer must write
+all the code by hand</p>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The main disadvantages of using JAXB-annotated view models is that any referenced persistent entity must be annotated
+with the <a href="#_rg_annotations_manpage-XmlJavaTypeAdapter"><code>@XmlJavaTypeAdapter</code></a>, using the
+framework-provided <code>PersistentEntityAdapter</code>. This adapter converts any references to such domain entities using the
+<code>oidDto</code> complex type (as defined by the Apache Isis <a href="#_rg_schema-common">common schema</a>):
+the object’s type and its identifier.</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>The memento string for view models is converted into a form compatible with use within a URL. This is performed by the
+<a href="#_rg_services-spi_manpage-UrlEncodingService"><code>UrlEncodingService</code></a>, the default implementation of which
+simply encodes to base 64. If the view model XML graph is too large to be serialized to a string, then an alternative
+implementation (eg which maps XML strings to a GUID, say) can be configured using the technique described in
+<a href="#_ug_how-tos_replacing-default-service-implementations">here</a> in the user guide.</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="sect3">
+<h4 id="_example">2.34.1. Example</h4>
+<div class="paragraph">
+<p>This example is taken from the (non-ASF) <a href="http://github.com/isisaddons/isis-app-todoapp">Isis addons' todoapp</a>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@XmlRootElement</span>(name = <span class="string"><span class="delimiter">"</span><span class="content">toDoItemDto</span><span class="delimiter">"</span></span>) <i class="conum" data-value="1"></i><b>(1)</b>
+<span class="directive">public</span> <span class="type">class</span> <span class="class">ToDoItemDto</span> <span class="directive">implements</span> Dto {
+ <span class="annotation">@Getter</span> <span class="annotation">@Setter</span> <i class="conum" data-value="2"></i><b>(2)</b>
+ <span class="directive">protected</span> <span class="predefined-type">String</span> description;
+ <span class="annotation">@Getter</span> <span class="annotation">@Setter</span>
+ <span class="directive">protected</span> <span class="predefined-type">String</span> category;
+ <span class="annotation">@Getter</span> <span class="annotation">@Setter</span>
+ <span class="directive">protected</span> <span class="predefined-type">String</span> subcategory;
+ <span class="annotation">@Getter</span> <span class="annotation">@Setter</span>
+ <span class="directive">protected</span> <span class="predefined-type">BigDecimal</span> cost;
+}</code></pre>
+</div>
+</div>
+<div class="colist arabic">
+<table>
+<tr>
+<td><i class="conum" data-value="1"></i><b>1</b></td>
+<td>identifies this class as a view model and defines the root element for JAXB serialization</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="2"></i><b>2</b></td>
+<td>using Project Lombok for getters and setters</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_see_also">2.34.2. See also</h4>
+<div class="paragraph">
+<p>Although (like any other viewmodel) a JAXB-annotated can have behaviour (actions) and UI hints, you may wish to keep
+the DTO "clean", just focused on specifying the data contract.</p>
+</div>
+<div class="paragraph">
+<p>Behaviour can therefore be provided using <a href="ug.html#_ug_more-advanced_decoupling_mixins">mixins</a> (annotated with
+<a href="#_rg_annotations_manpage-Mixin"><code>@Mixin</code></a>), while <a href="#_rg_classes_uievent">UI events</a> can be used
+to obtain title, icons and so on.</p>
+</div>
+<div class="paragraph">
+<p>For a more complete discussion of writing JAXB view models/DTOs, see <a href="ug.html#_ug_more-advanced_view-models">this topic</a>
+in the user guide.</p>
+</div>
+</div>
+</div>
</div>
</div>
<div class="sect1">
@@ -12328,6 +13035,22 @@ SpecificationProvider</code></a>.</p>
<td class="tableblock halign-left valign-top"><div></div></td>
</tr>
<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rg_services-api_manpage-JaxbService"><code>o.a.i.applib.</code><br>
+<code>services.jaxb</code><br>
+<code>JaxbService</code></a></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>Marshal and unmarshal JAXB-annotated view models to/from XML.</p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><code>JaxbServiceDefault</code><br>
+<code>o.a.i.core</code><br>
+<code>isis-core-schema</code></p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><code>1.11.0-SNAPSHOT</code>.</p>
+</div></div></td>
+</tr>
+<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rg_services-api_manpage-MementoService"><code>o.a.i.applib.</code><br>
<code>services.memento</code><br>
<code>MementoService</code></a></p></td>
@@ -12590,15 +13313,14 @@ SpecificationProvider</code></a>.</p>
<h4 id="_registering_the_service">4.1.3. Registering the Service</h4>
<div class="paragraph">
<p>Assuming that the <code>configuration-and-annotation</code> services installer is configured (implicit if using the
-<code>AppManifest</code> to <a href="#_rg_classes_AppManifest-bootstrapping">bootstrap the app</a>):</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="CodeRay highlight"><code data-lang="ini">isis.services-installer=configuration-and-annotation</code></pre>
-</div>
+<code>AppManifest</code> to <a href="#_rg_classes_AppManifest-bootstrapping">bootstrap the app</a>) then Apache Isis' default
+implementation of <code>ActionInvocationContext</code> class is automatically registered (it is annotated with <code>@DomainService</code>)
+so no further configuration is required.</p>
</div>
<div class="paragraph">
-<p>then Isis' default implementation of <code>ActionInvocationContext</code> class is automatically registered (it is annotated with <code>@DomainService</code>) so no further configuration is required.</p>
+<p>To use an alternative implementation, use
+<a href="#_rg_annotations_manpage-DomainServiceLayout_menuOrder"><code>@DomainServiceLayout#menuOrder()</code></a> (as explained
+further in this <a href="ug.html#_ug_how-tos_replacing-default-service-implementations">"how to"</a> tip).</p>
</div>
</div>
<div class="sect3">
@@ -12745,15 +13467,14 @@ CommandContext commandContext; <i class="conum" data-value="1"></i><b>(1)</b></
<h4 id="_registering_the_services">4.2.4. Registering the Services</h4>
<div class="paragraph">
<p>Assuming that the <code>configuration-and-annotation</code> services installer is configured (implicit if using the
-<code>AppManifest</code> to <a href="#_rg_classes_AppManifest-bootstrapping">bootstrap the app</a>):</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="CodeRay highlight"><code data-lang="ini">isis.services-installer=configuration-and-annotation</code></pre>
-</div>
+<code>AppManifest</code> to <a href="#_rg_classes_AppManifest-bootstrapping">bootstrap the app</a>) then Apache Isis' core
+implementation of <code>BackgroundService</code> is automatically registered (it is annotated with <code>@DomainService</code>) so no
+further configuration is required.</p>
</div>
<div class="paragraph">
-<p>then Apache Isis' core implementation of <code>BackgroundService</code> is automatically registered (it is annotated with <code>@DomainService</code>) so no further configuration is required.</p>
+<p>To use an alternative implementation, use
+<a href="#_rg_annotations_manpage-DomainServiceLayout_menuOrder"><code>@DomainServiceLayout#menuOrder()</code></a> (as explained
+further in this <a href="ug.html#_ug_how-tos_replacing-default-service-implementations">"how to"</a> tip).</p>
</div>
</div>
<div class="sect3">
@@ -13095,15 +13816,14 @@ org.quartz.plugin.jobInitializer.failOnFileNotFound = true</code></pre>
<h4 id="_registering_the_service_2">4.3.4. Registering the Service</h4>
<div class="paragraph">
<p>Assuming that the <code>configuration-and-annotation</code> services installer is configured (implicit if using the
-<code>AppManifest</code> to <a href="#_rg_classes_AppManifest-bootstrapping">bootstrap the app</a>):</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="CodeRay highlight"><code data-lang="ini">isis.services-installer=configuration-and-annotation</code></pre>
-</div>
+<code>AppManifest</code> to <a href="#_rg_classes_AppManifest-bootstrapping">bootstrap the app</a>) then Apache Isis' core
+implementation of <code>BookmarkService</code> is automatically registered (it is annotated with <code>@DomainService</code>) so no further
+configuration is required.</p>
</div>
<div class="paragraph">
-<p>then Apache Isis' core implementation of <code>BookmarkService</code> is automatically registered (it is annotated with <code>@DomainService</code>) so no further configuration is required.</p>
+<p>To use an alternative implementation, use
+<a href="#_rg_annotations_manpage-DomainServiceLayout_menuOrder"><code>@DomainServiceLayout#menuOrder()</code></a> (as explained
+further in this <a href="ug.html#_ug_how-tos_replacing-default-service-implementations">"how to"</a> tip).</p>
</div>
</div>
</div>
@@ -13225,18 +13945,13 @@ org.quartz.plugin.jobInitializer.failOnFileNotFound = true</code></pre>
<h4 id="_registering_the_service_3">4.4.3. Registering the Service</h4>
<div class="paragraph">
<p>Assuming that the <code>configuration-and-annotation</code> services installer is configured (implicit if using the
-<code>AppManifest</code> to <a href="#_rg_classes_AppManifest-bootstrapping">bootstrap the app</a>):</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="CodeRay highlight"><code data-lang="ini">isis.services-installer=configuration-and-annotation</code></pre>
-</div>
+<code>AppManifest</code> to <a href="#_rg_classes_AppManifest-bootstrapping">bootstrap the app</a>) then Apache Isis' core
+implementation of <code>ClockService</code> is automatically registered (it is annotated with <code>@DomainService</code>) so no further
+configuration is required.</p>
</div>
<div class="paragraph">
-<p>then Apache Isis' core implementation of <code>ClockService</code> is automatically registered (it is annotated with <code>@DomainService</code>) so no further configuration is required.</p>
-</div>
-<div class="paragraph">
-<p>If you want to use a different implementation of <code>Clock</code>, eg delegating to NNTP, then do <em>not</em> register directly, but instead subclass from <code>o.a.i.applib.clock.Clock</code> singleton (as described in the section above).</p>
+<p>If you want to use a different implementation of <code>Clock</code>, eg delegating to NNTP, then do <em>not</em> register directly, but
+instead subclass from <code>o.a.i.applib.clock.Clock</code> singleton (as described in the section above).</p>
</div>
</div>
</div>
@@ -13526,15 +14241,14 @@ org.quartz.plugin.jobInitializer.failOnFileNotFound = true</code></pre>
<h4 id="_registering_the_services_2">4.5.5. Registering the Services</h4>
<div class="paragraph">
<p>Assuming that the <code>configuration-and-annotation</code> services installer is configured (implicit if using the
-<code>AppManifest</code> to <a href="#_rg_classes_AppManifest-bootstrapping">bootstrap the app</a>):</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="CodeRay highlight"><code data-lang="ini">isis.services-installer=configuration-and-annotation</code></pre>
-</div>
+<code>AppManifest</code> to <a href="#_rg_classes_AppManifest-bootstrapping">bootstrap the app</a>) then Apache Isis' core
+implementation of <code>CommandContext</code> service is automatically registered and injected (it is annotated with
+<code>@DomainService</code>) so no further configuration is required.</p>
</div>
<div class="paragraph">
-<p>then Apache Isis' core implementation of <code>CommandContext</code> service is automatically registered and injected (it is annotated with <code>@DomainService</code>) so no further configuration is required.</p>
+<p>To use an alternative implementation, use
+<a href="#_rg_annotations_manpage-DomainServiceLayout_menuOrder"><code>@DomainServiceLayout#menuOrder()</code></a> (as explained
+further in this <a href="ug.html#_ug_how-tos_replacing-default-service-implementations">"how to"</a> tip).</p>
</div>
</div>
<div class="sect3">
@@ -13603,15 +14317,14 @@ view model.</p>
<h4 id="_registering_the_services_3">4.6.4. Registering the Services</h4>
<div class="paragraph">
<p>Assuming that the <code>configuration-and-annotation</code> services installer is configured (implicit if using the
-<code>AppManifest</code> to <a href="#_rg_classes_AppManifest-bootstrapping">bootstrap the app</a>):</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="CodeRay highlight"><code data-lang="ini">isis.services-installer=configuration-and-annotation</code></pre>
-</div>
+<code>AppManifest</code> to <a href="#<em>rg_classes_AppManifest-bootstrapping">bootstrap the app</a>), _and</em> that the
+<a href="ug.html#_ug_wicket-viewer">Wicket viewer</a> is being used, then an implementation of <code>DeepLinkService</code> is
+automatically registered and injected (it is annotated with <code>@DomainService</code>) so no further configuration is required.</p>
</div>
<div class="paragraph">
-<p>and that the <a href="ug.html#_ug_wicket-viewer">Wicket viewer</a> is being used then an implementation of <code>DeepLinkService</code> is automatically registered and injected (it is annotated with <code>@DomainService</code>) so no further configuration is required.</p>
+<p>To use an alternative implementation, use
+<a href="#_rg_annotations_manpage-DomainServiceLayout_menuOrder"><code>@DomainServiceLayout#menuOrder()</code></a> (as explained
+further in this <a href="ug.html#_ug_how-tos_replacing-default-service-implementations">"how to"</a> tip).</p>
</div>
</div>
</div>
@@ -14263,15 +14976,9 @@ container.persist(cust);</code></pre>
<h4 id="_registering_the_service_4">4.7.10. Registering the Service</h4>
<div class="paragraph">
<p>Assuming that the <code>configuration-and-annotation</code> services installer is configured (implicit if using the
-<code>AppManifest</code> to <a href="#_rg_classes_AppManifest-bootstrapping">bootstrap the app</a>):</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="CodeRay highlight"><code data-lang="ini">isis.services-installer=configuration-and-annotation</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>then Apache Isis' core implementation of <code>DomainObjectContainer</code> service is automatically registered and injected (it is annotated with <code>@DomainService</code>) so no further configuration is required.</p>
+<code>AppManifest</code> to <a href="#_rg_classes_AppManifest-bootstrapping">bootstrap the app</a>) then Apache Isis' core
+implementation of <code>DomainObjectContainer</code> service is automatically registered and injected (it is annotated with
+<code>@DomainService</code>) so no further configuration is required.</p>
</div>
</div>
</div>
@@ -14398,18 +15105,14 @@ container.persist(cust);</code></pre>
<h4 id="_registering_the_services_4">4.8.4. Registering the Services</h4>
<div class="paragraph">
<p>Assuming that the <code>configuration-and-annotation</code> services installer is configured (implicit if using the
-<code>AppManifest</code> to <a href="#_rg_classes_AppManifest-bootstrapping">bootstrap the app</a>):</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="CodeRay highlight"><code data-lang="ini">isis.services-installer=configuration-and-annotation</code></pre>
-</div>
+<code>AppManifest</code> to <a href="#_rg_classes_AppManifest-bootstrapping">bootstrap the app</a>) then Apache Isis' core
+implementation of <code>EmailService</code> service is automatically registered and injected (it is annotated with
+<code>@DomainService</code>) so no further configuration is required.</p>
</div>
<div class="paragraph">
-<p>then Apache Isis' core implementation of <code>EmailService</code> service is automatically registered and injected (it is annotated with <code>@DomainService</code>) so no further configuration is required.</p>
-</div>
-<div class="paragraph">
-<p>If you have written an alternative implementation, then register your implementation in <code>isis.properties</code> under the "isis.services" key and it will be used instead.</p>
+<p>To use an alternative implementation, use
+<a href="#_rg_annotations_manpage-DomainServiceLayout_menuOrder"><code>@DomainServiceLayout#menuOrder()</code></a> (as explained
+further in this <a href="ug.html#_ug_how-tos_replacing-default-service-implementations">"how to"</a> tip).</p>
</div>
</div>
<div class="sect3">
@@ -14925,15 +15628,14 @@ public <span class="directive">static</span> <span class="type">class</span> <sp
<h4 id="_registering_the_services_5">4.9.9. Registering the Services</h4>
<div class="paragraph">
<p>Assuming that the <code>configuration-and-annotation</code> services installer is configured (implicit if using the
-<code>AppManifest</code> to <a href="#_rg_classes_AppManifest-bootstrapping">bootstrap the app</a>):</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="CodeRay highlight"><code data-lang="ini">isis.services-installer=configuration-and-annotation</code></pre>
-</div>
+<code>AppManifest</code> to <a href="#_rg_classes_AppManifest-bootstrapping">bootstrap the app</a>) then Apache Isis' core
+implementation of <code>EventBusService</code> service is automatically registered and injected (it is annotated with
+<code>@DomainService</code>) so no further configuration is required.</p>
</div>
<div class="paragraph">
-<p>then Apache Isis' core implementation of <code>EventBusService</code> service is automatically registered and injected (it is annotated with <code>@DomainService</code>) so no further configuration is required.</p>
+<p>To use an alternative implementation, use
+<a href="#_rg_annotations_manpage-DomainServiceLayout_menuOrder"><code>@DomainServiceLayout#menuOrder()</code></a> (as explained
+further in this <a href="ug.html#_ug_how-tos_replacing-default-service-implementations">"how to"</a> tip).</p>
</div>
</div>
<div class="sect3">
@@ -15102,15 +15804,14 @@ public <span class="directive">static</span> <span class="type">class</span> <sp
<h4 id="_registering_the_services_6">4.11.3. Registering the Services</h4>
<div class="paragraph">
<p>Assuming that the <code>configuration-and-annotation</code> services installer is configured (implicit if using the
-<code>AppManifest</code> to <a href="#_rg_classes_AppManifest-bootstrapping">bootstrap the app</a>):</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="CodeRay highlight"><code data-lang="ini">isis.services-installer=configuration-and-annotation</code></pre>
-</div>
+<code>AppManifest</code> to <a href="#<em>rg_classes_AppManifest-bootstrapping">bootstrap the app</a>), _and</em> that the
+<a href="ug.html#_ug_wicket-viewer">Wicket viewer</a> is being used, then an implementation of <code>GuiceBeanProvider</code> is
+automatically registered and injected (it is annotated with <code>@DomainService</code>) so no further configuration is required.</p>
</div>
<div class="paragraph">
-<p>and that the <a href="ug.html#_ug_wicket-viewer">Wicket viewer</a> is being used then an implementation of <code>GuiceBeanProvider</code> is automatically registered and injected (it is annotated with <code>@DomainService</code>) so no further configuration is required.</p>
+<p>To use an alternative implementation, use
+<a href="#_rg_annotations_manpage-DomainServiceLayout_menuOrder"><code>@DomainServiceLayout#menuOrder()</code></a> (as explained
+further in this <a href="ug.html#_ug_how-tos_replacing-default-service-implementations">"how to"</a> tip).</p>
</div>
</div>
</div>
@@ -15431,20 +16132,98 @@ refresh the parent.</p>
<h4 id="_registering_the_services_7">4.12.6. Registering the Services</h4>
<div class="paragraph">
<p>Assuming that the <code>configuration-and-annotation</code> services installer is configured (implicit if using the
-<code>AppManifest</code> to <a href="#_rg_classes_AppManifest-bootstrapping">bootstrap the app</a>):</p>
+<code>AppManifest</code> to <a href="#_rg_classes_AppManifest-bootstrapping">bootstrap the app</a>) then Apache Isis' core
+implementation of <code>IsisJdoSupport</code> service is automatically registered and injected (it is annotated with
+<code>@DomainService</code>) so no further configuration is required.</p>
+</div>
+<div class="paragraph">
+<p>To use an alternative implementation, use
+<a href="#_rg_annotations_manpage-DomainServiceLayout_menuOrder"><code>@DomainServiceLayout#menuOrder()</code></a> (as explained
+further in this <a href="ug.html#_ug_how-tos_replacing-default-service-implementations">"how to"</a> tip).</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_rg_services-api_manpage-JaxbService">4.13. <code>JaxbService</code> (<code>1.11.0-SNAPSHOT</code>)</h3>
+<div class="paragraph">
+<p>The <code>JaxbService</code> (<code>1.11.0-SNAPSHOT</code>) allows instances of JAXB-annotated classes to be marshalled to XML and
+unmarshalled from XML back into domain objects.</p>
+</div>
+<div class="sect3">
+<h4 id="_rg_services-api_manpage-JaxbService_api-and-implementation">4.13.1. API & Implementation</h4>
+<div class="paragraph">
+<p>The API defined by <code>JaxbService</code> is:</p>
</div>
<div class="listingblock">
<div class="content">
-<pre class="CodeRay highlight"><code data-lang="ini">isis.services-installer=configuration-and-annotation</code></pre>
+<pre class="CodeRay highlight"><code data-lang="java"><span class="directive">public</span> <span class="type">interface</span> <span class="class">JaxbService</span> {
+ <span class="annotation">@Programmatic</span>
+ <T> T fromXml(<span class="predefined-type">Class</span><T> domainClass, <span class="predefined-type">String</span> xml); <i class="conum" data-value="1"></i><b>(1)</b>
+ <span class="annotation">@Programmatic</span>
+ <span class="directive">public</span> <span class="predefined-type">String</span> toXml(<span class="directive">final</span> <span class="predefined-type">Object</span> domainObject); <i class="conum" data-value="2"></i><b>(2)</b>
+ <span class="directive">public</span> <span class="type">enum</span> IsisSchemas { <i class="conum" data-value="3"></i><b>(3)</b>
+ INCLUDE, IGNORE
+ }
+ <span class="annotation">@Programmatic</span>
+ <span class="directive">public</span> <span class="predefined-type">Map</span><<span class="predefined-type">String</span>, <span class="predefined-type">String</span>> toXsd(<span class="directive">final</span> <span class="predefined-type">Object</span> domainObject, <span class="directive">final</span> IsisSchemas isSchemas);} <i class="conum" data-value="4"></i><b>(4)</b></code></pre>
</div>
</div>
+<div class="colist arabic">
+<table>
+<tr>
+<td><i class="conum" data-value="1"></i><b>1</b></td>
+<td>unmarshalls the XML into an instance of the class.</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="2"></i><b>2</b></td>
+<td>marshalls the domain object into XML</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="3"></i><b>3</b></td>
+<td>whether to include or exclude the Isis schemas in the generated map of XSDs. Discussed further below.</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="4"></i><b>4</b></td>
+<td>generates a map of each of the schemas referenced; the key is the schema namespace, the value is the XML of the schema itself.</td>
+</tr>
+</table>
+</div>
<div class="paragraph">
-<p>then Apache Isis' core implementation of <code>IsisJdoSupport</code> service is automatically registered and injected (it is annotated with <code>@DomainService</code>) so no further configuration is required.</p>
+<p>With respect to the <code>IsisSchemas</code> enum: a JAXB-annotated domain object will live in its own XSD namespace and may
+reference multiple other XSD schemas. In particular, many JAXB domain objects will reference the
+<a href="#_rg_schema">common Isis schemas</a> (for example the <code>OidDto</code> class that represents a reference to
+a persistent entity). The enum indicates whether these schemas should be included or excluded from the map.</p>
+</div>
+<div class="paragraph">
+<p>Isis provides a default implementation of the service, <code>o.a.i.schema.services.jaxb.JaxbServiceDefault</code>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_usage_within_the_framework_2">4.13.2. Usage within the framework</h4>
+<div class="paragraph">
+<p>This service is provided as a convenience for applications, but is also used internally by the framework to
+<a href="#_rg_annotations_manpage-XmlRootElement"><code>@XmlRootElement</code></a>-annotated
+<a href="ug.html#_ug_more-advanced_view-models">view models</a>. The functionality to download XML and XSD schemas is also
+exposed in the UI through mixins to <
<TRUNCATED>
[5/5] isis-site git commit: ISIS-1250, ISIS-915, ISIS-1251, ISIS-1252,
ISIS-1254, ISIS-1255
Posted by da...@apache.org.
ISIS-1250, ISIS-915, ISIS-1251, ISIS-1252, ISIS-1254, ISIS-1255
Project: http://git-wip-us.apache.org/repos/asf/isis-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis-site/commit/3970c476
Tree: http://git-wip-us.apache.org/repos/asf/isis-site/tree/3970c476
Diff: http://git-wip-us.apache.org/repos/asf/isis-site/diff/3970c476
Branch: refs/heads/asf-site
Commit: 3970c476c7a36b3353cde5e7076294f012ca1543
Parents: d9a2c38
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Thu Nov 19 22:43:54 2015 +0000
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Thu Nov 19 22:43:54 2015 +0000
----------------------------------------------------------------------
content/articles-and-presentations.html | 31 +
content/asf.html | 31 +
content/books.html | 31 +
content/cheat-sheet.html | 31 +
content/common-use-cases.html | 31 +
content/documentation.html | 31 +
content/downloadable-presentations.html | 31 +
content/downloads.html | 31 +
content/guides/cg.html | 41 +-
content/guides/rg.html | 3291 +++++++++++++-----
content/guides/simpleapp-archetype.html | 31 +
content/guides/tg.html | 31 +
content/guides/ug.html | 1509 ++++----
content/help.html | 31 +
content/how-isis-works.html | 31 +
content/icons.html | 31 +
content/index.html | 2 +-
.../common-use-cases/common-use-cases.html | 31 +
.../isis-in-pictures/isis-in-pictures.html | 31 +
content/isis-in-pictures.html | 31 +
content/migration-notes.html | 78 +
content/more-thanks.html | 31 +
content/powered-by.html | 31 +
content/release-notes.html | 31 +
.../templates/asciidoc-templates-idea.xml | 365 --
.../templates/isis-asciidoc-templates-idea.xml | 365 ++
content/screencasts.html | 31 +
content/support.html | 31 +
28 files changed, 4500 insertions(+), 1802 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis-site/blob/3970c476/content/articles-and-presentations.html
----------------------------------------------------------------------
diff --git a/content/articles-and-presentations.html b/content/articles-and-presentations.html
index 63d6f9d..59a69a9 100644
--- a/content/articles-and-presentations.html
+++ b/content/articles-and-presentations.html
@@ -46,6 +46,20 @@
<![endif]-->
+
+ <style type="text/css">
+ pre code {
+ background-color: inherit;
+ border-style: none;
+ }
+
+ pre code > span:first-child {
+ margin-left: -5px;
+ }
+
+ <style>
+
+ <!--
<style type="text/css">
/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
/*pre.CodeRay {background-color:#f7f7f8;}*/
@@ -164,6 +178,7 @@ table.CodeRay td.code>pre{padding:0}
}
<style>
+ -->
<style>
.github-fork-ribbon-wrapper.right {
@@ -242,6 +257,22 @@ table.CodeRay td.code>pre{padding:0}
margin-top: 30px;
}
+ div#doc-content a.header-link {
+ margin-left: -75px;
+ }
+
+ div#doc-content div.sect1 h2 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect3 h4 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect2 h3 {
+ margin-left: -60px;
+ }
+
div.documentation-page table.frame-all {
border-left: none;
border-right: none;
http://git-wip-us.apache.org/repos/asf/isis-site/blob/3970c476/content/asf.html
----------------------------------------------------------------------
diff --git a/content/asf.html b/content/asf.html
index 4f2076e..2f7f403 100644
--- a/content/asf.html
+++ b/content/asf.html
@@ -46,6 +46,20 @@
<![endif]-->
+
+ <style type="text/css">
+ pre code {
+ background-color: inherit;
+ border-style: none;
+ }
+
+ pre code > span:first-child {
+ margin-left: -5px;
+ }
+
+ <style>
+
+ <!--
<style type="text/css">
/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
/*pre.CodeRay {background-color:#f7f7f8;}*/
@@ -164,6 +178,7 @@ table.CodeRay td.code>pre{padding:0}
}
<style>
+ -->
<style>
.github-fork-ribbon-wrapper.right {
@@ -242,6 +257,22 @@ table.CodeRay td.code>pre{padding:0}
margin-top: 30px;
}
+ div#doc-content a.header-link {
+ margin-left: -75px;
+ }
+
+ div#doc-content div.sect1 h2 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect3 h4 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect2 h3 {
+ margin-left: -60px;
+ }
+
div.documentation-page table.frame-all {
border-left: none;
border-right: none;
http://git-wip-us.apache.org/repos/asf/isis-site/blob/3970c476/content/books.html
----------------------------------------------------------------------
diff --git a/content/books.html b/content/books.html
index a8bf604..7eaf8a0 100644
--- a/content/books.html
+++ b/content/books.html
@@ -46,6 +46,20 @@
<![endif]-->
+
+ <style type="text/css">
+ pre code {
+ background-color: inherit;
+ border-style: none;
+ }
+
+ pre code > span:first-child {
+ margin-left: -5px;
+ }
+
+ <style>
+
+ <!--
<style type="text/css">
/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
/*pre.CodeRay {background-color:#f7f7f8;}*/
@@ -164,6 +178,7 @@ table.CodeRay td.code>pre{padding:0}
}
<style>
+ -->
<style>
.github-fork-ribbon-wrapper.right {
@@ -242,6 +257,22 @@ table.CodeRay td.code>pre{padding:0}
margin-top: 30px;
}
+ div#doc-content a.header-link {
+ margin-left: -75px;
+ }
+
+ div#doc-content div.sect1 h2 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect3 h4 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect2 h3 {
+ margin-left: -60px;
+ }
+
div.documentation-page table.frame-all {
border-left: none;
border-right: none;
http://git-wip-us.apache.org/repos/asf/isis-site/blob/3970c476/content/cheat-sheet.html
----------------------------------------------------------------------
diff --git a/content/cheat-sheet.html b/content/cheat-sheet.html
index 34f5e48..e22cd6d 100644
--- a/content/cheat-sheet.html
+++ b/content/cheat-sheet.html
@@ -46,6 +46,20 @@
<![endif]-->
+
+ <style type="text/css">
+ pre code {
+ background-color: inherit;
+ border-style: none;
+ }
+
+ pre code > span:first-child {
+ margin-left: -5px;
+ }
+
+ <style>
+
+ <!--
<style type="text/css">
/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
/*pre.CodeRay {background-color:#f7f7f8;}*/
@@ -164,6 +178,7 @@ table.CodeRay td.code>pre{padding:0}
}
<style>
+ -->
<style>
.github-fork-ribbon-wrapper.right {
@@ -242,6 +257,22 @@ table.CodeRay td.code>pre{padding:0}
margin-top: 30px;
}
+ div#doc-content a.header-link {
+ margin-left: -75px;
+ }
+
+ div#doc-content div.sect1 h2 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect3 h4 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect2 h3 {
+ margin-left: -60px;
+ }
+
div.documentation-page table.frame-all {
border-left: none;
border-right: none;
http://git-wip-us.apache.org/repos/asf/isis-site/blob/3970c476/content/common-use-cases.html
----------------------------------------------------------------------
diff --git a/content/common-use-cases.html b/content/common-use-cases.html
index 077bd79..b69b7d4 100644
--- a/content/common-use-cases.html
+++ b/content/common-use-cases.html
@@ -46,6 +46,20 @@
<![endif]-->
+
+ <style type="text/css">
+ pre code {
+ background-color: inherit;
+ border-style: none;
+ }
+
+ pre code > span:first-child {
+ margin-left: -5px;
+ }
+
+ <style>
+
+ <!--
<style type="text/css">
/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
/*pre.CodeRay {background-color:#f7f7f8;}*/
@@ -164,6 +178,7 @@ table.CodeRay td.code>pre{padding:0}
}
<style>
+ -->
<style>
.github-fork-ribbon-wrapper.right {
@@ -242,6 +257,22 @@ table.CodeRay td.code>pre{padding:0}
margin-top: 30px;
}
+ div#doc-content a.header-link {
+ margin-left: -75px;
+ }
+
+ div#doc-content div.sect1 h2 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect3 h4 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect2 h3 {
+ margin-left: -60px;
+ }
+
div.documentation-page table.frame-all {
border-left: none;
border-right: none;
http://git-wip-us.apache.org/repos/asf/isis-site/blob/3970c476/content/documentation.html
----------------------------------------------------------------------
diff --git a/content/documentation.html b/content/documentation.html
index 386f6b5..2dc88e3 100644
--- a/content/documentation.html
+++ b/content/documentation.html
@@ -46,6 +46,20 @@
<![endif]-->
+
+ <style type="text/css">
+ pre code {
+ background-color: inherit;
+ border-style: none;
+ }
+
+ pre code > span:first-child {
+ margin-left: -5px;
+ }
+
+ <style>
+
+ <!--
<style type="text/css">
/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
/*pre.CodeRay {background-color:#f7f7f8;}*/
@@ -164,6 +178,7 @@ table.CodeRay td.code>pre{padding:0}
}
<style>
+ -->
<style>
.github-fork-ribbon-wrapper.right {
@@ -242,6 +257,22 @@ table.CodeRay td.code>pre{padding:0}
margin-top: 30px;
}
+ div#doc-content a.header-link {
+ margin-left: -75px;
+ }
+
+ div#doc-content div.sect1 h2 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect3 h4 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect2 h3 {
+ margin-left: -60px;
+ }
+
div.documentation-page table.frame-all {
border-left: none;
border-right: none;
http://git-wip-us.apache.org/repos/asf/isis-site/blob/3970c476/content/downloadable-presentations.html
----------------------------------------------------------------------
diff --git a/content/downloadable-presentations.html b/content/downloadable-presentations.html
index 555b8d9..f317ab2 100644
--- a/content/downloadable-presentations.html
+++ b/content/downloadable-presentations.html
@@ -46,6 +46,20 @@
<![endif]-->
+
+ <style type="text/css">
+ pre code {
+ background-color: inherit;
+ border-style: none;
+ }
+
+ pre code > span:first-child {
+ margin-left: -5px;
+ }
+
+ <style>
+
+ <!--
<style type="text/css">
/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
/*pre.CodeRay {background-color:#f7f7f8;}*/
@@ -164,6 +178,7 @@ table.CodeRay td.code>pre{padding:0}
}
<style>
+ -->
<style>
.github-fork-ribbon-wrapper.right {
@@ -242,6 +257,22 @@ table.CodeRay td.code>pre{padding:0}
margin-top: 30px;
}
+ div#doc-content a.header-link {
+ margin-left: -75px;
+ }
+
+ div#doc-content div.sect1 h2 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect3 h4 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect2 h3 {
+ margin-left: -60px;
+ }
+
div.documentation-page table.frame-all {
border-left: none;
border-right: none;
http://git-wip-us.apache.org/repos/asf/isis-site/blob/3970c476/content/downloads.html
----------------------------------------------------------------------
diff --git a/content/downloads.html b/content/downloads.html
index 6c266f7..b1ffda4 100644
--- a/content/downloads.html
+++ b/content/downloads.html
@@ -46,6 +46,20 @@
<![endif]-->
+
+ <style type="text/css">
+ pre code {
+ background-color: inherit;
+ border-style: none;
+ }
+
+ pre code > span:first-child {
+ margin-left: -5px;
+ }
+
+ <style>
+
+ <!--
<style type="text/css">
/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
/*pre.CodeRay {background-color:#f7f7f8;}*/
@@ -164,6 +178,7 @@ table.CodeRay td.code>pre{padding:0}
}
<style>
+ -->
<style>
.github-fork-ribbon-wrapper.right {
@@ -242,6 +257,22 @@ table.CodeRay td.code>pre{padding:0}
margin-top: 30px;
}
+ div#doc-content a.header-link {
+ margin-left: -75px;
+ }
+
+ div#doc-content div.sect1 h2 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect3 h4 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect2 h3 {
+ margin-left: -60px;
+ }
+
div.documentation-page table.frame-all {
border-left: none;
border-right: none;
http://git-wip-us.apache.org/repos/asf/isis-site/blob/3970c476/content/guides/cg.html
----------------------------------------------------------------------
diff --git a/content/guides/cg.html b/content/guides/cg.html
index b7a071d..8368bcd 100644
--- a/content/guides/cg.html
+++ b/content/guides/cg.html
@@ -46,6 +46,20 @@
<![endif]-->
+
+ <style type="text/css">
+ pre code {
+ background-color: inherit;
+ border-style: none;
+ }
+
+ pre code > span:first-child {
+ margin-left: -5px;
+ }
+
+ <style>
+
+ <!--
<style type="text/css">
/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
/*pre.CodeRay {background-color:#f7f7f8;}*/
@@ -164,6 +178,7 @@ table.CodeRay td.code>pre{padding:0}
}
<style>
+ -->
<style>
.github-fork-ribbon-wrapper.right {
@@ -242,6 +257,22 @@ table.CodeRay td.code>pre{padding:0}
margin-top: 30px;
}
+ div#doc-content a.header-link {
+ margin-left: -75px;
+ }
+
+ div#doc-content div.sect1 h2 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect3 h4 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect2 h3 {
+ margin-left: -60px;
+ }
+
div.documentation-page table.frame-all {
border-left: none;
border-right: none;
@@ -507,7 +538,7 @@ table.CodeRay td.code>pre{padding:0}
</ul>
</div>
<div class="paragraph">
-<p>The developer' guide is <em>not</em> intended as a reference manual; for that see the <strong><a href="rg.html#_rg">Reference Guide</a></strong>. This guide also doesn’t describe how to actually build an Apache Isis application; for that see the <strong><a href="ug.html#_ug">Users' Guide</a></strong>.</p>
+<p>This contributors' guide is <em>not</em> intended as a reference manual; for that see the <strong><a href="rg.html#_rg">Reference Guide</a></strong>. This guide also doesn’t describe how to actually build an Apache Isis application; for that see the <strong><a href="ug.html#_ug">Users' Guide</a></strong>.</p>
</div>
</div>
</div>
@@ -1625,7 +1656,7 @@ rather than Lombok’s own <code>@Getter</code> and `@Setter.</p>
<h2 id="_cg_ide-templates">3. IDE Templates</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>We provide IDE templates (for IntelliJ and Eclipse) for writing Apache Isis domain objects, and also for unit tests (JUnit and JMock). We also provide them for IntelliJ for writing Asciidoc documentation (see also the <a href="#_cg__cg_asciidoc-templates">appendix</a>).</p>
+<p>We provide IDE templates (for IntelliJ and Eclipse) for writing Apache Isis domain objects, and also for unit tests (JUnit and JMock). We also provide them for IntelliJ for writing Asciidoc documentation (see also the <a href="#_cg_asciidoc-templates">appendix</a>).</p>
</div>
<div class="sect2">
<h3 id="_download">3.1. Download</h3>
@@ -1695,7 +1726,7 @@ rather than Lombok’s own <code>@Getter</code> and `@Setter.</p>
<p>ad</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p><a href="../resources/templates/asciidoc-templates-idea.xml">Download</a></p>
+<p><a href="../resources/templates/isis-asciidoc-templates-idea.xml">Download</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p>(none )</p>
@@ -1712,7 +1743,7 @@ rather than Lombok’s own <code>@Getter</code> and `@Setter.</p>
<div class="sect3">
<h4 id="_intellij">3.2.1. IntelliJ</h4>
<div class="paragraph">
-<p>To install in IntelliJ (Community edition 14), copy to the relevant <code>config/templates</code> directory, eg:</p>
+<p>To install in IntelliJ (Community edition 15), copy to the relevant <code>config/templates</code> directory, eg:</p>
</div>
<div class="ulist">
<ul>
@@ -1728,7 +1759,7 @@ rather than Lombok’s own <code>@Getter</code> and `@Setter.</p>
</ul>
</div>
<div class="paragraph">
-<p>If using the Ultimate edition, the directory is <code>.IntelliJIdea14</code> rather than <code>IdeaIC14</code>.</p>
+<p>If using the Ultimate edition, the directory is <code>.IntelliJIdea15</code> rather than <code>IdeaIC15</code>.</p>
</div>
</div>
<div class="sect3">
[2/5] isis-site git commit: ISIS-1250, ISIS-915, ISIS-1251, ISIS-1252,
ISIS-1254, ISIS-1255
Posted by da...@apache.org.
http://git-wip-us.apache.org/repos/asf/isis-site/blob/3970c476/content/guides/ug.html
----------------------------------------------------------------------
diff --git a/content/guides/ug.html b/content/guides/ug.html
index fc6cf41..c0572ff 100644
--- a/content/guides/ug.html
+++ b/content/guides/ug.html
@@ -46,6 +46,20 @@
<![endif]-->
+
+ <style type="text/css">
+ pre code {
+ background-color: inherit;
+ border-style: none;
+ }
+
+ pre code > span:first-child {
+ margin-left: -5px;
+ }
+
+ <style>
+
+ <!--
<style type="text/css">
/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
/*pre.CodeRay {background-color:#f7f7f8;}*/
@@ -164,6 +178,7 @@ table.CodeRay td.code>pre{padding:0}
}
<style>
+ -->
<style>
.github-fork-ribbon-wrapper.right {
@@ -242,6 +257,22 @@ table.CodeRay td.code>pre{padding:0}
margin-top: 30px;
}
+ div#doc-content a.header-link {
+ margin-left: -75px;
+ }
+
+ div#doc-content div.sect1 h2 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect3 h4 {
+ margin-left: -60px;
+ }
+
+ div#doc-content div.sect2 h3 {
+ margin-left: -60px;
+ }
+
div.documentation-page table.frame-all {
border-left: none;
border-right: none;
@@ -500,7 +531,7 @@ table.CodeRay td.code>pre{padding:0}
<p>Later chapters discuss essential topics such as <a href="#_ug_testing">testing</a> and how to <a href="#_ug_deployment">deploy</a> your app, and discuss other ways in which you can <a href="#_ug_extending">extend</a> or adapt the framework itself to your particular needs.</p>
</div>
<div class="paragraph">
-<p>The users' guide is <em>not</em> intended as a reference manual; for that see the <strong><a href="rg.html#_rg">Reference Guide</a></strong>. The users' guide also doesn’t explain how to setup your development environment; for that see the <strong><a href="cg.html#_cg">Contributors' Guide</a></strong>.</p>
+<p>This users' guide is <em>not</em> intended as a reference manual; for that see the <strong><a href="rg.html#_rg">Reference Guide</a></strong>. This guide also doesn’t explain how to setup your development environment; for that see the <strong><a href="cg.html#_cg">Contributors' Guide</a></strong>.</p>
</div>
</div>
</div>
@@ -554,7 +585,7 @@ table.CodeRay td.code>pre{padding:0}
<p>Let’s look at each in turn.</p>
</div>
<div class="sect4">
-<h5 id="_ubiquitous_language">Ubiquitous Language</h5>
+<h5 id="_ug_core-concepts_philosophy_domain-driven-design_ubiquitous-language">Ubiquitous Language</h5>
<div class="paragraph">
<p>It’s no secret that the IT industry is plagued by project failures. Too often systems take longer than intended to implement, and when finally implemented, they don’t address the real requirements anyway.</p>
</div>
@@ -1470,21 +1501,33 @@ in Apache Isis, and do <em>not</em> correspond to actions even though they have
</div>
</div>
<div class="sect3">
-<h4 id="_domain_entities_vs_view_models">2.3.4. Domain Entities vs View Models</h4>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-TODO
-</td>
-</tr>
-</table>
+<h4 id="_entities_vs_view_models">2.3.4. Entities vs View Models</h4>
+<div class="paragraph">
+<p>When developing an Apache Isis application you will most likely start off with the persistent domain entities:
+<code>Customer</code>, <code>Order</code>, <code>Product</code>, and so on. For some applications this may well suffice. However, if the application
+needs to integrate with other systems, or if the application needs to support reasonably complex business processes,
+then you may need to look beyond just domain entities.</p>
+</div>
+<div class="paragraph">
+<p>To support these use cases we support view models. In the same way that an (RDBMS) database view can aggregate and
+abstract from multiple underlying database tables, so a view model sits on top of one or many underlying entities.</p>
+</div>
+<div class="paragraph">
+<p>View models are not persisted, but nevertheless they can have behaviour (and titles, and icons) just like domain
+entities. Indeed, to a user of the system there is no particular distinction (again, in the same way that when using
+an RDBMS one can use database views and database tables pretty much interchangeably).</p>
+</div>
+<div class="paragraph">
+<p>View models generally tend to be associated with supporting a particular use case; logically they are part of the
+application layer, not part of the domain layer (where entities live).</p>
+</div>
+<div class="paragraph">
+<p>We introduce view models here because they do get mentioned quite often within the users and reference guide. However,
+we do consider them a more advanced topic; we generally recommend that you build your applications from the domain
+layer up, rather than from the view model down.</p>
</div>
<div class="paragraph">
-<p><code>@DomainObject(nature=…​)</code></p>
+<p>For further discussion on view models, see <a href="#_ug_more-advanced_view-models">this topic</a>.</p>
</div>
</div>
<div class="sect3">
@@ -1529,7 +1572,7 @@ TODO
</div>
</div>
<div class="sect3">
-<h4 id="_ug_core-concepts_building-blocks_value-objects">2.3.6. Value Objects (Primitives)</h4>
+<h4 id="_ug_core-concepts_building-blocks_mixins-and-contributions">2.3.6. Mixins & Contributions</h4>
<div class="admonitionblock note">
<table>
<tr>
@@ -1542,9 +1585,13 @@ TODO
</tr>
</table>
</div>
+<div class="paragraph">
+<p>For more information, see <a href="#_ug_more-advanced_decoupling_contributions">this topic on contribution</a>s, and
+<a href="#_ug_more-advanced_decoupling_mixins">this topic on mixin</a>s.</p>
+</div>
</div>
<div class="sect3">
-<h4 id="_ug_core-concepts_building-blocks_mixins-and-contributions">2.3.7. Mixins & Contributions</h4>
+<h4 id="_ug_core-concepts_building-blocks_domain-events">2.3.7. Domain Events</h4>
<div class="admonitionblock note">
<table>
<tr>
@@ -1552,14 +1599,83 @@ TODO
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
-TODO
+TODO; see <a href="rg.html#_rg_classes_domainevent">domain event</a> classes.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect4">
+<h5 id="_ui_events_code_1_11_0_snapshot_code">UI Events (<code>1.11.0-SNAPSHOT</code>)</h5>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+TODO; see <a href="rg.html#_rg_classes_uievent">UI event</a> classes.
</td>
</tr>
</table>
</div>
</div>
+</div>
+<div class="sect3">
+<h4 id="_ug_core-concepts_building-blocks_oid">2.3.8. OIDs</h4>
+<div class="paragraph">
+<p>As well as defining a <a href="#_ug_core-concepts_building-blocks_metamodel">metamodel</a> of the structure (domain
+classes) of its domain objects, Apache Isis also manages the runtime instances of said domain objects.</p>
+</div>
+<div class="paragraph">
+<p>When a domain entity is recreated from the database, the framework keeps track of its identity through an "OID": an
+object identifier. Fundamentally this is a combination of its type (domain class), along with an identifier. You can think
+of it as its "primary key", except across all domain entity types.</p>
+</div>
+<div class="paragraph">
+<p>For portability and resilience, though, the object type is generally an alias for the actual domain class: thus
+"customers.CUS", say, rather than "com.mycompany.myapp.customers.Customer". This is derived from an annotation. The
+identifier meanwhile is always converted to a string.</p>
+</div>
+<div class="paragraph">
+<p>Although simple, the OID is an enormously powerful concept: it represents a URI to any domain object managed by
+a given Apache Isis application. With it, we have the ability to lookup any arbitrary domain objects.</p>
+</div>
+<div class="paragraph">
+<p>Some examples:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>an OID allows sharing of information between users, eg as a deep link to be pasted into an email.</p>
+</li>
+<li>
+<p>the information within an OID could be converted into a barcode, and stamped onto a PDF form. When the PDF is
+scanned by the mail room, the barcode could be read to attach the correspondence to the relevant domain object.</p>
+</li>
+<li>
+<p>as a handle to any object in an audit record (as used by the
+<a href="rg.html#_rg_services-spi_manpage-AuditingService"><code>AuditingService</code></a>, in fact).</p>
+</li>
+<li>
+<p>and of course both the <a href="#_ug_restfulobjects-viewer">RestfulObjects viewer</a> and
+<a href="#_ug_wicket-viewer">Wicket viewer</a>
+use the oid tuple to look up, render and allow the user to interact with domain objects.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Although the exact content of an OID should be considered opaque by domain objects, it is possible for domain objects
+to obtain OIDs. These are represented as <code>Bookmark`s, obtained from the
+<a href="rg.html#_rg_services-api_manpage-BookmarkService">`BookmarkService</code></a>. Deep links meanwhile can be obtained from
+the <a href="rg.html#_rg_annotations_manpage-DeepLinkService"><code>@DeepLinkService</code></a>.</p>
+</div>
+<div class="paragraph">
+<p>OIDs can also be converted into XML format, useful for integration scenarios. The
+<a href="rg.html#_rg_schema-common">common schema</a> XSD defines the <code>oidDto</code> complex type for precisely this purpose.</p>
+</div>
+</div>
<div class="sect3">
-<h4 id="_ug_core-concepts_building-blocks_domain-events">2.3.8. Domain Events</h4>
+<h4 id="_ug_core-concepts_building-blocks_value-objects">2.3.9. Value Objects (Primitives)</h4>
<div class="admonitionblock note">
<table>
<tr>
@@ -2468,7 +2584,7 @@ script to be run.</p>
<div class="sect2">
<h3 id="_ug_how-tos_class-structure">4.1. Class Structure</h3>
<div class="paragraph">
-<p>Apache Isis works by building a metamodel of the domain objects: entities, view models and services. The class members of both entities and view models represent both state — (single-valued) properties and (multi-valued) collections — and behaviour — actions. The class members of domain services is simpler: just behaviour, ie actions.</p>
+<p>Apache Isis works by building a metamodel of the domain objects: entities, <a href="#_ug_more-advanced_view-models">view model</a>s and services. The class members of both entities and view models represent both state — (single-valued) properties and (multi-valued) collections — and behaviour — actions. The class members of domain services is simpler: just behaviour, ie actions.</p>
</div>
<div class="paragraph">
<p>In the automatically generated UI a property is rendered as a field. This can be either of a value type (a string, number, date, boolean etc) or can be a reference to another entity. A collection is generally rendered as a table.</p>
@@ -4233,10 +4349,11 @@ TODO
</td>
<td class="content">
<div class="paragraph">
-<p>If you don’t do this then you may (as of Apache Isis 1.4.1) hit an NullPointerException. This may be a bug in DataNucleus, we are not completely sure, but the above idiom seems to fix the issue.</p>
+<p>If you don’t do this then you may hit a <code>NullPointerException</code>. The above idiom fixes the issue.</p>
</div>
<div class="paragraph">
-<p>For more information, see <a href="http://isis.markmail.org/thread/ipu2lzqqikqdglox">this thread</a> on the Apache Isis users mailing list, including this <a href="http://markmail.org/message/hblptpw675mlw723">message</a> with the above recommendation.</p>
+<p>For more information, see <a href="http://isis.markmail.org/thread/ipu2lzqqikqdglox">this thread</a> on the Apache Isis users
+mailing list, including this <a href="http://markmail.org/message/hblptpw675mlw723">message</a> with the above recommendation.</p>
</div>
</td>
</tr>
@@ -4865,89 +4982,16 @@ TODO - <a href="rg.html#_rg_annotations_manpage-DomainObject_bounded"><code>@Dom
</div>
</div>
<div class="sect2">
-<h3 id="_ug_how-tos_replacing-default-service-implementations">4.11. Replacing Service Implns</h3>
-<div class="paragraph">
-<p>The framework provides default implementations for many of the <a href="rg.html#_rg_services-api">API Services</a>. This is convenient, but sometimes you will want to replace the default implementation with your own service implementation.</p>
-</div>
-<div class="paragraph">
-<p>The trick is to use the <a href="rg.html#_rg_annotations_manpage-DomainServiceLayout_menuOrder"><code>@DomainServiceLayout#menuOrder()</code></a> attribute, specifying a low number (typically <code>"1"</code>).</p>
-</div>
-<div class="paragraph">
-<p>For example, suppose you wanted to provide your own implementation of <a href="rg.html#_rg_services-api_manpage-LocaleProvider"><code>LocaleProvider</code></a>. Here’s how:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainService</span>(
- nature = NatureOfService.DOMAIN
-)
-<span class="annotation">@DomainServiceLayout</span>(
- menuOrder = <span class="string"><span class="delimiter">"</span><span class="content">1</span><span class="delimiter">"</span></span> <i class="conum" data-value="1"></i><b>(1)</b>
-)
-<span class="directive">public</span> <span class="type">class</span> <span class="class">MyLocaleProvider</span> <span class="directive">implements</span> LocaleProvider {
- <span class="annotation">@Override</span>
- <span class="directive">public</span> <span class="predefined-type">Locale</span> getLocale() {
- <span class="keyword">return</span> ...
- }
-}</code></pre>
-</div>
-</div>
-<div class="colist arabic">
-<table>
-<tr>
-<td><i class="conum" data-value="1"></i><b>1</b></td>
-<td>takes precedence over the default implementation.</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>It’s also quite common to want to decorate the existing implementation (ie have your own implementation delegate to the default); this is also possible and quite easy if using <code>1.10.0</code> or later:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainService</span>(
- nature = NatureOfService.DOMAIN
-)
-<span class="annotation">@DomainServiceLayout</span>(
- menuOrder = <span class="string"><span class="delimiter">"</span><span class="content">1</span><span class="delimiter">"</span></span> <i class="conum" data-value="1"></i><b>(1)</b>
-)
-<span class="directive">public</span> <span class="type">class</span> <span class="class">MyLocaleProvider</span> <span class="directive">implements</span> LocaleProvider {
- <span class="annotation">@Override</span>
- <span class="directive">public</span> <span class="predefined-type">Locale</span> getLocale() {
- <span class="keyword">return</span> getDelegateLocaleProvider().getLocale(); <i class="conum" data-value="2"></i><b>(2)</b>
- }
- Optional<LocaleProvider> delegateLocaleProvider; <i class="conum" data-value="3"></i><b>(3)</b>
- <span class="directive">private</span> LocaleProvider getDelegateLocaleProvider() {
- <span class="keyword">if</span>(delegateLocaleProvider == <span class="predefined-constant">null</span>) {
- delegateLocaleProvider = Iterables.tryFind(localeProviders, input -> input != <span class="local-variable">this</span>); <i class="conum" data-value="4"></i><b>(4)</b>
- }
- <span class="keyword">return</span> delegateLocaleProvider.orNull();
- }
- <span class="annotation">@Inject</span>
- <span class="predefined-type">List</span><LocaleProvider> localeProviders; <i class="conum" data-value="5"></i><b>(5)</b>
-}</code></pre>
-</div>
-</div>
-<div class="colist arabic">
+<h3 id="_ug_how-tos_bulk-actions">4.11. Bulk Actions</h3>
+<div class="admonitionblock note">
<table>
<tr>
-<td><i class="conum" data-value="1"></i><b>1</b></td>
-<td>takes precedence over the default implementation when injected elsewhere.</td>
-</tr>
-<tr>
-<td><i class="conum" data-value="2"></i><b>2</b></td>
-<td>this implementation merely delegates to the default implementation</td>
-</tr>
-<tr>
-<td><i class="conum" data-value="3"></i><b>3</b></td>
-<td>lazily populated</td>
-</tr>
-<tr>
-<td><i class="conum" data-value="4"></i><b>4</b></td>
-<td>delegate to the first implementation that isn’t <em>this</em> implementation (else infinite loop!)</td>
-</tr>
-<tr>
-<td><i class="conum" data-value="5"></i><b>5</b></td>
-<td>Injects all implementations, including this implemenation</td>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+TODO - <a href="rg.html#_rg_annotations_manpage-Action_invokeOn"><code>@Action#invokeOn()</code></a>
+</td>
</tr>
</table>
</div>
@@ -5700,22 +5744,40 @@ methods for properties (see ?).</p>
</div>
</div>
<div class="sect2">
-<h3 id="_ug_more-advanced_bulk-actions">5.3. Bulk Actions</h3>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-TODO - <a href="rg.html#_rg_annotations_manpage-Action_invokeOn"><code>@Action#invokeOn()</code></a>
-</td>
-</tr>
-</table>
+<h3 id="_ug_more-advanced_view-models">5.3. View Models</h3>
+<div class="paragraph">
+<p>View models are a type of domain object (with state, behaviour etc) but where the state is <em>not</em> persisted into the
+ JDO/DataNucleus-managed database, but is instead converted to/from a string memento, and held by the calling client.
+This opens up a number of more advanced use cases.</p>
</div>
+<div class="paragraph">
+<p>In this topic we’ll explore those use cases, and learn the programming model and conventions to use view models in your application.</p>
+</div>
+<div class="sect3">
+<h4 id="_ug_more-advanced_view-models_use-cases">5.3.1. Use Cases</h4>
+<div class="paragraph">
+<p>When developing an Apache Isis application you will most likely start off with the persistent domain entities:
+<code>Customer</code>, <code>Order</code>, <code>Product</code>, and so on. For some applications this may well suffice. However, if the application
+needs to integrate with other systems, or if the application needs to support reasonably complex business processes, then you may need to look beyond just domain entities. This section explores these use cases.</p>
+</div>
+<div class="sect4">
+<h5 id="_externally_managed_entities">Externally-managed entities</h5>
+<div class="paragraph">
+<p>Sometimes the entities that make up your application are persisted not in the local JDO/DataNucleus database
+but reside in some other system, for example accessible only through a SOAP web service. Logically that data
+might still be considered a domain entity and we might want to associate behaviour with it, however it cannot be
+modelled as a domain entity if only because JDO/DataNucleus doesn’t know about the entity nor how to retrieve or
+update it.</p>
+</div>
+<div class="paragraph">
+<p>There are a couple of ways around this: we could either replicate the data somehow from the external system into the
+ Isis-managed database (in which case it is once again just another domain entity), or we could set up a stub/proxy for
+ the externally managed entity. This proxy would hold the reference to the externally-managed domain entity (eg an
+ external id), as well as the "smarts" to know how to interact with that entity (by making SOAP web service calls etc).</p>
+</div>
+<div class="paragraph">
+<p>The stub/proxy is a type of view model: a view - if you like - onto the domain entity managed by the external system.</p>
</div>
-<div class="sect2">
-<h3 id="_ug_more-advanced_view-models">5.4. View Models</h3>
<div class="admonitionblock note">
<table>
<tr>
@@ -5723,93 +5785,613 @@ TODO - <a href="rg.html#_rg_annotations_manpage-Action_invokeOn"><code>@Action#i
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
-TODO - <a href="rg.html#_rg_annotations_manpage-ViewModel"><code>@ViewModel</code></a>, <a href="rg.html#_rg_classes_super_manpage-AbstractViewModel"><code>AbstractViewModel</code></a>, <a href="rg.html#_rg_annotations_manpage-DomainObject_nature"><code>@DomainObject#nature()</code></a>
+<div class="paragraph">
+<p>DataNucleus does in fact define its own <a href="http://www.datanucleus.org/documentation/extensions/store_manager.html">Store Manager</a> extension point, so an alternative architecture would be to implement this interface such that DataNucleus
+could make the calls to the external system; these externally-persisted domain entities would therefore be modelled as regular <code>@PersistenceCapable</code> entities after all. For entities not persisted externally the implementation would delegate down to the default RDBMS-specific <code>StoreManager</code> provided by DataNucleus itself.</p>
+</div>
+<div class="paragraph">
+<p>An implementation that supported only reading from an external entity ought to be comparatively straight-forward, but
+implementing one that also supported updating external entities would need to carefully consider error conditions if the
+external system is unavailable; distributed transactions are most likely difficult/impossible to implement (and not
+desirable in any case).</p>
+</div>
</td>
</tr>
</table>
</div>
+</div>
+<div class="sect4">
+<h5 id="_in_memory_entities">In-memory entities</h5>
<div class="paragraph">
-<p>Nature of view models</p>
+<p>As a variation on the above, sometimes there are domain objects that are, conceptually at least entities, but whose
+state is not actually persisted anywhere, merely held in-memory (eg in a hash).</p>
</div>
-<div class="ulist">
-<ul>
-<li>
-<p>inmemory-entity</p>
-</li>
-<li>
-<p>external_entity</p>
-</li>
-<li>
-<p>application layer</p>
-</li>
-</ul>
+<div class="paragraph">
+<p>A simple example might be read-only configuration data that is read from a config file (eg log4j appender
+definitions) but thereafter is presented in the UI just like any other entity.</p>
</div>
+</div>
+<div class="sect4">
+<h5 id="_application_layer_view_models">Application-layer view models</h5>
<div class="paragraph">
-<p>Consumers of view models</p>
+<p>Domain entities (whether locally persisted using JDO/DataNucleus or managed externally) are the bread-and-butter of Apache Isis applications: the focus after all, should be on the business domain concepts and ensuring that they are
+solid. Generally those domain entities will make sense to the business domain experts: they form the <em>ubiquitous language</em> of the domain. These domain entities are part of the domain layer.</p>
</div>
-<div class="ulist">
-<ul>
-<li>
-<p>within the Wicket viewer</p>
-</li>
-<li>
-<p>within the REST viewer, as an external client consuming a stable API</p>
-</li>
-</ul>
+<div class="paragraph">
+<p>That said, it may not always be practical to expect end-users of the application to interact solely with those domain
+entities. For example, it may be useful to show a dashboard of the most significant data in the system to a user,
+often pulling in and aggregating information from multiple points of the app. Obtaining this information by hand (by
+ querying the respective services/repositories) would be tedious and slow; far better to have a dashboard do the job for
+ the end user.</p>
</div>
<div class="paragraph">
-<p>An alternative to using view models is to map the domain object using the <a href="rg.html#_rg_services-spi_manpage-ContentMappingService"><code>ContentMappingService</code></a>.</p>
+<p>A dashboard object is a model of the most relevant state to the end-user, in other words it is (quite literally) a view
+ model. It is not a persisted entity, instead it belongs to the application layer.</p>
</div>
+<div class="paragraph">
+<p>A view model need not merely aggregate data; it could also provide actions of its own. Most likely these actions will
+be queries and will always ultimately just delegate down to the appropriate domain-layer service/repository. But in
+some cases such view model actions might also modify state of underlying domain entities.</p>
</div>
-<div class="sect2">
-<h3 id="_ug_more-advanced_mapping-rdbms-views">5.5. Mapping RDBMS Views</h3>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-TODO - as used in <a href="http://github.com/estatio/estatio">Estatio</a>
-</td>
-</tr>
-</table>
+<div class="paragraph">
+<p>Another common use for view models is to help co-ordinate complex business processes; for example to perform a
+quarterly invoicing run, or to upload annual interest rates from an Excel spreadsheet. In these cases the view model
+might have some state of its own, but in most cases that state does not need to be persisted per se.</p>
</div>
+<div class="sidebarblock">
+<div class="content">
+<div class="title">Desire Lines</div>
+<div class="paragraph">
+<p>One way to think of application view models is as modelling the "desire line": the commonly-trod path
+that end-users must follow to get from point A to point B as quickly as possible.</p>
</div>
-<div class="sect2">
-<h3 id="_ug_more-advanced_transactions-and-errors">5.6. Transactions and Errors</h3>
<div class="paragraph">
-<p>In Apache Isis, every action invocation (in fact, every interaction) is automatically wrapped in a transaction, and any repository query automatically does a flush.</p>
+<p>To explain: there are <a href="http://ask.metafilter.com/62599/Where-the-sidewalk-ends">documented</a>
+<a href="https://sivers.org/walkways">examples</a>
+<a href="http://www.softpanorama.org/People/Wall/larry_wall_articles_and_interviews.shtml">that</a> architects of university
+campus will only add in paths some while after the campus buildings are complete: let the pedestrians figure out the
+routes they want to take. The name we like best for this idea is "desire lines", though it has also been called
+a "desire path", "paving the path" or "paving the sidewalk".</p>
</div>
<div class="paragraph">
-<p>What that means is that there’s no need to explicitly start or commit transactions in Apache Isis; this will be done for you. Indeed, if you do try to manage transactions (eg by reaching into the JDO <code>PersistenceManager</code> exposed by the <a href="rg.html#_rg_services-api_manpage-IsisJdoSupport">IsisJdoSupport</a> domain service, then you are likely to confuse Isis and get a stack trace for your trouble.</p>
+<p>What that means is you should add view models <em>after</em> having built up the domain layer, rather than before. These view
+models pave that commonly-trod path, automating the steps that the end-user would otherwise have to do by hand.</p>
</div>
-<div class="sect3">
-<h4 id="_aborting_transactions">5.6.1. Aborting Transactions</h4>
<div class="paragraph">
-<p>If you want to abort Apache Isis' transaction, this can be done by throwing <code>RecoverableException</code> (or any subclass, eg <code>ApplicationException</code>). The transaction will be aborted, and the exception message will be displayed to the user.</p>
+<p>It takes a little practice though, because even when building the domain layer "first", you should still bear in mind
+what the use cases are that those domain entities are trying to support. You certainly <em>shouldn’t</em> try to build out a
+domain layer that could support every conceivable use case before starting to think about view models.</p>
</div>
<div class="paragraph">
-<p>If you throw any other exception (ie not a subclass of <code>RecoverableException</code>), then the users will see an error page (if Wicket viewer) or a 500 (if Restful Objects viewer).</p>
+<p>Instead, you should iterate. Identify the use case/story/end-user objective that you will deliver value to the
+business. Then build out the minimum domain entities to support that use case (refining the <a href="#_ug_core-concepts_philosophy_domain-driven-design_ubiquitous-language">ubiquitous language</a> as you
+go). Then, identify if there any view models that could be introduced which would simplify the end-user interactions
+with the system (perhaps automating several related use cases together).</p>
</div>
</div>
-<div class="sect3">
-<h4 id="_raise_message_errors_to_users">5.6.2. Raise message/errors to users</h4>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-TODO - <a href="rg.html#_rg_services-api_manpage-DomainObjectContainer_messages-api"><code>DomainObjectContainer</code></a>
-</td>
-</tr>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_dtos_code_1_11_0_snapshot_code">DTOs (<code>1.11.0-SNAPSHOT</code>)</h5>
+<div class="paragraph">
+<p>DTOs (data transfer objects) are simple classes that (according to <a href="https://en.wikipedia.org/wiki/Data_transfer_object">wikipedia</a>) "carries data between processes".</p>
+</div>
+<div class="paragraph">
+<p>If those two processes are parts of the same overall application (the same team builds and deploys both server and
+client) then there’s generally no need to define a DTO; just access the entities using Apache Isis'
+<a href="#_ug_restfulobjects-viewer">RestfulObjects viewer</a>.</p>
+</div>
+<div class="paragraph">
+<p>On the other hand, if the client consuming the DTO is a different application — by which we mean developed/deployed by
+a different (possible third-party) team — then the DTOs act as a formal contract between the provider and the consumer.
+In such cases, exposing domain entities over <a href="#_ug_restfulobjects-viewer">RestfulObjects</a> would be
+"A Bad Thing"™ because the consumer would in effect have access to implementation details that could then not be
+easily changed by the producer.</p>
+</div>
+<div class="paragraph">
+<p>Instead, a view model can be defined to act as a DTO. To put this formal contract onto a solid footing, this view
+model can (as of <code>1.11.0-SNAPSHOT</code>) simply be defined as a JAXB-annotated entity; this allows the consumer to obtain
+the DTO in XML format along with a corresponding XSD schema describing the structure of that XML. These XML
+representations can be surfaced by the <a href="#_ug_restfulobjects-viewer">RestfulObjects viewer</a> (by implementing
+the <a href="rg.html#_rg_services-spi_manpage-ContentMappingService"><code>ContentMappingService</code></a>); the XSD can be obtained
+using the <a href="rg.html#_rg_services-api_manpage-JaxbService"><code>JaxbService</code></a>. Using the formalism of XML also allows
+DTOs to be carefully and properly versioned using XML namespaces.</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>If the view model DTO implements the <a href="rg.html#_rg_classes_mixins_Dto"><code>Dto</code></a> marker interface, then the framework
+will also provide the ability to download the XML or its XSD directly from the UI.</p>
+</div>
+</td>
+</tr>
</table>
</div>
+<div class="paragraph">
+<p>In case it’s not clear, these DTOs are still usable as "regular" view models; they will render in the <a href="#_ug_wicket-viewer">Wicket viewer</a> just like any other. Indeed (as the <a href="#_ug_more-advanced_view-models_programming-model">programming model</a> section below makes clear), these
+JAXB-annotated view models are in many regards the most powerful of all the view model alternatives.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_esb_subscribers">ESB Subscribers</h5>
+<div class="paragraph">
+<p>One important variation of the DTO use case concerns subscribers on an enterprise event bus such as
+<a href="http://camel.apache.org">Apache Camel™</a> and similar.</p>
+</div>
+<div class="paragraph">
+<p>A <a href="rg.html#_rg_services-spi_manpage-PublishingService"><code>PublishingService</code></a> implementation (eg that provided by
+(non-ASF) <a href="http://github.com/isisaddons/isis-module-publishmq">Isis addons' publishmq</a> module) can publish XML events
+onto a message queue, typically representing action invocations within the originating Isis application. The ESB
+(Apache Camel) then dispatches this event to all interested subscribers. These subscribers represent external systems
+in the enterprise, managed by other teams, and so act as the third-party consumers of the data.</p>
+</div>
+<div class="paragraph">
+<p>Rather than try to anticipate their requirements and push the data that these subscribers might need into the original
+XML event (a hopeless task), DTO objects can be defined to allow these consumers to call back to the publishing Isis
+application to obtain the data they need.</p>
+</div>
+</div>
</div>
<div class="sect3">
-<h4 id="_exception_recognizers">5.6.3. Exception Recognizers</h4>
+<h4 id="_ug_more-advanced_view-models_programming-model">5.3.2. Programming Model</h4>
+<div class="paragraph">
+<p>So much for the theory; how should view models be implemented? Fundamentally all view models' state is serialized into
+a string memento; this memento is then held by the client (browser) in the form of a URL. As you might imagine, this
+URL can become quite long, but Apache Isis offers a mechanism (the <a href="rg.html#_rg_services-spi_manpage-UrlEncodingService"><code>UrlEncodingService</code></a>) if it exceeds the maximum length for a URL
+(2083 characters). Also, of course, this string memento must only contain characters that it is valid for use within
+a URL.</p>
+</div>
+<div class="paragraph">
+<p>While the underlying technique is the same irrespective of use case, the programming model provides various ways of
+defining a view model so that the original intent is not lost. They are:</p>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<caption class="title">Table 2. View model programming model</caption>
+<colgroup>
+<col style="width: 14%;">
+<col style="width: 57%;">
+<col style="width: 28%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Use case</th>
+<th class="tableblock halign-left valign-top">Code</th>
+<th class="tableblock halign-left valign-top">Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>External entity</p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainObject</span>(nature=Nature.EXTERNAL_ENTITY)
+<span class="directive">public</span> <span class="type">class</span> <span class="class">CustomerRecordOnSAP</span> { ... }</code></pre>
+</div>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>Annotated with <a href="rg.html#_rg_annotations_manpage-DomainObject_nature"><code>@DomainObject#nature()</code></a> and a nature of <code>EXTERNAL_ENTITY</code>, with memento derived automatically from the properties of the domain object. Collections are ignored, as are any properties annotated as <a href="rg.html#_rg_annotations_manpage-Property_notPersisted">not persisted</a>.</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>In-memory entity</p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainObject</span>(nature=Nature.INMEMORY_ENTITY)
+<span class="directive">public</span> <span class="type">class</span> <span class="class">Log4JAppender</span> { ... }</code></pre>
+</div>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>As preceding, but using a nature of <code>INMEMORY_ENTITY</code>.</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>Application view model</p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainObject</span>(nature=Nature.VIEW_MODEL)
+<span class="directive">public</span> <span class="type">class</span> <span class="class">Dashboard</span> { ... }</code></pre>
+</div>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>As preceding, but using a nature of <code>VIEW_MODEL</code>.</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>Application view model</p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@ViewModel</span>
+<span class="directive">public</span> <span class="type">class</span> <span class="class">Dashboard</span> { ... }</code></pre>
+</div>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>Annotated with <a href="rg.html#_rg_annotations_manpage-ViewModel"><code>@ViewModel</code></a> annotation (effectively just an alias)' memento is as preceding: from "persisted" properties, collections ignored</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>Application view model</p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><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">ExcelUploadManager</span> <span class="directive">implements</span> ViewModel {
+ <span class="directive">public</span> <span class="predefined-type">String</span> viewModelMemento() { ... }
+ <span class="directive">public</span> <span class="type">void</span> viewModelInit(<span class="predefined-type">String</span> memento) { ... }
+}</code></pre>
+</div>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>Implement <a href="rg.html#_rg_classes_super_manpage-ViewModel"><code>ViewModel</code></a> interface. The memento is as defined by the
+interface’s methods: the programmer has full control (but also full responsibility) for the string memento.</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>DTO (<code>1.11.0-SNAPSHOT</code>)</p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@XmlRootElement</span>(<span class="string"><span class="delimiter">"</span><span class="content">customer</span><span class="delimiter">"</span></span>)
+<span class="directive">public</span> <span class="type">class</span> <span class="class">CustomerDto</span> { ... }</code></pre>
+</div>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>Annotate using JAXB <a href="rg.html#<em>rg_annotations_manpage-XmlRootElement"><code>@XmlRootElement</code></a> annotation. Memento
+derived automatically by serializing the XML graph as implied by the JAXB annotations. Note that (unlike <code>@ViewModel</code>
+et al) this state _can</em> include collections.</p>
+</div></div></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p>JAXB-annotated DTOs are discussed in more detail immediately <a href="rg.html#_ug_more-advanced_view-models_jaxb">below</a>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_ug_more-advanced_view-models_jaxb">5.3.3. JAXB-annotated DTOs (<code>1.11.0-SNAPSHOT</code>)</h4>
+<div class="paragraph">
+<p>This section provides some recommended practices if using JAXB and <code>@XmlRootElement</code> to define domain models. The
+examples are taken from the (non-ASF) <a href="http://github.com/isisaddons/isis-app-todoapp">Isis addons' todoapp</a>.</p>
+</div>
+<div class="sect4">
+<h5 id="_use_packages_to_version_dtos">Use packages to version DTOs</h5>
+<div class="paragraph">
+<p>The whole point of using DTOs (in Apache Isis, at least) is to define a formal contact between two interoperating but
+independent applications. Since the only thing we can predicate about the future with any certainty is that it one or
+both of these applications will change, we should version DTOs from the get-go.</p>
+</div>
+<div class="paragraph">
+<p>With XML every element may be defined as belonging to a particular namespace; in JAXB this translates to Java packages.
+We therefore should place each DTO within its own package, and that package should include a version identifier.</p>
+</div>
+<div class="paragraph">
+<p>For example, the <a href="http://github.com/isisaddons/isis-app-todoapp">Isis addons' todoapp</a> defines this DTO (as a versioned
+representation of its underlying <code>ToDoItem</code> entity):</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@XmlRootElement</span>(name = <span class="string"><span class="delimiter">"</span><span class="content">toDoItemDto</span><span class="delimiter">"</span></span>) <i class="conum" data-value="1"></i><b>(1)</b>
+<span class="annotation">@XmlType</span>(
+ namespace = <span class="string"><span class="delimiter">"</span><span class="content">http://viewmodels.app.todoapp/v1/todoitem</span><span class="delimiter">"</span></span>, <i class="conum" data-value="2"></i><b>(2)</b>
+ propOrder = { <i class="conum" data-value="3"></i><b>(3)</b>
+ <span class="string"><span class="delimiter">"</span><span class="content">description</span><span class="delimiter">"</span></span>,
+ <span class="string"><span class="delimiter">"</span><span class="content">category</span><span class="delimiter">"</span></span>,
+ <span class="string"><span class="delimiter">"</span><span class="content">subcategory</span><span class="delimiter">"</span></span>,
+ <span class="string"><span class="delimiter">"</span><span class="content">cost</span><span class="delimiter">"</span></span>
+ }
+)
+<span class="annotation">@DomainObjectLayout</span>(
+ titleUiEvent = TitleUiEvent.Doop.class <i class="conum" data-value="4"></i><b>(4)</b>
+)
+<span class="directive">public</span> <span class="type">class</span> <span class="class">ToDoItemDto</span> <span class="directive">implements</span> Dto {
+ <span class="annotation">@XmlElement</span>(required = <span class="predefined-constant">true</span>)
+ <span class="annotation">@Getter</span> <span class="annotation">@Setter</span> <i class="conum" data-value="5"></i><b>(5)</b>
+ <span class="directive">protected</span> <span class="predefined-type">String</span> description;
+
+ <span class="annotation">@XmlElement</span>(required = <span class="predefined-constant">true</span>)
+ <span class="annotation">@Getter</span> <span class="annotation">@Setter</span>
+ <span class="directive">protected</span> <span class="predefined-type">String</span> category;
+
+ <span class="annotation">@Getter</span> <span class="annotation">@Setter</span>
+ <span class="directive">protected</span> <span class="predefined-type">String</span> subcategory;
+
+ <span class="annotation">@Getter</span> <span class="annotation">@Setter</span>
+ <span class="directive">protected</span> <span class="predefined-type">BigDecimal</span> cost;
+}</code></pre>
+</div>
+</div>
+<div class="colist arabic">
+<table>
+<tr>
+<td><i class="conum" data-value="1"></i><b>1</b></td>
+<td>identifies this class as a view model and defines the root element for JAXB serialization</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="2"></i><b>2</b></td>
+<td>specify the XML schema namespace to which this element type belongs</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="3"></i><b>3</b></td>
+<td>all properties in the class must be listed; (they can be ignored using <code>@XmlTransient</code>)</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="4"></i><b>4</b></td>
+<td>demonstrating use of UI events for a subscriber to provide the DTO’s title; see <a href="rg.html#_rg_annotations_manpage-DomainObjectLayout_titleUiEvent"><code>@DomainObjectLayout#titleUiEvent()</code></a>.</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="5"></i><b>5</b></td>
+<td>optional; JAXB metadata can specify such attributes as required/optional</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>For the package in which the DTO class resides, we define a corresponding namespace. This goes in <code>package-info.java</code>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@javax</span>.xml.bind.annotation.XmlSchema(
+ namespace = <span class="string"><span class="delimiter">"</span><span class="content">http://viewmodels.app.todoapp/v1/todoitem</span><span class="delimiter">"</span></span>, <i class="conum" data-value="1"></i><b>(1)</b>
+ xmlns = {
+ <span class="annotation">@javax</span>.xml.bind.annotation.XmlNs(
+ namespaceURI = <span class="string"><span class="delimiter">"</span><span class="content">http://isis.apache.org/schema/common</span><span class="delimiter">"</span></span>, <i class="conum" data-value="2"></i><b>(2)</b>
+ prefix = <span class="string"><span class="delimiter">"</span><span class="content">common</span><span class="delimiter">"</span></span>
+ )
+ },
+ elementFormDefault = javax.xml.bind.annotation.XmlNsForm.QUALIFIED
+)
+<span class="keyword">package</span> <span class="namespace">todoapp.app.viewmodels.todoitem.v1_0</span>; <i class="conum" data-value="3"></i><b>(3)</b></code></pre>
+</div>
+</div>
+<div class="colist arabic">
+<table>
+<tr>
+<td><i class="conum" data-value="1"></i><b>1</b></td>
+<td>the namespace URI. There is no requirement for this to correspond to a physical URL, but it should be unique (this
+usually implies the usage of a company domain name)</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="2"></i><b>2</b></td>
+<td>define an alias for all of other Java types used within the DTO class. It’s recommended that the Apache Isis <a href="rg.html#_rg_schema-common">common schema</a> is always be defined; any references to persistent entities will resultin usage
+of this schema.</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="3"></i><b>3</b></td>
+<td>the package in which the DTO resides.</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Note how both the XML namespace and package are broadly equivalent to each other; in particular note that they both
+also include a version "v1".</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_versioning">Versioning</h5>
+<div class="paragraph">
+<p>Versioning DTOs enables us to make changes without breaking existing consumers of the data. We can distinguish two
+types of changes:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>backwardly compatible changes</p>
+</li>
+<li>
+<p>breaking changes.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Following <a href="http://semver.org">semantic versioning</a> approach, we suggest using <code>v1_0</code>, <code>v1_1</code>, <code>v1_2</code> etc as the
+package version for a sequence of backwardly compatible changes, then bump up to <code>v2_0</code> for a breaking change.</p>
+</div>
+<div class="paragraph">
+<p>Backwardly compatible changes can generally (always?) be modelled using class inheritance. Thus, <code>v1_1.ToDoItemDto</code>
+is a subclass of <code>v1_0.ToDoItemDto</code>. This makes sense too: OO inheritance means "is-substitutable-for", so what is
+true in an OO context is true when processing XML documents.</p>
+</div>
+<div class="paragraph">
+<p>On the other hand, breaking changes probably (always?) imply that the next version of the DTO does not use inheritance.
+Thus <code>v2_0.ToDoItemDto</code> might share many of the same properties as the <code>v1_1.ToDoItemDto</code>, but any reuse would be
+copy-n-paste rather than through inheritance.</p>
+</div>
+<div class="paragraph">
+<p>To see this in practice, here’s (the outline of) v1.1 of <code>ToDoItemDto</code>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="keyword">package</span> <span class="namespace">todoapp.app.viewmodels.todoitem.v1_1</span>;
+...
+<span class="annotation">@XmlRootElement</span>(name = <span class="string"><span class="delimiter">"</span><span class="content">toDoItemDto</span><span class="delimiter">"</span></span>)
+<span class="annotation">@XmlType</span>(
+ namespace = <span class="string"><span class="delimiter">"</span><span class="content">http://viewmodels.app.todoapp/v1_1/todoitem</span><span class="delimiter">"</span></span>,
+ propOrder = {
+ <span class="string"><span class="delimiter">"</span><span class="content">toDoItem</span><span class="delimiter">"</span></span>,
+ <span class="string"><span class="delimiter">"</span><span class="content">similarItems</span><span class="delimiter">"</span></span>
+ }
+)
+<span class="directive">public</span> <span class="type">class</span> <span class="class">ToDoItemDto</span> <span class="directive">extends</span> todoapp.app.viewmodels.todoitem.v1_0.ToDoItemDto {
+ ...
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The corresponding <code>package-info.java</code> is similar to that for <code>v1_0</code>, though note how it also defines a namespace prefix
+for <code>v1_0</code>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@javax</span>.xml.bind.annotation.XmlSchema(
+ namespace = <span class="string"><span class="delimiter">"</span><span class="content">http://viewmodels.app.todoapp/v1_1/todoitem</span><span class="delimiter">"</span></span>,
+ xmlns = {
+ <span class="annotation">@javax</span>.xml.bind.annotation.XmlNs(
+ namespaceURI = <span class="string"><span class="delimiter">"</span><span class="content">http://isis.apache.org/schema/common</span><span class="delimiter">"</span></span>,
+ prefix = <span class="string"><span class="delimiter">"</span><span class="content">common</span><span class="delimiter">"</span></span>
+ ),
+ <span class="annotation">@javax</span>.xml.bind.annotation.XmlNs(
+ namespaceURI = <span class="string"><span class="delimiter">"</span><span class="content">http://viewmodels.app.todoapp/v1_0/todoitem</span><span class="delimiter">"</span></span>,
+ prefix = <span class="string"><span class="delimiter">"</span><span class="content">todoitem-v1_0</span><span class="delimiter">"</span></span>
+ ),
+ <span class="annotation">@javax</span>.xml.bind.annotation.XmlNs(
+ namespaceURI = <span class="string"><span class="delimiter">"</span><span class="content">http://viewmodels.app.todoapp/v1_1/todoitem</span><span class="delimiter">"</span></span>,
+ prefix = <span class="string"><span class="delimiter">"</span><span class="content">todoitem-v1_1</span><span class="delimiter">"</span></span>
+ )
+ },
+ elementFormDefault = javax.xml.bind.annotation.XmlNsForm.QUALIFIED
+)
+<span class="keyword">package</span> <span class="namespace">todoapp.app.viewmodels.todoitem.v1_1</span>;</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_referencing_domain_entities">Referencing Domain Entities</h5>
+<div class="paragraph">
+<p>It’s quite common for view models to be "backed by" (be projections of) some underlying domain entity. The
+<code>ToDoItemDto</code> we’ve been using as the example in this section is an example: there is an underlying <code>ToDoItem</code> entity.</p>
+</div>
+<div class="paragraph">
+<p>It wouldn’t make sense to serialize out the state of a persistent entity: the point of a DTO is to act as a facade
+on top of the entity so that the implementation details (of the entity’s structure) don’t leak out to the consumer.
+However, the identity of the underlying entity can be well defined; Apache Isis defines the
+<a href="rg.html#_rg_schema-common">Common schema</a> which defines the <code><oid-dto></code> element (and corresponding <code>OidDto</code> class):
+the object’s type and its identifier. This is basically a formal XML equivalent to the <code>Bookmark</code> object obtained
+from the <a href="rg.html#_rg_services-api_manpage-BookmarkService"><code>BookmarkService</code></a>.</p>
+</div>
+<div class="paragraph">
+<p>There is only one requirement to make this work: every referenced domain entity must be annotated with
+<a href="rg.html#_rg_annotations_manpage-XmlJavaTypeAdapter"><code>@XmlJavaTypeAdapter</code></a>, specifying the framework-provided
+<code>PersistentEntityAdapter.class</code>. This class is similar to the <code>BookmarkService</code>: it knows how to create an <code>OidDto</code>
+from an object reference.</p>
+</div>
+<div class="paragraph">
+<p>Thus, in our view model we can legitimately write:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="keyword">package</span> <span class="namespace">todoapp.app.viewmodels.todoitem.v1_1</span>;
+...
+public <span class="type">class</span> <span class="class">ToDoItemDto</span> <span class="directive">extends</span> todoapp.app.viewmodels.todoitem.v1_0.ToDoItemDto {
+ ...
+ <span class="annotation">@Getter</span> <span class="annotation">@Setter</span>
+ <span class="directive">protected</span> ToDoItem toDoItem;
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>All we need to do is remember to add that <code>@XmlJavaTypeAdapter</code> annotation to the referenced entity:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@XmlJavaTypeAdapter</span>(PersistentEntityAdapter.class)
+<span class="directive">public</span> <span class="type">class</span> <span class="class">ToDoItem</span> ... {
+ ...
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_collections_3">Collections</h5>
+<div class="paragraph">
+<p>It’s also possible for a DTO to hold collections of objects. These can be of any type, either simple properties, or
+references to other objects.</p>
+</div>
+<div class="paragraph">
+<p>The only bit of boilerplate that is required is the <code>@XmlElementWrapper</code> annotation. This instructs JAXB to create
+an XML element (based on the field name) to contain each of the elements. (If this is omitted then the contents of
+the collection are at the same level as the properties; almost certainly not what is required).</p>
+</div>
+<div class="paragraph">
+<p>For example, the v1.1 of the <code>ToDoItemDto</code> could also contain:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="keyword">package</span> <span class="namespace">todoapp.app.viewmodels.todoitem.v1_1</span>;
+...
+public <span class="type">class</span> <span class="class">ToDoItemDto</span> <span class="directive">extends</span> todoapp.app.viewmodels.todoitem.v1_0.ToDoItemDto {
+ ...
+ <span class="annotation">@XmlElementWrapper</span>
+ <span class="annotation">@XmlElement</span>(name = <span class="string"><span class="delimiter">"</span><span class="content">todoItem</span><span class="delimiter">"</span></span>)
+ <span class="annotation">@Getter</span> <span class="annotation">@Setter</span>
+ <span class="directive">protected</span> <span class="predefined-type">List</span><ToDoItem> similarItems = Lists.newArrayList();
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>There’s nothing to prevent a JAXB DTO from containing rich graphs of data, parent containing children containing
+children. Be aware though that all of this state will become the DTO’s memento, ultimately converted into a URL-safe
+form, by way of the <a href="rg.html#_rg_services-spi_manpage-UrlEncodingService"><code>UrlEncodingService</code></a>.</p>
+</div>
+<div class="paragraph">
+<p>There are limits to the lengths of URLs, however. Therefore the DTO should not include state that can easily be
+derived from other information. If the URL does exceed limits, then provide a custom implementation of <code>UrlEncodingService</code>
+to handle the memento string in some other fashion (eg substituting it with a GUID, with the memento cached somehow
+on the server).</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_ug_more-advanced_mapping-rdbms-views">5.4. Mapping RDBMS Views</h3>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+TODO - as used in <a href="http://github.com/estatio/estatio">Estatio</a>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_ug_more-advanced_transactions-and-errors">5.5. Transactions and Errors</h3>
+<div class="paragraph">
+<p>In Apache Isis, every action invocation (in fact, every interaction) is automatically wrapped in a transaction, and any repository query automatically does a flush.</p>
+</div>
+<div class="paragraph">
+<p>What that means is that there’s no need to explicitly start or commit transactions in Apache Isis; this will be done for you. Indeed, if you do try to manage transactions (eg by reaching into the JDO <code>PersistenceManager</code> exposed by the <a href="rg.html#_rg_services-api_manpage-IsisJdoSupport">IsisJdoSupport</a> domain service, then you are likely to confuse Isis and get a stack trace for your trouble.</p>
+</div>
+<div class="sect3">
+<h4 id="_aborting_transactions">5.5.1. Aborting Transactions</h4>
+<div class="paragraph">
+<p>If you want to abort Apache Isis' transaction, this can be done by throwing <code>RecoverableException</code> (or any subclass, eg <code>ApplicationException</code>). The transaction will be aborted, and the exception message will be displayed to the user.</p>
+</div>
+<div class="paragraph">
+<p>If you throw any other exception (ie not a subclass of <code>RecoverableException</code>), then the users will see an error page (if Wicket viewer) or a 500 (if Restful Objects viewer).</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_raise_message_errors_to_users">5.5.2. Raise message/errors to users</h4>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+TODO - <a href="rg.html#_rg_services-api_manpage-DomainObjectContainer_messages-api"><code>DomainObjectContainer</code></a>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_exception_recognizers">5.5.3. Exception Recognizers</h4>
<div class="admonitionblock note">
<table>
<tr>
@@ -5825,7 +6407,7 @@ TODO - <a href="rg.html#_rg_services-spi_manpage-ExceptionRecognizer"><code>Exce
</div>
</div>
<div class="sect2">
-<h3 id="_ug_more-advanced_i18n">5.7. i18n</h3>
+<h3 id="_ug_more-advanced_i18n">5.6. i18n</h3>
<div class="paragraph">
<p>Apache Isis' support for i18n allows every element of the domain model (the class names, property names, action names, parameter names and so forth) to be translated.</p>
</div>
@@ -5836,7 +6418,7 @@ TODO - <a href="rg.html#_rg_services-spi_manpage-ExceptionRecognizer"><code>Exce
<p>Isis does not translate the values of your domain objects, though. So, if you have a domain concept such as <code>Country</code> whose name is intended to be localized according to the current user, you will need to model</p>
</div>
<div class="sect3">
-<h4 id="_implementation_approach">5.7.1. Implementation Approach</h4>
+<h4 id="_implementation_approach">5.6.1. Implementation Approach</h4>
<div class="paragraph">
<p>Most Java frameworks tackle i18n by using Java’s own <code>ResourceBundle</code> API. However, there are some serious drawbacks in this approach, such as:</p>
</div>
@@ -5910,7 +6492,7 @@ TODO - <a href="rg.html#_rg_services-spi_manpage-ExceptionRecognizer"><code>Exce
</div>
</div>
<div class="sect3">
-<h4 id="__code_translationservice_code">5.7.2. <code>TranslationService</code></h4>
+<h4 id="__code_translationservice_code">5.6.2. <code>TranslationService</code></h4>
<div class="paragraph">
<p>The cornerstone of Apache Isis' support for i18n is the <code>TranslationService</code> service. This is defined in the applib with the following API:</p>
</div>
@@ -5985,7 +6567,7 @@ TODO - <a href="rg.html#_rg_services-spi_manpage-ExceptionRecognizer"><code>Exce
</div>
</div>
<div class="sect3">
-<h4 id="_imperative_messages">5.7.3. Imperative messages</h4>
+<h4 id="_imperative_messages">5.6.3. Imperative messages</h4>
<div class="paragraph">
<p>The <code>TranslationService</code> is used internally by Apache Isis when building up the metamodel; the name and description of every class, property, collection, action and action parameter is automatically translated. Thus the simple act of bootstrapping Apache Isis will cause most of the messages requiring translation (that is: those for the Apache Isis metamodel) to be captured by the <code>TranslationService</code>.</p>
</div>
@@ -6139,7 +6721,7 @@ msgstr "Iche heisse {firstName} {lastName}."</code></pre>
</div>
</div>
<div class="sect3">
-<h4 id="_integration_testing">5.7.4. Integration Testing</h4>
+<h4 id="_integration_testing">5.6.4. Integration Testing</h4>
<div class="paragraph">
<p>So much for the API; but as noted, it is also necessary to ensure that the required translations are recorded (by the <code>TranslationService</code>) into the <code>.pot</code> file.</p>
</div>
@@ -6211,7 +6793,7 @@ FixtureScripts fixtureScripts;
</div>
</div>
<div class="sect3">
-<h4 id="_configuration">5.7.5. Configuration</h4>
+<h4 id="_configuration">5.6.5. Configuration</h4>
<div class="paragraph">
<p>There are several different aspects of the translation service that can be configured.</p>
</div>
@@ -6292,171 +6874,33 @@ log4j.additivity.org.apache.isis.core.runtime.services.i18n.po.PotWriter=false</
</div>
</div>
<div class="paragraph">
-<p>Then this directory will be used as the base for searching for translations (rather than the default 'WEB-INF/' directory).</p>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_force_read_mode">Force read mode</h5>
-<div class="paragraph">
-<p>As noted above, if running in prototype mode then <code>TranslationServicePo</code> will be in write mode, if in production mode then will be in read mode. To force read mode (ie use translations) even if in prototype mode, add the following configuration property to <code>isis.properties</code>:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="CodeRay highlight"><code data-lang="ini">isis.services.translation.po.mode=read</code></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_supporting_services">5.7.6. Supporting services</h4>
-<div class="paragraph">
-<p>The <code>TranslationServicePo</code> has a number of supporting/related services.</p>
-</div>
-<div class="sect4">
-<h5 id="__code_localeprovider_code"><code>LocaleProvider</code></h5>
-<div class="paragraph">
-<p>The <code>LocaleProvider</code> API is used by the <code>TranslationServicePo</code> implementation to obtain the locale of the "current user".</p>
-</div>
-<div class="paragraph">
-<p>A default implementation is provided by the Wicket viewer.</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>Note that this default implementation does not support requests made through the Restful Objects viewer (there is no Wicket 'application' object available); the upshot is that requests through Restful Objects are never translated. Registering a different implementation of <code>LocaleProvider</code> that taps into appropriate REST (RestEasy?) APIs would be the way to address this.</p>
-</div>
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect4">
-<h5 id="__code_translationsresolver_code"><code>TranslationsResolver</code></h5>
-<div class="paragraph">
-<p>The <code>TranslationResolver</code> is used by the <code>TranslationService</code> implementation to lookup translations for a specified locale. It is this service that reads from the <code>WEB-INF/</code> (or externalized directory).</p>
-</div>
-</div>
-<div class="sect4">
-<h5 id="__code_translationservicepomenu_code"><code>TranslationServicePoMenu</code></h5>
-<div class="paragraph">
-<p>The <code>TranslationServicePoMenu</code> provides a couple of menu actions in the UI (prototype mode only) that interacts with the underlying <code>TranslationServicePo</code>:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>the <code>downloadTranslationsFile()</code> action - available only in write mode - allows the current <code>.pot</code> file to be downloaded.<br></p>
-<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>While this will contain all the translations from the metamodel, it will not necessarily contain all translations for all imperative methods returning <code>TranslatableString</code> instances; which are present and which are missing will depend on which imperative methods have been called (recorded by the service) prior to downloading.</p>
-</div>
-</td>
-</tr>
-</table>
-</div>
-</li>
-<li>
-<p>the <code>clearTranslationsCache()</code> action - available only in read mode - will clear the cache so that new translations can be loaded.<br></p>
-<div class="paragraph">
-<p>This allows a translator to edit the appropriate <code>translations-xx-XX.po</code> file and check the translation is correct without having to restart the app.</p>
-</div>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_ug_more-advanced_multi-tenancy">5.8. Multi-tenancy</h3>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-TODO - as supported by (non-ASF) <a href="http://github.com/isisaddons/isis-module-security">Isis addons' security</a> module.
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_ug_more-advanced_persistence-lifecycle">5.9. Persistence Lifecycle</h3>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-TODO
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_ug_more-advanced_tips-n-tricks">5.10. Tips n Tricks</h3>
-<div class="paragraph">
-<p>This section catalogues a miscellaneous collection of hints-and-tips.</p>
-</div>
-<div class="sect3">
-<h4 id="_ug_more-advanced_tips-n-tricks_are-you-sure">5.10.1. 'Are you sure?' idiom</h4>
-<div class="paragraph">
-<p>Sometimes an action might perform irreversible changes. In such a case it’s probably a good idea for the UI to require that the
-end-user explicitly confirms that they intended to invoke the action.</p>
+<p>Then this directory will be used as the base for searching for translations (rather than the default 'WEB-INF/' directory).</p>
+</div>
</div>
<div class="sect4">
-<h5 id="_using_action_semantics">Using action semantics</h5>
+<h5 id="_force_read_mode">Force read mode</h5>
<div class="paragraph">
-<p>One way to meet this requirement is using the framework’s built-in <a href="rg.html#_rg_annotations_manpage-Action_semantics"><code>@Action#semantics()</code></a> attribute:</p>
+<p>As noted above, if running in prototype mode then <code>TranslationServicePo</code> will be in write mode, if in production mode then will be in read mode. To force read mode (ie use translations) even if in prototype mode, add the following configuration property to <code>isis.properties</code>:</p>
</div>
<div class="listingblock">
<div class="content">
-<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@Action</span>(
- semantics = SemanticsOf.IDEMPOTENT_ARE_YOU_SURE
-)
-<span class="directive">public</span> SimpleObject updateName(
- <span class="annotation">@Parameter</span>(maxLength = NAME_LENGTH)
- <span class="annotation">@ParameterLayout</span>(named = <span class="string"><span class="delimiter">"</span><span class="content">New name</span><span class="delimiter">"</span></span>)
- <span class="directive">final</span> <span class="predefined-type">String</span> name) {
- setName(name);
- <span class="keyword">return</span> <span class="local-variable">this</span>;
-}</code></pre>
-</div>
+<pre class="CodeRay highlight"><code data-lang="ini">isis.services.translation.po.mode=read</code></pre>
</div>
-<div class="paragraph">
-<p>This will render as:</p>
</div>
-<div class="imageblock">
-<div class="content">
-<img src="images//how-tos/tips-n-tricks/action-semantics-are-you-sure.png" alt="action semantics are you sure">
</div>
</div>
+<div class="sect3">
+<h4 id="_supporting_services">5.6.6. Supporting services</h4>
+<div class="paragraph">
+<p>The <code>TranslationServicePo</code> has a number of supporting/related services.</p>
</div>
<div class="sect4">
-<h5 id="_using_a_checkbox">Using a checkbox</h5>
+<h5 id="__code_localeprovider_code"><code>LocaleProvider</code></h5>
<div class="paragraph">
-<p>An alternative approach (for all versions of the framework) is to require the end-user to check a dummy checkbox parameter (and prevent the action from being invoked if the user hasn’t checked that parameter).</p>
+<p>The <code>LocaleProvider</code> API is used by the <code>TranslationServicePo</code> implementation to obtain the locale of the "current user".</p>
</div>
<div class="paragraph">
-<p>For example:</p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="images//how-tos/tips-n-tricks/are-you-sure.png" alt="are you sure">
-</div>
+<p>A default implementation is provided by the Wicket viewer.</p>
</div>
<div class="admonitionblock note">
<table>
@@ -6466,70 +6910,56 @@ end-user explicitly confirms that they intended to invoke the action.</p>
</td>
<td class="content">
<div class="paragraph">
-<p>Note that these screenshots shows an earlier version of the <a href="#_ug_wicket-viewer">Wicket viewer</a> UI (specifically, pre 1.8.0).</p>
+<p>Note that this default implementation does not support requests made through the Restful Objects viewer (there is no Wicket 'application' object available); the upshot is that requests through Restful Objects are never translated. Registering a different implementation of <code>LocaleProvider</code> that taps into appropriate REST (RestEasy?) APIs would be the way to address this.</p>
</div>
</td>
</tr>
</table>
</div>
-<div class="paragraph">
-<p>If the user checks the box:</p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="images//how-tos/tips-n-tricks/are-you-sure-happy-case.png" alt="are you sure happy case">
-</div>
-</div>
-<div class="paragraph">
-<p>then the action will complete.</p>
</div>
+<div class="sect4">
+<h5 id="__code_translationsresolver_code"><code>TranslationsResolver</code></h5>
<div class="paragraph">
-<p>However, if the user fails to check the box, then a validation message is shown:</p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="images//how-tos/tips-n-tricks/are-you-sure-sad-case.png" alt="are you sure sad case">
+<p>The <code>TranslationResolver</code> is used by the <code>TranslationService</code> implementation to lookup translations for a specified locale. It is this service that reads from the <code>WEB-INF/</code> (or externalized directory).</p>
</div>
</div>
+<div class="sect4">
+<h5 id="__code_translationservicepomenu_code"><code>TranslationServicePoMenu</code></h5>
<div class="paragraph">
-<p>The code for this is pretty simple:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="CodeRay highlight"><code data-lang="java"><span class="directive">public</span> <span class="predefined-type">List</span><ToDoItem> delete(<span class="annotation">@Named</span>(<span class="string"><span class="delimiter">"</span><span class="content">Are you sure?</span><span class="delimiter">"</span></span>) <span class="type">boolean</span> areYouSure) {
- container.removeIfNotAlready(<span class="local-variable">this</span>);
- container.informUser(<span class="string"><span class="delimiter">"</span><span class="content">Deleted </span><span class="delimiter">"</span></span> + container.titleOf(<span class="local-variable">this</span>));
- <span class="keyword">return</span> toDoItems.notYetComplete(); <i class="conum" data-value="1"></i><b>(1)</b>
-}
-<span class="directive">public</span> <span class="predefined-type">String</span> validateDelete(<span class="type">boolean</span> areYouSure) {
- <span class="keyword">return</span> areYouSure? <span class="predefined-constant">null</span>: <span class="string"><span class="delimiter">"</span><span class="content">Please confirm you are sure</span><span class="delimiter">"</span></span>;
-}</code></pre>
-</div>
+<p>The <code>TranslationServicePoMenu</code> provides a couple of menu actions in the UI (prototype mode only) that interacts with the underlying <code>TranslationServicePo</code>:</p>
</div>
-<div class="colist arabic">
+<div class="ulist">
+<ul>
+<li>
+<p>the <code>downloadTranslationsFile()</code> action - available only in write mode - allows the current <code>.pot</code> file to be downloaded.<br></p>
+<div class="admonitionblock note">
<table>
<tr>
-<td><i class="conum" data-value="1"></i><b>1</b></td>
-<td>invalid to return <code>this</code> (cannot render a deleted object)</td>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>While this will contain all the translations from the metamodel, it will not necessarily contain all translations for all imperative methods returning <code>TranslatableString</code> instances; which are present and which are missing will depend on which imperative methods have been called (recorded by the service) prior to downloading.</p>
+</div>
+</td>
</tr>
</table>
</div>
+</li>
+<li>
+<p>the <code>clearTranslationsCache()</code> action - available only in read mode - will clear the cache so that new translations can be loaded.<br></p>
<div class="paragraph">
-<p>Note that the action itself does not use the boolean parameter, it is only
-used by the supporting <a href="rg.html#_rg_methods_prefixes_manpage-validate"><code>validate…​()</code></a> method.</p>
+<p>This allows a translator to edit the appropriate <code>translations-xx-XX.po</code> file and check the translation is correct without having to restart the app.</p>
</div>
+</li>
+</ul>
</div>
</div>
-<div class="sect3">
-<h4 id="_ug_more-advanced_tips-n-tricks_simulating-collections-of-values">5.10.2. Collections of values</h4>
-<div class="paragraph">
-<p>Although in Apache Isis you can have properties of either values (string, number, date etc) or of (references to other) entities, with collections the framework (currently) only supports collections of (references to) entities. That is, collections of values (a bag of numbers, say) are not supported.</p>
</div>
-<div class="paragraph">
-<p>However, it is possible to simulate a bag of numbers using view models.</p>
</div>
-<div class="sect4">
-<h5 id="_view_model">View Model</h5>
+<div class="sect2">
+<h3 id="_ug_more-advanced_multi-tenancy">5.7. Multi-tenancy</h3>
<div class="admonitionblock note">
<table>
<tr>
@@ -6537,14 +6967,14 @@ used by the supporting <a href="rg.html#_rg_methods_prefixes_manpage-validate"><
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
-TODO
+TODO - as supported by (non-ASF) <a href="http://github.com/isisaddons/isis-module-security">Isis addons' security</a> module.
</td>
</tr>
</table>
</div>
</div>
-<div class="sect4">
-<h5 id="_persistence_concerns">Persistence Concerns</h5>
+<div class="sect2">
+<h3 id="_ug_more-advanced_persistence-lifecycle">5.8. Persistence Lifecycle</h3>
<div class="admonitionblock note">
<table>
<tr>
@@ -6552,196 +6982,98 @@ TODO
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
-TODO - easiest to simply store using DataNucleus' support for collections, marked as <a href="rg.html#_rg_annotations_manpage-Programmatic"><code>@Programmatic</code></a> so that it is ignored by Apache Isis. Alternatively can store as json/xml in a varchar(4000) or clob and manually unpack.
+TODO
</td>
</tr>
</table>
</div>
</div>
-</div>
-<div class="sect3">
-<h4 id="_ug_more-advanced_tips-n-tricks_render-all-properties-in-tables">5.10.3. Subclass properties in tables</h4>
-<div class="paragraph">
-<p>Suppose you have a hierarchy of classes where a property is derived and abstract in the superclass, concrete implementations in the subclasses. 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="directive">abstract</span> <span class="type">class</span> <span class="class">LeaseTerm</span> {
- <span class="directive">public</span> <span class="directive">abstract</span> <span class="predefined-type">BigDecimal</span> getEffectiveValue();
- ...
-}
-
-<span class="directive">public</span> <span class="type">class</span> <span class="class">LeaseTermForIndexableTerm</span> <span class="directive">extends</span> LeaseTerm {
- <span class="directive">public</span> <span class="predefined-type">BigDecimal</span> getEffectveValue() { ... }
- ...
-}</code></pre>
-</div>
-</div>
+<div class="sect2">
+<h3 id="_ug_more-advanced_replacing-default-service-implementations">5.9. Replacing Service Implns</h3>
<div class="paragraph">
-<p>Currently the Wicket viewer will not render the property in tables (though the property is correctly rendered in views).</p>
+<p>The framework provides default implementations for many of the <a href="rg.html#_rg_services-api">API Services</a>. This is convenient, but sometimes you will want to replace the default implementation with your own service implementation.</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>For more background on this workaround, see <a href="https://issues.apache.org/jira/browse/ISIS-582">ISIS-582</a>.</p>
-</div>
-</td>
-</tr>
-</table>
+<p>The trick is to use the <a href="rg.html#_rg_annotations_manpage-DomainServiceLayout_menuOrder"><code>@DomainServiceLayout#menuOrder()</code></a> attribute, specifying a low number (typically <code>"1"</code>).</p>
</div>
<div class="paragraph">
-<p>The work-around is simple enough; make the method concrete in the superclass and return a dummy implementation, eg:</p>
+<p>For example, suppose you wanted to provide your own implementation of <a href="rg.html#_rg_services-api_manpage-LocaleProvider"><code>LocaleProvider</code></a>. Here’s how:</p>
</div>
<div class="listingblock">
<div class="content">
-<pre class="CodeRay highlight"><code data-lang="java"><span class="directive">public</span> <span class="directive">abstract</span> <span class="type">class</span> <span class="class">LeaseTerm</span> {
- <span class="directive">public</span> <span class="predefined-type">BigDecimal</span> getEffectiveValue() {
- <span class="keyword">return</span> <span class="predefined-constant">null</span>; <span class="comment">// workaround for ISIS-582</span>
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainService</span>(
+ nature = NatureOfService.DOMAIN
+)
+<span class="annotation">@DomainServiceLayout</span>(
+ menuOrder = <span class="string"><span class="delimiter">"</span><span class="content">1</span><span class="delimiter">"</span></span> <i class="conum" data-value="1"></i><b>(1)</b>
+)
+<span class="directive">public</span> <span class="type">class</span> <span class="class">MyLocaleProvider</span> <span class="directive">implements</span> LocaleProvider {
+ <span class="annotation">@Override</span>
+ <span class="directive">public</span> <span class="predefined-type">Locale</span> getLocale() {
+ <span class="keyword">return</span> ...
}
- ...
}</code></pre>
</div>
</div>
-<div class="paragraph">
-<p>Alternatively the implementation could throw a <code>RuntimeException</code>, eg</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="CodeRay highlight"><code data-lang="java"><span class="keyword">throw</span> <span class="keyword">new</span> <span class="exception">RuntimeException</span>(<span class="string"><span class="delimiter">"</span><span class="content">never called; workaround for ISIS-582</span><span class="delimiter">"</span></span>);</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_ug_more-advanced_tips-n-tricks_per-user-themes">5.10.4. Per-user Themes</h4>
-<div class="paragraph">
-<p>From the Apache Isis mailing list is:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><em>Is it possible to have each of our resellers (using our Isis application) use there own theme/branding with their own logo and colors? Would this also be possible for the login page, possibly depending on the used host name?</em></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Yes, you can do this, by installing a custom implementation of the Wicket Bootstrap’s <code>ActiveThemeProvider</code>.</p>
+<div class="colist arabic">
+<table>
+<tr>
+<td><i class="conum" data-value="1"></i><b>1</b></td>
+<td>takes precedence over the default implementation.</td>
+</tr>
+</table>
</div>
<div class="paragraph">
-<p>The <a href="http://github.com/isisaddons/isis-app-todoapp">Isis addons' todoapp</a> (non-ASF) actually <a href="https://github.com/isisaddons/isis-app-todoapp/tree/61b8114a8e01dbb3c380b31cf09eaed456407570">does this</a>, storing the info via the <a href="http://github.com/isisaddons/isis-module-settings">Isis addons' settings module</a> settings modules:</p>
+<p>It’s also quite common to want to decorate the existing implementation (ie have your own implementation delegate to the default); this is also possible and quite easy if using <code>1.10.0</code> or later:</p>
</div>
<div class="listingblock">
-<div class="title">IActiveThemeProvider implementation</div>
<div class="content">
-<pre class="CodeRay highlight"><code data-lang="java"><span class="directive">public</span> <span class="type">class</span> <span class="class">UserSettingsThemeProvider</span> <span class="directive">implements</span> ActiveThemeProvider {
- ...
- <span class="annotation">@Override</span>
- <span class="directive">public</span> ITheme getActiveTheme() {
- <span class="keyword">if</span>(IsisContext.getSpecificationLoader().isInitialized()) {
- <span class="directive">final</span> <span class="predefined-type">String</span> themeName = IsisContext.doInSession(<span class="keyword">new</span> <span class="predefined-type">Callable</span><<span class="predefined-type">String</span>>() {
- <span class="annotation">@Override</span>
- <span class="directive">public</span> <span class="predefined-type">String</span> call() <span class="directive">throws</span> <span class="exception">Exception</span> {
- <span class="directive">final</span> <span class="predefined-type">Class</span><UserSettingsService> serviceClass = UserSettingsService.class;
- <span class="directive">final</span> UserSettingsService userSettingsService = lookupService(serviceClass);
- <span class="directive">final</span> UserSetting activeTheme = userSettingsService.find(
- IsisContext.getAuthenticationSession().getUserName(), ACTIVE_THEME);
- <span class="keyword">return</span> activeTheme != <span class="predefined-constant">null</span> ? activeTheme.valueAsString() : <span class="predefined-constant">null</span>;
- }
- });
- <span class="keyword">return</span> themeFor(themeName);
- }
- <span class="keyword">return</span> <span class="keyword">new</span> SessionThemeProvider().getActiveTheme();
- }
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainService</span>(
+ nature = NatureOfService.DOMAIN
+)
+<span class="annotation">@DomainServiceLayout</span>(
+ menuOrder = <span class="string"><span class="delimiter">"</span><span class="content">1</span><span class="delimiter">"</span></span> <i class="conum" data-value="1"></i><b>(1)</b>
+)
+<span class="directive">public</span> <span class="type">class</span> <span class="class">MyLocaleProvider</span> <span class="directive">implements</span> LocaleProvider {
<span class="annotation">@Override</span>
- <span class="directive">public</span> <span class="type">void</span> setActiveTheme(<span class="directive">final</span> <span class="predefined-type">String</span> themeName) {
- IsisContext.doInSession(<span class="keyword">new</span> <span class="predefined-type">Runnable</span>() {
- <span class="annotation">@Override</span>
- <span class="directive">public</span> <span class="type">void</span> run() {
- <span class="directive">final</span> <span class="predefined-type">String</span> currentUsrName = IsisContext.getAuthenticationSession().getUserName();
- <span class="directive">final</span> UserSettingsServiceRW userSettingsService =
- lookupService(UserSettingsServiceRW.class);
- <span class="directive">final</span> UserSettingJdo activeTheme =
- (UserSettingJdo) userSettingsService.find(currentUsrName, ACTIVE_THEME);
- <span class="keyword">if</span>(activeTheme != <span class="predefined-constant">null</span>) {
- activeTheme.updateAsString(themeName);
- } <span class="keyword">else</span> {
- userSettingsService.newString(
- currentUsrName, ACTIVE_THEME, <span class="string"><span class="delimiter">"</span><span class="content">Active Bootstrap theme for user</span><span class="delimiter">"</span></span>, themeName);
- }
-
<TRUNCATED>