eu.europeana.cloud.mcs.driver

Class RecordServiceClient

java.lang.Object

eu.europeana.cloud.mcs.driver.RecordServiceClient

public class RecordServiceClient
extends Object

Exposes API related to records.

Constructor Summary

Constructors

Constructor and Description
RecordServiceClient(String baseUrl) Creates instance of RecordServiceClient.
RecordServiceClient(String baseUrl, String username, String password) Creates instance of RecordServiceClient.

Method Summary

Methods

Modifier and Type	Method and Description
URI	copyRepresentation(String cloudId, String representationName, String version) Copies all information from one representation version to another.
URI	createRepresentation(String cloudId, String representationName, String providerId) Creates new representation version.
void	deleteRecord(String cloudId) Deletes record with all its representations in all versions.
void	deleteRepresentation(String cloudId, String representationName) Deletes representation with all versions.
void	deleteRepresentation(String cloudId, String representationName, String version) Deletes representation in specified version.
Record	getRecord(String cloudId) Returns record with all its latest persistent representations.
Representation	getRepresentation(String cloudId, String representationName) Returns latest persistent version of representation.
Representation	getRepresentation(String cloudId, String representationName, String version) Returns representation in specified version.
List<Representation>	getRepresentations(String cloudId) Lists all latest persistent versions of record representation.
List<Representation>	getRepresentations(String cloudId, String representationName) Lists all versions of record representation.
URI	persistRepresentation(String cloudId, String representationName, String version) Makes specified temporary representation version persistent.

Methods inherited from class java.lang.Object

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

Constructor Detail

RecordServiceClient

public RecordServiceClient(String baseUrl)

Creates instance of RecordServiceClient.

Parameters:

baseUrl - URL of the MCS Rest Service

RecordServiceClient

public RecordServiceClient(String baseUrl,
                   String username,
                   String password)

Creates instance of RecordServiceClient. Same as RecordServiceClient(String) but includes username and password to perform authenticated requests.

Parameters:

baseUrl - URL of the MCS Rest Service

Method Detail

getRecord

public Record getRecord(String cloudId)
                 throws RecordNotExistsException,
                        MCSException

Returns record with all its latest persistent representations.

Parameters:

cloudId - id of the record (required)

Returns:

record of specified cloudId (required)

Throws:

RecordNotExistsException - when id is not known UIS Service

MCSException - on unexpected situations

deleteRecord

public void deleteRecord(String cloudId)
                  throws RecordNotExistsException,
                         MCSException

Deletes record with all its representations in all versions. Does not remove mapping from Unique Identifier Service. If record exists, but nothing was deleted (it had no representations assigned), nothing happens.

Parameters:

cloudId - id of deleted record (required)

Throws:

RecordNotExistsException - if cloudId is not known UIS Service

MCSException - on unexpected situations

getRepresentations

public List<Representation> getRepresentations(String cloudId)
                                        throws RecordNotExistsException,
                                               MCSException

Lists all latest persistent versions of record representation.

Parameters:

cloudId - id of record from which to get representations (required)

Returns:

list of representations

Throws:

RecordNotExistsException - if cloudId is not known UIS Service

MCSException - on unexpected situations

getRepresentation

public Representation getRepresentation(String cloudId,
                               String representationName)
                                 throws RepresentationNotExistsException,
                                        MCSException

Returns latest persistent version of representation.

Parameters:

cloudId - id of record from which to get representations (required)

representationName - name of the representation (required)

Returns:

representation of specified representationName and cloudId

Throws:

RepresentationNotExistsException - representation does not exist or no persistent version of this representation exists

MCSException - on unexpected situations

createRepresentation

public URI createRepresentation(String cloudId,
                       String representationName,
                       String providerId)
                         throws ProviderNotExistsException,
                                RecordNotExistsException,
                                MCSException

Creates new representation version.

Parameters:

cloudId - id of the record in which to create the representation (required)

representationName - name of the representation to be created (required)

providerId - provider of this representation version (required)

Returns:

URI to the created representation

Throws:

ProviderNotExistsException - when no provider with given id exists

RecordNotExistsException - when cloud id is not known to UIS Service

MCSException - on unexpected situations

deleteRepresentation

public void deleteRepresentation(String cloudId,
                        String representationName)
                          throws RepresentationNotExistsException,
                                 MCSException

Deletes representation with all versions.

Parameters:

cloudId - id of the record to delete representation from (required)

representationName - representation name of deleted representation (required)

Throws:

RepresentationNotExistsException - if specified Representation does not exist

MCSException - on unexpected situations

getRepresentations

public List<Representation> getRepresentations(String cloudId,
                                      String representationName)
                                        throws RepresentationNotExistsException,
                                               MCSException

Lists all versions of record representation.

Parameters:

cloudId - id of the record to get representation from (required)

representationName - name of the representation (required)

Returns:

representation versions list

Throws:

RepresentationNotExistsException - if specified Representation does not exist

MCSException - on unexpected situations

getRepresentation

public Representation getRepresentation(String cloudId,
                               String representationName,
                               String version)
                                 throws RepresentationNotExistsException,
                                        MCSException

Returns representation in specified version. If Version = LATEST, will redirect to actual latest persistent version at the moment of invoking this method.

Parameters:

cloudId - id of the record to get representation from (required)

representationName - name of the representation (required)

version - version of the representation to be obtained; if version==LATEST function will return latest persistent version (required)

Returns:

requested representation version

Throws:

RepresentationNotExistsException - if specified representation does not exist

MCSException - on unexpected situations

deleteRepresentation

public void deleteRepresentation(String cloudId,
                        String representationName,
                        String version)
                          throws RepresentationNotExistsException,
                                 CannotModifyPersistentRepresentationException,
                                 MCSException

Deletes representation in specified version.

Parameters:

cloudId - id of the record to delete representation version from (required)

representationName - name of the representation (required)

version - the deleted version of the representation (required)

Throws:

RepresentationNotExistsException - if specified representation does not exist

CannotModifyPersistentRepresentationException - if specified representation is persistent and thus cannot be removed

MCSException - on unexpected situations

copyRepresentation

public URI copyRepresentation(String cloudId,
                     String representationName,
                     String version)
                       throws RepresentationNotExistsException,
                              MCSException

Copies all information from one representation version to another. Copies all information with all files and their content from one representation version to a new temporary one.

Parameters:

cloudId - id of the record that holds representation (required)

representationName - name of the copied representation (required)

version - version of the copied representation (required)

Returns:

URI to the created copy of representation

Throws:

RepresentationNotExistsException - if specified representation version does not exist

MCSException - on unexpected situations

persistRepresentation

public URI persistRepresentation(String cloudId,
                        String representationName,
                        String version)
                          throws RepresentationNotExistsException,
                                 CannotModifyPersistentRepresentationException,
                                 CannotPersistEmptyRepresentationException,
                                 MCSException

Makes specified temporary representation version persistent.

Parameters:

cloudId - id of the record that holds representation (required)

representationName - name of the representation to be persisted (required)

version - version that should be made persistent (required)

Returns:

URI to the persisted representation

Throws:

RepresentationNotExistsException - when representation does not exist in specified version

CannotModifyPersistentRepresentationException - when representation version is already persistent

CannotPersistEmptyRepresentationException - when representation version has no file attached and thus cannot be made persistent

MCSException - on unexpected situations