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/03 10:51:24 UTC
[1/2] isis-site git commit: migration notes for 1.10.0
Repository: isis-site
Updated Branches:
refs/heads/asf-site b2d0972c0 -> a46bb8ed1
migration notes for 1.10.0
Project: http://git-wip-us.apache.org/repos/asf/isis-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis-site/commit/d1268b9b
Tree: http://git-wip-us.apache.org/repos/asf/isis-site/tree/d1268b9b
Diff: http://git-wip-us.apache.org/repos/asf/isis-site/diff/d1268b9b
Branch: refs/heads/asf-site
Commit: d1268b9b205baf5c88cade977b16901ea36d4759
Parents: b2d0972
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Tue Nov 3 09:34:48 2015 +0000
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Tue Nov 3 09:34:48 2015 +0000
----------------------------------------------------------------------
content/migration-notes.html | 78 ++++++++++++++++++++++++++++++++++++++-
1 file changed, 76 insertions(+), 2 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis-site/blob/d1268b9b/content/migration-notes.html
----------------------------------------------------------------------
diff --git a/content/migration-notes.html b/content/migration-notes.html
index 86886e6..4d45c93 100644
--- a/content/migration-notes.html
+++ b/content/migration-notes.html
@@ -488,6 +488,75 @@ table.CodeRay td.code>pre{padding:0}
<div id="doc-content">
<div class="sect1">
+<h2 id="_release-notes_migration-notes_1.9.0-to-1.10.0">From v1.9.0 to 1.10.0</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Existing projects written against v1.9.0 should run against v1.10.0 with few if any changes. If you <strong>do</strong> encounter
+any difficulties then let us know via the <a href="support.html">users mailing list</a>, so we can support you and document
+issues here.</p>
+</div>
+<div class="sect2">
+<h3 id="__code_allowlateregistration_code"><code>allowLateRegistration</code></h3>
+<div class="paragraph">
+<p>One possible issue is that (as per <a href="https://issues.apache.org/jira/browse/ISIS-830">ISIS-830</a>) the <a href="rg.html#_rg_services-api_manpage-EventBusService"><code>EventBusService</code></a> is now initialized as one of the first domain
+services; this is to ensure that any object lifecycle events caused by domain services initializing themselves can be
+posted on the event bus for subscribers. The typical case for such lifecycle events to occur is from domain services
+that seed reference data; one such example can be found in the (non-ASF)
+ <a href="http://github.com/isisaddons/isis-module-security">Isis addons' security</a> module.</p>
+</div>
+<div class="paragraph">
+<p>In previous releases, the ordering of initialization for the <code>EventBusService</code> was undefined (but would typically be towards the
+"end" of the list of services. What this meant in practice is that it generally didn’t matter whether (domain service)
+subscribers were initialized before or after seed services.</p>
+</div>
+<div class="paragraph">
+<p>Now, though, because the <code>EventBusService</code> is initialized early on, it proactively checks that all subscribers have
+been registered before any event posts occur (so that no events get missed). If any subscriber attempts to register
+after at least one event has been posted, then the service will fail fast and the framework will not start. The error looks something like:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="log">: EXEC
+org.isisaddons.module.security.seed.scripts.IsisModuleSecurityAdminUser
+seed-users-and-roles-fixture-script/isis-applib-fixture-results-role-and-permissions
+: EXEC
+org.isisaddons.module.security.seed.scripts.IsisApplibFixtureResultsRoleAndPermissions
+19:41:19,478 [IsisTransaction main INFO ] abort transaction
+IsisTransaction@5dc1597f[state=MUST_ABORT,commands=1]
+19:41:19,495 [IsisWicketApplication main ERROR] Failed to initialize
+com.google.inject.ProvisionException: Guice provision errors:
+
+1) Error in custom provider,
+org.apache.isis.core.runtime.system.transaction.IsisTransactionManagerException:
+java.lang.IllegalStateException: Events have already been posted; too late
+to register any further (singleton) subscribers
+ at
+org.apache.isis.core.runtime.runner.IsisInjectModule.provideIsisSystem(IsisInjectModule.java:139)</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>To ensure that subscriber domain services are initialized before "seed" domain services, the <a href="rg.html#_rg_annotations_manpage-DomainServiceLayout_menuOrder"><code>@DomainServiceLayout#menuOrder()</code></a> attribute can be used.
+Normally this attribute is just used to order UI-visible services on the menu bars, but it also is used
+internally to sequence the internal list of services being initialized.</p>
+</div>
+<div class="paragraph">
+<p>Alternatively, you can disable this checking within the <code>EventBusService</code> using:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="ini">isis.services.eventbus.allowLateRegistration=false</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>If you do that, be aware that not all subscribers may not receive some events generated by other domain services.</p>
+</div>
+<div class="paragraph">
+<p>For more details, see the <a href="rg.html#_rg_services-api_manpage-EventBusService"><code>EventBusService</code></a> man page.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
<h2 id="_release-notes_migration-notes_1.8.0-to-1.9.0">From v1.8.0 to 1.9.0</h2>
<div class="sectionbody">
<div class="sect2">
@@ -1373,9 +1442,9 @@ then let us know via the <a href="support.html">users mailing list</a>, so we ca
set of annotations; see <a href="../../reference/recognized-annotations/about.html">here</a>. To help you migrate your application
over to the new annotations, there is a new configuration property that can be set in <code>isis.properties</code>:</p>
</div>
-<div class="literalblock">
+<div class="listingblock">
<div class="content">
-<pre>isis.reflector.validator.allowDeprecated=false</pre>
+<pre class="CodeRay highlight"><code data-lang="ini">isis.reflector.validator.allowDeprecated=false</code></pre>
</div>
</div>
<div class="paragraph">
@@ -1701,6 +1770,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="#_release-notes_migration-notes_1.9.0-to-1.10.0">From v1.9.0 to 1.10.0</a>
+<ul class="sectlevel2">
+<li><a href="#__code_allowlateregistration_code"><code>allowLateRegistration</code></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>
<ul class="sectlevel2">
<li><a href="#_migration-notes_1.8.0-to-1.9.0_upgrading-to-dn4">Upgrading to DataNucleus 4</a>
[2/2] isis-site git commit: updated page on APT processor settings
for IntelliJ
Posted by da...@apache.org.
updated page on APT processor settings for IntelliJ
Project: http://git-wip-us.apache.org/repos/asf/isis-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis-site/commit/a46bb8ed
Tree: http://git-wip-us.apache.org/repos/asf/isis-site/tree/a46bb8ed
Diff: http://git-wip-us.apache.org/repos/asf/isis-site/diff/a46bb8ed
Branch: refs/heads/asf-site
Commit: a46bb8ed1da6dce604079c36c6a15c4c3a55793e
Parents: d1268b9
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Tue Nov 3 09:50:51 2015 +0000
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Tue Nov 3 09:50:51 2015 +0000
----------------------------------------------------------------------
content/guides/cg.html | 16 +++++++++++++++-
.../020-annotation-processor.png | Bin 57338 -> 67560 bytes
2 files changed, 15 insertions(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis-site/blob/a46bb8ed/content/guides/cg.html
----------------------------------------------------------------------
diff --git a/content/guides/cg.html b/content/guides/cg.html
index 2e5c2d9..6971768 100644
--- a/content/guides/cg.html
+++ b/content/guides/cg.html
@@ -724,7 +724,7 @@ at the time of writing Apache Isis supports only Java 7; Java 8 is scheduled for
<div class="title">Figure 16. IntelliJ Compiler Settings</div>
</div>
<div class="paragraph">
-<p>On the <strong>Annotation Processors</strong> page, enable and adjust:</p>
+<p>On the <strong>Annotation Processors</strong> page, enable and adjust for the 'default' setting:</p>
</div>
<div class="imageblock">
<div class="content">
@@ -736,6 +736,20 @@ at the time of writing Apache Isis supports only Java 7; Java 8 is scheduled for
<p>This setting enables the generation of the <code>Q*</code> classes for DataNucleus type-safe queries, as well as being required
for frameworks such as <a href="#_cg_ide_project-lombok">Project Lombok</a>.</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>IntelliJ may also have inferred these settings for specific projects/modules when importing; review the list on the left to see if the default is overridden and fix/delete as required.</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
</div>
<div class="sect4">
<h5 id="_cg_ide_intellij_other-settings-maven">Other Settings (Maven)</h5>
http://git-wip-us.apache.org/repos/asf/isis-site/blob/a46bb8ed/content/guides/images/appendices/dev-env/intellij-idea/040-other-settings-compiler/020-annotation-processor.png
----------------------------------------------------------------------
diff --git a/content/guides/images/appendices/dev-env/intellij-idea/040-other-settings-compiler/020-annotation-processor.png b/content/guides/images/appendices/dev-env/intellij-idea/040-other-settings-compiler/020-annotation-processor.png
index 96f4199..7618a4d 100644
Binary files a/content/guides/images/appendices/dev-env/intellij-idea/040-other-settings-compiler/020-annotation-processor.png and b/content/guides/images/appendices/dev-env/intellij-idea/040-other-settings-compiler/020-annotation-processor.png differ