5.1 Transferring Data using standard TransferUtility

Add the following to the import statements:

import com.amazonaws.services.s3.AmazonS3Client;
import com.amazonaws.mobileconnectors.s3.transferutility.TransferObserver;
import com.amazonaws.mobileconnectors.s3.transferutility.TransferUtility;

Create a credentials provider so you can easily integrate AWS S3 with your Android application. You pass the credentials provider object to the constructor of the AWS client you are using. The credentials provider looks like this:

Java

AWSCredentials credentialsProvider = new AWSCredentials() {
    @Override
    public String getAWSAccessKeyId() {
        return AWS_ACCESS_KEY;
    }

    @Override
    public String getAWSSecretKey() {
        return AWS_SECRET_KEY;
    }
};                       

Kotlin

5.1.1 Initialize the S3 TransferUtility

First, pass your Amazon credentials provider to the AmazonS3Client constructor. Then, pass the client to the TransferUtility constructor along with the application context:

Java

AmazonS3Client s3 = new AmazonS3Client(credentialsProvider, appContext);
TransferUtility transferUtility = new TransferUtility(s3, appContext);// Some code

Kotlin

5.1.2 Upload a File to Amazon S3

To upload a file to S3, instantiate a TransferObserver object. Call upload() on your TransferUtility object and assign it to the observer, passing the following parameters:

• bucket_name – Name of the S3 bucket to store the file

• key – Name of the file, once stored in S3

• file – java.io.File object to upload

Java

TransferObserver transferObserver = transferUtility.upload(
  MY_BUCKET,     /* The bucket to upload to */
  OBJECT_KEY,    /* The key for the uploaded object */
  MY_FILE        /* The file where the data to upload exists */
);                  

Kotlin

Uploads automatically use S3’s multi-part upload functionality on large files to enhance throughput.

5.1.3 Download a File from Amazon S3

To download a file from S3, instantiate a TransferObserver object. Call download() on your TransferUtility object and assign it to the observer, passing the following parameters:

• bucket_name – A string representing the name of the S3 bucket where the file is stored

• key – A string representing the name of the S3 object (a file in this case) to download

• file – the java.io.File object where the downloaded file will be written

Java

TransferObserver transferObserver = transferUtility.download(
  MY_BUCKET,     /* The bucket to download from */
  OBJECT_KEY,    /* The key for the object to download */
  MY_FILE        /* The file to download the object to */
);

Kotlin

5.1.4 Tracking S3 Transfer Progress

With the TransferUtility, the download() and upload() methods return a TransferObserver object. This object gives access to:

• The state (now specified as an enum)

• The total bytes transferred thus far

• The total bytes to transfer (for easily calculating progress bars)

• A unique ID that you can use to keep track of distinct transfers

Given the transfer ID, this TransferObserver object can be retrieved from anywhere in your app, including if the app is killed. It also lets you create a TransferListener, which will be updated on state or progress change, as well as when an error occurs.

To get the progress of a download or upload, call setTransferListener() on your TransferObserver. This requires you to implement onStateChanged, onProgressChanged, and onError. For example:

Java

TransferListener listener = new TransferListener(){

    @Override
    public void onStateChanged(int id, TransferState state) {
        // do something
    }

    @Override
    public void onProgressChanged(int id, long bytesCurrent, long bytesTotal) {
        int percentage = (int) (bytesCurrent/bytesTotal * 100);
        //Display percentage transffered to user
    }

    @Override
    public void onError(int id, Exception ex) {
        // do something
    }
};

TransferObserver transferObserver = transferUtility.download(MY_BUCKET, OBJECT_KEY, MY_FILE, listener);

Kotlin