io.micronaut.objectstorage.oraclecloud

Class OracleCloudStorageOperations

java.lang.Object

io.micronaut.objectstorage.oraclecloud.OracleCloudStorageOperations

All Implemented Interfaces:

ObjectStorageOperations<com.oracle.bmc.objectstorage.requests.PutObjectRequest.Builder,com.oracle.bmc.objectstorage.responses.PutObjectResponse,com.oracle.bmc.objectstorage.responses.DeleteObjectResponse>

@EachBean(value=OracleCloudStorageConfiguration.class)
public class OracleCloudStorageOperations
extends java.lang.Object
implements ObjectStorageOperations<com.oracle.bmc.objectstorage.requests.PutObjectRequest.Builder,com.oracle.bmc.objectstorage.responses.PutObjectResponse,com.oracle.bmc.objectstorage.responses.DeleteObjectResponse>

Oracle Cloud implementation of ObjectStorageOperations.

Since:

1.0

Author:

Pavol Gressa

Constructor Summary

Constructors

Constructor and Description
OracleCloudStorageOperations(OracleCloudStorageConfiguration configuration, com.oracle.bmc.objectstorage.ObjectStorage client) Deprecated. use OracleCloudStorageOperations(OracleCloudStorageConfiguration, ObjectStorage, RegionProvider)
OracleCloudStorageOperations(OracleCloudStorageConfiguration configuration, com.oracle.bmc.objectstorage.ObjectStorage client, com.oracle.bmc.auth.RegionProvider regionProvider)

Method Summary

Modifier and Type	Method and Description
void	copy(java.lang.String sourceKey, java.lang.String destinationKey) Copies an object stored at sourceKey to destinationKey, within the same object storage (bucket/container).
com.oracle.bmc.objectstorage.responses.DeleteObjectResponse	delete(java.lang.String key) Deletes an object from the object storage.
boolean	exists(java.lang.String key) Checks whether an entry with the given key exists in the object storage.
protected com.oracle.bmc.objectstorage.requests.PutObjectRequest.Builder	getRequestBuilder(UploadRequest request)
java.util.Set<java.lang.String>	listObjects() Lists the objects that exist in the object storage.
java.util.Optional<OracleCloudStorageEntry>	retrieve(java.lang.String key) Gets the object from object storage.
UploadResponse<com.oracle.bmc.objectstorage.responses.PutObjectResponse>	upload(UploadRequest request) Uploads an object to the object storage.
UploadResponse<com.oracle.bmc.objectstorage.responses.PutObjectResponse>	upload(UploadRequest request, java.util.function.Consumer<com.oracle.bmc.objectstorage.requests.PutObjectRequest.Builder> requestConsumer) Uploads an object to the object storage.

Methods inherited from class java.lang.Object

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

Constructor Detail

OracleCloudStorageOperations

@Deprecated
public OracleCloudStorageOperations(@Parameter
                                                OracleCloudStorageConfiguration configuration,
                                                com.oracle.bmc.objectstorage.ObjectStorage client)

Deprecated. use OracleCloudStorageOperations(OracleCloudStorageConfiguration, ObjectStorage, RegionProvider)

Parameters:

configuration - Oracle Cloud Storage Configuration

client - Object Storage Client

OracleCloudStorageOperations

@Inject
public OracleCloudStorageOperations(@Parameter
                                            OracleCloudStorageConfiguration configuration,
                                            com.oracle.bmc.objectstorage.ObjectStorage client,
                                            com.oracle.bmc.auth.RegionProvider regionProvider)

Parameters:

configuration - Oracle Cloud Storage Configuration

client - Object Storage Client

regionProvider - Region provider, to determine the current region

Method Detail

upload

@NonNull
public UploadResponse<com.oracle.bmc.objectstorage.responses.PutObjectResponse> upload(@NonNull
                                                                                                UploadRequest request)

Description copied from interface: ObjectStorageOperations

Uploads an object to the object storage. If there is an existing entry, it will be updated.

Specified by:

upload in interface ObjectStorageOperations<com.oracle.bmc.objectstorage.requests.PutObjectRequest.Builder,com.oracle.bmc.objectstorage.responses.PutObjectResponse,com.oracle.bmc.objectstorage.responses.DeleteObjectResponse>

