AWS Java SDK v1

// Core SDK framework
import com.amazonaws.*;
import com.amazonaws.auth.*;
import com.amazonaws.regions.*;
import com.amazonaws.client.builder.*;

// Service-specific imports
import com.amazonaws.services.s3.*;
import com.amazonaws.services.s3.model.*;
import com.amazonaws.services.ec2.*;
import com.amazonaws.services.ec2.model.*;
import com.amazonaws.services.dynamodbv2.*;
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;
import com.amazonaws.services.s3.model.PutObjectRequest;

// Create S3 client using builder pattern
AmazonS3 s3Client = AmazonS3ClientBuilder.standard()
    .withCredentials(new DefaultAWSCredentialsProviderChain())
    .withRegion(Regions.US_EAST_1)
    .build();

// Upload an object
s3Client.putObject(new PutObjectRequest("my-bucket", "my-key", "Hello World!"));

// Clean up resources
s3Client.shutdown();

// Abstract base for all service builders
public abstract class AwsClientBuilder<Subclass extends AwsClientBuilder, TypeToBuild> {
    public final Subclass withCredentials(AWSCredentialsProvider credentialsProvider);
    public final Subclass withRegion(Regions region);
    public final Subclass withRegion(String region);
    public final Subclass withClientConfiguration(ClientConfiguration clientConfiguration);
    public abstract TypeToBuild build();
}

// Client configuration container
public class ClientConfiguration {
    public ClientConfiguration();
    public void setConnectionTimeout(int connectionTimeout);
    public void setSocketTimeout(int socketTimeout);
    public void setMaxConnections(int maxConnections);
    public void setRetryPolicy(RetryPolicy retryPolicy);
    public void setProxyHost(String proxyHost);
    public void setProxyPort(int proxyPort);
}

// Main credential provider interface
public interface AWSCredentialsProvider {
    AWSCredentials getCredentials();
    void refresh();
}

// Default credential provider chain
public class DefaultAWSCredentialsProviderChain implements AWSCredentialsProvider {
    public DefaultAWSCredentialsProviderChain();
    public AWSCredentials getCredentials();
    public void refresh();
}

// Static credentials provider
public class AWSStaticCredentialsProvider implements AWSCredentialsProvider {
    public AWSStaticCredentialsProvider(AWSCredentials credentials);
    public AWSCredentials getCredentials();
    public void refresh();
}

public interface AmazonS3 {
    // Object operations
    PutObjectResult putObject(PutObjectRequest putObjectRequest);
    PutObjectResult putObject(String bucketName, String key, String content);
    PutObjectResult putObject(String bucketName, String key, File file);
    S3Object getObject(GetObjectRequest getObjectRequest);
    S3Object getObject(String bucketName, String key);
    void deleteObject(DeleteObjectRequest deleteObjectRequest);
    void deleteObject(String bucketName, String key);
    
    // Bucket operations
    Bucket createBucket(CreateBucketRequest createBucketRequest);
    Bucket createBucket(String bucketName);
    void deleteBucket(DeleteBucketRequest deleteBucketRequest);
    void deleteBucket(String bucketName);
    List<Bucket> listBuckets();
    
    // Listing operations
    ObjectListing listObjects(ListObjectsRequest listObjectsRequest);
    ObjectListing listObjects(String bucketName);
}

public interface AmazonEC2 {
    // Instance management
    RunInstancesResult runInstances(RunInstancesRequest runInstancesRequest);
    TerminateInstancesResult terminateInstances(TerminateInstancesRequest terminateInstancesRequest);
    DescribeInstancesResult describeInstances(DescribeInstancesRequest describeInstancesRequest);
    DescribeInstancesResult describeInstances();
    StartInstancesResult startInstances(StartInstancesRequest startInstancesRequest);
    StopInstancesResult stopInstances(StopInstancesRequest stopInstancesRequest);
    
    // Security groups
    CreateSecurityGroupResult createSecurityGroup(CreateSecurityGroupRequest createSecurityGroupRequest);
    DescribeSecurityGroupsResult describeSecurityGroups(DescribeSecurityGroupsRequest describeSecurityGroupsRequest);
    AuthorizeSecurityGroupIngressResult authorizeSecurityGroupIngress(AuthorizeSecurityGroupIngressRequest request);
}

public interface AmazonDynamoDB {
    // Item operations
    PutItemResult putItem(PutItemRequest putItemRequest);
    PutItemResult putItem(String tableName, Map<String, AttributeValue> item);
    GetItemResult getItem(GetItemRequest getItemRequest);
    GetItemResult getItem(String tableName, Map<String, AttributeValue> key);
    DeleteItemResult deleteItem(DeleteItemRequest deleteItemRequest);
    UpdateItemResult updateItem(UpdateItemRequest updateItemRequest);
    
