Skip to Content
Technical Articles
Author's profile photo Varun Verma

Document Storage in Cloud Foundry with AWS S3


While developing applications on SAP Cloud Platform, we often have need to store files. In the SCP Neo edition a Document Service is available.

However, in the Cloud Foundry edition – the same Document service is not available.

Instead, a different service called Object Storage is available. This service specefic to the underlying IaaS.

For e.g. this is S3 (on AWS), Cloud Storage (on GCP), Blob Storage (on Azure)

In this blog post, we will focus on S3 storage and how to develop a simple Java app to read and store files.


Account Setup

Before proceeding futher, make sure that the objectstore service is available and quota is added to your subaccount.

An instance of the object store service must be created and it can be done in the following ways:

Option 1: Create instance of this service directly from the cockpit. Simply select default options.

Option 2: Add this service / resource as a dependency in the MTA Deployment descriptor (mta.yaml)  file. In this case the service instance will be created automatically when the application is deployed

Recommendation: Option 2 is recommended.


Understanding S3 service in AWS

In this blog post, we will not explain about AWS S3 service. Read about AWS S3 as a prerequisite.

It is beneficial to understand the concepts of bucket and how buckets are used.

For the lazy developers who don’t like reading long documentation:

  • An AWS bucket is a like a big folder where you can store your files.
  • A bucket (folder) will be provided for your application where you can organize your own files.
  • Anyone with the access key can read / write files in this bucket (folder)


Project MTA

Coming back to real stuff : Implementation in the Project

First – We have to define objectstore as a requirement / dependency in the MTA Yaml file like this:

ID: ObjectStore_Demo
_schema-version: '2.1'
description: Object Store Demo
version: 0.0.1
  - name: ObjectStore
    type: java
    path: ObjectStore
      memory: 1024M
      - name: ObjectStore_api
          url: '${default-url}'
      - name: demo_s3
  - name: demo_s3
    type: objectstore
      service: objectstore
      service-plan: s3-standard
      service-name: demo_s3

When this app is deployed, the service instance with name demo_s3 will be created and the application will be bound to it automatically.


Service Instance and Bucket Keys

When the application is deployed, the following happens:

  • Service instance is created
  • Application binding is done
  • System creates a bucket and access keys for your application



AWS provides SDKs for several programming languages. For now, we focus only on JAVA SDK.

There are 2 versions of SDK available at the moment:

  • Version 1.1
  • Version 2.0

For this PoC we used version 1.1 as this is older version and a lot of commuity support was available. This was also easier to implement.


POM Dependencies

Add the following dependencies to the POM.xml



Initialize the S3 Client

In JAVA, we need to access the bucket name and access keys. This can be accessed via VCAP services.

		JSONObject vcap = new JSONObject(System.getenv("VCAP_SERVICES"));
		s3_credentials = vcap.getJSONArray("objectstore").getJSONObject(0).getJSONObject("credentials");
		String access_id = s3_credentials.getString("access_key_id");
		String secret_key = s3_credentials.getString("secret_access_key");
		String region = s3_credentials.getString("region");
		BasicAWSCredentials awsCreds = new BasicAWSCredentials(access_id, secret_key);
		s3 = AmazonS3ClientBuilder.standard()
		        .withCredentials(new AWSStaticCredentialsProvider(awsCreds))



Reading file List

Note that you can read the files only from your bucket.

		JSONArray file_list = new JSONArray();
		JSONObject file;
		String bucket_name = s3_credentials.getString("bucket");
		ListObjectsV2Result result = s3.listObjectsV2(bucket_name);
		List<S3ObjectSummary> objects = result.getObjectSummaries();
		for (S3ObjectSummary o : objects) {
			file = new JSONObject();
		return file_list;


Write files to bucket

String file_name = "my_file_name";
String file_content = "my_file_content";
String bucket_name = s3_credentials.getString("bucket");
s3.putObject(bucket_name, file_name, file_content);


Read File Content

		String bucket_name = s3_credentials.getString("bucket");
		S3Object o = s3.getObject(bucket_name, file_name);
		BufferedReader reader = new BufferedReader(new InputStreamReader(o.getObjectContent()));
		StringBuilder sbuilder = new StringBuilder();
		String line;
		while ((line = reader.readLine()) != null) {
		JSONObject result = new JSONObject();
		result.put("file_content", sbuilder.toString());
		return result;


Build and Deploy

You application is not ready to build and deploy. Deploy it on the cloud platform and test.


Full working example:

The complete development example can be seen in the video:



Integrating and using AWS S3 as object store service is really easy.

In this blog post we learnt the followng:

  • How to add object store as a requirement in the MTA file
  • How to read the bucket credentials and access the bucket
  • How to do read and write operations on bucket a S3

The object store sercice can be used where applications have to store and manage files (or raw data). For e.g. in scenarios where application has to store documents, images, reciepts etc.

In my next blog post, I plan to demonstrate how the same can be achieved when underlying IaaS is GCP.

Assigned Tags

      You must be Logged on to comment or reply to a post.
      Author's profile photo Pierre Dominique
      Pierre Dominique


      Thanks for sharing this Varun, this has helped me do the same with Node.js!



      Author's profile photo Wolfgang Himmelsbach
      Wolfgang Himmelsbach

      Buidl and Deploy, typo...

      Author's profile photo Varun Verma
      Varun Verma
      Blog Post Author

      Thanks. Corrected it 🙂

      Author's profile photo Kangana Dash
      Kangana Dash

      Hi      Varun Verma  , Pierre Dominique

      Maximilian Streifeneder 

      Thanks a lot for the great blogs. This has given very good idea about Object Store. But in Reality, we don't have the file directly available .Here in this scenario, you have used POSTMAN and you have uploaded the file Physically, but in Reality, we might need to Use FileUpload Control. So how should we pass the data with File UPload Control? Base64 String? Can you please help me understand this. If Possible , can you please upload a Base64 string file from Post Man.