com.github.abhinavmishra14.aws.s3.service.impl

Class AwsS3IamServiceImpl

java.lang.Object

com.github.abhinavmishra14.aws.s3.service.impl.AwsS3IamServiceImpl

All Implemented Interfaces:

AwsS3IamService

public class AwsS3IamServiceImpl
extends Object
implements AwsS3IamService

The Class AwsS3IamServiceImpl.

Author:

Abhinav kumar mishra

Constructor Summary

Constructors

Constructor and Description
AwsS3IamServiceImpl() Instantiates a new aws s3 iam service impl.
AwsS3IamServiceImpl(String accessKey, String secretKey) Instantiates a new aws s3 iam service impl. Use this constructor if you have keys and dont want to use IAM roles.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	checkBucketPermission(String bucketName, com.amazonaws.services.s3.model.Permission permission) Check bucket permission. If access to the given bucket is not valid then 'AccessDenied' error will be raised. Read ACP permission should be available to user who is trying to check permission on bucket.
boolean	checkObjectPermission(String bucketName, String key, com.amazonaws.services.s3.model.Permission permission) Check object permission. If object is not available in given bucket, an exception will be thrown
void	cleanAndDeleteBucket(String bucketName) Clean and delete bucket.
com.amazonaws.services.s3.model.Bucket	createBucket(String bucketName) Creates the bucket. A bucket is owned by the AWS account that created it.
com.amazonaws.services.s3.model.Bucket	createBucket(String bucketName, boolean isPublicAccessible) Creates the bucket. Permission set for a Bucket does NOT automatically propagate to files stored in that Bucket. A bucket is owned by the AWS account that created it.
com.amazonaws.services.s3.model.Bucket	createBucket(String bucketName, com.amazonaws.services.s3.model.CannedAccessControlList cannedAcl) Creates the bucket. A bucket is owned by the AWS account that created it.
com.amazonaws.services.s3.model.PutObjectResult	createDirectory(String bucketName, String dirName) Creates the directory.
com.amazonaws.services.s3.model.PutObjectResult	createDirectory(String bucketName, String dirName, boolean isPublicAccessible) Creates the directory. You can pass true/false flag to allow directories created in S3 to be publicly accessible.
com.amazonaws.services.s3.model.PutObjectResult	createDirectory(String bucketName, String dirName, com.amazonaws.services.s3.model.CannedAccessControlList cannedAcl) Creates the directory.
void	deleteBucket(String bucketName) Delete bucket.
void	deleteDirectory(String bucketName, String dirName) Delete directory.
void	deleteObject(String bucketName, String fileName) Delete object.
com.amazonaws.services.s3.model.DeleteObjectsResult	deleteObjects(String bucketName, List<com.amazonaws.services.s3.model.DeleteObjectsRequest.KeyVersion> keys) Delete objects.
com.amazonaws.services.s3.model.ObjectMetadata	downloadObject(String bucketName, String key, String filePath) Download object.
URL	generateObjectURL(String bucketName, String fileName) Generate object url.
String	generateObjectUrlAsString(String bucketName, String fileName) Generate object url as string.
List<com.amazonaws.services.s3.model.Bucket>	getAllBuckets() Gets the all buckets.
com.amazonaws.services.s3.model.AccessControlList	getBucketAccessControlList(String bucketName) Gets the bucket access control list. Provides opportunities to grant permissions and check permissions on bucket. If access to the given bucket is not valid then 'AccessDenied' error will be raised. Read ACP permission should be available to user who is trying to check permission on bucket.
List<com.amazonaws.services.s3.model.Grant>	getBucketPermissions(String bucketName) Gets the bucket permissions. Returns the list of Grant objects in this access control list (ACL). The Grant object has Permission object which tell what kind of permissions are available. and it has Grantee object which tell who are grantees. Following are permissions available: FullControl, Read, Write, ReadAcp, WriteAcp If access to the given bucket is not valid then 'AccessDenied' error will be raised.
com.amazonaws.services.s3.model.S3Object	getObject(com.amazonaws.services.s3.model.GetObjectRequest getObjRequest) Gets the object.
InputStream	getObject(String bucketName, String key) Gets the object.
boolean	hasFullControlPermission(String bucketName) Checks if the bucket has full control permission If access to the given bucket is not valid then 'AccessDenied' error will be raised. Read ACP permission should be available to user who is trying to check permission on bucket.
boolean	hasWritePermissionOnBucket(String bucketName) Checks for write permission on s3 bucket. It checks if user has write permissions on bucket or not, even if ReadACP is not granted.
boolean	isBucketExists(String bucketName) Checks if is bucket exists.
com.amazonaws.services.s3.transfer.Transfer	uploadDirectoryOrFile(String bucketName, File source, String virtualDirectoryKeyPrefix) Upload directory or file. S3 will overwrite any existing objects that happen to have the same key, just as when uploading individual files, so use with caution. This method will upload the files or directory to S3 asynchronously You can use Transfer returning object to check for progress, Usage: transfer.getProgress().getPercentTransferred() It is implemented via TransferManager TransferManager provides a simple API for uploading content to Amazon S3, and makes extensive use of Amazon S3 multipart uploads to achieve enhanced throughput, performance and reliability.
boolean	uploadDirectoryOrFileAndListenProgress(String bucketName, File source, String virtualDirectoryKeyPrefix) Upload directory or file and Listen Progress. S3 will overwrite any existing objects that happen to have the same key, just as when uploading individual files, so use with caution. This method will upload the files or directory to S3 and prints the progress. It is implemented via TransferManager TransferManager provides a simple API for uploading content to Amazon S3, and makes extensive use of Amazon S3 multipart uploads to achieve enhanced throughput, performance and reliability.
com.amazonaws.services.s3.transfer.Upload	uploadFileAsync(String bucketName, String fileName, File fileObj) Upload file async. S3 will overwrite any existing objects that happen to have the same key, just as when uploading individual files, so use with caution. This method will upload the file to S3 asynchronously You can use Upload returning object to check for progress Usage: upload.getProgress().getPercentTransferred() It is implemented via TransferManager TransferManager provides a simple API for uploading content to Amazon S3, and makes extensive use of Amazon S3 multipart uploads to achieve enhanced throughput, performance and reliability.
com.amazonaws.services.s3.transfer.Upload	uploadFileAsync(String bucketName, String fileName, File fileObj, boolean isPublicAccessible) Upload file async. S3 will overwrite any existing objects that happen to have the same key, just as when uploading individual files, so use with caution. This method will upload the file to S3 asynchronously You can use Upload returning object to check for progress Usage: upload.getProgress().getPercentTransferred() It is implemented via TransferManager TransferManager provides a simple API for uploading content to Amazon S3, and makes extensive use of Amazon S3 multipart uploads to achieve enhanced throughput, performance and reliability.
com.amazonaws.services.s3.transfer.Upload	uploadFileAsync(String bucketName, String fileName, File fileObj, com.amazonaws.services.s3.model.CannedAccessControlList cannedAcl) Upload file async. S3 will overwrite any existing objects that happen to have the same key, just as when uploading individual files, so use with caution. This method will upload the file to S3 asynchronously You can use Upload returning object to check for progress Usage: upload.getProgress().getPercentTransferred() It is implemented via TransferManager TransferManager provides a simple API for uploading content to Amazon S3, and makes extensive use of Amazon S3 multipart uploads to achieve enhanced throughput, performance and reliability.
com.amazonaws.services.s3.model.PutObjectResult	uploadObject(com.amazonaws.services.s3.model.PutObjectRequest putObjectRequest) Upload object.
com.amazonaws.services.s3.model.PutObjectResult	uploadObject(String bucketName, String fileName, InputStream inputStream) Upload object.
com.amazonaws.services.s3.model.PutObjectResult	uploadObject(String bucketName, String fileName, InputStream inputStream, boolean isPublicAccessible) Upload object. You can pass true/false flag to allow objects pushed to S3 to be publicly accessible.
com.amazonaws.services.s3.model.PutObjectResult	uploadObject(String bucketName, String fileName, InputStream inputStream, com.amazonaws.services.s3.model.CannedAccessControlList cannedAcl) Upload object.
boolean	uploadObjectAndListenProgress(String bucketName, String fileName, InputStream inputStream) Upload object and Listen progress. S3 will overwrite any existing objects that happen to have the same key, just as when uploading individual files, so use with caution. This method will upload the file to S3 and prints the progress. It is implemented via TransferManager TransferManager provides a simple API for uploading content to Amazon S3, and makes extensive use of Amazon S3 multipart uploads to achieve enhanced throughput, performance and reliability.
boolean	uploadObjectAndListenProgress(String bucketName, String fileName, InputStream inputStream, boolean isPublicAccessible) Upload object and Listen progress. S3 will overwrite any existing objects that happen to have the same key, just as when uploading individual files, so use with caution. This method will upload the file to S3 and prints the progress. It is implemented via TransferManager TransferManager provides a simple API for uploading content to Amazon S3, and makes extensive use of Amazon S3 multipart uploads to achieve enhanced throughput, performance and reliability.
boolean	uploadObjectAndListenProgress(String bucketName, String fileName, InputStream inputStream, com.amazonaws.services.s3.model.CannedAccessControlList cannedAcl) Upload object and Listen progress. S3 will overwrite any existing objects that happen to have the same key, just as when uploading individual files, so use with caution. This method will upload the file to S3 and prints the progress. It is implemented via TransferManager TransferManager provides a simple API for uploading content to Amazon S3, and makes extensive use of Amazon S3 multipart uploads to achieve enhanced throughput, performance and reliability.