Parameters:

request - the upload request

Returns:

the upload response

upload

@NonNull
public UploadResponse<com.oracle.bmc.objectstorage.responses.PutObjectResponse> upload(@NonNull
                                                                                                UploadRequest request,
                                                                                                @NonNull
                                                                                                java.util.function.Consumer<com.oracle.bmc.objectstorage.requests.PutObjectRequest.Builder> requestConsumer)

Description copied from interface: ObjectStorageOperations

Uploads an object to the object storage. If there is an existing entry, it will be updated.

Specified by:

upload in interface ObjectStorageOperations<com.oracle.bmc.objectstorage.requests.PutObjectRequest.Builder,com.oracle.bmc.objectstorage.responses.PutObjectResponse,com.oracle.bmc.objectstorage.responses.DeleteObjectResponse>

Parameters:

request - the upload request

requestConsumer - Upload request builder consumer

Returns:

the upload response

retrieve

@NonNull
public java.util.Optional<OracleCloudStorageEntry> retrieve(@NonNull
                                                                     java.lang.String key)

Description copied from interface: ObjectStorageOperations

Gets the object from object storage.

Specified by:

retrieve in interface ObjectStorageOperations<com.oracle.bmc.objectstorage.requests.PutObjectRequest.Builder,com.oracle.bmc.objectstorage.responses.PutObjectResponse,com.oracle.bmc.objectstorage.responses.DeleteObjectResponse>

Parameters:

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

Returns:

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

delete

@NonNull
public com.oracle.bmc.objectstorage.responses.DeleteObjectResponse delete(@NonNull
                                                                                   java.lang.String key)

Description copied from interface: ObjectStorageOperations

Deletes an object from the object storage.

Specified by:

delete in interface ObjectStorageOperations<com.oracle.bmc.objectstorage.requests.PutObjectRequest.Builder,com.oracle.bmc.objectstorage.responses.PutObjectResponse,com.oracle.bmc.objectstorage.responses.DeleteObjectResponse>

Parameters:

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

Returns:

Cloud vendor-specific delete response.

exists

public boolean exists(@NonNull
                      java.lang.String key)

Description copied from interface: ObjectStorageOperations

Checks whether an entry with the given key exists in the object storage.

Specified by:

exists in interface ObjectStorageOperations<com.oracle.bmc.objectstorage.requests.PutObjectRequest.Builder,com.oracle.bmc.objectstorage.responses.PutObjectResponse,com.oracle.bmc.objectstorage.responses.DeleteObjectResponse>

Parameters:

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

Returns:

true if the entry exists, false otherwise.

listObjects

@NonNull
public java.util.Set<java.lang.String> listObjects()

Description copied from interface: ObjectStorageOperations

Lists the objects that exist in the object storage.

Specified by:

listObjects in interface ObjectStorageOperations<com.oracle.bmc.objectstorage.requests.PutObjectRequest.Builder,com.oracle.bmc.objectstorage.responses.PutObjectResponse,com.oracle.bmc.objectstorage.responses.DeleteObjectResponse>

Returns:

a list of keys (paths) of the existing objects, if any, or an empty list otherwise.

copy

public void copy(@NonNull
                 java.lang.String sourceKey,
                 @NonNull
                 java.lang.String destinationKey)

Description copied from interface: ObjectStorageOperations

Copies an object stored at sourceKey to destinationKey, within the same object storage (bucket/container). If the destination exists, it will be overwritten.

Specified by:

copy in interface ObjectStorageOperations<com.oracle.bmc.objectstorage.requests.PutObjectRequest.Builder,com.oracle.bmc.objectstorage.responses.PutObjectResponse,com.oracle.bmc.objectstorage.responses.DeleteObjectResponse>

Parameters:

sourceKey - the key of the source object

destinationKey - the key of the destination object

getRequestBuilder

@NonNull
protected com.oracle.bmc.objectstorage.requests.PutObjectRequest.Builder getRequestBuilder(@NonNull
                                                                                                    UploadRequest request)

Parameters:

request - Upload Request

Returns:

The Put Object Request Builder