eu.europeana.cloud.service.mcs.rest

Class RepresentationResource

java.lang.Object

eu.europeana.cloud.service.mcs.rest.RepresentationResource

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

Resource to manage representations.

Constructor Summary

Constructors

Constructor and Description
RepresentationResource()

Method Summary

Methods

Modifier and Type	Method and Description
javax.ws.rs.core.Response	createRepresentation(javax.ws.rs.core.UriInfo uriInfo, String globalId, String schema, String providerId) Creates a new representation version.
void	deleteRepresentation(String globalId, String schema) Deletes representation with all of its versions for a given cloudId.
eu.europeana.cloud.common.model.Representation	getRepresentation(javax.ws.rs.core.UriInfo uriInfo, String globalId, String schema) Returns the latest persistent version of a given representation .

Methods inherited from class java.lang.Object

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

Constructor Detail

RepresentationResource

public RepresentationResource()

Method Detail

getRepresentation

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

Returns the latest persistent version of a given representation . Read permissions required.

Parameters:

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

schema - name of the representation .

Returns:

requested representation in its latest persistent version.

Throws:

eu.europeana.cloud.service.mcs.exception.RepresentationNotExistsException - representation does not exist or no persistent version of this representation exists.

deleteRepresentation

@PreAuthorize(value="hasRole(\'ROLE_ADMIN\')")
public void deleteRepresentation(String globalId,
                                     String schema)
                          throws eu.europeana.cloud.service.mcs.exception.RepresentationNotExistsException

Deletes representation with all of its versions for a given cloudId. Admin permissions required.

Parameters:

globalId - cloud id of the record which all the representations will be deleted (required)

schema - name of the representation to be deleted (required)

Throws:

eu.europeana.cloud.service.mcs.exception.RepresentationNotExistsException - Representation does not exist.

createRepresentation

@PreAuthorize(value="isAuthenticated()")
public javax.ws.rs.core.Response createRepresentation(@Context
                                                          javax.ws.rs.core.UriInfo uriInfo,
                                                          String globalId,
                                                          String schema,
                                                          String providerId)
                                               throws eu.europeana.cloud.service.mcs.exception.RecordNotExistsException,
                                                      eu.europeana.cloud.service.mcs.exception.ProviderNotExistsException

Creates a new representation version. Url of the created representation version will be returned in response. User permissions required.

Parameters:

globalId - cloud id of the record in which the new representation will be created (required).

schema - name of the representation to be created (required).

providerId - provider id of this representation version.

Returns:

The url of the created representation.

Throws:

eu.europeana.cloud.service.mcs.exception.RecordNotExistsException - provided id is not known to Unique Identifier Service.

eu.europeana.cloud.service.mcs.exception.ProviderNotExistsException - no provider with given id exists