{"ref":"artifact:sap-samples-btp-neo-java-app-migration","page":"/artifacts/sap-samples-btp-neo-java-app-migration","json":"/artifacts/sap-samples-btp-neo-java-app-migration.json","generated":"2026-10-26","drafted_with_ai":true,"entity":{"id":"sap-samples-btp-neo-java-app-migration","name":"btp-neo-java-app-migration","artifact_type":"sample","ecosystem":"btp","domain":"operations-and-runtime","origin_ring":"sap-official","use_as":"reference","description":{"one_line":"A guide and set of scenario samples for moving a Java application from the SAP BTP Neo environment to Cloud Foundry, replacing the Neo Java Web API with the SAP Cloud SDK for Java.","short":"Guide and samples for moving Java apps from Neo to Cloud Foundry","what_it_solves":"Walks through the parts of a Neo-to-Cloud-Foundry move: migrating to Jakarta EE 10 and Java 25, replacing the Neo Java Web API, which Cloud Foundry does not provide, with the [SAP Cloud SDK for Java](https://sap.github.io/cloud-sdk/docs/java/overview-cloud-sdk-for-java), and setting up authentication and authorization again. Nine scenario sections carry their own guidelines and examples, for destinations, connectivity, mail sessions, persistence, document management, the keystore, custom domains, monitoring and the TomEE runtime, and the guide ends by packaging the application as a multitarget application and deploying it to the [SAP BTP, Cloud Foundry Runtime](artifact:btp-cloud-foundry-runtime). Two branches hold the before-and-after code as SAP Java Buildpack v1 and v2 samples, and a final section covers AI-assisted migration."},"links":{"repo":"https://github.com/SAP-samples/btp-neo-java-app-migration"},"identity":{"license":"Apache-2.0"},"source_available":true,"demonstrates":["capability:platform-migration"],"requires":[{"ref":"artifact:btp-cloud-foundry-runtime","for":"the environment the refactored application is deployed to, which the guide's last steps build the MTA for","requirement":"required","sources":[{"url":"https://github.com/SAP-samples/btp-neo-java-app-migration","title":"SAP-samples/btp-neo-java-app-migration — README, 1. Purpose","checked":"2026-10-19","quote":"This guide describes how you should refactor your Java applications to migrate them from the SAP BTP, Neo environment to the SAP BTP, Cloud Foundry environment."},{"url":"https://github.com/SAP-samples/btp-neo-java-app-migration","title":"SAP-samples/btp-neo-java-app-migration — README, 8.2 Deploy the Java Application to the Cloud Foundry Environment","checked":"2026-10-19","quote":"The `mtad.yaml` file is the deployment descriptor for multitarget applications (MTA)."}]}],"type_properties":{"form":{"value":"tutorial","sources":[{"url":"https://github.com/SAP-samples/btp-neo-java-app-migration","title":"SAP-samples/btp-neo-java-app-migration — repository description","checked":"2026-10-19","quote":"Code sample and documentation for migrating SAP BTP Java applications from NEO to Cloud Foundry, showcasing step-by-step processes and best practices."},{"url":"https://github.com/SAP-samples/btp-neo-java-app-migration","title":"SAP-samples/btp-neo-java-app-migration — README, 1. Purpose","checked":"2026-10-19","quote":"This guide describes how you should refactor your Java applications to migrate them from the SAP BTP, Neo environment to the SAP BTP, Cloud Foundry environment."}]}},"maintainers":["actor:sap-samples"],"drafted_with_ai":true,"provenance":{"discovered_via":[{"source":"source:curator"}],"first_seen":"2026-09-14"},"contributors":["actor:ajinkyapatil8190","actor:i028409","actor:mayastefanovasap","actor:nikolay-kabadzhov","actor:oleksiikrasnovskyi","actor:pavel-lazhbanau","actor:svgradev","actor:tsvetanmadanski-sap"]},"effective_normative_relations":[],"readings":{"liveness":[{"label":"Maintenance","tier":"unknown","evidence":"no release data"},{"label":"Continuity","tier":"good","evidence":"10 contributors, org-owned"},{"label":"Repository","tier":"good","evidence":"pushed 2026-09, not archived"}],"compatibility":[{"label":"Declared for","tier":"unknown","evidence":"no BTP release lines in the atlas"},{"label":"Survived majors","tier":"unknown","evidence":"no BTP release lines in the atlas"},{"label":"Maintainer's CI","tier":"fair","evidence":"no CI configured"}],"practice":[{"label":"Tests","tier":"good","evidence":"9 test files"},{"label":"Docs","tier":"good","evidence":"README 24 KB"},{"label":"Changelog","tier":"good","evidence":"CHANGELOG in the repo"}],"reach":[{"value":null,"unit":"installs/week"},{"value":6,"unit":"watching"}]},"signals":{"crawled_at":"2026-10-25","npm":"not published under this name","stars":6,"forks":0,"open_issues":0,"archived":false,"pushed_at":"2026-09-29","license_spdx":"Apache-2.0","org_owned":true,"default_branch":"main","created_at":"2024-04-17T07:56:50Z","open_prs":0,"tree_truncated":false,"test_files":9,"workflows":0,"other_ci":false,"readme_bytes":24739,"docs_files":0,"changelog":true,"license_file":true,"dts_files":0,"first_commit":"2024-04-17","last_commit":"2026-09-29","commits":50,"contributors":10,"readme_path":"README.md","readme_sha":"935ca8f7de5400bdb02d7a2e8051d676806564d7","repo_read":"2026-10-25"},"release_notes":{"license":"Apache-2.0","quotable":true,"source":{"kind":"repo","path":"CHANGELOG.md","ref":"main","url":"https://github.com/SAP-samples/btp-neo-java-app-migration/blob/main/CHANGELOG.md"},"format":"keep-a-changelog","releases":[{"version":"1.1.1","date":"2026-08-14","date_source":"heading","heading":"[1.1.1] - 2026-08-14","url":"https://github.com/SAP-samples/btp-neo-java-app-migration/blob/main/CHANGELOG.md#111---2026-08-14","sections":[{"kind":"feature","heading":"Added","items":2},{"kind":"fix","heading":"Fixed","items":1}],"hash":"551b4438fce2896e"},{"version":"1.1.0","date":"2026-08-05","date_source":"heading","heading":"[1.1.0] - 2026-08-05","url":"https://github.com/SAP-samples/btp-neo-java-app-migration/blob/main/CHANGELOG.md#110---2026-08-05","sections":[{"kind":"feature","heading":"Added","items":7},{"kind":"change","heading":"Changed","items":3},{"kind":"fix","heading":"Fixed","items":9}],"hash":"239681798a0b570f"},{"version":"1.0.1","date":"2026-06-19","date_source":"heading","heading":"[1.0.1] - 2026-06-19","url":"https://github.com/SAP-samples/btp-neo-java-app-migration/blob/main/CHANGELOG.md#101---2026-06-19","sections":[{"kind":"feature","heading":"Added","items":1}],"hash":"74fd2f063b4bcffc"},{"version":"1.0.0","date":"2026-05-08","date_source":"heading","heading":"[1.0.0] - 2026-05-08","url":"https://github.com/SAP-samples/btp-neo-java-app-migration/blob/main/CHANGELOG.md#100---2026-05-08","sections":[{"kind":"feature","heading":"Added","items":5}],"hash":"30f95fd6252b1def"}],"crawled_at":"2026-10-25"},"edges":{"maintainers":[{"ref":"actor:sap-samples","name":"SAP Samples","json":"/actors/sap-samples.json"}],"contributors":[{"ref":"actor:ajinkyapatil8190","name":"Ajinkya Patil","json":"/actors/ajinkyapatil8190.json"},{"ref":"actor:i028409","name":"Emil Aleksandrov","json":"/actors/i028409.json"},{"ref":"actor:mayastefanovasap","name":"mayaStefanovaSap","json":"/actors/mayastefanovasap.json"},{"ref":"actor:nikolay-kabadzhov","name":"nikolay-kabadzhov","json":"/actors/nikolay-kabadzhov.json"},{"ref":"actor:oleksiikrasnovskyi","name":"oleksiikrasnovskyi","json":"/actors/oleksiikrasnovskyi.json"},{"ref":"actor:pavel-lazhbanau","name":"Pavel-lazhbanau","json":"/actors/pavel-lazhbanau.json"},{"ref":"actor:svgradev","name":"Stoyan Gradev","json":"/actors/svgradev.json"},{"ref":"actor:tsvetanmadanski-sap","name":"tsvetanmadanski-sap","json":"/actors/tsvetanmadanski-sap.json"}],"explained_by":[],"alternative_to_this":[],"needed_by":[],"available_via":[],"parts":[],"add_ons":[],"answered_through_parts":[]}}