Methods inherited from class java.lang.Object

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

Constructor Detail

AwsS3IamServiceImpl

public AwsS3IamServiceImpl(String accessKey,
                   String secretKey)

Instantiates a new aws s3 iam service impl.
Use this constructor if you have keys and dont want to use IAM roles. This Service can be used when you want to communicate with Amazon S3 bucket independenly.
UseCase: Assuming you are working on a developer machine and want to upload contents on S3 bucket.
This service is implementation of core amazon sdk.

Parameters:

accessKey - the access key

secretKey - the secret key

AwsS3IamServiceImpl

public AwsS3IamServiceImpl()

Instantiates a new aws s3 iam service impl.

Method Detail

getAllBuckets

public List<com.amazonaws.services.s3.model.Bucket> getAllBuckets()
                                                           throws com.amazonaws.AmazonClientException,
                                                                  com.amazonaws.AmazonServiceException

Description copied from interface: AwsS3IamService

Gets the all buckets.

Specified by:

getAllBuckets in interface AwsS3IamService

Returns:

the all buckets

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

createBucket

public com.amazonaws.services.s3.model.Bucket createBucket(String bucketName)
                                                    throws com.amazonaws.AmazonClientException,
                                                           com.amazonaws.AmazonServiceException

Description copied from interface: AwsS3IamService

