From b6bced6a0b4e12e2604c4a39208da0964ef59eb6 Mon Sep 17 00:00:00 2001 From: Stefan Henke Date: Tue, 31 Mar 2026 13:55:25 +0200 Subject: [PATCH 1/9] Update migration.md with property and API changes Added sections for adjusted, deprecated, and removed properties, as well as removed Java APIs in migration documentation. --- java/migration.md | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/java/migration.md b/java/migration.md index 7d6b4d281..460fb0e01 100644 --- a/java/migration.md +++ b/java/migration.md @@ -157,6 +157,38 @@ The internally used maven modules `repackaged/odata-v4-lib` and `repackaged/odat 3. Use upstream open-source Apache Olingo. Change dependencies from corresponding internal CAP `mvn` modules to OSS packages `org.apache.olingo:olingo-odata4`, `org.apache.olingo:olingo-odata2` +### Adjusted Property Defaults + +Some property defaults have been adjusted: + +| Property | Old Value | New Value | Explanation | +| --- | --- | --- | --- | +| `abc` | false | true | Any description. | + +### Deprecated Properties + +The following properties have been deprecated and might be removed in a future major version: + +- `abd` + +The functionality provided by these properties is enabled by default and there is no reason to switch these off. + +### Removed Properties + +The following table gives an overview about the removed properties: + +| Removed Property | Replacement / Explanation | +| --- | --- | +| `abc` | Any description about replacement | + +### Removed Java APIs + +- Removed deprecated classes: + - `com.sap.cds.A`, use `B` instead + +- Removed deprecated methods: + - `com.sap.cds.ql.cqn.A.search(String term)`, use `searchTerm(CqnSearchTermPredicate)` instead + ## CAP Java 3.10 to CAP Java 4.0 { #three-to-four } ### New License From 14b60f0efdec72265e570d5b69848294bc829f26 Mon Sep 17 00:00:00 2001 From: Stefan Henke Date: Wed, 8 Apr 2026 14:30:09 +0200 Subject: [PATCH 2/9] Update property defaults and deprecate old properties --- java/migration.md | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/java/migration.md b/java/migration.md index 460fb0e01..70f10bc55 100644 --- a/java/migration.md +++ b/java/migration.md @@ -163,7 +163,12 @@ Some property defaults have been adjusted: | Property | Old Value | New Value | Explanation | | --- | --- | --- | --- | -| `abc` | false | true | Any description. | +| `cds.odatav2.batch.maxRequests` | -1 | 10 | Changed due to security constraints. | +| `cds.multiTenancy.serviceManager.cacheRefreshInterval` | 20 | 60 | | +| `cds.multiTenancy.mock.enabled` | null | true | | +| `cds.persistence.changeset.enforceTransational` | true | false | | +| `cds.errors.preferServiceException` | false | true | | + ### Deprecated Properties @@ -179,7 +184,9 @@ The following table gives an overview about the removed properties: | Removed Property | Replacement / Explanation | | --- | --- | -| `abc` | Any description about replacement | +| `cds.taskScheduler.enabled` | Use 'cds.outbox.persistent.scheduler.enabled'. | +| `cds.mcp.autoConfig` | Use `cds.mcp.autoWired`. | +| `cds.errors.combined` | Removed as the underlying feature is active by default now. | ### Removed Java APIs From d71ef5770217849fcc2c0e857862176a7d20ffb8 Mon Sep 17 00:00:00 2001 From: Stefan Henke Date: Wed, 8 Apr 2026 14:36:53 +0200 Subject: [PATCH 3/9] Adjust property defaults and update deprecations --- java/migration.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/java/migration.md b/java/migration.md index 70f10bc55..9c7d600fe 100644 --- a/java/migration.md +++ b/java/migration.md @@ -163,12 +163,11 @@ Some property defaults have been adjusted: | Property | Old Value | New Value | Explanation | | --- | --- | --- | --- | -| `cds.odatav2.batch.maxRequests` | -1 | 10 | Changed due to security constraints. | +| `cds.errors.preferServiceException` | false | true | | | `cds.multiTenancy.serviceManager.cacheRefreshInterval` | 20 | 60 | | | `cds.multiTenancy.mock.enabled` | null | true | | +| `cds.odatav2.batch.maxRequests` | -1 | 10 | Changed due to security constraints. | | `cds.persistence.changeset.enforceTransational` | true | false | | -| `cds.errors.preferServiceException` | false | true | | - ### Deprecated Properties @@ -184,9 +183,9 @@ The following table gives an overview about the removed properties: | Removed Property | Replacement / Explanation | | --- | --- | -| `cds.taskScheduler.enabled` | Use 'cds.outbox.persistent.scheduler.enabled'. | -| `cds.mcp.autoConfig` | Use `cds.mcp.autoWired`. | | `cds.errors.combined` | Removed as the underlying feature is active by default now. | +| `cds.mcp.autoConfig` | Use `cds.mcp.autoWired`. | +| `cds.taskScheduler.enabled` | Use 'cds.outbox.persistent.scheduler.enabled'. | ### Removed Java APIs From a135512024cae4a9943cfa4d3bd18ef86bb7569b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Adrian=20G=C3=B6rler?= Date: Mon, 20 Apr 2026 08:46:17 +0200 Subject: [PATCH 4/9] 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 9c7d600fe..e918ab1c4 100644 --- a/java/migration.md +++ b/java/migration.md @@ -164,8 +164,8 @@ Some property defaults have been adjusted: | Property | Old Value | New Value | Explanation | | --- | --- | --- | --- | | `cds.errors.preferServiceException` | false | true | | -| `cds.multiTenancy.serviceManager.cacheRefreshInterval` | 20 | 60 | | | `cds.multiTenancy.mock.enabled` | null | true | | +| `cds.multiTenancy.serviceManager.cacheRefreshInterval` | 20 | 60 | | | `cds.odatav2.batch.maxRequests` | -1 | 10 | Changed due to security constraints. | | `cds.persistence.changeset.enforceTransational` | true | false | | From e828ced3ce7b42376beeac137781f9bfc7d23143 Mon Sep 17 00:00:00 2001 From: Stefan Henke Date: Wed, 22 Apr 2026 13:22:31 +0200 Subject: [PATCH 5/9] Update migration.md --- java/migration.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/java/migration.md b/java/migration.md index e918ab1c4..f842cd3d9 100644 --- a/java/migration.md +++ b/java/migration.md @@ -163,17 +163,23 @@ Some property defaults have been adjusted: | Property | Old Value | New Value | Explanation | | --- | --- | --- | --- | +| `cds.changeSet.enforceTransactional` | true | false | | | `cds.errors.preferServiceException` | false | true | | | `cds.multiTenancy.mock.enabled` | null | true | | | `cds.multiTenancy.serviceManager.cacheRefreshInterval` | 20 | 60 | | | `cds.odatav2.batch.maxRequests` | -1 | 10 | Changed due to security constraints. | +| `cds.odatav2.searchMode` | "odata-lenient" | "pass-through" | | +| `cds.odatav4.searchMode` | "odata-lenient" | "pass-through" | | +| `cds.outbox.services..ordered` | true | false | | `cds.persistence.changeset.enforceTransational` | true | false | | +| `cds.sql.toOnePath.mode` | "always-join" | "optimize" | | ### Deprecated Properties The following properties have been deprecated and might be removed in a future major version: -- `abd` +- `cds.outbox.inMemory.enabled` +- `cds.outbox.inMemory.emitDuringChangeSetContext` The functionality provided by these properties is enabled by default and there is no reason to switch these off. From 32be825db513541b78557be5b0c5172801f36f09 Mon Sep 17 00:00:00 2001 From: Stefan Henke Date: Wed, 29 Apr 2026 12:21:45 +0200 Subject: [PATCH 6/9] Update migration.md --- java/migration.md | 1 + 1 file changed, 1 insertion(+) diff --git a/java/migration.md b/java/migration.md index f842cd3d9..8fa390190 100644 --- a/java/migration.md +++ b/java/migration.md @@ -172,6 +172,7 @@ Some property defaults have been adjusted: | `cds.odatav4.searchMode` | "odata-lenient" | "pass-through" | | | `cds.outbox.services..ordered` | true | false | | `cds.persistence.changeset.enforceTransational` | true | false | | +| `cds.query.restrictions.enabled` | false | true | | | `cds.sql.toOnePath.mode` | "always-join" | "optimize" | | ### Deprecated Properties From 3050e5136244690b1cea0d0c363955d52d6fe616 Mon Sep 17 00:00:00 2001 From: Stefan Henke Date: Wed, 29 Apr 2026 16:09:33 +0200 Subject: [PATCH 7/9] Update migration.md --- java/migration.md | 1 - 1 file changed, 1 deletion(-) diff --git a/java/migration.md b/java/migration.md index 8fa390190..f4dcdb668 100644 --- a/java/migration.md +++ b/java/migration.md @@ -165,7 +165,6 @@ Some property defaults have been adjusted: | --- | --- | --- | --- | | `cds.changeSet.enforceTransactional` | true | false | | | `cds.errors.preferServiceException` | false | true | | -| `cds.multiTenancy.mock.enabled` | null | true | | | `cds.multiTenancy.serviceManager.cacheRefreshInterval` | 20 | 60 | | | `cds.odatav2.batch.maxRequests` | -1 | 10 | Changed due to security constraints. | | `cds.odatav2.searchMode` | "odata-lenient" | "pass-through" | | From 763985e2c7aabb6e5591a1c8de716d97ab0a2274 Mon Sep 17 00:00:00 2001 From: Stefan Henke Date: Wed, 29 Apr 2026 16:18:23 +0200 Subject: [PATCH 8/9] Update migration.md --- java/migration.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/java/migration.md b/java/migration.md index f4dcdb668..9ffbba4e0 100644 --- a/java/migration.md +++ b/java/migration.md @@ -163,14 +163,13 @@ Some property defaults have been adjusted: | Property | Old Value | New Value | Explanation | | --- | --- | --- | --- | -| `cds.changeSet.enforceTransactional` | true | false | | | `cds.errors.preferServiceException` | false | true | | | `cds.multiTenancy.serviceManager.cacheRefreshInterval` | 20 | 60 | | | `cds.odatav2.batch.maxRequests` | -1 | 10 | Changed due to security constraints. | | `cds.odatav2.searchMode` | "odata-lenient" | "pass-through" | | | `cds.odatav4.searchMode` | "odata-lenient" | "pass-through" | | | `cds.outbox.services..ordered` | true | false | -| `cds.persistence.changeset.enforceTransational` | true | false | | +| `cds.persistence.changeSet.enforceTransational` | true | false | | | `cds.query.restrictions.enabled` | false | true | | | `cds.sql.toOnePath.mode` | "always-join" | "optimize" | | From 8b63344d3091e26608066b919806b448fe8be3de Mon Sep 17 00:00:00 2001 From: Robin de Silva Jayasinghe Date: Tue, 2 Jun 2026 13:21:18 +0200 Subject: [PATCH 9/9] docs(java): merge property changes from java-migration-4.9-to-5.0-property-changes MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Add Maven 3.9.10 to minimum versions - Add cds.security.authentication.mode default change - Add cds.query.deepEntityReadonly default change - Add explanations to all property default rows - Fix typo: enforceTransational → enforceTransactional - Fix cds.multitenancy casing and use PT20M/PT60M notation - Fix cds.errors.combined removal description --- java/migration.md | 67 +++++++++++++---------------------------------- 1 file changed, 18 insertions(+), 49 deletions(-) diff --git a/java/migration.md b/java/migration.md index 9ffbba4e0..21222b165 100644 --- a/java/migration.md +++ b/java/migration.md @@ -71,21 +71,32 @@ CAP Java 5.0 increased some minimum required versions: | XSUAA (BTP Security Library) | 4.0.0 | | Maven | 3.9.10 | - +| `cds.errors.combined` | Was deprecated since CAP Java 4.0. The property had no effect anymore and has been removed. | +| `cds.mcp.autoConfig` | Use `cds.mcp.autoWired`. | +| `cds.taskScheduler.enabled` | Use `cds.outbox.persistent.scheduler.enabled`. | ### Removed Java APIs { #removed-java-apis-4-to-5 } @@ -156,50 +169,6 @@ The internally used maven modules `repackaged/odata-v4-lib` and `repackaged/odat 3. Use upstream open-source Apache Olingo. Change dependencies from corresponding internal CAP `mvn` modules to OSS packages `org.apache.olingo:olingo-odata4`, `org.apache.olingo:olingo-odata2` - -### Adjusted Property Defaults - -Some property defaults have been adjusted: - -| Property | Old Value | New Value | Explanation | -| --- | --- | --- | --- | -| `cds.errors.preferServiceException` | false | true | | -| `cds.multiTenancy.serviceManager.cacheRefreshInterval` | 20 | 60 | | -| `cds.odatav2.batch.maxRequests` | -1 | 10 | Changed due to security constraints. | -| `cds.odatav2.searchMode` | "odata-lenient" | "pass-through" | | -| `cds.odatav4.searchMode` | "odata-lenient" | "pass-through" | | -| `cds.outbox.services..ordered` | true | false | -| `cds.persistence.changeSet.enforceTransational` | true | false | | -| `cds.query.restrictions.enabled` | false | true | | -| `cds.sql.toOnePath.mode` | "always-join" | "optimize" | | - -### Deprecated Properties - -The following properties have been deprecated and might be removed in a future major version: - -- `cds.outbox.inMemory.enabled` -- `cds.outbox.inMemory.emitDuringChangeSetContext` - -The functionality provided by these properties is enabled by default and there is no reason to switch these off. - -### Removed Properties - -The following table gives an overview about the removed properties: - -| Removed Property | Replacement / Explanation | -| --- | --- | -| `cds.errors.combined` | Removed as the underlying feature is active by default now. | -| `cds.mcp.autoConfig` | Use `cds.mcp.autoWired`. | -| `cds.taskScheduler.enabled` | Use 'cds.outbox.persistent.scheduler.enabled'. | - -### Removed Java APIs - -- Removed deprecated classes: - - `com.sap.cds.A`, use `B` instead - -- Removed deprecated methods: - - `com.sap.cds.ql.cqn.A.search(String term)`, use `searchTerm(CqnSearchTermPredicate)` instead - ## CAP Java 3.10 to CAP Java 4.0 { #three-to-four } ### New License