Developer guide - AWS SDK for Java 2.x

The AWS SDK for Java provides a Java API for AWS services. Using the SDK, you can easily build Java applications that work with Amazon S3, Amazon EC2, DynamoDB, and more.

The AWS SDK for Java 2.x is a major rewrite of the version 1.x code base. It’s built on top of Java 8+ and adds several frequently requested features. These include support for non-blocking I/O and the ability to plug in a different HTTP implementation at run time. For more information see the AWS Blog.

We regularly add support for new services to the AWS SDK for Java. For a list of changes and features in a particular version, view the change log.

Get started with the SDK

If you’re ready to get hands-on with the SDK, follow the Quick Start tutorial.

To set up your development environment, see Setting up.

If you’re currently using version 1.x of the SDK for Java, see Migrating to version 2 for specific guidance.

For information on making requests to Amazon S3, DynamoDB, Amazon EC2 and other AWS services, see Using the SDK for Java and Code examples for the AWS SDK for Java 2.x.

Developing applications for Android

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

Maintenance and support for SDK major versions

For information about maintenance and support for SDK major versions and their underlying dependencies, see the following in the AWS SDKs and Tools Reference Guide

• AWS SDKs and Tools Maintenance Policy

• AWS SDKs and Tools Version Support Matrix

Additional resources

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

• AWS SDK for Java 2.x Reference

• Java developer blog

• Java developer forums

• GitHub:

  • Documentation source

  • SDK source

• The AWS Code Sample Catalog

• @awsforjava (Twitter)

Features not yet in the version 2 of the SDK

See the following Github issues for details about additional features not yet in 2.x. Comments and feedback are also welcome.

• High-level libraries

  • Amazon S3 Transfer manager

  • Amazon S3 Encryption Client

  • DynamoDB document APIs

  • DynamoDB Encryption Client

  • Amazon SQS Client-side Buffering

• Progress Listeners

Contributing to the SDK

Developers can also contribute feedback through the following channels:

• Submit issues on GitHub:

  • Submit documentation issues

  • Submit SDK issues

• Join an informal chat about SDK on the AWS SDK for Java 2.x gitter channel

• Submit feedback anonymously to [e-mail]. This email is monitored by the AWS SDK for Java team.

• Submit pull requests in the documentation or SDK source GitHub repositories to contribute to the SDK development.