Creates the bucket.
A bucket is owned by the AWS account that created it. By default, you can create up to 100 buckets in each of your AWS accounts. If you need additional buckets, you can increase your bucket limit by submitting a service limit increase.

Specified by:

createBucket in interface AwsS3IamService

Parameters:

bucketName - the bucket name

Returns:

the bucket

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

createBucket

public com.amazonaws.services.s3.model.Bucket createBucket(String bucketName,
                                                  com.amazonaws.services.s3.model.CannedAccessControlList cannedAcl)
                                                    throws com.amazonaws.AmazonClientException,
                                                           com.amazonaws.AmazonServiceException

Description copied from interface: AwsS3IamService

Creates the bucket.
A bucket is owned by the AWS account that created it. By default, you can create up to 100 buckets in each of your AWS accounts. If you need additional buckets, you can increase your bucket limit by submitting a service limit increase.

Specified by:

createBucket in interface AwsS3IamService

Parameters:

bucketName - the bucket name

cannedAcl - the canned acl

Returns:

the bucket

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

See Also:

ACL Overview, Canned ACL

createBucket

public com.amazonaws.services.s3.model.Bucket createBucket(String bucketName,
                                                  boolean isPublicAccessible)
                                                    throws com.amazonaws.AmazonClientException,
                                                           com.amazonaws.AmazonServiceException

Description copied from interface: AwsS3IamService

Creates the bucket.
Permission set for a Bucket does NOT automatically propagate to files stored in that Bucket.
A bucket is owned by the AWS account that created it. By default, you can create up to 100 buckets in each of your AWS accounts. If you need additional buckets, you can increase your bucket limit by submitting a service limit increase.

Specified by:

createBucket in interface AwsS3IamService

Parameters:

bucketName - the bucket name

isPublicAccessible - the is public accessible

Returns:

the bucket

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

deleteBucket

public void deleteBucket(String bucketName)
                  throws com.amazonaws.AmazonClientException,
                         com.amazonaws.AmazonServiceException

Description copied from interface: AwsS3IamService

Delete bucket.

Specified by:

deleteBucket in interface AwsS3IamService

Parameters:

bucketName - the bucket name

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

uploadObject

public com.amazonaws.services.s3.model.PutObjectResult uploadObject(com.amazonaws.services.s3.model.PutObjectRequest putObjectRequest)
                                                             throws com.amazonaws.AmazonClientException,
                                                                    com.amazonaws.AmazonServiceException

Description copied from interface: AwsS3IamService

Upload object.

Specified by:

uploadObject in interface AwsS3IamService

Parameters:

putObjectRequest - the put object request

Returns:

the put object result

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

uploadObject

