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:53:32 UTC
[1/4] isis git commit: ISIS-830: adding migration notes for 1.10.0,
mentioning the allowLateRegistration flag.
Repository: isis
Updated Branches:
refs/heads/master efea4aba6 -> 8ad840ac9
ISIS-830: adding migration notes for 1.10.0, mentioning the allowLateRegistration flag.
Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/c610861d
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/c610861d
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/c610861d
Branch: refs/heads/master
Commit: c610861d241dabc9f6475ded2b1bf063c29acccc
Parents: efea4ab
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Tue Nov 3 09:33:47 2015 +0000
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Tue Nov 3 09:33:47 2015 +0000
----------------------------------------------------------------------
.../_migration-notes_1.7.0-to-1.8.0.adoc | 5 +-
.../_migration-notes_1.9.0-to-1.10.0.adoc | 65 ++++++++++++++++++++
.../src/main/asciidoc/migration-notes.adoc | 2 +
3 files changed, 71 insertions(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis/blob/c610861d/adocs/documentation/src/main/asciidoc/_migration-notes_1.7.0-to-1.8.0.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/_migration-notes_1.7.0-to-1.8.0.adoc b/adocs/documentation/src/main/asciidoc/_migration-notes_1.7.0-to-1.8.0.adoc
index 07fc6d0..c641322 100644
--- a/adocs/documentation/src/main/asciidoc/_migration-notes_1.7.0-to-1.8.0.adoc
+++ b/adocs/documentation/src/main/asciidoc/_migration-notes_1.7.0-to-1.8.0.adoc
@@ -15,7 +15,10 @@ That said, many of the existing annotations have been deprecated in 1.8.0, repla
set of annotations; see link:../../reference/recognized-annotations/about.html[here]. To help you migrate your application
over to the new annotations, there is a new configuration property that can be set in `isis.properties`:
- isis.reflector.validator.allowDeprecated=false
+[source,ini]
+----
+isis.reflector.validator.allowDeprecated=false
+----
If this flag is present and set to false, then metamodel validation errors will be thrown on startup if any deprecated
annotations are encountered. These can be viewed either in the console or by browsing to the app (an error page will
http://git-wip-us.apache.org/repos/asf/isis/blob/c610861d/adocs/documentation/src/main/asciidoc/_migration-notes_1.9.0-to-1.10.0.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/_migration-notes_1.9.0-to-1.10.0.adoc b/adocs/documentation/src/main/asciidoc/_migration-notes_1.9.0-to-1.10.0.adoc
new file mode 100644
index 0000000..cab3c3a
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/_migration-notes_1.9.0-to-1.10.0.adoc
@@ -0,0 +1,65 @@
+[[_release-notes_migration-notes_1.9.0-to-1.10.0]]
+= From v1.9.0 to 1.10.0
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+
+Existing projects written against v1.9.0 should run against v1.10.0 with few if any changes. If you *do* encounter
+any difficulties then let us know via the link:support.html[users mailing list], so we can support you and document
+issues here.
+
+
+
+== `allowLateRegistration`
+
+One possible issue is that (as per link:https://issues.apache.org/jira/browse/ISIS-830[ISIS-830]) the xref:rg.adoc#_rg_services-api_manpage-EventBusService[`EventBusService`] 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)
+ http://github.com/isisaddons/isis-module-security[Isis addons' security] module.
+
+In previous releases, the ordering of initialization for the `EventBusService` 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.
+
+Now, though, because the `EventBusService` 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:
+
+[source,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)
+----
+
+
+To ensure that subscriber domain services are initialized before "seed" domain services, the xref:rg.adoc#_rg_annotations_manpage-DomainServiceLayout_menuOrder[`@DomainServiceLayout#menuOrder()`] 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.
+
+Alternatively, you can disable this checking within the `EventBusService` using:
+
+[source,ini]
+----
+isis.services.eventbus.allowLateRegistration=false
+----
+
+If you do that, be aware that not all subscribers may not receive some events generated by other domain services.
+
+For more details, see the xref:rg.adoc#_rg_services-api_manpage-EventBusService[`EventBusService`] man page.
+
http://git-wip-us.apache.org/repos/asf/isis/blob/c610861d/adocs/documentation/src/main/asciidoc/migration-notes.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/migration-notes.adoc b/adocs/documentation/src/main/asciidoc/migration-notes.adoc
index 5dd5d7b..eef8ed1 100644
--- a/adocs/documentation/src/main/asciidoc/migration-notes.adoc
+++ b/adocs/documentation/src/main/asciidoc/migration-notes.adoc
@@ -6,6 +6,8 @@
+
+include::_migration-notes_1.9.0-to-1.10.0.adoc[leveloffset=+1]
include::_migration-notes_1.8.0-to-1.9.0.adoc[leveloffset=+1]
include::_migration-notes_1.7.0-to-1.8.0.adoc[leveloffset=+1]
include::_migration-notes_1.6.0-to-1.7.0.adoc[leveloffset=+1]
[4/4] isis git commit: ISIS-1195: recreating simpleapp archetype
Posted by da...@apache.org.
ISIS-1195: recreating simpleapp archetype
Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/8ad840ac
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/8ad840ac
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/8ad840ac
Branch: refs/heads/master
Commit: 8ad840ac935dfc065782a1bc2c8c17a0506573db
Parents: f0ff059
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Tue Nov 3 09:52:10 2015 +0000
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Tue Nov 3 09:52:10 2015 +0000
----------------------------------------------------------------------
.../src/main/java/domainapp/dom/simple/SimpleObject.layout.json | 2 +-
.../src/test/resources/projects/basic/archetype.properties | 2 +-
2 files changed, 2 insertions(+), 2 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis/blob/8ad840ac/example/archetype/simpleapp/src/main/resources/archetype-resources/dom/src/main/java/domainapp/dom/simple/SimpleObject.layout.json
----------------------------------------------------------------------
diff --git a/example/archetype/simpleapp/src/main/resources/archetype-resources/dom/src/main/java/domainapp/dom/simple/SimpleObject.layout.json b/example/archetype/simpleapp/src/main/resources/archetype-resources/dom/src/main/java/domainapp/dom/simple/SimpleObject.layout.json
index 3d5e23f..d6d6012 100644
--- a/example/archetype/simpleapp/src/main/resources/archetype-resources/dom/src/main/java/domainapp/dom/simple/SimpleObject.layout.json
+++ b/example/archetype/simpleapp/src/main/resources/archetype-resources/dom/src/main/java/domainapp/dom/simple/SimpleObject.layout.json
@@ -32,7 +32,7 @@
},
"versionSequence": {
"propertyLayout": {
- "name": "version"
+ "named": "Version"
}
}
}
http://git-wip-us.apache.org/repos/asf/isis/blob/8ad840ac/example/archetype/simpleapp/src/test/resources/projects/basic/archetype.properties
----------------------------------------------------------------------
diff --git a/example/archetype/simpleapp/src/test/resources/projects/basic/archetype.properties b/example/archetype/simpleapp/src/test/resources/projects/basic/archetype.properties
index e8e37f2..05fcd84 100644
--- a/example/archetype/simpleapp/src/test/resources/projects/basic/archetype.properties
+++ b/example/archetype/simpleapp/src/test/resources/projects/basic/archetype.properties
@@ -1,4 +1,4 @@
-#Mon Nov 02 18:40:29 GMT 2015
+#Tue Nov 03 09:51:58 GMT 2015
package=it.pkg
version=0.1-SNAPSHOT
groupId=archetype.it
[3/4] isis git commit: ISIS-1195: updating docs on APT processing in
IntelliJ.
Posted by da...@apache.org.
ISIS-1195: updating docs on APT processing in IntelliJ.
Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/f0ff059e
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/f0ff059e
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/f0ff059e
Branch: refs/heads/master
Commit: f0ff059e0e35fed08e24c3137ae477c08a053eb4
Parents: 6fd4f5b
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Tue Nov 3 09:50:40 2015 +0000
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Tue Nov 3 09:50:40 2015 +0000
----------------------------------------------------------------------
.../main/asciidoc/guides/_cg_ide_intellij.adoc | 8 +++++++-
.../020-annotation-processor.png | Bin 57338 -> 67560 bytes
2 files changed, 7 insertions(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis/blob/f0ff059e/adocs/documentation/src/main/asciidoc/guides/_cg_ide_intellij.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_cg_ide_intellij.adoc b/adocs/documentation/src/main/asciidoc/guides/_cg_ide_intellij.adoc
index fbc3f97..20e3cd2 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_cg_ide_intellij.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_cg_ide_intellij.adoc
@@ -127,7 +127,7 @@ On the *Compiler* Settings page, ensure that `build automatically` is enabled (a
image::{_imagesdir}appendices/dev-env/intellij-idea/040-other-settings-compiler/010-build-automatically.png[width="600px"]
-On the *Annotation Processors* page, enable and adjust:
+On the *Annotation Processors* page, enable and adjust for the 'default' setting:
.IntelliJ Annotation Processor Settings
image::{_imagesdir}appendices/dev-env/intellij-idea/040-other-settings-compiler/020-annotation-processor.png[width="600px"]
@@ -135,6 +135,12 @@ image::{_imagesdir}appendices/dev-env/intellij-idea/040-other-settings-compiler/
This setting enables the generation of the `Q*` classes for DataNucleus type-safe queries, as well as being required
for frameworks such as xref:_cg_ide_project-lombok[Project Lombok].
+[NOTE]
+====
+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.
+====
+
+
[[_cg_ide_intellij_other-settings-maven]]
=== Other Settings (Maven)
http://git-wip-us.apache.org/repos/asf/isis/blob/f0ff059e/adocs/documentation/src/main/asciidoc/guides/images/appendices/dev-env/intellij-idea/040-other-settings-compiler/020-annotation-processor.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/images/appendices/dev-env/intellij-idea/040-other-settings-compiler/020-annotation-processor.png b/adocs/documentation/src/main/asciidoc/guides/images/appendices/dev-env/intellij-idea/040-other-settings-compiler/020-annotation-processor.png
index 96f4199..7618a4d 100644
Binary files a/adocs/documentation/src/main/asciidoc/guides/images/appendices/dev-env/intellij-idea/040-other-settings-compiler/020-annotation-processor.png and b/adocs/documentation/src/main/asciidoc/guides/images/appendices/dev-env/intellij-idea/040-other-settings-compiler/020-annotation-processor.png differ
[2/4] isis git commit: ISIS-1195: tiny fix for simpleapp.
Posted by da...@apache.org.
ISIS-1195: tiny fix for simpleapp.
Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/6fd4f5be
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/6fd4f5be
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/6fd4f5be
Branch: refs/heads/master
Commit: 6fd4f5be7e06137dd1129d07bde0754829a2635b
Parents: c610861
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Tue Nov 3 09:34:07 2015 +0000
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Tue Nov 3 09:34:07 2015 +0000
----------------------------------------------------------------------
.../src/main/java/domainapp/dom/simple/SimpleObject.layout.json | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis/blob/6fd4f5be/example/application/simpleapp/dom/src/main/java/domainapp/dom/simple/SimpleObject.layout.json
----------------------------------------------------------------------
diff --git a/example/application/simpleapp/dom/src/main/java/domainapp/dom/simple/SimpleObject.layout.json b/example/application/simpleapp/dom/src/main/java/domainapp/dom/simple/SimpleObject.layout.json
index 3d5e23f..d6d6012 100644
--- a/example/application/simpleapp/dom/src/main/java/domainapp/dom/simple/SimpleObject.layout.json
+++ b/example/application/simpleapp/dom/src/main/java/domainapp/dom/simple/SimpleObject.layout.json
@@ -32,7 +32,7 @@
},
"versionSequence": {
"propertyLayout": {
- "name": "version"
+ "named": "Version"
}
}
}