fr.gouv.vitam.storage.engine.client

Interface StorageClient

All Superinterfaces:

AutoCloseable, BasicClient, MockOrRestClient, VitamAutoCloseable

public interface StorageClient
extends BasicClient

Storage Client interface

Field Summary

Fields inherited from interface fr.gouv.vitam.common.client.BasicClient

STATUS_URL

Method Summary

Modifier and Type	Method and Description
boolean	delete(String strategyId, DataCategory type, String guid, String digest, DigestType digestAlgorithm) Delete an object of given type in the storage offer strategy
boolean	deleteContainer(String strategyId) Delete a container in the storage offer strategy A non-empty container CANNOT be deleted !
boolean	exists(String strategyId, DataCategory type, String guid, List<String> offerIds) Check the existence of an object in storage by its id and type DataCategory.
boolean	existsContainer(String strategyId) Check the existance of a tenant container in storage by its id
javax.ws.rs.core.Response	getContainerAsync(String strategyId, String guid, DataCategory type) Retrieves a binary object knowing its guid as an inputStream for a specific tenant/strategy
com.fasterxml.jackson.databind.JsonNode	getInformation(String strategyId, DataCategory type, String guid, List<String> offerIds) Get object information from objects in storage
RequestResponse<OfferLog>	getOfferLogs(String strategyId, DataCategory type, Long offset, int limit, Order order) Get offer log .
com.fasterxml.jackson.databind.JsonNode	getStorageInformation(String strategyId) Check if the storage of objects could be done, knowing a required size
VitamRequestIterator<com.fasterxml.jackson.databind.JsonNode>	listContainer(String strategyId, DataCategory type) List object type in container
RequestResponseOK	storageLogBackup() Call storage log backup operation.
RequestResponseOK	storageLogTraceability() Call storage log traceability operation.
StoredInfoResult	storeFileFromWorkspace(String strategyId, DataCategory type, String guid, ObjectDescription description) Store an object available in workspace by its vitam guid

Methods inherited from interface fr.gouv.vitam.common.client.MockOrRestClient

checkStatus, checkStatus, close, consumeAnyEntityAndClose, getResourcePath, getServiceUrl

Method Detail

getStorageInformation

com.fasterxml.jackson.databind.JsonNode getStorageInformation(String strategyId)
                                                       throws StorageNotFoundClientException,
                                                              StorageServerClientException

Check if the storage of objects could be done, knowing a required size

Parameters:

strategyId - the storage strategy id

Returns:

the capacity of the storage

Throws:

StorageNotFoundClientException - if the Server got a NotFound result

StorageServerClientException - if the Server got an internal error

storeFileFromWorkspace

StoredInfoResult storeFileFromWorkspace(String strategyId,
                                        DataCategory type,
                                        String guid,
                                        ObjectDescription description)
                                 throws StorageAlreadyExistsClientException,
                                        StorageNotFoundClientException,
                                        StorageServerClientException

Store an object available in workspace by its vitam guid

Parameters:

strategyId - the storage strategy id

type - the type of object collection

guid - vitam guid

description - object description

Returns:

the result status of object creation

Throws:

StorageAlreadyExistsClientException - if the Server got a CONFLICT status result

StorageNotFoundClientException - if the Server got a NotFound result

StorageServerClientException - if the Server got an internal error

existsContainer

boolean existsContainer(String strategyId)
                 throws StorageServerClientException

Check the existance of a tenant container in storage by its id

Parameters:

strategyId - the storage strategy id

Returns:

true if exist

Throws:

StorageServerClientException - if the Server got an internal error

exists

boolean exists(String strategyId,
               DataCategory type,
               String guid,
               List<String> offerIds)
        throws StorageServerClientException

Check the existence of an object in storage by its id and type DataCategory.

Parameters:

strategyId - the storage strategy id

type - the type of object collection

guid - vitam guid

Returns:

true if exist

Throws:

StorageServerClientException - if the Server got an internal error

deleteContainer

boolean deleteContainer(String strategyId)
                 throws StorageServerClientException

Delete a container in the storage offer strategy A non-empty container CANNOT be deleted !

Parameters:

strategyId - the storage strategy id

Returns:

true if deleted

Throws:

StorageServerClientException - if the Server got an internal error

delete

boolean delete(String strategyId,
               DataCategory type,
               String guid,
               String digest,
               DigestType digestAlgorithm)
        throws StorageServerClientException

Delete an object of given type in the storage offer strategy

Parameters:

strategyId - the storage strategy id

type - the type of object collection

guid - vitam guid

digest - the digest to be compared with

digestAlgorithm - the digest Algorithm

Returns:

true if deleted

Throws:

StorageServerClientException - if the Server got an internal error

getContainerAsync

javax.ws.rs.core.Response getContainerAsync(String strategyId,
                                            String guid,
                                            DataCategory type)
                                     throws StorageServerClientException,
                                            StorageNotFoundException

Retrieves a binary object knowing its guid as an inputStream for a specific tenant/strategy

Parameters:

strategyId - the storage strategy id

guid - vitam guid of the object to be returned

type -

Returns:

the object requested

Throws:

StorageServerClientException - if the Server got an internal error

StorageNotFoundException - if the Server got a NotFound result, if the container or the object does not exist

listContainer

VitamRequestIterator<com.fasterxml.jackson.databind.JsonNode> listContainer(String strategyId,
                                                                            DataCategory type)
                                                                     throws StorageServerClientException

List object type in container

Parameters:

strategyId - the strategy ID

type - the object type to list

Returns:

an iterator with object list

Throws:

StorageServerClientException - thrown if the server got an internal error

storageLogBackup

RequestResponseOK storageLogBackup()
                            throws StorageServerClientException,
                                   InvalidParseOperationException

Call storage log backup operation.

Returns:

Storage logbook backup response

Throws:

StorageServerClientException

InvalidParseOperationException

storageLogTraceability

RequestResponseOK storageLogTraceability()
                                  throws StorageServerClientException,
                                         InvalidParseOperationException

Call storage log traceability operation.

Returns:

storage log traceability response

Throws:

StorageServerClientException

InvalidParseOperationException

getInformation

com.fasterxml.jackson.databind.JsonNode getInformation(String strategyId,
                                                       DataCategory type,
                                                       String guid,
                                                       List<String> offerIds)
                                                throws StorageServerClientException,
                                                       StorageNotFoundClientException

Get object information from objects in storage

Parameters:

strategyId -

type -

guid -

offerIds -

Returns:

Throws:

StorageServerClientException

StorageNotFoundClientException

getOfferLogs

RequestResponse<OfferLog> getOfferLogs(String strategyId,
                                       DataCategory type,
                                       Long offset,
                                       int limit,
                                       Order order)
                                throws StorageServerClientException

Get offer log .

Parameters:

strategyId - the strategy to get offers

type - the object type to list

offset - offset of the last object before

limit - the number of result wanted

order - the order order

Returns:

list of offer log

Throws:

StorageServerClientException