Skip to content

Add CAP Java 5.0 OpenRewrite recipes to migration table#2647

Merged
renejeglinsky merged 10 commits into
mainfrom
update_recipe_list
Jun 25, 2026
Merged

Add CAP Java 5.0 OpenRewrite recipes to migration table#2647
renejeglinsky merged 10 commits into
mainfrom
update_recipe_list

Conversation

@rjayasinghe

Copy link
Copy Markdown
Contributor

Extends the Currently Released CAP Java Migrations table in java/migration.md with the new recipes added for the CAP Java 5.0 release, and adds a second table listing the umbrella recipes.

Fine-grained recipes added

  • Cap_4.9_Properties — was already shipped but missing from the table; renames cds.mcp.autoConfig.*cds.mcp.autoWired.* and cds.taskScheduler.enabledcds.outbox.persistent.scheduler.enabled.
  • Cap_5.0_Properties — removes properties no longer supported in CAP Java 5.0 (cds.errors.combined, cds.sql.collate, cds.sql.hana.optimizationMode, cds.odataV4.searchMode, cds.odataV2.searchMode, the two removed cds.multiTenancy.serviceManager.* flags).
  • Cap_5.0_OutboxOrdered — adds ordered: true to custom cds.outbox.services entries to preserve the previous behavior, since the default flips from true to false in 5.0.

Umbrella recipes table added

New table lists Cap_4.8, Cap_4.9, and Cap_5.0, describing which fine-grained recipes each one bundles and which Maven version it upgrades CAP Java dependencies to.

Source: recipe YAMLs under cds-services-recipes/src/main/resources/META-INF/rewrite/.

Extend the 'Currently Released CAP Java Migrations' table with the
recipes added for the CAP Java 5.0 release (Cap_5.0_Properties,
Cap_5.0_OutboxOrdered) and also list the previously missing
Cap_4.9_Properties recipe. Add a second table listing the umbrella
recipes (Cap_4.8, Cap_4.9, Cap_5.0) and what each one bundles.
Comment thread java/migration.md Outdated
Comment thread java/migration.md Outdated
Comment thread java/migration.md Outdated
Comment thread java/migration.md
Comment thread java/migration.md Outdated
Comment thread java/migration.md
Comment thread java/migration.md
Add the recipes introduced after the initial 5.0 recipe list was
written, and align names with their YAML definitions:

- SearchModeProperty (migrates cds.sql.search.mode →
  cds.sql.search.localized)
- MigrateCdsMavenPluginConfig (migrates cds-maven-plugin config and
  aligns @sap/cds-dk)
- Cap_5.0_OutboxOrdered → CustomOutboxOrdered (renamed in the YAML to
  drop the version-bound prefix)

Also update the Cap_5.0 umbrella description to list the recipes its
recipeList now includes.
Reorder both the individual and the umbrella recipe tables so the
newest entries by "Available since" come first. Addresses review
feedback.
The umbrella table duplicated information from the individual-recipe
table above (each row's "Available since" already identifies which
umbrella ships it). Drop the table and keep a short note explaining
that an umbrella recipe Cap_<major>.<minor> is provided per release.
Also remove the now-redundant umbrella sentence from the lead-in
paragraph.

Addresses review comment
#2647 (comment)
StefanHenke
StefanHenke previously approved these changes Jun 24, 2026
@rjayasinghe

Copy link
Copy Markdown
Contributor Author

@renejeglinsky @smahati you can go ahead with this one. :)

Comment thread java/migration.md Outdated
Comment thread java/migration.md Outdated
Comment thread java/migration.md Outdated
@agoerler

Copy link
Copy Markdown
Contributor

I had opencode generate a tool to translate the docu from the recipies' yaml file to markdown: https://github.wdf.sap.corp/cds-java/cds-services/pull/7064/

the idea is that just like we do it for CDSProperties the docu is genarted from the source so that we don't have to review it.

@rjayasinghe

Copy link
Copy Markdown
Contributor Author

I had opencode generate a tool to translate the docu from the recipies' yaml file to markdown: https://github.wdf.sap.corp/cds-java/cds-services/pull/7064/

the idea is that just like we do it for CDSProperties the docu is genarted from the source so that we don't have to review it.

that's a great idea! I'll have a look at the PR. 👍🏽

Co-authored-by: Adrian Görler <adrian.goerler@sap.com>
agoerler
agoerler previously approved these changes Jun 24, 2026

@renejeglinsky renejeglinsky left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think that information make sense at the very beginning. WDYT?

Comment thread java/migration.md Outdated
Comment thread java/migration.md
Co-authored-by: René Jeglinsky <rene.jeglinsky@sap.com>
Co-authored-by: René Jeglinsky <rene.jeglinsky@sap.com>
Comment thread java/migration.md Outdated
Co-authored-by: Adrian Görler <adrian.goerler@sap.com>
@renejeglinsky renejeglinsky added this pull request to the merge queue Jun 25, 2026
Merged via the queue into main with commit 303fa5f Jun 25, 2026
4 checks passed
@renejeglinsky renejeglinsky deleted the update_recipe_list branch June 25, 2026 11:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants