Package org.apache.jackrabbit.oak.blob.cloud.s3

Class Utils

java.lang.Object

org.apache.jackrabbit.oak.blob.cloud.s3.Utils

public final class Utils
extends Object

Amazon S3 utilities.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	AWSDOTCOM	constants to define endpoint to various AWS region
static final String	DASH
static final String	DEFAULT_AWS_BUCKET_REGION	The default value AWS bucket region.
static final String	DEFAULT_CONFIG_FILE
static final String	DOT
static final String	S3
static final String	US_EAST_1_AWS_BUCKET_REGION	The value for the us-east-1 region.

Method Summary

Modifier and Type	Method	Description
static Map<String,Object>	asMap(Properties props)
static void	deleteBucket(String bucketName)	Delete S3 bucket.
static com.amazonaws.services.s3.AmazonS3Client	openService(Properties prop)	Create AmazonS3Client from properties.
static Properties	readConfig(String fileName)	Read a configuration properties file.
static boolean	waitForBucket(@NotNull com.amazonaws.services.s3.AmazonS3 s3Client, @NotNull String bucketName)	Waits for an S3 bucket, one we expect to exist, to report that it exists.

Methods inherited from class java.lang.Object

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

Field Details

DEFAULT_CONFIG_FILE

public static final String DEFAULT_CONFIG_FILE

See Also:

• Constant Field Values

DEFAULT_AWS_BUCKET_REGION

public static final String DEFAULT_AWS_BUCKET_REGION

The default value AWS bucket region.

See Also:

• Constant Field Values

US_EAST_1_AWS_BUCKET_REGION

public static final String US_EAST_1_AWS_BUCKET_REGION

The value for the us-east-1 region.

See Also:

• Constant Field Values

AWSDOTCOM

public static final String AWSDOTCOM

constants to define endpoint to various AWS region

See Also:

• Constant Field Values

S3

public static final String S3

See Also:

• Constant Field Values

DOT

public static final String DOT

See Also:

• Constant Field Values

DASH

public static final String DASH

See Also:

• Constant Field Values

Method Details

openService

public static com.amazonaws.services.s3.AmazonS3Client openService(Properties prop)

Create AmazonS3Client from properties.

Parameters:

prop - properties to configure @link AmazonS3Client

Returns:

AmazonS3Client

waitForBucket

public static boolean waitForBucket(@NotNull
 @NotNull com.amazonaws.services.s3.AmazonS3 s3Client,
 @NotNull
 @NotNull String bucketName)

Waits for an S3 bucket, one we expect to exist, to report that it exists. A check for the bucket is called with a limited number of repeats with an increasing backoff. Usually you would call this after creating a bucket to block until the bucket is actually available before moving forward with other tasks that expect the bucket to be available.

Parameters:

s3Client - The AmazonS3 client connection to the storage service.

bucketName - The name of the bucket to check.

Returns:

True if the bucket exists; false otherwise.

deleteBucket

public static void deleteBucket(String bucketName)
                         throws IOException

Delete S3 bucket. This method first deletes all objects from bucket and then delete empty bucket.

Parameters:

bucketName - the bucket name.

Throws:

IOException

readConfig

public static Properties readConfig(String fileName)
                             throws IOException

Read a configuration properties file. If the file name ends with ";burn", the file is deleted after reading.

Parameters:

fileName - the properties file name

Returns:

the properties

Throws:

IOException - if the file doesn't exist

asMap

public static Map<String,Object> asMap(Properties props)