public com.amazonaws.services.s3.model.PutObjectResult uploadObject(String bucketName,
                                                           String fileName,
                                                           InputStream inputStream)
                                                             throws com.amazonaws.AmazonClientException,
                                                                    com.amazonaws.AmazonServiceException,
                                                                    IOException

Description copied from interface: AwsS3IamService

Upload object.

Specified by:

uploadObject in interface AwsS3IamService

Parameters:

bucketName - the bucket name

fileName - the file name

inputStream - the input stream

Returns:

the put object result

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

IOException - Signals that an I/O exception has occurred.

uploadObject

public com.amazonaws.services.s3.model.PutObjectResult uploadObject(String bucketName,
                                                           String fileName,
                                                           InputStream inputStream,
                                                           com.amazonaws.services.s3.model.CannedAccessControlList cannedAcl)
                                                             throws com.amazonaws.AmazonClientException,
                                                                    com.amazonaws.AmazonServiceException,
                                                                    IOException

Description copied from interface: AwsS3IamService

Upload object.

Specified by:

uploadObject in interface AwsS3IamService

Parameters:

bucketName - the bucket name

fileName - the file name

inputStream - the input stream

cannedAcl - the canned acl

Returns:

the put object result

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

IOException - Signals that an I/O exception has occurred.

See Also:

ACL Overview, Canned ACL

uploadObject

public com.amazonaws.services.s3.model.PutObjectResult uploadObject(String bucketName,
                                                           String fileName,
                                                           InputStream inputStream,
                                                           boolean isPublicAccessible)
                                                             throws com.amazonaws.AmazonClientException,
                                                                    com.amazonaws.AmazonServiceException,
                                                                    IOException

Description copied from interface: AwsS3IamService

Upload object.
You can pass true/false flag to allow objects pushed to S3 to be publicly accessible.

Specified by:

uploadObject in interface AwsS3IamService

Parameters:

bucketName - the bucket name

fileName - the file name

inputStream - the input stream

isPublicAccessible - the is public accessible

Returns:

the put object result

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

IOException - Signals that an I/O exception has occurred.

uploadObjectAndListenProgress

public boolean uploadObjectAndListenProgress(String bucketName,
                                    String fileName,
                                    InputStream inputStream)
                                      throws com.amazonaws.AmazonClientException,
                                             com.amazonaws.AmazonServiceException,
                                             IOException

Description copied from interface: AwsS3IamService

Upload object and Listen progress.
S3 will overwrite any existing objects that happen to have the same key, just as when uploading individual files, so use with caution.
This method will upload the file to S3 and prints the progress.
It is implemented via TransferManager
TransferManager provides a simple API for uploading content to Amazon S3, and makes extensive use of Amazon S3 multipart uploads to achieve enhanced throughput, performance and reliability.
When possible, TransferManager attempts to use multiple threads to upload multiple parts of a single upload at once.
When dealing with large content sizes and high bandwidth, this can have a significant increase on throughput.

Specified by:

uploadObjectAndListenProgress in interface AwsS3IamService

Parameters:

bucketName - the bucket name

fileName - the file name

inputStream - the input stream

Returns:

the boolean

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

IOException - Signals that an I/O exception has occurred.

uploadObjectAndListenProgress

public boolean uploadObjectAndListenProgress(String bucketName,
                                    String fileName,
                                    InputStream inputStream,
                                    com.amazonaws.services.s3.model.CannedAccessControlList cannedAcl)
                                      throws com.amazonaws.AmazonClientException,
                                             com.amazonaws.AmazonServiceException,
                                             IOException

Description copied from interface: AwsS3IamService

Upload object and Listen progress.
S3 will overwrite any existing objects that happen to have the same key, just as when uploading individual files, so use with caution.
This method will upload the file to S3 and prints the progress.
It is implemented via TransferManager
TransferManager provides a simple API for uploading content to Amazon S3, and makes extensive use of Amazon S3 multipart uploads to achieve enhanced throughput, performance and reliability.
When possible, TransferManager attempts to use multiple threads to upload multiple parts of a single upload at once.
When dealing with large content sizes and high bandwidth, this can have a significant increase on throughput.

Specified by:

uploadObjectAndListenProgress in interface AwsS3IamService

Parameters:

bucketName - the bucket name

fileName - the file name

inputStream - the input stream

cannedAcl - the canned acl

Returns:

the boolean

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

IOException - Signals that an I/O exception has occurred.

See Also:

ACL Overview, Canned ACL

uploadObjectAndListenProgress

