eu.europeana.cloud.service.mcs.rest

Class RepresentationVersionResource

java.lang.Object

eu.europeana.cloud.service.mcs.rest.RepresentationVersionResource

@Component
@Scope(value="request")
public class RepresentationVersionResource
extends Object

Resource to manage representation versions.

Constructor Summary

Constructors

Constructor and Description
RepresentationVersionResource()

Method Summary

Methods

Modifier and Type	Method and Description
javax.ws.rs.core.Response	copyRepresentation(javax.ws.rs.core.UriInfo uriInfo, String version, String schema, String globalId) Copies all information with all files and their contents from one representation version to a new temporary one.
void	deleteRepresentation(String version, String schema, String globalId) Deletes representation version.
eu.europeana.cloud.common.model.Representation	getRepresentationVersion(javax.ws.rs.core.UriInfo uriInfo, String version, String schema, String globalId) Returns representation in a specified version.
javax.ws.rs.core.Response	persistRepresentation(javax.ws.rs.core.UriInfo uriInfo, String version, String schema, String globalId) Persists temporary representation.

Methods inherited from class java.lang.Object

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

Constructor Detail

RepresentationVersionResource

public RepresentationVersionResource()

Method Detail

getRepresentationVersion

@PreAuthorize(value="hasPermission(#globalId.concat(\'/\').concat(#schema).concat(\'/\').concat(#version), \'eu.europeana.cloud.common.model.Representation\', read)")
public eu.europeana.cloud.common.model.Representation getRepresentationVersion(@Context
                                                                                   javax.ws.rs.core.UriInfo uriInfo,
                                                                                   String version,
                                                                                   String schema,
                                                                                   String globalId)
                                                                        throws eu.europeana.cloud.service.mcs.exception.RepresentationNotExistsException

Returns representation in a specified version. Read permissions required.

Parameters:

globalId - cloud id of the record which contains the representation(required).

schema - name of the representation(required).

version - a specific version of the representation(required).

Returns:

representation in requested version

Throws:

eu.europeana.cloud.service.mcs.exception.RepresentationNotExistsException - representation does not exist in the specified version.

deleteRepresentation

@PreAuthorize(value="hasPermission(#globalId.concat(\'/\').concat(#schema).concat(\'/\').concat(#version), \'eu.europeana.cloud.common.model.Representation\', delete)")
public void deleteRepresentation(String version,
                                     String schema,
                                     String globalId)
                          throws eu.europeana.cloud.service.mcs.exception.RepresentationNotExistsException,
                                 eu.europeana.cloud.service.mcs.exception.CannotModifyPersistentRepresentationException

Deletes representation version. Delete permissions required.

Parameters:

globalId - cloud id of the record which contains the representation version (required).

schema - name of the representation(required).

version - a specific version of the representation(required).

Throws:

eu.europeana.cloud.service.mcs.exception.RepresentationNotExistsException - representation does not exist in specified version.

eu.europeana.cloud.service.mcs.exception.CannotModifyPersistentRepresentationException - representation in specified version is persistent and as such cannot be removed.

persistRepresentation

@PreAuthorize(value="hasPermission(#globalId.concat(\'/\').concat(#schema).concat(\'/\').concat(#version), \'eu.europeana.cloud.common.model.Representation\', write)")
public javax.ws.rs.core.Response persistRepresentation(@Context
                                                           javax.ws.rs.core.UriInfo uriInfo,
                                                           String version,
                                                           String schema,
                                                           String globalId)
                                                throws eu.europeana.cloud.service.mcs.exception.RepresentationNotExistsException,
                                                       eu.europeana.cloud.service.mcs.exception.CannotModifyPersistentRepresentationException,
                                                       eu.europeana.cloud.service.mcs.exception.CannotPersistEmptyRepresentationException

Persists temporary representation. Write permissions required.

Parameters:

globalId - cloud id of the record which contains the representation version(required).

schema - name of the representation(required).

version - a specific version of the representation(required).

Returns:

URI to the persisted representation in content-location.

Throws:

eu.europeana.cloud.service.mcs.exception.RepresentationNotExistsException - representation does not exist in specified version.

eu.europeana.cloud.service.mcs.exception.CannotModifyPersistentRepresentationException - representation version is already persistent.

eu.europeana.cloud.service.mcs.exception.CannotPersistEmptyRepresentationException - representation version has no file attached and as such cannot be made persistent.

copyRepresentation

@PreAuthorize(value="hasPermission(#globalId.concat(\'/\').concat(#schema).concat(\'/\').concat(#version), \'eu.europeana.cloud.common.model.Representation\', read)")
public javax.ws.rs.core.Response copyRepresentation(@Context
                                                        javax.ws.rs.core.UriInfo uriInfo,
                                                        String version,
                                                        String schema,
                                                        String globalId)
                                             throws eu.europeana.cloud.service.mcs.exception.RepresentationNotExistsException

Copies all information with all files and their contents from one representation version to a new temporary one. Read permissions required.

Parameters:

globalId - cloud id of the record which contains the representation version

schema - name of the representation

version - a specific version of the representation

Returns:

URI to the created representation in content-location.

Throws:

eu.europeana.cloud.service.mcs.exception.RepresentationNotExistsException - representation does not exist in specified version.