    // Query and scan operations
    QueryResult query(QueryRequest queryRequest);
    ScanResult scan(ScanRequest scanRequest);
    ScanResult scan(String tableName, List<String> attributesToGet);
    
    // Table management
    CreateTableResult createTable(CreateTableRequest createTableRequest);
    DeleteTableResult deleteTable(DeleteTableRequest deleteTableRequest);
    DescribeTableResult describeTable(DescribeTableRequest describeTableRequest);
    DescribeTableResult describeTable(String tableName);
}

public interface AWSLambda {
    // Function management
    CreateFunctionResult createFunction(CreateFunctionRequest createFunctionRequest);
    GetFunctionResult getFunction(GetFunctionRequest getFunctionRequest);
    UpdateFunctionCodeResult updateFunctionCode(UpdateFunctionCodeRequest updateFunctionCodeRequest);
    DeleteFunctionResult deleteFunction(DeleteFunctionRequest deleteFunctionRequest);
    ListFunctionsResult listFunctions(ListFunctionsRequest listFunctionsRequest);
    
    // Function invocation
    InvokeResult invoke(InvokeRequest invokeRequest);
    
    // Event source mappings
    CreateEventSourceMappingResult createEventSourceMapping(CreateEventSourceMappingRequest request);
    ListEventSourceMappingsResult listEventSourceMappings(ListEventSourceMappingsRequest request);
}

public interface AmazonCloudWatch {
    // Metrics operations
    PutMetricDataResult putMetricData(PutMetricDataRequest putMetricDataRequest);
    GetMetricStatisticsResult getMetricStatistics(GetMetricStatisticsRequest getMetricStatisticsRequest);
    ListMetricsResult listMetrics(ListMetricsRequest listMetricsRequest);
    
    // Alarm management
    PutMetricAlarmResult putMetricAlarm(PutMetricAlarmRequest putMetricAlarmRequest);
    DeleteAlarmsResult deleteAlarms(DeleteAlarmsRequest deleteAlarmsRequest);
    DescribeAlarmsResult describeAlarms(DescribeAlarmsRequest describeAlarmsRequest);
    DescribeAlarmsResult describeAlarms();
}

public interface AmazonIdentityManagement {
    // User management
    CreateUserResult createUser(CreateUserRequest createUserRequest);
    GetUserResult getUser(GetUserRequest getUserRequest);
    ListUsersResult listUsers(ListUsersRequest listUsersRequest);
    DeleteUserResult deleteUser(DeleteUserRequest deleteUserRequest);
    
    // Role management
    CreateRoleResult createRole(CreateRoleRequest createRoleRequest);
    GetRoleResult getRole(GetRoleRequest getRoleRequest);
    ListRolesResult listRoles(ListRolesRequest listRolesRequest);
    
    // Policy management
    CreatePolicyResult createPolicy(CreatePolicyRequest createPolicyRequest);
    GetPolicyResult getPolicy(GetPolicyRequest getPolicyRequest);
    AttachUserPolicyResult attachUserPolicy(AttachUserPolicyRequest attachUserPolicyRequest);
}

// Base exception for all SDK exceptions
public class SdkBaseException extends RuntimeException {
    public SdkBaseException(String message);
    public SdkBaseException(String message, Throwable cause);
}

// Base client exception for AWS SDK operations
public class AmazonClientException extends SdkBaseException {
    public AmazonClientException(String message);
    public AmazonClientException(String message, Throwable cause);
}

// Client-side exceptions (local errors)
public class SdkClientException extends AmazonClientException {
    public SdkClientException(String message);
    public SdkClientException(String message, Throwable cause);
}

// Service-side exceptions (AWS errors)
public class AmazonServiceException extends AmazonClientException {
    public String getErrorCode();
    public String getRequestId();
    public int getStatusCode();
    public ErrorType getErrorType();
    public String getServiceName();
    
    public enum ErrorType {
        Client, Service, Unknown
    }
}

// Base request class
public abstract class AmazonWebServiceRequest {
    public void setRequestCredentials(AWSCredentials credentials);
    public AWSCredentials getRequestCredentials();
    public void setGeneralProgressListener(ProgressListener progressListener);
    public ProgressListener getGeneralProgressListener();
}

// Response metadata
public class ResponseMetadata {
    public String getRequestId();
    public Map<String, String> getMetadata();
}

// AWS credentials
public interface AWSCredentials {
    String getAWSAccessKeyId();
    String getAWSSecretKey();
}

// Region enumeration
public enum Regions {
    US_EAST_1("us-east-1"),
    US_WEST_1("us-west-1"),
    US_WEST_2("us-west-2"),
    EU_WEST_1("eu-west-1"),
    EU_CENTRAL_1("eu-central-1"),
    AP_SOUTHEAST_1("ap-southeast-1"),
    AP_NORTHEAST_1("ap-northeast-1");
    
    public String getName();
    public static Regions fromName(String regionName);
    public static Regions getCurrentRegion();
}