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 <joerg.r...@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.