io.micronaut.objectstorage

Interface ObjectStorageOperations<I,O,D>

Type Parameters:

I - Cloud vendor-specific upload request class or builder.

O - Cloud vendor-specific upload response.

D - Cloud vendor-specific delete response.

All Known Implementing Classes:

AwsS3Operations, AzureBlobStorageOperations, GoogleCloudStorageOperations, OracleCloudStorageOperations

public interface ObjectStorageOperations<I,O,D>

Main interface for object storage operations.

Since:

1.0

Author:

Pavol Gressa

Method Summary

Modifier and Type	Method and Description
D	delete(java.lang.String key) Deletes an object from the object storage.
<E extends ObjectStorageEntry<?>> java.util.Optional<E>	retrieve(java.lang.String key) Gets the object from object storage.
UploadResponse<O>	upload(UploadRequest request) Uploads an object to the object storage.
UploadResponse<O>	upload(UploadRequest request, java.util.function.Consumer<I> requestConsumer) Uploads an object to the object storage.

Method Detail

upload

@NonNull
UploadResponse<O> upload(@NonNull
                                  UploadRequest request)

Uploads an object to the object storage.

Parameters:

request - the upload request

Returns:

the upload response

Throws:

ObjectStorageException - if there was a failure storing the object

upload

@NonNull
UploadResponse<O> upload(@NonNull
                                  UploadRequest request,
                                  @NonNull
                                  java.util.function.Consumer<I> requestConsumer)

Uploads an object to the object storage.

Parameters:

request - the upload request

requestConsumer - Upload request builder consumer

Returns:

the upload response

Throws:

ObjectStorageException - if there was a failure storing the object

retrieve

@NonNull
<E extends ObjectStorageEntry<?>> java.util.Optional<E> retrieve(@NonNull
                                                                          java.lang.String key)

Gets the object from object storage.

Type Parameters:

E - an instance of ObjectStorageEntry.

Parameters:

key - the object path in the format /foo/bar/file

Returns:

the object, or empty optional if the object does not exist

Throws:

ObjectStorageException - if there was a failure retrieving the object

delete

@NonNull
D delete(@NonNull
                  java.lang.String key)

Deletes an object from the object storage.

Parameters:

key - object path in the format /foo/bar/file

Returns:

Cloud vendor-specific delete response.

Throws:

ObjectStorageException - if there was a failure deleting the object