public boolean uploadObjectAndListenProgress(String bucketName,
                                    String fileName,
                                    InputStream inputStream,
                                    boolean isPublicAccessible)
                                      throws com.amazonaws.AmazonClientException,
                                             com.amazonaws.AmazonServiceException,
                                             IOException

Description copied from interface: AwsS3IamService

Upload object and Listen progress.
S3 will overwrite any existing objects that happen to have the same key, just as when uploading individual files, so use with caution.
This method will upload the file to S3 and prints the progress.
It is implemented via TransferManager
TransferManager provides a simple API for uploading content to Amazon S3, and makes extensive use of Amazon S3 multipart uploads to achieve enhanced throughput, performance and reliability.
When possible, TransferManager attempts to use multiple threads to upload multiple parts of a single upload at once.
When dealing with large content sizes and high bandwidth, this can have a significant increase on throughput.
You can pass true/false flag to allow objects pushed to S3 to be publicly accessible.

Specified by:

uploadObjectAndListenProgress in interface AwsS3IamService

Parameters:

bucketName - the bucket name

fileName - the file name

inputStream - the input stream

isPublicAccessible - the is public accessible

Returns:

the boolean

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

IOException - Signals that an I/O exception has occurred.

uploadFileAsync

public com.amazonaws.services.s3.transfer.Upload uploadFileAsync(String bucketName,
                                                        String fileName,
                                                        File fileObj)
                                                          throws com.amazonaws.AmazonClientException,
                                                                 com.amazonaws.AmazonServiceException,
                                                                 IOException

Description copied from interface: AwsS3IamService

Upload file async.
S3 will overwrite any existing objects that happen to have the same key, just as when uploading individual files, so use with caution.
This method will upload the file to S3 asynchronously
You can use Upload returning object to check for progress Usage: upload.getProgress().getPercentTransferred()
It is implemented via TransferManager
TransferManager provides a simple API for uploading content to Amazon S3, and makes extensive use of Amazon S3 multipart uploads to achieve enhanced throughput, performance and reliability.
When possible, TransferManager attempts to use multiple threads to upload multiple parts of a single upload at once.
When dealing with large content sizes and high bandwidth, this can have a significant increase on throughput.

Specified by:

uploadFileAsync in interface AwsS3IamService

Parameters:

bucketName - the bucket name

fileName - the file name

fileObj - the file object

Returns:

the upload

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

IOException - Signals that an I/O exception has occurred.

uploadFileAsync

public com.amazonaws.services.s3.transfer.Upload uploadFileAsync(String bucketName,
                                                        String fileName,
                                                        File fileObj,
                                                        com.amazonaws.services.s3.model.CannedAccessControlList cannedAcl)
                                                          throws com.amazonaws.AmazonClientException,
                                                                 com.amazonaws.AmazonServiceException,
                                                                 IOException

Description copied from interface: AwsS3IamService

Upload file async.
S3 will overwrite any existing objects that happen to have the same key, just as when uploading individual files, so use with caution.
This method will upload the file to S3 asynchronously
You can use Upload returning object to check for progress Usage: upload.getProgress().getPercentTransferred()
It is implemented via TransferManager
TransferManager provides a simple API for uploading content to Amazon S3, and makes extensive use of Amazon S3 multipart uploads to achieve enhanced throughput, performance and reliability.
When possible, TransferManager attempts to use multiple threads to upload multiple parts of a single upload at once.
When dealing with large content sizes and high bandwidth, this can have a significant increase on throughput.

Specified by:

uploadFileAsync in interface AwsS3IamService

Parameters:

bucketName - the bucket name

fileName - the file name

fileObj - the file object

cannedAcl - the canned acl

Returns:

the upload

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

IOException - Signals that an I/O exception has occurred.

See Also:

ACL Overview, Canned ACL

uploadFileAsync

public com.amazonaws.services.s3.transfer.Upload uploadFileAsync(String bucketName,
                                                        String fileName,
                                                        File fileObj,
                                                        boolean isPublicAccessible)
                                                          throws com.amazonaws.AmazonClientException,
                                                                 com.amazonaws.AmazonServiceException,
                                                                 IOException

Description copied from interface: AwsS3IamService

Upload file async.
S3 will overwrite any existing objects that happen to have the same key, just as when uploading individual files, so use with caution.
This method will upload the file to S3 asynchronously
You can use Upload returning object to check for progress Usage: upload.getProgress().getPercentTransferred()
It is implemented via TransferManager
TransferManager provides a simple API for uploading content to Amazon S3, and makes extensive use of Amazon S3 multipart uploads to achieve enhanced throughput, performance and reliability.
When possible, TransferManager attempts to use multiple threads to upload multiple parts of a single upload at once.
When dealing with large content sizes and high bandwidth, this can have a significant increase on throughput.
You can pass true/false flag to allow objects pushed to S3 to be publicly accessible.

