Sample code for 30+ languages & platforms
Android™

(using AWS Signature Version 2) Streaming Download to File

See more Amazon S3 (new) Examples

The main purpose of this example is to demonstrate how to use the older Signature Version 2 authentication w/ S3. It uses V2 authentication to download a file.

Chilkat Android™ Downloads

Android™
// Important: Don't forget to include the call to System.loadLibrary
// as shown at the bottom of this code sample.
package com.test;

import android.app.Activity;
import com.chilkatsoft.*;

import android.widget.TextView;
import android.os.Bundle;

public class SimpleActivity extends Activity {

  private static final String TAG = "Chilkat";

  // Called when the activity is first created.
  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    boolean success = false;

    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    CkRest rest = new CkRest();

    // Connect to the Amazon AWS REST server.
    boolean bTls = true;
    int port = 443;
    boolean bAutoReconnect = true;
    // The file is located in the bucket named "chilkat100", which becomes part of the domain:
    success = rest.Connect("chilkat100.s3.amazonaws.com",port,bTls,bAutoReconnect);

    // Provide AWS credentials for the REST call.
    CkAuthAws authAws = new CkAuthAws();
    authAws.put_AccessKey("AWS_ACCESS_KEY");
    authAws.put_SecretKey("AWS_SECRET_KEY");
    authAws.put_ServiceName("s3");

    // For AWS Signature Version 2, the following two properties need to be set:
    authAws.put_SignatureVersion(2);
    // See http://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html#ConstructingTheCanonicalizedResourceElement
    authAws.put_CanonicalizedResourceV2("/chilkat100/starfish.jpg");

    success = rest.SetAuthAws(authAws);

    // Send the request to download the JPG.
    success = rest.SendReqNoBody("GET","/starfish.jpg");
    if (success != true) {
        Log.i(TAG, rest.lastErrorText());
        return;
        }

    // Read the response header.
    int responseStatusCode = rest.ReadResponseHeader();
    if (responseStatusCode < 0) {
        Log.i(TAG, rest.lastErrorText());
        return;
        }

    Log.i(TAG, "Response status code = " + String.valueOf(responseStatusCode));

    // We expect a 200 response status if the JPG data is coming.
    // Otherwise, we'll get a string response body with an error message(or no response body).
    if (responseStatusCode == 200) {

        CkStream bodyStream = new CkStream();

        // The stream's sink will be a file.
        bodyStream.put_SinkFile("qa_output/starfish.jpg");

        // Read the response body to the stream.  Given that we've
        // set the stream's sink to a file, it will stream directly
        // to the file.
        success = rest.ReadRespBodyStream(bodyStream,true);
        if (success != true) {
            Log.i(TAG, rest.lastErrorText());
            return;
            }

        Log.i(TAG, "Successfully received the JPG file.");

        }
    else {
        String errResponse = rest.readRespBodyString();
        if (rest.get_LastMethodSuccess() != true) {
            Log.i(TAG, rest.lastErrorText());
            }
        else {
            Log.i(TAG, errResponse);
            }

        }


  }

  static {
      System.loadLibrary("chilkat");

      // Note: If the incorrect library name is passed to System.loadLibrary,
      // then you will see the following error message at application startup:
      //"The application <your-application-name> has stopped unexpectedly. Please try again."
  }
}