org.apache.hadoop.fs.s3a

Interface S3ClientFactory

All Known Implementing Classes:

DefaultS3ClientFactory

Deprecated.

This interface will be replaced by one which uses the AWS SDK V2 S3 client as part of upgrading S3A to SDK V2. See HADOOP-18073.

@InterfaceAudience.LimitedPrivate(value="HBoss")
 @InterfaceStability.Evolving
public interface S3ClientFactory

Factory for creation of S3Client client instances. Important: HBase's HBoss module implements this interface in its tests. Take care when updating this interface to ensure that a client implementing only the deprecated method will work. See https://github.com/apache/hbase-filesystem

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	S3ClientFactory.S3ClientCreationParameters Deprecated. Settings for the S3 Client.

Method Summary

Modifier and Type	Method and Description
software.amazon.awssdk.services.s3.S3AsyncClient	createS3AsyncClient(URI uri, S3ClientFactory.S3ClientCreationParameters parameters) Deprecated. Creates a new S3AsyncClient.
software.amazon.awssdk.services.s3.S3Client	createS3Client(URI uri, S3ClientFactory.S3ClientCreationParameters parameters) Deprecated. Creates a new S3Client.
software.amazon.awssdk.transfer.s3.S3TransferManager	createS3TransferManager(software.amazon.awssdk.services.s3.S3AsyncClient s3AsyncClient) Deprecated. Creates a new S3TransferManager.

Method Detail

createS3Client

software.amazon.awssdk.services.s3.S3Client createS3Client(URI uri,
                                                           S3ClientFactory.S3ClientCreationParameters parameters)
                                                    throws IOException

Deprecated.

Creates a new S3Client. The client returned supports synchronous operations. For asynchronous operations, use createS3AsyncClient(URI, S3ClientCreationParameters).

Parameters:

uri - S3A file system URI

parameters - parameter object

Returns:

S3 client

Throws:

IOException - on any IO problem

createS3AsyncClient

software.amazon.awssdk.services.s3.S3AsyncClient createS3AsyncClient(URI uri,
                                                                     S3ClientFactory.S3ClientCreationParameters parameters)
                                                              throws IOException

Deprecated.

Creates a new S3AsyncClient. The client returned supports asynchronous operations. For synchronous operations, use createS3Client(URI, S3ClientCreationParameters).

Parameters:

uri - S3A file system URI

parameters - parameter object

Returns:

Async S3 client

Throws:

IOException - on any IO problem

createS3TransferManager

software.amazon.awssdk.transfer.s3.S3TransferManager createS3TransferManager(software.amazon.awssdk.services.s3.S3AsyncClient s3AsyncClient)

Deprecated.

Creates a new S3TransferManager.

Parameters:

s3AsyncClient - the async client to be used by the TM.

Returns:

S3 transfer manager