Specified by:

uploadFileAsync in interface AwsS3IamService

Parameters:

bucketName - the bucket name

fileName - the file name

fileObj - the file object

isPublicAccessible - the is public accessible

Returns:

the upload

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

IOException - Signals that an I/O exception has occurred.

uploadDirectoryOrFileAndListenProgress

public boolean uploadDirectoryOrFileAndListenProgress(String bucketName,
                                             File source,
                                             String virtualDirectoryKeyPrefix)
                                               throws com.amazonaws.AmazonClientException,
                                                      com.amazonaws.AmazonServiceException,
                                                      FileNotFoundException

Description copied from interface: AwsS3IamService

Upload directory or file and Listen Progress.
S3 will overwrite any existing objects that happen to have the same key, just as when uploading individual files, so use with caution.
This method will upload the files or directory to S3 and prints the progress.
It is implemented via TransferManager
TransferManager provides a simple API for uploading content to Amazon S3, and makes extensive use of Amazon S3 multipart uploads to achieve enhanced throughput, performance and reliability.
When possible, TransferManager attempts to use multiple threads to upload multiple parts of a single upload at once.
When dealing with large content sizes and high bandwidth, this can have a significant increase on throughput.

Specified by:

uploadDirectoryOrFileAndListenProgress in interface AwsS3IamService

Parameters:

bucketName - the bucket name

source - the source fir or directory

virtualDirectoryKeyPrefix - the key prefix of the virtual directory to upload to. Use the null or empty string to upload files to the root of the bucket.

Returns:

the true or false

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

FileNotFoundException - the file not found exception

uploadDirectoryOrFile

public com.amazonaws.services.s3.transfer.Transfer uploadDirectoryOrFile(String bucketName,
                                                                File source,
                                                                String virtualDirectoryKeyPrefix)
                                                                  throws com.amazonaws.AmazonClientException,
                                                                         com.amazonaws.AmazonServiceException,
                                                                         IOException

Description copied from interface: AwsS3IamService

Upload directory or file.
S3 will overwrite any existing objects that happen to have the same key, just as when uploading individual files, so use with caution.
This method will upload the files or directory to S3 asynchronously
You can use Transfer returning object to check for progress, Usage: transfer.getProgress().getPercentTransferred()
It is implemented via TransferManager
TransferManager provides a simple API for uploading content to Amazon S3, and makes extensive use of Amazon S3 multipart uploads to achieve enhanced throughput, performance and reliability.
When possible, TransferManager attempts to use multiple threads to upload multiple parts of a single upload at once.
When dealing with large content sizes and high bandwidth, this can have a significant increase on throughput.

Specified by:

uploadDirectoryOrFile in interface AwsS3IamService

Parameters:

bucketName - the bucket name

source - the source fir or directory

virtualDirectoryKeyPrefix - the key prefix of the virtual directory to upload to. Use the null or empty string to upload files to the root of the bucket.

Returns:

the transfer

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

IOException - Signals that an I/O exception has occurred.

getObject

public com.amazonaws.services.s3.model.S3Object getObject(com.amazonaws.services.s3.model.GetObjectRequest getObjRequest)
                                                   throws com.amazonaws.AmazonClientException,
                                                          com.amazonaws.AmazonServiceException

Description copied from interface: AwsS3IamService

Gets the object.

Specified by:

getObject in interface AwsS3IamService

Parameters:

getObjRequest - the get obj request

Returns:

the object

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

getObject

public InputStream getObject(String bucketName,
                    String key)
                      throws com.amazonaws.AmazonClientException,
                             com.amazonaws.AmazonServiceException

Description copied from interface: AwsS3IamService

Gets the object.

Specified by:

getObject in interface AwsS3IamService

Parameters:

bucketName - the bucket name

key - the key

Returns:

the object

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

downloadObject

public com.amazonaws.services.s3.model.ObjectMetadata downloadObject(String bucketName,
                                                            String key,
                                                            String filePath)
                                                              throws com.amazonaws.AmazonClientException,
                                                                     com.amazonaws.AmazonServiceException

Description copied from interface: AwsS3IamService

Download object.

Specified by:

downloadObject in interface AwsS3IamService

Parameters:

bucketName - the bucket name

key - the key

filePath - the file path

Returns:

the object metadata

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

createDirectory

