Java

Upload File with User-Defined Metadata

See more Amazon S3 Examples

Demonstrates how to upload a file with user-defined metadata to the Amazon S3 service. Chilkat2 Java

import com.chilkatsoft.chilkat2.ChilkatException;
import com.chilkatsoft.chilkat2.Http;

public class ChilkatExample {

    public static void main(String[] args) {
        // This example assumes the Chilkat API to have been previously unlocked.
        // See Global Unlock Sample for sample code.

        Http http = new Http();

        // Insert your AWS keys here:
        http.setAwsAccessKey("AWS_ACCESS_KEY");
        http.setAwsSecretKey("AWS_SECRET_KEY");

        String bucketName = "chilkat.ocean";
        String objectName = "seahorse.jpg";
        String localFilePath = "qa_data/jpg/seahorse.jpg";
        String contentType = "image/jpg";

        // User-defined metadata are name/value pairs, and are added to the HTTP request header.
        // Header names must begin with "x-amz-meta-" to distinguish them from other HTTP headers.
        // Note that Amazon S3 stores user-defined metadata keys in lowercase.

        // For example, to add genus=Hippocampus, we do this:
        http.setRequestHeader("x-amz-meta-genus", "Hippocampus");

        // Add a few more user-metadata key pairs.
        http.setRequestHeader("x-amz-meta-species", "big-belly seahorse");
        http.setRequestHeader("x-amz-meta-habitat", "shallow tropical and temperate waters");

        try {
            http.s3UploadFile(localFilePath, contentType, bucketName, objectName);
            System.out.println("File uploaded.");
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
        }
    }
}