eu.europeana.cloud.service.mcs.persistent.cassandra

Class CassandraRecordDAO

java.lang.Object

eu.europeana.cloud.service.mcs.persistent.cassandra.CassandraRecordDAO

@Repository
public class CassandraRecordDAO
extends Object

Repository for records, their representations and versions. Uses Cassandra as storage.

Constructor Summary

Constructors

Constructor and Description
CassandraRecordDAO()

Method Summary

Methods

Modifier and Type	Method and Description
void	addOrReplaceFileInRepresentation(String cloudId, String schema, String version, eu.europeana.cloud.common.model.File file) Adds or modifies given file to list of files of representation.
eu.europeana.cloud.common.model.Representation	createRepresentation(String cloudId, String schema, String providerId, Date creationTime) Creates new temporary version for a specific record's representation.
void	deleteRecord(String cloudId) Deletes record with all representations and all versions.
void	deleteRepresentation(String cloudId, String schema) Deletes representation with all versions.
void	deleteRepresentation(String cloudId, String schema, String version) Deletes record's representation in specified version.
List<eu.europeana.cloud.common.model.File>	getFilesForRepresentation(String cloudId, String schema, String version) Returns files for representation.
eu.europeana.cloud.common.model.Representation	getLatestPersistentRepresentation(String cloudId, String schema) Returns latest persistent version of record's representation.
eu.europeana.cloud.common.model.Record	getRecord(String cloudId) Returns a record containing latest persistent representation in each schema.
eu.europeana.cloud.common.model.Representation	getRepresentation(String cloudId, String schema, String version) Returns a representation of a record in specified schema and version.
List<eu.europeana.cloud.common.model.Representation>	listRepresentationVersions(String cloudId) Returns all versions of all representations (persistent or not) for a cloud id.
List<eu.europeana.cloud.common.model.Representation>	listRepresentationVersions(String cloudId, String schema) Returns all versions of representation (persistent or not), sorted from the most recent to the oldes.
void	persistRepresentation(String cloudId, String schema, String version, Date creationTime) Makes a certain temporary representation version a persistent one.
boolean	providerHasRepresentations(String providerId) Checks if given provider has any representations.
void	removeFileFromRepresentation(String cloudId, String schema, String version, String fileName) Removes file entry from list of files belonging to record representation.

Methods inherited from class java.lang.Object

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

Constructor Detail

CassandraRecordDAO

public CassandraRecordDAO()

Method Detail

getRecord

public eu.europeana.cloud.common.model.Record getRecord(String cloudId)
                                                 throws com.datastax.driver.core.exceptions.NoHostAvailableException,
                                                        com.datastax.driver.core.exceptions.QueryExecutionException

Returns a record containing latest persistent representation in each schema. If there is no persistent representation in some schema, it would not be returned.

Parameters:

cloudId -

Returns:

Throws:

com.datastax.driver.core.exceptions.NoHostAvailableException

com.datastax.driver.core.exceptions.QueryExecutionException

deleteRecord

public void deleteRecord(String cloudId)
                  throws com.datastax.driver.core.exceptions.NoHostAvailableException,
                         com.datastax.driver.core.exceptions.QueryExecutionException

Deletes record with all representations and all versions. If such record doesn't exist - nothing happens.

Parameters:

cloudId - indentifier of record to be deleted.

Throws:

com.datastax.driver.core.exceptions.NoHostAvailableException

com.datastax.driver.core.exceptions.QueryExecutionException

deleteRepresentation

public void deleteRepresentation(String cloudId,
                        String schema)
                          throws com.datastax.driver.core.exceptions.NoHostAvailableException,
                                 com.datastax.driver.core.exceptions.QueryExecutionException

Deletes representation with all versions. If such represenation doesn't exist - nothing happens.

Parameters:

cloudId - identifier of record

schema - schema of representation to be deleted.

Throws:

com.datastax.driver.core.exceptions.NoHostAvailableException

com.datastax.driver.core.exceptions.QueryExecutionException

deleteRepresentation

public void deleteRepresentation(String cloudId,
                        String schema,
                        String version)
                          throws com.datastax.driver.core.exceptions.NoHostAvailableException,
                                 com.datastax.driver.core.exceptions.QueryExecutionException

Deletes record's representation in specified version. If such version doesn't exist - nothing happens. This method doesn't check any constraints e.g. can delete persistent version.

Parameters:

cloudId - identifier of record

schema - schema of representation

version - version of representation

Throws:

com.datastax.driver.core.exceptions.NoHostAvailableException

com.datastax.driver.core.exceptions.QueryExecutionException

getLatestPersistentRepresentation

public eu.europeana.cloud.common.model.Representation getLatestPersistentRepresentation(String cloudId,
                                                                               String schema)

Returns latest persistent version of record's representation. If there is no such representation or no version of this representation is persistent - will return null.

Parameters:

cloudId - identifier of record

schema - schema of representation

Returns:

latest persistent version of a representation or null if such doesn't exist.

createRepresentation

public eu.europeana.cloud.common.model.Representation createRepresentation(String cloudId,
                                                                  String schema,
                                                                  String providerId,
                                                                  Date creationTime)
                                                                    throws com.datastax.driver.core.exceptions.NoHostAvailableException,
                                                                           com.datastax.driver.core.exceptions.QueryExecutionException

Creates new temporary version for a specific record's representation.

Parameters:

cloudId - identifier of record