public com.amazonaws.services.s3.model.PutObjectResult createDirectory(String bucketName,
                                                              String dirName)
                                                                throws com.amazonaws.AmazonClientException,
                                                                       com.amazonaws.AmazonServiceException

Description copied from interface: AwsS3IamService

Creates the directory.

Specified by:

createDirectory in interface AwsS3IamService

Parameters:

bucketName - the bucket name

dirName - the dir name

Returns:

the put object result

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

createDirectory

public com.amazonaws.services.s3.model.PutObjectResult createDirectory(String bucketName,
                                                              String dirName,
                                                              com.amazonaws.services.s3.model.CannedAccessControlList cannedAcl)
                                                                throws com.amazonaws.AmazonClientException,
                                                                       com.amazonaws.AmazonServiceException

Description copied from interface: AwsS3IamService

Creates the directory.

Specified by:

createDirectory in interface AwsS3IamService

Parameters:

bucketName - the bucket name

dirName - the dir name

cannedAcl - the canned acl

Returns:

the put object result

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

See Also:

ACL Overview, Canned ACL

createDirectory

public com.amazonaws.services.s3.model.PutObjectResult createDirectory(String bucketName,
                                                              String dirName,
                                                              boolean isPublicAccessible)
                                                                throws com.amazonaws.AmazonClientException,
                                                                       com.amazonaws.AmazonServiceException

Description copied from interface: AwsS3IamService

Creates the directory.
You can pass true/false flag to allow directories created in S3 to be publicly accessible.

Specified by:

createDirectory in interface AwsS3IamService

Parameters:

bucketName - the bucket name

dirName - the dir name

isPublicAccessible - the is public accessible

Returns:

the put object result

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

deleteObject

public void deleteObject(String bucketName,
                String fileName)
                  throws com.amazonaws.AmazonClientException,
                         com.amazonaws.AmazonServiceException

Description copied from interface: AwsS3IamService

Delete object.

Specified by:

deleteObject in interface AwsS3IamService

Parameters:

bucketName - the bucket name

fileName - the file name

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

deleteObjects

public com.amazonaws.services.s3.model.DeleteObjectsResult deleteObjects(String bucketName,
                                                                List<com.amazonaws.services.s3.model.DeleteObjectsRequest.KeyVersion> keys)
                                                                  throws com.amazonaws.AmazonClientException,
                                                                         com.amazonaws.AmazonServiceException

Description copied from interface: AwsS3IamService

Delete objects.

Specified by:

deleteObjects in interface AwsS3IamService

Parameters:

bucketName - the bucket name

keys - the keys

Returns:

the delete objects result

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

deleteDirectory

public void deleteDirectory(String bucketName,
                   String dirName)
                     throws com.amazonaws.AmazonClientException,
                            com.amazonaws.AmazonServiceException

Description copied from interface: AwsS3IamService

Delete directory.

Specified by:

deleteDirectory in interface AwsS3IamService

Parameters:

bucketName - the bucket name

dirName - the dir name

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

cleanAndDeleteBucket

public void cleanAndDeleteBucket(String bucketName)
                          throws com.amazonaws.AmazonClientException,
                                 com.amazonaws.AmazonServiceException

Description copied from interface: AwsS3IamService

Clean and delete bucket.

Specified by:

cleanAndDeleteBucket in interface AwsS3IamService

Parameters:

bucketName - the bucket name

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

isBucketExists

public boolean isBucketExists(String bucketName)
                       throws com.amazonaws.AmazonClientException,
                              com.amazonaws.AmazonServiceException

Description copied from interface: AwsS3IamService

Checks if is bucket exists.

Specified by:

isBucketExists in interface AwsS3IamService

Parameters:

bucketName - the bucket name

Returns:

true, if is bucket exists

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

generateObjectUrlAsString

public String generateObjectUrlAsString(String bucketName,
                               String fileName)
                                 throws com.amazonaws.AmazonClientException,
                                        com.amazonaws.AmazonServiceException

Description copied from interface: AwsS3IamService

Generate object url as string.

Specified by:

generateObjectUrlAsString in interface AwsS3IamService

Parameters:

bucketName - the bucket name

fileName - the file name

Returns:

the string

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

generateObjectURL

public URL generateObjectURL(String bucketName,
                    String fileName)
                      throws com.amazonaws.AmazonClientException,
                             com.amazonaws.AmazonServiceException

Description copied from interface: AwsS3IamService

Generate object url.

Specified by:

generateObjectURL in interface AwsS3IamService

Parameters:

bucketName - the bucket name

fileName - the file name

Returns:

the url

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

getBucketPermissions

