com.amazonaws.mobileconnectors.dynamodbv2.dynamodbmapper

Class S3ClientCache

java.lang.Object

com.amazonaws.mobileconnectors.dynamodbv2.dynamodbmapper.S3ClientCache

public class S3ClientCache
extends java.lang.Object

A smart Map for AmazonS3Client objects. S3ClientCache keeps the clients organized by region, and if provided AWSCredentials will create clients on the fly. Otherwise it just return clients given to it with useClient(AmazonS3Client).

Method Summary

Modifier and Type	Method and Description
AmazonS3Client	getClient(Region s3region) Returns a client for the requested region, or throws an exception when unable.
void	useClient(AmazonS3Client client) Force the client cache to provide a certain client for the region which that client is configured.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

useClient

public void useClient(AmazonS3Client client)

Force the client cache to provide a certain client for the region which that client is configured. This can be useful to provide clients with different S3ClientOptions.

Parameters:

client - An AmazonS3Client to use in the cache. Its region will be detected automatically.

getClient

public AmazonS3Client getClient(Region s3region)

Returns a client for the requested region, or throws an exception when unable.

Parameters:

s3region - The region the returned AmazonS3Client will be configured to use.

Returns:

A client for the given region from the cache, either instantiated automatically from the provided AWSCredentials or provided with useClient(AmazonS3Client).

Throws:

java.lang.IllegalArgumentException - When a region is requested that has not been provided to the cache with useClient(AmazonS3Client), and the cache has no AWSCredentials with which a client may be instantiated.