schema - schema of representation

providerId - representation version provider

creationTime - creation date

Returns:

Throws:

com.datastax.driver.core.exceptions.NoHostAvailableException

com.datastax.driver.core.exceptions.QueryExecutionException

getRepresentation

public eu.europeana.cloud.common.model.Representation getRepresentation(String cloudId,
                                                               String schema,
                                                               String version)
                                                                 throws com.datastax.driver.core.exceptions.NoHostAvailableException,
                                                                        com.datastax.driver.core.exceptions.QueryExecutionException

Returns a representation of a record in specified schema and version.

Parameters:

cloudId - id of the record

schema - schema of the representation

version - version of the representation.

Returns:

representation.

Throws:

com.datastax.driver.core.exceptions.QueryExecutionException - if error occured while executing a query.

com.datastax.driver.core.exceptions.NoHostAvailableException - if no Cassandra host are available.

getFilesForRepresentation

public List<eu.europeana.cloud.common.model.File> getFilesForRepresentation(String cloudId,
                                                                   String schema,
                                                                   String version)
                                                                     throws com.datastax.driver.core.exceptions.NoHostAvailableException,
                                                                            com.datastax.driver.core.exceptions.QueryExecutionException

Returns files for representation. If threre is no such representation - will return null. If representation does not contain any files - will return empty list.

Parameters:

cloudId -

schema -

version -

Returns:

Throws:

com.datastax.driver.core.exceptions.NoHostAvailableException

com.datastax.driver.core.exceptions.QueryExecutionException

persistRepresentation

public void persistRepresentation(String cloudId,
                         String schema,
                         String version,
                         Date creationTime)
                           throws com.datastax.driver.core.exceptions.NoHostAvailableException,
                                  com.datastax.driver.core.exceptions.QueryExecutionException

Makes a certain temporary representation version a persistent one. Sets creation date.

Parameters:

cloudId - id of the record

schema - schema of the representation

version - version of the representation

creationTime - date of creation

Throws:

com.datastax.driver.core.exceptions.QueryExecutionException - if error occured while executing a query.

com.datastax.driver.core.exceptions.NoHostAvailableException - if no Cassandra host are available.

listRepresentationVersions

public List<eu.europeana.cloud.common.model.Representation> listRepresentationVersions(String cloudId,
                                                                              String schema)
                                                                                throws com.datastax.driver.core.exceptions.NoHostAvailableException,
                                                                                       com.datastax.driver.core.exceptions.QueryExecutionException,
                                                                                       eu.europeana.cloud.service.mcs.exception.RepresentationNotExistsException

Returns all versions of representation (persistent or not), sorted from the most recent to the oldes. If no representation exist - will return empty list.

Parameters:

cloudId - record id

schema - schema id

Returns:

Throws:

eu.europeana.cloud.service.mcs.exception.RepresentationNotExistsException - when there is no representation matching requested parameters

com.datastax.driver.core.exceptions.NoHostAvailableException

com.datastax.driver.core.exceptions.QueryExecutionException

listRepresentationVersions

public List<eu.europeana.cloud.common.model.Representation> listRepresentationVersions(String cloudId)
                                                                                throws com.datastax.driver.core.exceptions.NoHostAvailableException,
                                                                                       com.datastax.driver.core.exceptions.QueryExecutionException

Returns all versions of all representations (persistent or not) for a cloud id.

Parameters:

cloudId - record id

Returns:

Throws:

com.datastax.driver.core.exceptions.NoHostAvailableException

com.datastax.driver.core.exceptions.QueryExecutionException

addOrReplaceFileInRepresentation

public void addOrReplaceFileInRepresentation(String cloudId,
                                    String schema,
                                    String version,
                                    eu.europeana.cloud.common.model.File file)
                                      throws com.datastax.driver.core.exceptions.NoHostAvailableException,
                                             com.datastax.driver.core.exceptions.QueryExecutionException

Adds or modifies given file to list of files of representation.

Parameters:

cloudId - record if

schema - schema id

version - version id

file - file

Throws:

com.datastax.driver.core.exceptions.QueryExecutionException - if error occured while executing a query.

com.datastax.driver.core.exceptions.NoHostAvailableException - if no Cassandra host are available.

removeFileFromRepresentation

public void removeFileFromRepresentation(String cloudId,
                                String schema,
                                String version,
                                String fileName)
                                  throws com.datastax.driver.core.exceptions.NoHostAvailableException,
                                         com.datastax.driver.core.exceptions.QueryExecutionException

Removes file entry from list of files belonging to record representation.

Parameters:

cloudId - record if

schema - schema id

version - version id

fileName - name of file to be removed from representation

Throws:

com.datastax.driver.core.exceptions.QueryExecutionException - if error occured while executing a query.

com.datastax.driver.core.exceptions.NoHostAvailableException - if no Cassandra host are available.

providerHasRepresentations

public boolean providerHasRepresentations(String providerId)
                                   throws com.datastax.driver.core.exceptions.NoHostAvailableException,
                                          com.datastax.driver.core.exceptions.QueryExecutionException

Checks if given provider has any representations.

Parameters:

providerId - identifier of the provider

Returns:

true if provider has representations, false otherwise

Throws:

com.datastax.driver.core.exceptions.QueryExecutionException - if error occured while executing a query.

com.datastax.driver.core.exceptions.NoHostAvailableException - if no Cassandra host are available.