Skip to content

Commit 3513de5

Browse files
agoerleragoerler
authored
Update migration.md
1 parent e6766ca commit 3513de5

1 file changed

Lines changed: 18 additions & 17 deletions

File tree

‎java/migration.md‎

Lines changed: 18 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -72,23 +72,24 @@ CAP Java 5.0 increased some minimum required versions:
7272
| XSUAA (BTP Security Library) | 4.0.0 |
7373
| Maven | 3.9.14 |
7474

75-
### Adjusted Property Defaults
75+
### Adjusted Property Defaults { #adjusted-defaults-4-to-5 }
7676

7777
Some property defaults have been adjusted:
7878

7979
| Property | Old Value | New Value | Explanation |
8080
| --- | --- | --- | --- |
8181
| [cds.errors.preferServiceException](../developing-applications/properties#cds-errors-preferServiceException) | `false` | `true` | `ServiceException` is now preferred over generic exceptions when mapping errors to HTTP responses. |
8282
| [cacheRefreshInterval](../developing-applications/properties#cds-multiTenancy-serviceManager-cacheRefreshInterval) | `PT20M` (20 min) | `PT60M` (60 min) | The service manager cache is now refreshed less frequently to reduce overhead. |
83-
| [cds.outbox.services.<key>.ordered](../developing-applications/properties#cds-outbox-services-%3Ckey%3E-ordered) | `true` | `false` | Outbox instances now process entries in parallel by default. Set to `true` to restore ordered, single-threaded processing. |
83+
| [cds.outbox.services.&lt;key&gt;.ordered](../developing-applications/properties#cds-outbox-services-%3Ckey%3E-ordered) | `true` | `false` | Outbox instances now process entries in parallel by default. Set to `true` to restore ordered, single-threaded processing. |
8484
| [enforceTransactional](../developing-applications/properties#cds-persistence-changeSet-enforceTransactional) | `true` | `false` | Transactional enforcement for change sets is now opt-in. |
8585
| `cds.query.deepEntityReadonly` | `false` | `true` | Readonly handling is now enforced for deep entity reads by default. |
8686
| [cds.query.restrictions.enabled](../developing-applications/properties#cds-query-restrictions) | `false` | `true` | |
8787
| [cds.security.authentication.mode](../developing-applications/properties#cds-security-authentication) | `model-strict` | `model-relaxed` | Authentication mode now defaults to `model-relaxed`, which only enforces authentication for endpoints protected via `@requires` or `@restrict`. |
8888
| [cds.sql.hana.search.fuzzy](../developing-applications/properties#cds-sql-hana-search-fuzzy) | `false` | `true` | Fuzzy search is now enabled on HANA by default |
8989
| [cds.sql.toOnePath.mode](../developing-applications/properties#cds-sql-toOnePath-mode) | `always-join` | `optimize` | SQL generation now avoids joins for to-one path expressions when a FK column can be selected directly, improving query performance. |
9090

91-
### Deprecated Properties
91+
92+
### Deprecated Properties { #deprecated-properties-4-to-5 }
9293

9394
The following properties have been deprecated and might be removed in a future major version:
9495

@@ -98,16 +99,16 @@ The following properties have been deprecated and might be removed in a future m
9899
| [cds.outbox.inMemory.emitDuringChangeSetContext](../developing-applications/properties#cds-outbox-inMemory-emitDuringChangeSetContext) | The functionality provided by this property is enabled by default and there is no reason to switch it off. |
99100
| [cds.outbox.inMemory.enabled](../developing-applications/properties#cds-outbox-inMemory-enabled) | The functionality provided by this property is enabled by default and there is no reason to switch it off. |
100101

101-
### Removed Properties
102+
### Removed Properties { #removed-properties-4-to-5 }
102103

103104
The following table gives an overview about the removed properties:
104105

105106
| Removed Property | Replacement / Explanation |
106107
| --- | --- |
107108
| `cds.errors.combined` | Was deprecated since CAP Java 4.0. The property had no effect anymore and has been removed. |
108109
| `cds.mcp.autoConfig` | Replaced by `cds.mcp.autoWired`. |
109-
| `cds.multiTenancy.serviceManager.acceptInstancesWithoutTenant` | Removed. No replacement — silent breaking change. |
110-
| `cds.multiTenancy.serviceManager.ignoreDuplicateTenantInstances` | Removed. No replacement — silent breaking change. |
110+
| `cds.multiTenancy.serviceManager` `.acceptInstancesWithoutTenant` | Removed. No replacement — silent breaking change. |
111+
| `cds.multiTenancy.serviceManager` `.ignoreDuplicateTenantInstances` | Removed. No replacement — silent breaking change. |
111112
| `cds.odataV2.searchMode` | Removed. The runtime now behaves as if `pass-through` was set (the search string is passed through to the data store). The property has no effect anymore. Remove any configured value. |
112113
| `cds.odataV4.searchMode` | Removed. The runtime now behaves as if `pass-through` was set (the search string is passed through to the data store). The property has no effect anymore. Remove any configured value. |
113114
| `cds.sql.collate` | Removed. The property had no documented effect and was never exposed. Remove any configured value. |
@@ -121,18 +122,18 @@ Removed deprecated methods:
121122

122123
| Removed method | Replacement / Explanation |
123124
|--------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------|
124-
| `c.s.c.feature.ucl.services.AssignEventContext.getUclResult()` | `getResult()` |
125-
| `c.s.c.feature.ucl.services.AssignEventContext.setUclResult(SpiiResult)` | `setResult(SpiiResult)` |
125+
| `c.s.c.feature.ucl.services.AssignEventContext` `.getUclResult()` | `getResult()` |
126+
| `c.s.c.feature.ucl.services.AssignEventContext` `.setUclResult(SpiiResult)` | `setResult(SpiiResult)` |
126127
| `c.s.c.reflect.CdsEntity.isAbstract()` | always `false` |
127-
| `c.s.c.services.mt.SaaSRegistryDependency.getAppId()` | `getXsappname()` |
128-
| `c.s.c.services.mt.SaaSRegistryDependency.setAppId(String appId)` | `setXsappname(appId)` |
129-
| `c.s.c.services.mt.SaaSRegistryDependency.getAppName()` | `getXsappname()` |
130-
| `c.s.c.services.mt.SaaSRegistryDependency.setAppName(String appName)` | `setXsappname(appName)` |
131-
| `c.s.c.services.ServiceExceptionUtils.getLocalizedMessage (String code, Object[] args, Locale locale)` | `getLocalizedMessage(code, args, locale, true)` (pass `true` for `errorStatusFallback` to keep the previous behavior) |
132-
| `c.s.c.services.ServiceExceptionUtils.getMessageTarget(Path path, CdsElement element)` | `MessageTarget.create(path, element)` |
133-
| `c.s.c.services.ServiceExceptionUtils.getMessageTarget(String target)` | `MessageTarget.create(target)` |
134-
| `c.s.c.services.ServiceExceptionUtils.getMessageTarget(String parameter, Class type, Function path)` | `MessageTarget.create(parameter, type, path)` |
135-
| `c.s.c.services.ServiceExceptionUtils.getMessageTarget(String parameter, Function path)` | `MessageTarget.create(parameter, path)` |
128+
| `c.s.c.services.mt.SaaSRegistryDependency` `.getAppId()` | `getXsappname()` |
129+
| `c.s.c.services.mt.SaaSRegistryDependency` `.setAppId(String appId)` | `setXsappname(appId)` |
130+
| `c.s.c.services.mt.SaaSRegistryDependency` `.getAppName()` | `getXsappname()` |
131+
| `c.s.c.services.mt.SaaSRegistryDependency` `.setAppName(String appName)` | `setXsappname(appName)` |
132+
| `c.s.c.services.ServiceExceptionUtils` `.getLocalizedMessage (String code, Object[] args, Locale locale)` | `getLocalizedMessage(code, args, locale, true)` (pass `true` for `errorStatusFallback` to keep the previous behavior) |
133+
| `c.s.c.services.ServiceExceptionUtils` `.getMessageTarget(Path path, CdsElement element)` | `MessageTarget.create(path, element)` |
134+
| `c.s.c.services.ServiceExceptionUtils` `.getMessageTarget(String target)` | `MessageTarget.create(target)` |
135+
| `c.s.c.services.ServiceExceptionUtils` `.getMessageTarget(String parameter, Class type, Function path)` | `MessageTarget.create(parameter, type, path)` |
136+
| `c.s.c.services.ServiceExceptionUtils` `.getMessageTarget(String parameter, Function path)` | `MessageTarget.create(parameter, path)` |
136137

137138
### Changes in the `cds-maven-plugin`
138139

0 commit comments

Comments
 (0)