# sap/cloud-sdk-java architecture

> Architecture diagram of the GitHub repository sap/cloud-sdk-java, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sap/cloud-sdk-java
- Repository: https://github.com/sap/cloud-sdk-java

## Overview

SAP Cloud SDK for Java is a library for building connected, resilient, multitenant applications on SAP BTP. An application uses generated or generic protocol clients to make outbound service calls; connectivity resolves destinations and supplies authentication and HTTP support. The repository also provides tenant-aware context, caching, and resilience facilities. README documents the OData, OpenAPI, and connectivity capabilities; sampled source and the SOURCE INDEX support selected internal relationships. Many integrations are represented by unsampled modules, so those links are shown as unverified rather than asserted calls.

Main entry points: [`cloudplatform/cloudplatform-connectivity/src/main/java/com/sap/cloud/sdk/cloudplatform/connectivity/Destination.java`](https://github.com/sap/cloud-sdk-java/blob/main/cloudplatform/cloudplatform-connectivity/src/main/java/com/sap/cloud/sdk/cloudplatform/connectivity/Destination.java) (Destination API), [`cloudplatform/connectivity-destination-service/src/main/java/com/sap/cloud/sdk/cloudplatform/connectivity/DestinationService.java`](https://github.com/sap/cloud-sdk-java/blob/main/cloudplatform/connectivity-destination-service/src/main/java/com/sap/cloud/sdk/cloudplatform/connectivity/DestinationService.java) (Destination Retrieval), [`datamodel/odata-v4/odata-v4-core/src/main/java/com/sap/cloud/sdk/datamodel/odatav4/core`](https://github.com/sap/cloud-sdk-java/tree/main/datamodel/odata-v4/odata-v4-core/src/main/java/com/sap/cloud/sdk/datamodel/odatav4/core) (OData v4), [`datamodel/openapi/openapi-core/src/main/java/com/sap/cloud/sdk/services/openapi`](https://github.com/sap/cloud-sdk-java/tree/main/datamodel/openapi/openapi-core/src/main/java/com/sap/cloud/sdk/services/openapi) (OpenAPI Client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_protocols["Protocol Clients"]
  node_odata["OData Clients"]
  node_odata4["OData v4"]
  node_openapi["OpenAPI Client"]
  node_soap["SOAP Transport"]
  node_rfc["RFC Connectivity"]
end

subgraph group_connectivity["Connectivity"]
  node_destination["Destination API<br/>[Destination.java]"]
  node_destinationload["Destination Retrieval"]
  node_oauth["OAuth Services<br/>[OAuth2Service.java]"]
  node_http["HTTP Clients"]
end

subgraph group_platform["Platform Services"]
  node_tenant["Tenant Context"]
  node_threadctx["Thread Context"]
  node_cache[("Shared Caching<br/>[CacheManager.java]")]
  node_resilience["Resilience"]
end

subgraph group_generation["Client Generation"]
  node_odata_gen["OData Generator<br/>[EdmService.java]"]
  node_openapi_gen["OpenAPI Generator"]
end

node_app(("SDK Consumer"))
node_remote(("Remote Services"))

node_app -->|"uses clients"| node_odata
node_app -->|"uses clients"| node_odata4
node_app -->|"uses clients"| node_openapi
node_app -->|"configures connections"| node_destination
node_odata_gen -.->|"generates clients"| node_odata4
node_openapi_gen -->|"generates clients"| node_openapi
node_destination -.->|"retrieves destinations"| node_destinationload
node_destinationload -->|"uses cache"| node_cache
node_destinationload -->|"uses tenant"| node_tenant
node_destinationload -->|"uses resilience"| node_resilience
node_oauth -->|"caches tokens"| node_cache
node_oauth -->|"reads tenant"| node_tenant
node_oauth -.->|"requests tokens"| node_http
node_odata -.->|"uses connectivity"| node_destination
node_odata4 -.->|"uses connectivity"| node_destination
node_openapi -.->|"uses connectivity"| node_destination
node_soap -.->|"uses connectivity"| node_destination
node_rfc -.->|"uses connectivity"| node_destination
node_odata -->|"sends requests"| node_remote
node_odata4 -->|"sends requests"| node_remote
node_openapi -->|"consumes services"| node_remote
node_soap -->|"sends requests"| node_remote
node_rfc -->|"sends requests"| node_remote
node_threadctx -.->|"propagates context"| node_tenant

click node_odata "https://github.com/sap/cloud-sdk-java/tree/main/datamodel/odata-client/src/main/java/com/sap/cloud/sdk/datamodel/odata/client"
click node_odata4 "https://github.com/sap/cloud-sdk-java/tree/main/datamodel/odata-v4/odata-v4-core/src/main/java/com/sap/cloud/sdk/datamodel/odatav4/core"
click node_openapi "https://github.com/sap/cloud-sdk-java/tree/main/datamodel/openapi/openapi-core/src/main/java/com/sap/cloud/sdk/services/openapi"
click node_soap "https://github.com/sap/cloud-sdk-java/blob/main/datamodel/soap/src/main/java/com/sap/cloud/sdk/s4hana/connectivity/soap/DefaultHttpClientTransportSender.java"
click node_rfc "https://github.com/sap/cloud-sdk-java/tree/main/s4hana/rfc/src/main/java/com/sap/cloud/sdk/s4hana/connectivity/rfc"
click node_destination "https://github.com/sap/cloud-sdk-java/blob/main/cloudplatform/cloudplatform-connectivity/src/main/java/com/sap/cloud/sdk/cloudplatform/connectivity/Destination.java"
click node_destinationload "https://github.com/sap/cloud-sdk-java/blob/main/cloudplatform/connectivity-destination-service/src/main/java/com/sap/cloud/sdk/cloudplatform/connectivity/DestinationService.java"
click node_oauth "https://github.com/sap/cloud-sdk-java/blob/main/cloudplatform/connectivity-oauth/src/main/java/com/sap/cloud/sdk/cloudplatform/connectivity/OAuth2Service.java"
click node_http "https://github.com/sap/cloud-sdk-java/tree/main/cloudplatform/connectivity-apache-httpclient5/src/main/java/com/sap/cloud/sdk/cloudplatform/connectivity"
click node_odata_gen "https://github.com/sap/cloud-sdk-java/blob/main/datamodel/odata-v4/odata-v4-generator/src/main/java/com/sap/cloud/sdk/datamodel/odatav4/generator/EdmService.java"
click node_openapi_gen "https://github.com/sap/cloud-sdk-java/tree/main/datamodel/openapi/openapi-generator/src/main/java/com/sap/cloud/sdk/datamodel/openapi/generator"
click node_tenant "https://github.com/sap/cloud-sdk-java/blob/main/cloudplatform/tenant/src/main/java/com/sap/cloud/sdk/cloudplatform/tenant/TenantAccessor.java"
click node_threadctx "https://github.com/sap/cloud-sdk-java/blob/main/cloudplatform/cloudplatform-core/src/main/java/com/sap/cloud/sdk/cloudplatform/thread/DefaultThreadContextExecutorService.java"
click node_cache "https://github.com/sap/cloud-sdk-java/blob/main/cloudplatform/caching/src/main/java/com/sap/cloud/sdk/cloudplatform/cache/CacheManager.java"
click node_resilience "https://github.com/sap/cloud-sdk-java/tree/main/cloudplatform/resilience-api/src/main/java/com/sap/cloud/sdk/cloudplatform/resilience"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_odata,node_odata4,node_openapi,node_soap,node_rfc toneBlue
class node_destination,node_destinationload,node_oauth,node_http toneAmber
class node_tenant,node_threadctx,node_cache,node_resilience toneMint
class node_odata_gen,node_openapi_gen toneRose
class node_app,node_remote toneIndigo
```

## Components

### Protocol Clients

- [OData Clients](https://github.com/sap/cloud-sdk-java/tree/main/datamodel/odata-client/src/main/java/com/sap/cloud/sdk/datamodel/odata/client): `datamodel/odata-client/src/main/java/com/sap/cloud/sdk/datamodel/odata/client`
- [OData v4](https://github.com/sap/cloud-sdk-java/tree/main/datamodel/odata-v4/odata-v4-core/src/main/java/com/sap/cloud/sdk/datamodel/odatav4/core): `datamodel/odata-v4/odata-v4-core/src/main/java/com/sap/cloud/sdk/datamodel/odatav4/core`
- [OpenAPI Client](https://github.com/sap/cloud-sdk-java/tree/main/datamodel/openapi/openapi-core/src/main/java/com/sap/cloud/sdk/services/openapi): `datamodel/openapi/openapi-core/src/main/java/com/sap/cloud/sdk/services/openapi`
- [SOAP Transport](https://github.com/sap/cloud-sdk-java/blob/main/datamodel/soap/src/main/java/com/sap/cloud/sdk/s4hana/connectivity/soap/DefaultHttpClientTransportSender.java): `datamodel/soap/src/main/java/com/sap/cloud/sdk/s4hana/connectivity/soap/DefaultHttpClientTransportSender.java`
- [RFC Connectivity](https://github.com/sap/cloud-sdk-java/tree/main/s4hana/rfc/src/main/java/com/sap/cloud/sdk/s4hana/connectivity/rfc): `s4hana/rfc/src/main/java/com/sap/cloud/sdk/s4hana/connectivity/rfc`

### Connectivity

- [Destination API](https://github.com/sap/cloud-sdk-java/blob/main/cloudplatform/cloudplatform-connectivity/src/main/java/com/sap/cloud/sdk/cloudplatform/connectivity/Destination.java): `cloudplatform/cloudplatform-connectivity/src/main/java/com/sap/cloud/sdk/cloudplatform/connectivity/Destination.java`
- [Destination Retrieval](https://github.com/sap/cloud-sdk-java/blob/main/cloudplatform/connectivity-destination-service/src/main/java/com/sap/cloud/sdk/cloudplatform/connectivity/DestinationService.java): `cloudplatform/connectivity-destination-service/src/main/java/com/sap/cloud/sdk/cloudplatform/connectivity/DestinationService.java`
- [OAuth Services](https://github.com/sap/cloud-sdk-java/blob/main/cloudplatform/connectivity-oauth/src/main/java/com/sap/cloud/sdk/cloudplatform/connectivity/OAuth2Service.java): `cloudplatform/connectivity-oauth/src/main/java/com/sap/cloud/sdk/cloudplatform/connectivity/OAuth2Service.java`
- [HTTP Clients](https://github.com/sap/cloud-sdk-java/tree/main/cloudplatform/connectivity-apache-httpclient5/src/main/java/com/sap/cloud/sdk/cloudplatform/connectivity): `cloudplatform/connectivity-apache-httpclient5/src/main/java/com/sap/cloud/sdk/cloudplatform/connectivity`

### Platform Services

- [Tenant Context](https://github.com/sap/cloud-sdk-java/blob/main/cloudplatform/tenant/src/main/java/com/sap/cloud/sdk/cloudplatform/tenant/TenantAccessor.java): `cloudplatform/tenant/src/main/java/com/sap/cloud/sdk/cloudplatform/tenant/TenantAccessor.java`
- [Thread Context](https://github.com/sap/cloud-sdk-java/blob/main/cloudplatform/cloudplatform-core/src/main/java/com/sap/cloud/sdk/cloudplatform/thread/DefaultThreadContextExecutorService.java): `cloudplatform/cloudplatform-core/src/main/java/com/sap/cloud/sdk/cloudplatform/thread/DefaultThreadContextExecutorService.java`
- [Shared Caching](https://github.com/sap/cloud-sdk-java/blob/main/cloudplatform/caching/src/main/java/com/sap/cloud/sdk/cloudplatform/cache/CacheManager.java): `cloudplatform/caching/src/main/java/com/sap/cloud/sdk/cloudplatform/cache/CacheManager.java`
- [Resilience](https://github.com/sap/cloud-sdk-java/tree/main/cloudplatform/resilience-api/src/main/java/com/sap/cloud/sdk/cloudplatform/resilience): `cloudplatform/resilience-api/src/main/java/com/sap/cloud/sdk/cloudplatform/resilience`

### Client Generation

- [OData Generator](https://github.com/sap/cloud-sdk-java/blob/main/datamodel/odata-v4/odata-v4-generator/src/main/java/com/sap/cloud/sdk/datamodel/odatav4/generator/EdmService.java): `datamodel/odata-v4/odata-v4-generator/src/main/java/com/sap/cloud/sdk/datamodel/odatav4/generator/EdmService.java`
- [OpenAPI Generator](https://github.com/sap/cloud-sdk-java/tree/main/datamodel/openapi/openapi-generator/src/main/java/com/sap/cloud/sdk/datamodel/openapi/generator): `datamodel/openapi/openapi-generator/src/main/java/com/sap/cloud/sdk/datamodel/openapi/generator`

### Other components

- **SDK Consumer**
- **Remote Services**

## Connections

- SDK Consumer → OData Clients: uses clients (evidence: `README.md`)
- SDK Consumer → OData v4: uses clients (evidence: `README.md`)
- SDK Consumer → OpenAPI Client: uses clients (evidence: `README.md`)
- SDK Consumer → Destination API: configures connections (evidence: `README.md`)
- OData Generator → OData v4: generates clients (evidence: `datamodel/odata-v4/odata-v4-generator/src/main/java/com/sap/cloud/sdk/datamodel/odatav4/generator/EdmService.java`)
- OpenAPI Generator → OpenAPI Client: generates clients (evidence: `README.md`)
- Destination API → Destination Retrieval: retrieves destinations (evidence: `cloudplatform/connectivity-destination-service/src/main/java/com/sap/cloud/sdk/cloudplatform/connectivity/DestinationService.java`)
- Destination Retrieval → Shared Caching: uses cache (evidence: `cloudplatform/connectivity-destination-service/src/main/java/com/sap/cloud/sdk/cloudplatform/connectivity/DestinationService.java`)
- Destination Retrieval → Tenant Context: uses tenant (evidence: `cloudplatform/connectivity-destination-service/src/main/java/com/sap/cloud/sdk/cloudplatform/connectivity/DestinationService.java`)
- Destination Retrieval → Resilience: uses resilience (evidence: `cloudplatform/connectivity-destination-service/src/main/java/com/sap/cloud/sdk/cloudplatform/connectivity/DestinationService.java`)
- OAuth Services → Shared Caching: caches tokens (evidence: `cloudplatform/connectivity-oauth/src/main/java/com/sap/cloud/sdk/cloudplatform/connectivity/OAuth2Service.java`)
- OAuth Services → Tenant Context: reads tenant (evidence: `cloudplatform/connectivity-oauth/src/main/java/com/sap/cloud/sdk/cloudplatform/connectivity/OAuth2Service.java`)
- OAuth Services → HTTP Clients: requests tokens
- OData Clients → Destination API: uses connectivity
- OData v4 → Destination API: uses connectivity
- OpenAPI Client → Destination API: uses connectivity (evidence: `datamodel/openapi/openapi-core/src/main/java/com/sap/cloud/sdk/services/openapi/core/AbstractOpenApiService.java`)
- SOAP Transport → Destination API: uses connectivity
- RFC Connectivity → Destination API: uses connectivity
- OData Clients → Remote Services: sends requests (evidence: `README.md`)
- OData v4 → Remote Services: sends requests (evidence: `README.md`)
- OpenAPI Client → Remote Services: consumes services (evidence: `README.md`)
- SOAP Transport → Remote Services: sends requests (evidence: `README.md`)
- RFC Connectivity → Remote Services: sends requests (evidence: `README.md`)
- Thread Context → Tenant Context: propagates context
