Skip to content
The official AWS SDK for Java - Version 2
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.changes Release 2.5.68. Updated CHANGELOG.md, README.md and all pom.xml. Jun 20, 2019
.github Update PULL_REQUEST_TEMPLATE.md Jan 30, 2019
aws-sdk-java Update to next snapshot version: 2.5.69-SNAPSHOT Jun 20, 2019
bom-internal Update to next snapshot version: 2.5.69-SNAPSHOT Jun 20, 2019
bom Update to next snapshot version: 2.5.69-SNAPSHOT Jun 20, 2019
build-tools Fix failed test with JDK11 Mar 19, 2019
buildspecs add transcribestreaming, sqs and kinesis stability tests Jun 14, 2019
bundle Update to next snapshot version: 2.5.69-SNAPSHOT Jun 20, 2019
codegen-lite-maven-plugin Update to next snapshot version: 2.5.69-SNAPSHOT Jun 20, 2019
codegen-lite Update to next snapshot version: 2.5.69-SNAPSHOT Jun 20, 2019
codegen-maven-plugin Update to next snapshot version: 2.5.69-SNAPSHOT Jun 20, 2019
codegen Update to next snapshot version: 2.5.69-SNAPSHOT Jun 20, 2019
core Update to next snapshot version: 2.5.69-SNAPSHOT Jun 20, 2019
docs Updated DynamoDB enhanced client design document. May 24, 2019
http-client-spi Update to next snapshot version: 2.5.69-SNAPSHOT Jun 20, 2019
http-clients Update to next snapshot version: 2.5.69-SNAPSHOT Jun 20, 2019
release-scripts Update to next snapshot version: 2.5.69-SNAPSHOT Jun 20, 2019
scripts Remove codebuild hacks and move to the standard codebuild image. May 31, 2019
services Update to next snapshot version: 2.5.69-SNAPSHOT Jun 20, 2019
test Update to next snapshot version: 2.5.69-SNAPSHOT Jun 20, 2019
utils Update to next snapshot version: 2.5.69-SNAPSHOT Jun 20, 2019
.codecov.yml Ignore test files for code coverage Mar 1, 2019
.gitignore Support Python 3.x for changelog scripts. May 30, 2019
.travis.yml add integ test code coverage support and cross module code coverage May 8, 2019
CHANGELOG.md Release 2.5.68. Updated CHANGELOG.md, README.md and all pom.xml. Jun 20, 2019
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md Mar 2, 2018
CONTRIBUTING.md Move wiki pages to docs folder Jun 21, 2018
LICENSE.txt AWS SDK for Java V2 - Developer Preview Jun 28, 2017
NOTICE.txt Update copyright year Feb 6, 2019
README.md Release 2.5.68. Updated CHANGELOG.md, README.md and all pom.xml. Jun 20, 2019
pom.xml Update to next snapshot version: 2.5.69-SNAPSHOT Jun 20, 2019

README.md

AWS SDK for Java 2.0

Build Status Build Status Maven Gitter codecov

The AWS SDK for Java 2.0 is a rewrite of 1.0 with some great new features. As with version 1.0, it enables you to easily work with Amazon Web Services but also includes features like non-blocking IO and pluggable HTTP implementation to further customize your applications. You can get started in minutes using Maven or any build system that supports MavenCentral as an artifact source.

Getting Started

Sign up for AWS

Before you begin, you need an AWS account. Please see the Sign Up for AWS section of the developer guide for information about how to create an AWS account and retrieve your AWS credentials.

Minimum requirements

To run the SDK you will need Java 1.8+. For more information about the requirements and optimum settings for the SDK, please see the Installing a Java Development Environment section of the developer guide.

Using the SDK

The recommended way to use the AWS SDK for Java in your project is to consume it from Maven.

Whole SDK

You can import the whole SDK into your project (includes all services) as follows:

<dependency>
  <groupId>software.amazon.awssdk</groupId>
  <artifactId>aws-sdk-java</artifactId>
  <version>2.5.68</version>
</dependency>

Individual Services

Alternatively you can add dependencies for the specific services you use only:

<dependency>
  <groupId>software.amazon.awssdk</groupId>
  <artifactId>ec2</artifactId>
  <version>2.5.68</version>
</dependency>
<dependency>
  <groupId>software.amazon.awssdk</groupId>
  <artifactId>s3</artifactId>
  <version>2.5.68</version>
</dependency>

Importing the BOM

To automatically manage module versions (currently all modules have the same version, but this may not always be the case) we recommend you use the Bill of Materials import as follows:

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>software.amazon.awssdk</groupId>
      <artifactId>bom</artifactId>
      <version>2.5.68</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

Then individual models may omit the version from their dependency statement:

<dependencies>
  <dependency>
    <groupId>software.amazon.awssdk</groupId>
    <artifactId>ec2</artifactId>
  </dependency>
  <dependency>
    <groupId>software.amazon.awssdk</groupId>
    <artifactId>s3</artifactId>
  </dependency>
  <dependency>
    <groupId>software.amazon.awssdk</groupId>
    <artifactId>dynamodb</artifactId>
  </dependency>
</dependencies>

See the Set up the AWS SDK for Java section of the developer guide for more usage information.

New Features for 2.0

  • Provides a way to plug in your own HTTP implementation.

  • Provides first class support for non-blocking IO in Async clients.

Building From Source

Once you check out the code from GitHub, you can build it using Maven.

mvn clean install

# Skip tests, checkstyles, findbugs, etc for quick build
mvn clean install -P quick

# Build a specific service module
mvn clean install -pl :s3 -P quick --am

Sample Code

You can find sample code for v2 in the following places:

Giving Feedback

We need your help in making this SDK great. Please participate in the community and contribute to this effort by submitting issues, participating in discussion forums and submitting pull requests through the following channels.

You can’t perform that action at this time.