[[r3.0.0]]
= 3.0.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.
:page-partial:


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.
The two versions are being released at the same time.


The v3.0.0 release is broadly equivalent to the v2.0.0 release.
As such, see the xref:2024/2.0.0/relnotes.adoc[2.0.0] release notes for full details of the features available in this release.

However, 3.0.0:

* targets Spring Boot 3.x (instead of Spring Boot 2.x)
* targets Java 17 (instead of Java 11)

It also uses the `jakarta` namespace rather than `javax`.


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[]



'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''

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

