You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@causeway.apache.org by da...@apache.org on 2024/04/03 19:24:37 UTC
(causeway) branch 3.0.0 updated (19619ff6bc -> 9b001038e8)
This is an automated email from the ASF dual-hosted git repository.
danhaywood pushed a change to branch 3.0.0
in repository https://gitbox.apache.org/repos/asf/causeway.git
from 19619ff6bc CAUSEWAY-3666: updates docs
new f08554d163 3.0.0: fixes <version> number
new 8b45dfc723 2.0.0: updates the 2.0.0 and 3.0.0 release notes
new 9b001038e8 2.0.0: improves the documentation for graphql viewer
The 3 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
.../modules/ROOT/pages/landing-page/releases.adoc | 2 +-
.../modules/ROOT/pages/2024/2.0.0/relnotes.adoc | 4 +-
.../modules/ROOT/pages/2024/3.0.0/relnotes.adoc | 40 +++++++++++++--
.../relnotes/modules/ROOT/pages/about.adoc | 9 ++--
.../ROOT/partials/2024/2.0.0/_relnotes.adoc | 5 +-
starters/adoc/modules/starters/pages/about.adoc | 4 +-
viewers/graphql/adoc/modules/ROOT/pages/about.adoc | 58 ++++++++++++++++++++--
7 files changed, 102 insertions(+), 20 deletions(-)
(causeway) 01/03: 3.0.0: fixes number
Posted by da...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
danhaywood pushed a commit to branch 3.0.0
in repository https://gitbox.apache.org/repos/asf/causeway.git
commit f08554d16354477d72aef18e2500f6e6de7c8ec2
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Wed Apr 3 20:01:56 2024 +0100
3.0.0: fixes <version> number
---
antora/components/docs/modules/ROOT/pages/landing-page/releases.adoc | 2 +-
starters/adoc/modules/starters/pages/about.adoc | 4 ++--
2 files changed, 3 insertions(+), 3 deletions(-)
diff --git a/antora/components/docs/modules/ROOT/pages/landing-page/releases.adoc b/antora/components/docs/modules/ROOT/pages/landing-page/releases.adoc
index b7136752e5..0ac2d9b48a 100644
--- a/antora/components/docs/modules/ROOT/pages/landing-page/releases.adoc
+++ b/antora/components/docs/modules/ROOT/pages/landing-page/releases.adoc
@@ -16,7 +16,7 @@ If your app inherits from the xref:docs:parent-pom:about.adoc[Parent POM], then
<parent>
<groupId>org.apache.causeway.app</groupId>
<artifactId>causeway-app-starter-parent</artifactId>
- <version>2.0.0</version> <!--.-->
+ <version>3.0.0</version> <!--.-->
</parent>
----
<.> update as required.
diff --git a/starters/adoc/modules/starters/pages/about.adoc b/starters/adoc/modules/starters/pages/about.adoc
index a126e69658..f946f2129a 100644
--- a/starters/adoc/modules/starters/pages/about.adoc
+++ b/starters/adoc/modules/starters/pages/about.adoc
@@ -53,9 +53,9 @@ For both apps you can bump to newer versions of the framework just by updating t
<parent>
<groupId>org.apache.causeway.app</groupId>
<artifactId>causeway-app-starter-parent</artifactId>
- <version>2.0.0</version> <!--1-->
+ <version>3.0.0</version> <!--.-->
</parent>
----
-<1> update as required.
+<.> update as required.
Check the release notes/migration notes for details on new features and of any breaking changes.
(causeway) 03/03: 2.0.0: improves the documentation for graphql viewer
Posted by da...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
danhaywood pushed a commit to branch 3.0.0
in repository https://gitbox.apache.org/repos/asf/causeway.git
commit 9b001038e8c99ec3ecd9e17bb3788a8db0defe87
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Wed Apr 3 20:20:11 2024 +0100
2.0.0: improves the documentation for graphql viewer
---
viewers/graphql/adoc/modules/ROOT/pages/about.adoc | 58 ++++++++++++++++++++--
1 file changed, 53 insertions(+), 5 deletions(-)
diff --git a/viewers/graphql/adoc/modules/ROOT/pages/about.adoc b/viewers/graphql/adoc/modules/ROOT/pages/about.adoc
index 6349df0b61..8b66d2cb0d 100644
--- a/viewers/graphql/adoc/modules/ROOT/pages/about.adoc
+++ b/viewers/graphql/adoc/modules/ROOT/pages/about.adoc
@@ -171,7 +171,55 @@ To list all ``Department``s, we can submit this query using either the "rich" sc
Together, these make up the xref:refguide:applib:index/services/bookmark/Bookmark.adoc[] of the domain object.
-But if using the "rich" schema, then as well as accessing properties and collections and invoking (safe) actions, the GraphQL viewer also allows access to the usual supporting semantics.
+Queries can also include parameters.
+
+[cols="1a,1a", options="header"]
+|===
+
+|Rich schema
+|Simple schema
+
+|
+[source,graphql]
+----
+{
+ rich {
+ university_dept_Departments {
+ findDepartmentByName {
+ invoke(name: "Classics") {
+ results {
+ name {
+ get
+ }
+ }
+ }
+ }
+ }
+ }
+}
+----
+|
+[source,graphql]
+----
+{
+ simple {
+ university_dept_Departments {
+ findDepartmentByName(name: "Classics") {
+ name
+ }
+ }
+ }
+}
+----
+|===
+
+The above is an example of invoking an action on a (singleton) domain service, but this works equally well on domain entities/view models once retrieved.
+More on this below.
+
+
+=== Supporting Metadata
+
+If you use the "rich" schema, then as well as accessing properties and collections and invoking (safe) actions, the GraphQL viewer also allows access to the usual supporting metadata.
For example:
[cols="1a,1a", options="header"]
@@ -227,10 +275,10 @@ There are also similar fields for properties:
[#the-meta-fieldtype]
== The Meta field/type
-As we saw in the previous section, the `_meta` field provides access to additional information about the domain object.
-The full list of fields provided are:
+The `_meta` field provides access to additional information about the domain object.
+Its full list of fields are:
-* `logicalTypeName` and `id` : these are equivalent to the xref:refguide:applib:index/services/bookmark/Bookmark.adoc[] of the domain object
+* `logicalTypeName` and `id`; these are equivalent to the xref:refguide:applib:index/services/bookmark/Bookmark.adoc[] of the domain object
* `version` (if an entity and available)
* `title` (as per the xref:userguide:ROOT:ui-layout-and-hints.adoc#object-title[title()] supporting method)
* `icon` (as per the xref:userguide:ROOT:ui-layout-and-hints.adoc#object-icon[icon], normally the associated `.png` file) and `grid` (as per the xref:userguide:ROOT:ui-layout-and-hints.adoc[layout], normally the associated `.layout.xml` file )
@@ -239,7 +287,7 @@ These can only be downloaded if configured, see xref:#resources-blobs-clobs-layo
* `cssClass` (as per the xref:userguide:ROOT:ui-layout-and-hints.adoc#object-css-styling[cssClass()] supporting method)
-There is also one additional field, `saveAs`; this is discussed in the xref:testsupport.adoc[Test Support].
+There is also one additional field, `saveAs`; this is discussed in the xref:testsupport.adoc[Test Support] section.
[#queries-that-lookup-a-domain-object]
(causeway) 02/03: 2.0.0: updates the 2.0.0 and 3.0.0 release notes
Posted by da...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
danhaywood pushed a commit to branch 3.0.0
in repository https://gitbox.apache.org/repos/asf/causeway.git
commit 8b45dfc7234615e0c19aa115e157cd96ff94475d
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Wed Apr 3 20:13:40 2024 +0100
2.0.0: updates the 2.0.0 and 3.0.0 release notes
---
.../modules/ROOT/pages/2024/2.0.0/relnotes.adoc | 4 +--
.../modules/ROOT/pages/2024/3.0.0/relnotes.adoc | 40 +++++++++++++++++++---
.../relnotes/modules/ROOT/pages/about.adoc | 9 +++--
.../ROOT/partials/2024/2.0.0/_relnotes.adoc | 5 +--
4 files changed, 46 insertions(+), 12 deletions(-)
diff --git a/antora/components/relnotes/modules/ROOT/pages/2024/2.0.0/relnotes.adoc b/antora/components/relnotes/modules/ROOT/pages/2024/2.0.0/relnotes.adoc
index 591b4027b4..a0964472cf 100644
--- a/antora/components/relnotes/modules/ROOT/pages/2024/2.0.0/relnotes.adoc
+++ b/antora/components/relnotes/modules/ROOT/pages/2024/2.0.0/relnotes.adoc
@@ -5,9 +5,7 @@
:page-partial:
-NOTE: Not yet released.
-
-After almost six years effort (!), v2.0.0 and v3.0.0 are the first official releases of Apache Causeway, now re-platformed to run on Spring Boot.
+After almost six years effort (!), v2.0.0 and v3.0.0 are the first official releases of Apache Causeway, now re-platformed to run on Spring Boot v2.x and v3.x respectively.
The two versions are being released at the same time.
include::partial$2024/2.0.0/_relnotes.adoc[]
diff --git a/antora/components/relnotes/modules/ROOT/pages/2024/3.0.0/relnotes.adoc b/antora/components/relnotes/modules/ROOT/pages/2024/3.0.0/relnotes.adoc
index dbcd85dff7..c2278b3c1c 100644
--- a/antora/components/relnotes/modules/ROOT/pages/2024/3.0.0/relnotes.adoc
+++ b/antora/components/relnotes/modules/ROOT/pages/2024/3.0.0/relnotes.adoc
@@ -19,14 +19,46 @@ However, 3.0.0:
It also uses the `jakarta` namespace rather than `javax`.
-You should generally use
-
There is one functional change, namely that support for xref:security:shiro:about.adoc[Shiro security] module has been dropped (for now).
See the xref:relnotes:ROOT:2024/3.0.0/mignotes.adoc#simple-security-replacement-for-shiro[migration notes] for options.
+include::partial$2024/2.0.0/_relnotes.adoc[]
-NOTE: Not yet released.
-include::partial$2024/2.0.0/_relnotes.adoc[]
+
+'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+
+Version `3.x` also has a number of its own changes not present in the `2.x` release:
+
+== New Feature
+
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3698[CAUSEWAY-3698] - Security Integration Replacement for Shiro INI based Realm
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3348[CAUSEWAY-3348] - [Programming Model] Support for Action Parameters as a Tuple using Java Records (Mixins only)
+
+== Improvement
+
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3691[CAUSEWAY-3691] - [JUnit] Remove 'stable' from regression test artifact names
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3682[CAUSEWAY-3682] - [Commons] YamlUtils to support Java Records
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3275[CAUSEWAY-3275] - Migrate from Spring Framework 5.x to 6.x
+
+
+== Bug
+
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3699[CAUSEWAY-3699] - Lower v3 Baseline from Java 21 to 17
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3681[CAUSEWAY-3681] - [Regression] Cannot send Mail (3.x branch)
+
+
+== Dependency upgrade
+
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3634[CAUSEWAY-3634] - [Wicket Viewer] Update to Wicket 10.0.0-M2
++
+Note that the final release uses Wicket 10.0
+
+== Not implemented (moved to Attic)
+
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-2925[CAUSEWAY-2925] - [Vaa] Support for all fundemental Value Types
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-2923[CAUSEWAY-2923] - [Vaa] Split the Vaadin Demo into JPA/JDO parts
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3407[CAUSEWAY-3407] - Thymeleaf/Webflux Viewer
+
diff --git a/antora/components/relnotes/modules/ROOT/pages/about.adoc b/antora/components/relnotes/modules/ROOT/pages/about.adoc
index 37cb0a5dbb..0bf912362b 100644
--- a/antora/components/relnotes/modules/ROOT/pages/about.adoc
+++ b/antora/components/relnotes/modules/ROOT/pages/about.adoc
@@ -19,9 +19,9 @@ This table summarises all releases of Apache Causeway to date.
| 3.0.0
| _tba_
| Release of Apache Causeway 3.0.0
-.2+| 5
-.2+| 25
-.2+| 12
+| 7
+| 28
+| 14
.2+|
* xref:relnotes:ROOT:2024/3.0.0/relnotes.adoc[Release Notes]
* xref:relnotes:ROOT:2024/3.0.0/mignotes.adoc[3.0.0 Migration Notes]
@@ -30,6 +30,9 @@ This table summarises all releases of Apache Causeway to date.
| 2.0.0
| _tba_
| Release of Apache Causeway 2.0.0
+| 5
+| 25
+| 12
| 2.0.0-RC4
| 2nd Jan 2024
diff --git a/antora/components/relnotes/modules/ROOT/partials/2024/2.0.0/_relnotes.adoc b/antora/components/relnotes/modules/ROOT/partials/2024/2.0.0/_relnotes.adoc
index 0d8f8afea7..301683a829 100644
--- a/antora/components/relnotes/modules/ROOT/partials/2024/2.0.0/_relnotes.adoc
+++ b/antora/components/relnotes/modules/ROOT/partials/2024/2.0.0/_relnotes.adoc
@@ -114,8 +114,9 @@ Apart from dependencies and the `javax`/`jakarta` namespace, in most regards v2.
The only feature not available in 3.0 is the Shiro module, because (at the time of release) Apache Shiro have not released `jakarta` support.
However, either the xref:security:spring:about.adoc[Spring Security] integration or even the xref:security:simple:about.adoc[Simple Security] implementation can be used instead.
----
-For `2.0.0` itself, below is the list of features, improvements and bugs made since `2.0.0-RC4`.
+'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+
+For `2.0.0` and `3.0.0`, below lists the features, improvements and bugs made since the previous release: