Package de.adorsys.datasafe.storage.impl.s3

Class S3StorageService

java.lang.Object

de.adorsys.datasafe.storage.impl.s3.S3StorageService

All Implemented Interfaces:

StorageCheckService, StorageListService, StorageReadService, StorageRemoveService, StorageWriteService, StorageService

public class S3StorageService
extends Object
implements StorageService

Amazon S3, minio and CEPH compatible default S3 interface adapter. Note: It is using rawPath of URI that is url-encoded due to: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html

Constructor Summary

Constructors

Constructor	Description
S3StorageService(com.amazonaws.services.s3.AmazonS3 s3, String bucketName, ExecutorService executorService)

Method Summary

Modifier and Type	Method	Description
Optional<Integer>	flushChunkSize(AbsoluteLocation location)
Stream<AbsoluteLocation<ResolvedResource>>	list(AbsoluteLocation location)	Lists all resources within bucket and returns absolute resource location for each entry without credentials.
boolean	objectExists(AbsoluteLocation location)	Checks if resource exists by its location (latest one if versioning enabled) or checks if resource with given version exists if version is available in location
InputStream	read(AbsoluteLocation location)	Reads resource by its location and uses its version if available in location
void	remove(AbsoluteLocation location)	Removes resource by its location (latest one if versioning enabled) or removes just one version of the resource if version if available in location
OutputStream	write(WithCallback<AbsoluteLocation,? extends ResourceWriteCallback> locationWithCallback)	Writes data stream into resource and sends resource version into callback if S3 returns version id.

Methods inherited from class java.lang.Object

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

Constructor Details

S3StorageService

public S3StorageService(com.amazonaws.services.s3.AmazonS3 s3,
 String bucketName,
 ExecutorService executorService)

Parameters:

s3 - Connection to S3

bucketName - Bucket to use

executorService - Multipart sending threadpool (file chunks are sent in parallel)

Method Details

list

public Stream<AbsoluteLocation<ResolvedResource>> list(AbsoluteLocation location)

Lists all resources within bucket and returns absolute resource location for each entry without credentials. Does not include object versions, only latest are shown.

Specified by:

list in interface StorageListService

read

public InputStream read(AbsoluteLocation location)

Reads resource by its location and uses its version if available in location

Specified by:

read in interface StorageReadService

write

public OutputStream write(WithCallback<AbsoluteLocation,? extends ResourceWriteCallback> locationWithCallback)

Writes data stream into resource and sends resource version into callback if S3 returns version id.

Specified by:

write in interface StorageWriteService

remove

public void remove(AbsoluteLocation location)

Removes resource by its location (latest one if versioning enabled) or removes just one version of the resource if version if available in location

Specified by:

remove in interface StorageRemoveService

objectExists

public boolean objectExists(AbsoluteLocation location)

Checks if resource exists by its location (latest one if versioning enabled) or checks if resource with given version exists if version is available in location

Specified by:

objectExists in interface StorageCheckService

flushChunkSize

public Optional<Integer> flushChunkSize(AbsoluteLocation location)

Specified by:

flushChunkSize in interface StorageWriteService