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/11 12:52:43 UTC
isis-site git commit: updating how-to and powered-by
Repository: isis-site
Updated Branches:
refs/heads/asf-site 698681478 -> 0b3c5d1cc
updating how-to and powered-by
Project: http://git-wip-us.apache.org/repos/asf/isis-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis-site/commit/0b3c5d1c
Tree: http://git-wip-us.apache.org/repos/asf/isis-site/tree/0b3c5d1c
Diff: http://git-wip-us.apache.org/repos/asf/isis-site/diff/0b3c5d1c
Branch: refs/heads/asf-site
Commit: 0b3c5d1ccc7e96305135f9516d8fefacc2ade905
Parents: 6986814
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Wed Nov 11 11:52:16 2015 +0000
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Wed Nov 11 11:52:16 2015 +0000
----------------------------------------------------------------------
content/documentation.html | 2 +-
content/guides/cg.html | 36 +++++++++++-----
content/guides/ug.html | 91 ++++++++++++++++++++++++++++++++++++++-
content/migration-notes.html | 8 ++++
content/powered-by.html | 2 +-
5 files changed, 126 insertions(+), 13 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis-site/blob/0b3c5d1c/content/documentation.html
----------------------------------------------------------------------
diff --git a/content/documentation.html b/content/documentation.html
index acfc5ed..ef62be3 100644
--- a/content/documentation.html
+++ b/content/documentation.html
@@ -542,7 +542,7 @@ table.CodeRay td.code>pre{padding:0}
<p><a href="./guides/tg.html">Tutorials</a></p>
</li>
<li>
-<p><a href="http://www.javadoc.io/doc/org.apache.isis.core/isis-core-applib/1.9.0">Javadoc (for Applib)</a> (not ASF)</p>
+<p><a href="http://www.javadoc.io/doc/org.apache.isis.core/isis-core-applib/1.10.0">Javadoc (for Applib)</a> (not ASF)</p>
</li>
</ul>
</div></div></td>
http://git-wip-us.apache.org/repos/asf/isis-site/blob/0b3c5d1c/content/guides/cg.html
----------------------------------------------------------------------
diff --git a/content/guides/cg.html b/content/guides/cg.html
index 068f312..8346303 100644
--- a/content/guides/cg.html
+++ b/content/guides/cg.html
@@ -4920,28 +4920,44 @@ git push</code></pre>
<p>Once the Apache Isis release is available, all of the (non-ASF) <a href="http://isisaddons.org">Isis Addons</a> should also be released.</p>
</div>
<div class="paragraph">
-<p>For each add-on:</p>
+<p>Using this <a href="https://gist.github.com/danhaywood/3129b688be3628322c01">gist</a> to invoke operations across all (or selected) addons:</p>
</div>
<div class="ulist">
<ul>
<li>
-<p>update its dependency on Apache Isis to reference the newly released version</p>
-<div class="ulist">
-<ul>
+<p>update its dependency on Apache Isis to reference the newly released version:<br></p>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="bash">sh all.sh -r "1.11.0" bumpisis</code></pre>
+</div>
+</div>
+</li>
<li>
-<p>all the addons define their dependency in the <code><isis.version></code> property, so search for this string across all <code>pom.xml</code> files</p>
+<p>confirm compiles:<br></p>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="bash">sh all.sh mcio</code></pre>
+</div>
+</div>
</li>
-</ul>
+<li>
+<p>release to mvn central:<br></p>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="bash">sh all.sh -r "1.11.0" -s "1.12.0-SNAPSHOT" -k "dan@haywood-associates.co.uk" -p "this is not my password" release</code></pre>
+</div>
</div>
</li>
<li>
-<p>use the <code>release.sh</code> script (that each provides) to release.</p>
+<p>update its dependency on Apache Isis to reference the next SNAPSHOT version:<br></p>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="bash">sh all.sh -r "1.12.0-SNAPSHOT" bumpisis</code></pre>
+</div>
+</div>
</li>
</ul>
</div>
-<div class="paragraph">
-<p>You can use this <a href="https://gist.github.com/danhaywood/3129b688be3628322c01">gist</a> to invoke <code>release.sh</code> across all (or selected) addons.</p>
-</div>
</div>
</div>
<div class="sect2">
http://git-wip-us.apache.org/repos/asf/isis-site/blob/0b3c5d1c/content/guides/ug.html
----------------------------------------------------------------------
diff --git a/content/guides/ug.html b/content/guides/ug.html
index 7d8f584..fc6cf41 100644
--- a/content/guides/ug.html
+++ b/content/guides/ug.html
@@ -2463,7 +2463,7 @@ script to be run.</p>
<h2 id="_ug_how-tos">4. How tos</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>This chapter provides instructions on how to go about actually developing Apache Isis domain applications.</p>
+<p>This chapter provides a grab bag of "how-to"s and tips to help you go about actually developing Apache Isis domain applications.</p>
</div>
<div class="sect2">
<h3 id="_ug_how-tos_class-structure">4.1. Class Structure</h3>
@@ -4864,6 +4864,94 @@ TODO - <a href="rg.html#_rg_annotations_manpage-DomainObject_bounded"><code>@Dom
<p>The above is probably the easiest and most straightforward design. One could imagine other designs where the persisted title is stored elsewhere. It could even be stored off into an <a href="http://lucene.apache.org/">Apache Lucene</a> (or similar) database to allow for free-text searches.</p>
</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">
+<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>
+</tr>
+</table>
+</div>
+</div>
</div>
</div>
<div class="sect1">
@@ -15111,6 +15199,7 @@ TODO
</ul>
</li>
<li><a href="#_ug_how-tos_persisted-title">4.10. Persisted Title</a></li>
+<li><a href="#_ug_how-tos_replacing-default-service-implementations">4.11. Replacing Service Implns</a></li>
</ul>
</li>
<li><a href="#_ug_more-advanced">5. More Advanced Techniques</a>
http://git-wip-us.apache.org/repos/asf/isis-site/blob/0b3c5d1c/content/migration-notes.html
----------------------------------------------------------------------
diff --git a/content/migration-notes.html b/content/migration-notes.html
index bcce2c9..d03c367 100644
--- a/content/migration-notes.html
+++ b/content/migration-notes.html
@@ -620,6 +620,13 @@ internally to sequence the internal list of services being initialized.</p>
</div>
</div>
</div>
+<div class="sect2">
+<h3 id="_isis_maven_plugin">isis-maven-plugin</h3>
+<div class="paragraph">
+<p>The way that the Isis Maven plugin is configured has changed slightly; check out its
+<a href="cg.html#_cg_isis-maven-plugin">documentation</a> for full details.</p>
+</div>
+</div>
</div>
</div>
<div class="sect1">
@@ -1841,6 +1848,7 @@ into the new <code>org.isisaddons.module.settings:isis-module-settings-dom</code
<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>
<li><a href="#__code_allowlateregistration_code"><code>allowLateRegistration</code></a></li>
<li><a href="#_simplify_domain_events">Simplify domain events</a></li>
+<li><a href="#_isis_maven_plugin">isis-maven-plugin</a></li>
</ul>
</li>
<li><a href="#_release-notes_migration-notes_1.8.0-to-1.9.0">From v1.8.0 to 1.9.0</a>
http://git-wip-us.apache.org/repos/asf/isis-site/blob/0b3c5d1c/content/powered-by.html
----------------------------------------------------------------------
diff --git a/content/powered-by.html b/content/powered-by.html
index f117b6b..59c641a 100644
--- a/content/powered-by.html
+++ b/content/powered-by.html
@@ -694,7 +694,7 @@ as <a href="http://github.com/isisaddons/isis-module-audit">audit</a>, <a href="
and the <a href="http://github.com/isisaddons/isis-module-excel">excel</a> modules).</p>
</div>
<div class="paragraph">
-<p>The GRC platform currently has more than 4600 automated tests, about 2000 being
+<p>The GRC platform currently has more than 5600 automated tests, about 2000 being
<a href="ug.html#_ug_testing_bdd-spec-support">BDD tests</a> and 3600 <a href="ug.html#_ug_testing_integ-test-support">integration
tests</a>, all leveraging Apache Isis' extensive testing capabilities.</p>
</div>