From 78e68d6e73b6010ea87f680f8f423289c11d307b Mon Sep 17 00:00:00 2001 From: Stefan Henke Date: Mon, 16 Mar 2026 11:47:36 +0100 Subject: [PATCH 1/4] Update migration for Spring Boot 4 Updated migration guide for CAP Java from version 4.10 to 5.0, including Spring Boot and Spring Security changes. --- java/migration.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/java/migration.md b/java/migration.md index 9e9316d6d..dedb5bbf0 100644 --- a/java/migration.md +++ b/java/migration.md @@ -49,11 +49,14 @@ Here, the *migration* `com.sap.cds.services.migrations.MigrateStatements` from C |--------|-----------|---------------| |[com.sap.cds.services.migrations.MigrateStatements](../releases/2025/aug25#typed-query-results)|Migrates CQN statements to comply with typed Query API changes in 4.3.0.|4.3.0| -## CAP Java 4.9 to CAP Java 5.0 (TBA) { #four-to-five } +## CAP Java 4.10 to CAP Java 5.0 (TBA) { #four-to-five } ### Spring Boot 4 -CAP Java 5 uses Spring Boot 4 as underlying framework. Consult the [Spring Boot 4.0 Migration Guide](https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-4.0-Migration-Guide) for changes between Spring Boot 3.5 and Spring Boot 4.0. +CAP Java 5 uses Spring Boot 4 as underlying framework. Consult the [Spring Boot 4.0 Migration Guide](https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-4.0-Migration-Guide) for changes between Spring Boot 3.5 and Spring Boot 4.0. A CAP Java application is typically only affected by Spring Boot 4 incompatibilities if it uses native Spring APIs. + +### Spring Security +CAP Java 4 is running with Spring Boot 3.5, which uses Spring Security 6.5. Spring Boot 4 uses Spring Security 7. In case you defined custom security configurations you need to follow the guides, which describe the migration from 6.5 to 7.0. It is also required to upgrade the [BTP Security Library](https://github.com/SAP/cloud-security-services-integration-library) to version > 4.0. ### Minimum Versions @@ -62,7 +65,7 @@ CAP Java 4.0 increased some minimum required versions: | Dependency | Minimum Version | | --- | --- | | Spring Boot | 4.0 | -| XSUAA | TBD | +| XSUAA (BTP Security Library) | 4.0.0 | ## CAP Java 3.10 to CAP Java 4.0 { #three-to-four } From dfecbdd37c69e59488257c5c15385b4f8cbde6cb Mon Sep 17 00:00:00 2001 From: Stefan Henke Date: Mon, 16 Mar 2026 12:12:50 +0100 Subject: [PATCH 2/4] Update migration.md --- java/migration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/java/migration.md b/java/migration.md index dedb5bbf0..0e7898276 100644 --- a/java/migration.md +++ b/java/migration.md @@ -65,7 +65,7 @@ CAP Java 4.0 increased some minimum required versions: | Dependency | Minimum Version | | --- | --- | | Spring Boot | 4.0 | -| XSUAA (BTP Security Library) | 4.0.0 | +| XSUAA (BTP Security Library) | ^4 | ## CAP Java 3.10 to CAP Java 4.0 { #three-to-four } From ce71251c8faf13cbe76717e157dd26ca203a422f Mon Sep 17 00:00:00 2001 From: Stefan Henke Date: Thu, 19 Mar 2026 08:39:01 +0100 Subject: [PATCH 3/4] Update migration.md --- java/migration.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/java/migration.md b/java/migration.md index 0e7898276..009565b11 100644 --- a/java/migration.md +++ b/java/migration.md @@ -53,10 +53,9 @@ Here, the *migration* `com.sap.cds.services.migrations.MigrateStatements` from C ### Spring Boot 4 -CAP Java 5 uses Spring Boot 4 as underlying framework. Consult the [Spring Boot 4.0 Migration Guide](https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-4.0-Migration-Guide) for changes between Spring Boot 3.5 and Spring Boot 4.0. A CAP Java application is typically only affected by Spring Boot 4 incompatibilities if it uses native Spring APIs. +CAP Java 5 uses Spring Boot 4 and Spring Security 7 as underlying framework. A CAP Java application is typically only affected by Spring Boot 4 incompatibilities if it uses native Spring APIs. Consult the [Spring Boot 4.0 Migration Guide](https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-4.0-Migration-Guide) for changes between Spring Boot 3.5 and Spring Boot 4.0. For changes between Spring Security 6.5 and 7 refer to the [Spring Security 7 Migration Guide](https://docs.spring.io/spring-security/reference/migration/). -### Spring Security -CAP Java 4 is running with Spring Boot 3.5, which uses Spring Security 6.5. Spring Boot 4 uses Spring Security 7. In case you defined custom security configurations you need to follow the guides, which describe the migration from 6.5 to 7.0. It is also required to upgrade the [BTP Security Library](https://github.com/SAP/cloud-security-services-integration-library) to version > 4.0. +In any case, it is required to upgrade the [BTP Security Library](https://github.com/SAP/cloud-security-services-integration-library) to version > 4.0. ### Minimum Versions @@ -65,7 +64,7 @@ CAP Java 4.0 increased some minimum required versions: | Dependency | Minimum Version | | --- | --- | | Spring Boot | 4.0 | -| XSUAA (BTP Security Library) | ^4 | +| XSUAA (BTP Security Library) | 4.0.0 | ## CAP Java 3.10 to CAP Java 4.0 { #three-to-four } From 6053cb5222648050fb61eda9be5a3320c71a7969 Mon Sep 17 00:00:00 2001 From: Stefan Henke Date: Thu, 19 Mar 2026 09:49:54 +0100 Subject: [PATCH 4/4] Update migration details from CAP Java 4.10 to 5.0 --- java/migration.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/java/migration.md b/java/migration.md index 009565b11..858b53f53 100644 --- a/java/migration.md +++ b/java/migration.md @@ -49,17 +49,17 @@ Here, the *migration* `com.sap.cds.services.migrations.MigrateStatements` from C |--------|-----------|---------------| |[com.sap.cds.services.migrations.MigrateStatements](../releases/2025/aug25#typed-query-results)|Migrates CQN statements to comply with typed Query API changes in 4.3.0.|4.3.0| -## CAP Java 4.10 to CAP Java 5.0 (TBA) { #four-to-five } +## CAP Java 4.9 to CAP Java 5.0 (TBA) { #four-to-five } ### Spring Boot 4 CAP Java 5 uses Spring Boot 4 and Spring Security 7 as underlying framework. A CAP Java application is typically only affected by Spring Boot 4 incompatibilities if it uses native Spring APIs. Consult the [Spring Boot 4.0 Migration Guide](https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-4.0-Migration-Guide) for changes between Spring Boot 3.5 and Spring Boot 4.0. For changes between Spring Security 6.5 and 7 refer to the [Spring Security 7 Migration Guide](https://docs.spring.io/spring-security/reference/migration/). -In any case, it is required to upgrade the [BTP Security Library](https://github.com/SAP/cloud-security-services-integration-library) to version > 4.0. +In any case, it is required to upgrade the [BTP Security Library](https://github.com/SAP/cloud-security-services-integration-library) to version > 4.0.0. ### Minimum Versions -CAP Java 4.0 increased some minimum required versions: +CAP Java 5.0 increased some minimum required versions: | Dependency | Minimum Version | | --- | --- |