Amazon S3 File Transfer Library

This library provides file upload and download wrapper classes for the AWS S3 SDK.

Uploading

We wrap a TransferManager with the following features:

• Application environment path prefix
  • This allows multiple environments to use the same S3 bucket but data separation at the root level of the bucket between them. The environment can be specified as any String.
• Automatic content length calculation
• Files downloaded straight to String

Uploading can be performed in 3 ways, each allow the caller to do more configuration:

• Using an UploadContent object - requires supplying the file content as a String along with a file name for the upload.
• Using a file name and InputStream
• Using your own PutObjectRequest

Modifying Uploaded File Permissions

By default the permissions of a newly uploaded file will be inherited from the parent folder or bucket. If you want to upload a file with different permissions, you can use the uploadSync method directly, supplying your own PutObjectRequest:

PutObjectRequest uploadRequest = s3FileUploader.getNewPutObjectRequest(s3Path, fileDataInputStream, fileDataLength);
// Allow everyone to read uploaded file
uploadRequest.setCannedAcl(CannedAccessControlList.PublicRead);

try {
    s3FileUploader.uploadSync(uploadRequest);
} catch (AmazonClientException | IllegalArgumentException e) {
    log.error("Failed to upload public file to Amazon. Error - " + e.getMessage(), e);
}

Required Access Permissions

In order to either upload or download files from Amazon S3, an account must be created with the following permissions:

• Download: GetObject
• Upload: PutObject