Skip to content

docs(java): add property default changes and removals for 4.9 → 5.0 migration #2610

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
rjayasinghe wants to merge 3 commits into from
Closed

docs(java): add property default changes and removals for 4.9 → 5.0 migration #2610

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
916edec
docs(java): add property default changes and removals for 4.9 → 5.0 m…
rjayasinghe Jun 2, 2026
05ef49d
docs(java): add cds.query.deepEntityReadonly default change to 4.9→5.…
rjayasinghe Jun 2, 2026
118bf89
Merge branch 'main' into java-migration-4.9-to-5.0-property-changes
rjayasinghe Jun 2, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 10 additions & 11 deletions java/migration.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -71,29 +71,28 @@ CAP Java 5.0 increased some minimum required versions:
| XSUAA (BTP Security Library) | 4.0.0 |
| Maven | 3.9.10 |

<!-- ### Adjusted Property Defaults
### 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. This reflects its intended behavior once the properties are deleted in future releases.
| `cds.security.authentication.mode` | `model-strict` | `model-relaxed` | Authentication mode now defaults to `model-relaxed`, which only enforces authentication for endpoints protected via `@requires` or `@restrict`. |
| `cds.odataV2.batch.maxRequests` | `-1` (unlimited) | `10` | OData V2 batch requests are now limited to 10 by default to protect against overload. |
| `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. |
| `cds.errors.preferServiceException` | `false` | `true` | `ServiceException` is now preferred over generic exceptions when mapping errors to HTTP responses. |
| `cds.outbox.services.<key>.ordered` | `true` | `false` | Outbox instances now process entries in parallel by default. Set to `true` to restore ordered, single-threaded processing. |
| `cds.multitenancy.serviceManager.cacheRefreshInterval` | `PT20M` (20 min) | `PT60M` (60 min) | The service manager cache is now refreshed less frequently to reduce overhead. |
| `cds.persistence.changeSet.enforceTransactional` | `true` | `false` | Transactional enforcement for change sets is now opt-in. |
| `cds.query.deepEntityReadonly` | `false` | `true` | Readonly handling is now enforced for deep entity reads by default. |

### Removed Properties

The following table gives an overview about the removed properties:

| Removed Property | Replacement / Explanation |
| --- | --- |
| `abc` | Any description about replacement | -->
| `cds.errors.combined` | Was deprecated since CAP Java 4.0. The property had no effect anymore and has been removed. |

### Removed Java APIs { #removed-java-apis-4-to-5 }

Expand Down
Loading