Developer guide - AWS SDK for Java 2.x

The AWS SDK for Java provides a Java API for Amazon Web 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. For guidance on migrating your application from 1.11.x to 2.x, see the migration guide.

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 AWS SDK for Java 2.x

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.

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

Developing AWS 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 Shared Configuration and Credentials 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 AWS SDK for Java 2.x

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

• High-level libraries

  • S3 Transfer manager

  • S3 Encryption Client

  • DynamoDB document APIs

  • DynamoDB Encryption Client

  • 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.