You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by jo...@apache.org on 2022/06/24 15:03:46 UTC
[isis] branch ISIS-3073 updated: ISIS-3073 detailed according to https://the-asf.slack.com/archives/CFC42LWBV/p1655990135439499
This is an automated email from the ASF dual-hosted git repository.
joergrade pushed a commit to branch ISIS-3073
in repository https://gitbox.apache.org/repos/asf/isis.git
The following commit(s) were added to refs/heads/ISIS-3073 by this push:
new 6da2cd7f06 ISIS-3073 detailed according to https://the-asf.slack.com/archives/CFC42LWBV/p1655990135439499
6da2cd7f06 is described below
commit 6da2cd7f062ff28b87066917bde630d490713062
Author: Jörg Rade <jo...@kuehne-nagel.com>
AuthorDate: Fri Jun 24 17:03:32 2022 +0200
ISIS-3073 detailed according to https://the-asf.slack.com/archives/CFC42LWBV/p1655990135439499
---
.../pages/index/events/domain/ActionDomainEvent.adoc | 15 ++++++++++++---
.../pages/index/events/domain/CollectionDomainEvent.adoc | 10 ++++++++--
.../pages/index/events/domain/PropertyDomainEvent.adoc | 10 ++++++++--
3 files changed, 28 insertions(+), 7 deletions(-)
diff --git a/antora/components/refguide-index/modules/applib/pages/index/events/domain/ActionDomainEvent.adoc b/antora/components/refguide-index/modules/applib/pages/index/events/domain/ActionDomainEvent.adoc
index b9ad0bda6b..6eafa31aa1 100644
--- a/antora/components/refguide-index/modules/applib/pages/index/events/domain/ActionDomainEvent.adoc
+++ b/antora/components/refguide-index/modules/applib/pages/index/events/domain/ActionDomainEvent.adoc
@@ -37,7 +37,10 @@ Subtypes can define a no-arg constructor; the framework sets state via (non-API)
<.> xref:#ActionDomainEvent__S[ActionDomainEvent(S)]
+
--
-Subtypes can define a one-arg constructor (for nested non-static classes of nested non-static mixins); the framework sets state via (non-API) setters.
+Subtypes can define a one-arg constructor; the framework sets state via (non-API) setters.
+This is useful where the domain event is declared in a mixin, which itself is nested as a non-static class within a parent type.
+In such a case the Java compiler implicitly adds a one-arg constructor of the parent type to the mixin, which means that the mixin contributes to its parent.
+The domain event defined within the mixin must also be non-static, and the compiler will again implicit add a one-arg constructor taking the mixin instance as its source.
--
<.> xref:#setReturnValue__Object[setReturnValue(Object)]
+
@@ -54,12 +57,18 @@ Set by the framework.
[#ActionDomainEvent__]
=== ActionDomainEvent()
-Subtypes can define a no-arg constructor; the framework sets state via (non-API) setters.
+Subtypes can define a one-arg constructor; the framework sets state via (non-API) setters.
+This is useful where the domain event is declared in a mixin, which itself is nested as a non-static class within a parent type.
+In such a case the Java compiler implicitly adds a one-arg constructor of the parent type to the mixin, which means that the mixin contributes to its parent.
+The domain event defined within the mixin must also be non-static, and the compiler will again implicit add a one-arg constructor taking the mixin instance as its source.
[#ActionDomainEvent__S]
=== ActionDomainEvent(S)
-Subtypes can define a one-arg constructor (for nested non-static classes of nested non-static mixins); the framework sets state via (non-API) setters.
+Subtypes can define a one-arg constructor; the framework sets state via (non-API) setters.
+This is useful where the domain event is declared in a mixin, which itself is nested as a non-static class within a parent type.
+In such a case the Java compiler implicitly adds a one-arg constructor of the parent type to the mixin, which means that the mixin contributes to its parent.
+The domain event defined within the mixin must also be non-static, and the compiler will again implicit add a one-arg constructor taking the mixin instance as its source.
[#setReturnValue__Object]
=== setReturnValue(Object)
diff --git a/antora/components/refguide-index/modules/applib/pages/index/events/domain/CollectionDomainEvent.adoc b/antora/components/refguide-index/modules/applib/pages/index/events/domain/CollectionDomainEvent.adoc
index 7bd3e2b297..fcfda27d01 100644
--- a/antora/components/refguide-index/modules/applib/pages/index/events/domain/CollectionDomainEvent.adoc
+++ b/antora/components/refguide-index/modules/applib/pages/index/events/domain/CollectionDomainEvent.adoc
@@ -27,7 +27,10 @@ Subtypes can define a no-arg constructor; the framework sets state via (non-API)
<.> xref:#CollectionDomainEvent__S[CollectionDomainEvent(S)]
+
--
-Subtypes can define a one-arg constructor (for nested non-static classes of nested non-static mixins); the framework sets state via (non-API) setters.
+Subtypes can define a one-arg constructor; the framework sets state via (non-API) setters.
+This is useful where the domain event is declared in a mixin, which itself is nested as a non-static class within a parent type.
+In such a case the Java compiler implicitly adds a one-arg constructor of the parent type to the mixin, which means that the mixin contributes to its parent.
+The domain event defined within the mixin must also be non-static, and the compiler will again implicit add a one-arg constructor taking the mixin instance as its source.
--
== Members
@@ -40,4 +43,7 @@ Subtypes can define a no-arg constructor; the framework sets state via (non-API)
[#CollectionDomainEvent__S]
=== CollectionDomainEvent(S)
-Subtypes can define a one-arg constructor (for nested non-static classes of nested non-static mixins); the framework sets state via (non-API) setters.
+Subtypes can define a one-arg constructor; the framework sets state via (non-API) setters.
+This is useful where the domain event is declared in a mixin, which itself is nested as a non-static class within a parent type.
+In such a case the Java compiler implicitly adds a one-arg constructor of the parent type to the mixin, which means that the mixin contributes to its parent.
+The domain event defined within the mixin must also be non-static, and the compiler will again implicit add a one-arg constructor taking the mixin instance as its source.
diff --git a/antora/components/refguide-index/modules/applib/pages/index/events/domain/PropertyDomainEvent.adoc b/antora/components/refguide-index/modules/applib/pages/index/events/domain/PropertyDomainEvent.adoc
index 96addb60da..5e24f47c10 100644
--- a/antora/components/refguide-index/modules/applib/pages/index/events/domain/PropertyDomainEvent.adoc
+++ b/antora/components/refguide-index/modules/applib/pages/index/events/domain/PropertyDomainEvent.adoc
@@ -31,7 +31,10 @@ Subtypes can define a no-arg constructor; the framework sets state via (non-API)
<.> xref:#PropertyDomainEvent__S[PropertyDomainEvent(S)]
+
--
-Subtypes can define a one-arg constructor (for nested non-static classes of nested non-static mixins); the framework sets state via (non-API) setters.
+Subtypes can define a one-arg constructor; the framework sets state via (non-API) setters.
+This is useful where the domain event is declared in a mixin, which itself is nested as a non-static class within a parent type.
+In such a case the Java compiler implicitly adds a one-arg constructor of the parent type to the mixin, which means that the mixin contributes to its parent.
+The domain event defined within the mixin must also be non-static, and the compiler will again implicit add a one-arg constructor taking the mixin instance as its source.
--
== Members
@@ -44,4 +47,7 @@ Subtypes can define a no-arg constructor; the framework sets state via (non-API)
[#PropertyDomainEvent__S]
=== PropertyDomainEvent(S)
-Subtypes can define a one-arg constructor (for nested non-static classes of nested non-static mixins); the framework sets state via (non-API) setters.
+Subtypes can define a one-arg constructor; the framework sets state via (non-API) setters.
+This is useful where the domain event is declared in a mixin, which itself is nested as a non-static class within a parent type.
+In such a case the Java compiler implicitly adds a one-arg constructor of the parent type to the mixin, which means that the mixin contributes to its parent.
+The domain event defined within the mixin must also be non-static, and the compiler will again implicit add a one-arg constructor taking the mixin instance as its source.