AWS SDK for Java 2.x Developer Guide

Overview

The AWS SDK for Java 2.x provides a modern, type-safe API for AWS services. Built on Java 8+, it offers improved performance, better error handling, and enhanced security compared to v1.x.

Key Features

Modern Architecture: Built on Java 8+ with reactive and async support
Type Safety: Comprehensive type annotations and validation
Performance Optimized: Connection pooling, async support, and SSL optimization
Enhanced Security: Better credential management and security practices
Extensive Coverage: Support for all AWS services with regular updates

Core Concepts

Service Clients

The primary interface for interacting with AWS services. All clients implement the SdkClient interface.

// S3Client example
S3Client s3 = S3Client.builder().region(Region.US_EAST_1).build();

Client Configuration

Configure behavior through builders supporting:

Timeout settings
HTTP client selection
Authentication methods
Monitoring and metrics

Credential Providers

Multiple authentication methods:

Environment variables
System properties
Shared credential files
IAM roles
SSO integration

HTTP Clients

Choose from three HTTP implementations:

Apache HttpClient (synchronous)
Netty NIO Client (asynchronous)
URL Connection Client (lightweight)

Migration from v1.x

The SDK 2.x is not backward compatible with v1.x. Key changes:

Builder pattern for client creation
Different package structure
Enhanced error handling
New credential system
Improved resource management

Getting Started

Include the BOM (Bill of Materials) for version management:

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>software.amazon.awssdk</groupId>
            <artifactId>bom</artifactId>
            <version>2.25.0</version> // Use latest stable version
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

Add service-specific dependencies:

<dependencies>
    <!-- S3 Service -->
    <dependency>
        <groupId>software.amazon.awssdk</groupId>
        <artifactId>s3</artifactId>
    </dependency>

    <!-- Core SDK -->
    <dependency>
        <groupId>software.amazon.awssdk</groupId>
        <artifactId>sdk-core</artifactId>
    </dependency>
</dependencies>

Architecture Overview

AWS Service Client
├── Configuration Layer
│   ├── Client Override Configuration
│   └── HTTP Client Configuration
├── Authentication Layer
│   ├── Credential Providers
│   └── Security Context
├── Transport Layer
│   ├── HTTP Client (Apache/Netty/URLConn)
│   └── Connection Pool
└── Protocol Layer
    ├── Service Protocol Implementation
    └── Error Handling

Service Discovery

The SDK automatically discovers and registers all available AWS services through service interfaces and paginators.

Available Services

All AWS services are available through dedicated client interfaces:

S3 (Simple Storage Service)
DynamoDB (NoSQL Database)
Lambda (Serverless Functions)
EC2 (Compute Cloud)
RDS (Managed Databases)
And 200+ other services

For a complete list, see the AWS Service documentation.

Support and Community

GitHub Issues: Report bugs and request features
AWS Amplify: For mobile app developers
Migration Guide: Available for v1.x users
Changelog: Track changes on GitHub

3.5 KiB Raw Blame History