How salesforce/multicloudj works
MultiCloudJ is a Java SDK that presents cloud-neutral APIs for common cloud services, with AWS, GCP, and Alibaba listed as supported providers. The principal workflow is an application choosing a provider and using a service API to perform cloud operations through a provider-specific implementation. The tree and README establish the service and provider breadth; sampled sources show some client-to-driver calls and provider behavior, but not wiring for every service/provider pair. Those unsampled implementation relationships are therefore not asserted.
Main entry points: Query.java Document Store API · TopicClient.java Pub/Sub API · BucketClient.java Blob Store API · StsClient.java STS API
Components 32
Application API
- MultiCloudJ SDK
Data Services
- Blob Store API
blob/blob-client/src/main/java/com/salesforce/multicloudj/blob/client/BucketClient.java - AWS Blob
blob/blob-aws/src/main/java/com/salesforce/multicloudj/blob/aws/AwsBlobClient.java - GCP Blob
blob/blob-gcp/src/main/java/com/salesforce/multicloudj/blob/gcp/GcpBlobClient.java - Alibaba Blob
blob/blob-ali/src/main/java/com/salesforce/multicloudj/blob/ali/AliBlobClient.java - Document Store API
docstore/docstore-client/src/main/java/com/salesforce/multicloudj/docstore/client/Query.java - Document Models
docstore/docstore-client/src/main/java/com/salesforce/multicloudj/docstore/driver/Collection.java - AWS Document Store
docstore/docstore-aws/src/main/java/com/salesforce/multicloudj/docstore/aws/AwsDocStore.java - Alibaba Document Store
docstore/docstore-ali/src/main/java/com/salesforce/multicloudj/docstore/ali/AliDocStore.java - Firestore Store
docstore/docstore-gcp-firestore/src/main/java/com/salesforce/multicloudj/docstore/gcp/FSDocStore.java - Spanner Codec
docstore/docstore-gcp-spanner/src/main/java/com/salesforce/multicloudj/docstore/gcp/SpannerCodec.java
Messaging and Identity
- Pub/Sub API
pubsub/pubsub-client/src/main/java/com/salesforce/multicloudj/pubsub/client/TopicClient.java - AWS Pub/Sub
pubsub/pubsub-aws/src/main/java/com/salesforce/multicloudj/pubsub/aws/AwsSnsTopic.java - Alibaba Pub/Sub
pubsub/pubsub-ali/src/main/java/com/salesforce/multicloudj/pubsub/ali/AliSmqTopic.java - GCP Subscription
pubsub/pubsub-gcp/src/main/java/com/salesforce/multicloudj/pubsub/gcp/GcpSubscription.java - STS API
sts/sts-client/src/main/java/com/salesforce/multicloudj/sts/client/StsClient.java - AWS STS
sts/sts-aws/src/main/java/com/salesforce/multicloudj/sts/aws/AwsStsUtilities.java - Alibaba STS
sts/sts-ali/src/main/java/com/salesforce/multicloudj/sts/ali/AliSts.java - GCP STS
sts/sts-gcp/src/main/java/com/salesforce/multicloudj/sts/gcp/GcpSts.java
Cloud Operations
- IAM API
iam/iam-client/src/main/java/com/salesforce/multicloudj/iam/client/IamClient.java - AWS IAM
iam/iam-aws/src/main/java/com/salesforce/multicloudj/iam/aws/AwsIam.java - GCP IAM
iam/iam-gcp/src/main/java/com/salesforce/multicloudj/iam/gcp/GcpIam.java - Container Registry
registry/registry-client/src/main/java/com/salesforce/multicloudj/registry/client/ContainerRegistryClient.java - AWS Registry
registry/registry-aws/src/main/java/com/salesforce/multicloudj/registry/aws/AuthStrippingInterceptor.java - GCP Registry
registry/registry-gcp/src/main/java/com/salesforce/multicloudj/registry/gcp/GcpRegistry.java - DB Backup Restore
dbbackuprestore/dbbackuprestore-client/src/main/java/com/salesforce/multicloudj/dbbackuprestore/client/DBBackupRestoreClient.java - AWS Backup Restore
dbbackuprestore/dbbackuprestore-aws/src/main/java/com/salesforce/multicloudj/dbbackuprestore/aws/AwsDBBackupRestore.java - Alibaba Backup Restore
dbbackuprestore/dbbackuprestore-ali/src/main/java/com/salesforce/multicloudj/dbbackuprestore/ali/AliDBBackupRestore.java - Firestore Backup
dbbackuprestore/dbbackuprestore-gcp-firestore/src/main/java/com/salesforce/multicloudj/dbbackuprestore/gcp/FSDBBackupRestore.java
Shared Foundation
- Common Runtime
multicloudj-common/src/main/java/com/salesforce/multicloudj/common/service/SdkService.java - Error Translation
multicloudj-common/src/main/java/com/salesforce/multicloudj/common/exceptions/ExceptionHandler.java
Other components
- Java application
Connections 34
- Java application → MultiCloudJ SDK: uses
README.md - MultiCloudJ SDK → Blob Store API: offers API
README.md - MultiCloudJ SDK → Document Store API: offers API
README.md - MultiCloudJ SDK → Pub/Sub API: offers API
README.md - MultiCloudJ SDK → STS API: offers API
README.md - MultiCloudJ SDK → IAM API: offers API
README.md - MultiCloudJ SDK → Container Registry: offers API
README.md - MultiCloudJ SDK → DB Backup Restore: offers API
README.md - Blob Store API → AWS Blob: provider implementation
- Blob Store API → GCP Blob: provider implementation
- Blob Store API → Alibaba Blob: provider implementation
- Document Store API → Document Models: uses models
docstore/docstore-client/src/main/java/com/salesforce/multicloudj/docstore/client/Query.java - Document Store API → AWS Document Store: provider implementation
- Document Store API → Alibaba Document Store: provider implementation
- Document Store API → Firestore Store: provider implementation
- Firestore Store → Spanner Codec: codec support
- Pub/Sub API → AWS Pub/Sub: provider implementation
- Pub/Sub API → Alibaba Pub/Sub: provider implementation
- Pub/Sub API → GCP Subscription: provider implementation
- STS API → AWS STS: provider implementation
- STS API → Alibaba STS: provider implementation
- STS API → GCP STS: provider implementation
- IAM API → AWS IAM: provider implementation
- IAM API → GCP IAM: provider implementation
- Container Registry → AWS Registry: provider implementation
- Container Registry → GCP Registry: provider implementation
- DB Backup Restore → AWS Backup Restore: provider implementation
- DB Backup Restore → Alibaba Backup Restore: provider implementation
- DB Backup Restore → Firestore Backup: provider implementation
- Common Runtime → Error Translation: builds errors
multicloudj-common/src/main/java/com/salesforce/multicloudj/common/service/SdkService.java - AWS Blob → Error Translation: maps errors
- Alibaba Blob → Error Translation: maps errors
- Document Store API → Alibaba Document Store: runs query
- Pub/Sub API → Common Runtime: maps errors