AWS SDK for Java 1.x

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.amazonaws</groupId>
      <artifactId>aws-java-sdk-bom</artifactId>
      <version>1.12.793</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <!-- Include only the services you need -->
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-s3</artifactId>
  </dependency>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-dynamodb</artifactId>
  </dependency>
</dependencies>

dependencies {
    implementation platform('com.amazonaws:aws-java-sdk-bom:1.12.793')
    implementation 'com.amazonaws:aws-java-sdk-s3'
    implementation 'com.amazonaws:aws-java-sdk-dynamodb'
}

// Core SDK classes
import com.amazonaws.auth.AWSCredentials;
import com.amazonaws.auth.AWSCredentialsProvider;
import com.amazonaws.auth.DefaultAWSCredentialsProviderChain;
import com.amazonaws.regions.Regions;
import com.amazonaws.ClientConfiguration;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;

// Service-specific imports (example: S3)
import com.amazonaws.services.s3.AmazonS3;
import com.amazonaws.services.s3.AmazonS3ClientBuilder;
import com.amazonaws.services.s3.model.*;

// Service-specific imports (example: DynamoDB)
import com.amazonaws.services.dynamodbv2.AmazonDynamoDB;
import com.amazonaws.services.dynamodbv2.AmazonDynamoDBClientBuilder;
import com.amazonaws.services.dynamodbv2.model.*;

import com.amazonaws.auth.DefaultAWSCredentialsProviderChain;
import com.amazonaws.regions.Regions;
import com.amazonaws.services.s3.AmazonS3;
import com.amazonaws.services.s3.AmazonS3ClientBuilder;

// Create S3 client with default configuration
AmazonS3 s3Client = AmazonS3ClientBuilder.standard()
    .withRegion(Regions.US_WEST_2)
    .withCredentials(new DefaultAWSCredentialsProviderChain())
    .build();

// Use the client
s3Client.listBuckets().forEach(bucket -> {
    System.out.println("Bucket: " + bucket.getName());
});

import com.amazonaws.auth.DefaultAWSCredentialsProviderChain;
import com.amazonaws.auth.AWSStaticCredentialsProvider;
import com.amazonaws.auth.BasicAWSCredentials;

// Recommended: Use default credential provider chain
// Automatically searches: env vars -> system properties -> profile -> IAM role
DefaultAWSCredentialsProviderChain credentialsProvider =
    new DefaultAWSCredentialsProviderChain();

// For development/testing: Static credentials
AWSStaticCredentialsProvider staticCreds = new AWSStaticCredentialsProvider(
    new BasicAWSCredentials("accessKey", "secretKey")
);

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;

try {
    s3Client.getObject("my-bucket", "my-key");
} catch (AmazonServiceException ase) {
    // Service-side error (4xx, 5xx HTTP status)
    System.err.println("Error Code: " + ase.getErrorCode());
    System.err.println("HTTP Status: " + ase.getStatusCode());
    System.err.println("Request ID: " + ase.getRequestId());
} catch (SdkClientException sce) {
    // Client-side error (network failure, etc.)
    System.err.println("Client error: " + sce.getMessage());
}

// Credential providers
interface AWSCredentialsProvider {
    AWSCredentials getCredentials();
    void refresh();
}

// Default credential chain
class DefaultAWSCredentialsProviderChain extends AWSCredentialsProviderChain {
    static DefaultAWSCredentialsProviderChain getInstance();
}

// Client builder base
abstract class AwsClientBuilder<Subclass, TypeToBuild> {
    Subclass withRegion(Regions region);
    Subclass withRegion(String region);
    Subclass withCredentials(AWSCredentialsProvider credentialsProvider);
    Subclass withClientConfiguration(ClientConfiguration config);
    TypeToBuild build();
}

// Exception hierarchy
class AmazonServiceException extends SdkClientException {
    String getErrorCode();
    int getStatusCode();
    String getRequestId();
}

// S3 client builder
class AmazonS3ClientBuilder extends AwsSyncClientBuilder<AmazonS3ClientBuilder, AmazonS3> {
    static AmazonS3ClientBuilder standard();
    static AmazonS3 defaultClient();
}

// Main S3 interface
interface AmazonS3 {
    // Bucket operations
    Bucket createBucket(String bucketName);
    void deleteBucket(String bucketName);
    List<Bucket> listBuckets();

    // Object operations
    PutObjectResult putObject(String bucketName, String key, File file);
    S3Object getObject(String bucketName, String key);
    void deleteObject(String bucketName, String key);
    ObjectListing listObjects(String bucketName);

    // Pre-signed URLs
    URL generatePresignedUrl(String bucketName, String key, Date expiration);
}

// DynamoDB client builder
class AmazonDynamoDBClientBuilder extends AwsSyncClientBuilder<AmazonDynamoDBClientBuilder, AmazonDynamoDB> {
    static AmazonDynamoDBClientBuilder standard();
    static AmazonDynamoDB defaultClient();
}

// Low-level DynamoDB interface
interface AmazonDynamoDB {
    PutItemResult putItem(String tableName, Map<String, AttributeValue> item);
    GetItemResult getItem(String tableName, Map<String, AttributeValue> key);
    QueryResult query(QueryRequest queryRequest);
    ScanResult scan(ScanRequest scanRequest);
}

// Document API
class DynamoDB {
    DynamoDB(AmazonDynamoDB client);
    Table getTable(String tableName);
}

// Object Mapper
class DynamoDBMapper {
    DynamoDBMapper(AmazonDynamoDB dynamoDB);
    <T> T load(Class<T> clazz, Object hashKey);
    <T> void save(T object);
    <T> PaginatedQueryList<T> query(Class<T> clazz, DynamoDBQueryExpression<T> queryExpression);
}

// Standard client creation pattern
AmazonS3 client = AmazonS3ClientBuilder.standard()
    .withRegion(Regions.US_WEST_2)
    .withCredentials(new DefaultAWSCredentialsProviderChain())
    .build();

// Pagination pattern for list operations
ListObjectsV2Request request = new ListObjectsV2Request()
    .withBucketName(bucketName)
    .withMaxKeys(1000);

ListObjectsV2Result result;
do {
    result = s3.listObjectsV2(request);
    // Process results
    request.setContinuationToken(result.getNextContinuationToken());
} while (result.isTruncated());

// Async operations with callback
asyncClient.putItemAsync(request, new AsyncHandler<PutItemRequest, PutItemResult>() {
    public void onSuccess(PutItemRequest req, PutItemResult result) { }
    public void onError(Exception exception) { }
});

// Waiter pattern for polling resource state
ec2.waiters().instanceRunning().run(
    new WaiterParameters<>(new DescribeInstancesRequest().withInstanceIds(instanceId))
);