From 82886f2e0d9873dbebf9a0c33231e5051c6ff098 Mon Sep 17 00:00:00 2001 From: Stefan Henke Date: Wed, 24 Jan 2024 14:40:34 +0100 Subject: [PATCH] adoption of Cloud SDK 5 in CAP Java (#627) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * fix links * adoption steps for cloud sdk 5 * revert table format * Update migration.md * minor corrections * Update migration.md * Update java/development/index.md Co-authored-by: BraunMatthias <59841349+BraunMatthias@users.noreply.github.com> * Update migration.md * Update index.md * Update java/migration.md Co-authored-by: René Jeglinsky * Update java/migration.md Co-authored-by: René Jeglinsky * Update java/migration.md Co-authored-by: René Jeglinsky * Apply suggestions from code review --------- Co-authored-by: Rene Jeglinsky Co-authored-by: BraunMatthias <59841349+BraunMatthias@users.noreply.github.com> --- java/development/index.md | 4 +++- java/migration.md | 13 +++++++++++++ 2 files changed, 16 insertions(+), 1 deletion(-) diff --git a/java/development/index.md b/java/development/index.md index 803d06121..b72550b1a 100644 --- a/java/development/index.md +++ b/java/development/index.md @@ -254,11 +254,13 @@ The CAP Java SDK uses various dependencies that are also used by the application | @sap/cds-compiler | 3 | latest | | Spring Boot | 3.0 | latest | | XSUAA | 3.0 | latest | -| SAP Cloud SDK | 4.24 | latest | +| SAP Cloud SDK | 4.24 | latest2 | | Java Logging | 3.7 | latest | 1 When using the SAP Business Application Studio JDK 17 is recommended. +2 Cloud SDK 5 is recommended. Refer to necessary steps for [adoption of Cloud SDK 5](../migration.md#cloudsdk5) + ::: warning The Cloud SDK BOM `sdk-bom` manages XSUAA until version 2.x, which isn't compatible with CAP Java 2.x. You have two options: diff --git a/java/migration.md b/java/migration.md index 310ca62d3..30ccd05e0 100644 --- a/java/migration.md +++ b/java/migration.md @@ -1043,3 +1043,16 @@ After rebuilding and restarting your application, your Application Services are + +## Cloud SDK 4 to 5 { #cloudsdk5 } + +CAP Java `2.6.0` and higher is compatible with Cloud SDK in version 4 and 5. For reasons of backward compatibility, CAP Java assumes Cloud SDK 4 as the default. However, we highly recommend to use at least version `5.2.0` of Cloud SDK. To upgrade your CAP Java application to Cloud SDK 5, in most cases, you don't need to adapt any code if you rely on the Cloud SDK integration package (`cds-integration-cloud-sdk`). In these cases, it's sufficient to add the following maven dependency to your CAP Java application: + +```xml + + com.sap.cloud.sdk.cloudplatform + connectivity-apache-httpclient4 + +``` + +