Developer Guide - Amazon SDK for Java 1.x - Amazon SDK for Java
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

Hello Amazon Web Services Java community! Please share your experience and help us improve the Amazon SDK for Java and its learning resources by taking a survey. This survey takes approximately 10 minute to complete.

Click here to take the survey

Developer Guide - Amazon SDK for Java 1.x

The Amazon SDK for Java provides a Java API for Amazon services. Using the SDK, you can easily build Java applications that work with Amazon S3, Amazon EC2, DynamoDB, and more. We regularly add support for new services to the Amazon SDK for Java. For a list of the supported services and their API versions that are included with each release of the SDK, view the release notes for the version that you’re working with.

Version 2 of the SDK released

Take a look at the new Amazon SDK for Java 2.x at https://github.com/aws/aws-sdk-java-v2/. It includes much awaited features, such as a way to plug in an HTTP implementation. To get started, see the Amazon SDK for Java 2.x Developer Guide.

Additional Documentation and Resources

In addition to this guide, the following are valuable online resources for Amazon SDK for Java developers:

Eclipse IDE Support

If you develop code using the Eclipse IDE, you can use the Amazon Toolkit for Eclipse to add the Amazon SDK for Java to an existing Eclipse project or to create a new Amazon SDK for Java project. The toolkit also supports creating and uploading Lambda functions, launching and monitoring Amazon EC2 instances, managing IAM users and security groups, a Amazon CloudFormation template editor, and more.

See the Amazon Toolkit for Eclipse User Guide for full documentation.

Developing Applications for Android

If you’re an Android developer, Amazon Web Services publishes an SDK made specifically for Android development: the Amazon Mobile SDK for Android. See the Amazon Mobile SDK for Android Developer Guide for full documentation.

Viewing the SDK's Revision History

To view the release history of the Amazon SDK for Java, including changes and supported services per SDK version, see the SDK’s release notes.

Building Java Reference Documentation for Earlier SDK versions

The Amazon SDK for Java API Reference represents the most recent build of version 1.x of the SDK. If you’re using an earlier build of the 1.x version, you might want to access the SDK reference documentation that matches the version you’re using.

The easiest way to build the documentation is using Apache’s Maven build tool. Download and install Maven first if you don’t already have it on your system, then use the following instructions to build the reference documentation.

  1. Locate and select the SDK version that you’re using on the releases page of the SDK repository on GitHub.

  2. Choose either the zip (most platforms, including Windows) or tar.gz (Linux, macOS, or Unix) link to download the SDK to your computer.

  3. Unpack the archive to a local directory.

  4. On the command line, navigate to the directory where you unpacked the archive, and type the following.

    mvn javadoc:javadoc
  5. After building is complete, you’ll find the generated HTML documentation in the aws-java-sdk/target/site/apidocs/ directory.