public List<com.amazonaws.services.s3.model.Grant> getBucketPermissions(String bucketName)
                                                                 throws com.amazonaws.AmazonClientException,
                                                                        com.amazonaws.AmazonServiceException,
                                                                        com.amazonaws.services.s3.model.AmazonS3Exception

Description copied from interface: AwsS3IamService

Gets the bucket permissions.
Returns the list of Grant objects in this access control list (ACL).
The Grant object has Permission object which tell what kind of permissions are available.
and it has Grantee object which tell who are grantees.
Following are permissions available: FullControl, Read, Write, ReadAcp, WriteAcp
If access to the given bucket is not valid then 'AccessDenied' error will be raised.

Specified by:

getBucketPermissions in interface AwsS3IamService

Parameters:

bucketName - the bucket name

Returns:

the bucket permissions

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

com.amazonaws.services.s3.model.AmazonS3Exception - the amazon s3 exception

See Also:

Grant, Permission, Grantee, Permissions

getBucketAccessControlList

public com.amazonaws.services.s3.model.AccessControlList getBucketAccessControlList(String bucketName)
                                                                             throws com.amazonaws.AmazonClientException,
                                                                                    com.amazonaws.AmazonServiceException,
                                                                                    com.amazonaws.services.s3.model.AmazonS3Exception

Description copied from interface: AwsS3IamService

Gets the bucket access control list.
Provides opportunities to grant permissions and check permissions on bucket.
If access to the given bucket is not valid then 'AccessDenied' error will be raised.
Read ACP permission should be available to user who is trying to check permission on bucket.

Specified by:

getBucketAccessControlList in interface AwsS3IamService

Parameters:

bucketName - the bucket name

Returns:

the bucket access control list

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

com.amazonaws.services.s3.model.AmazonS3Exception - the amazon s3 exception

See Also:

AccessControlList, Permissions

hasFullControlPermission

public boolean hasFullControlPermission(String bucketName)
                                 throws com.amazonaws.AmazonClientException,
                                        com.amazonaws.AmazonServiceException,
                                        com.amazonaws.services.s3.model.AmazonS3Exception

Description copied from interface: AwsS3IamService

Checks if the bucket has full control permission
If access to the given bucket is not valid then 'AccessDenied' error will be raised.
Read ACP permission should be available to user who is trying to check permission on bucket.

Specified by:

hasFullControlPermission in interface AwsS3IamService

Parameters:

bucketName - the bucket name

Returns:

true, if successful

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

com.amazonaws.services.s3.model.AmazonS3Exception - the amazon s3 exception

See Also:

Permissions

checkBucketPermission

public boolean checkBucketPermission(String bucketName,
                            com.amazonaws.services.s3.model.Permission permission)
                              throws com.amazonaws.AmazonClientException,
                                     com.amazonaws.AmazonServiceException,
                                     com.amazonaws.services.s3.model.AmazonS3Exception

Description copied from interface: AwsS3IamService

Check bucket permission.
If access to the given bucket is not valid then 'AccessDenied' error will be raised.
Read ACP permission should be available to user who is trying to check permission on bucket.

Specified by:

checkBucketPermission in interface AwsS3IamService

Parameters:

bucketName - the bucket name

permission - the permission

Returns:

true, if successful

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

com.amazonaws.services.s3.model.AmazonS3Exception - the amazon s3 exception

See Also:

Permissions

hasWritePermissionOnBucket

public boolean hasWritePermissionOnBucket(String bucketName)

Description copied from interface: AwsS3IamService

Checks for write permission on s3 bucket.
It checks if user has write permissions on bucket or not, even if ReadACP is not granted.

Specified by:

hasWritePermissionOnBucket in interface AwsS3IamService

Parameters:

bucketName - the bucket name

Returns:

true, if successful

checkObjectPermission

public boolean checkObjectPermission(String bucketName,
                            String key,
                            com.amazonaws.services.s3.model.Permission permission)
                              throws com.amazonaws.AmazonClientException,
                                     com.amazonaws.AmazonServiceException,
                                     com.amazonaws.services.s3.model.AmazonS3Exception

Description copied from interface: AwsS3IamService

Check object permission.
If object is not available in given bucket, an exception will be thrown

Specified by:

checkObjectPermission in interface AwsS3IamService

Parameters:

bucketName - the bucket name

key - the full path of object in given bucket

permission - the permission

Returns:

true, if successful

Throws:

com.amazonaws.AmazonClientException - the amazon client exception

com.amazonaws.AmazonServiceException - the amazon service exception

com.amazonaws.services.s3.model.AmazonS3Exception - the amazon s3 exception

See Also:

Permissions