eu.europeana.cloud.service.mcs.rest

Class FilesResource

java.lang.Object

eu.europeana.cloud.service.mcs.rest.FilesResource

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

FilesResource

Constructor Summary

Constructors

Constructor and Description
FilesResource()

Method Summary

Methods

Modifier and Type	Method and Description
javax.ws.rs.core.Response	sendFile(javax.ws.rs.core.UriInfo uriInfo, String globalId, String schema, String version, String mimeType, InputStream data, String fileName) Adds a new file to representation version.

Methods inherited from class java.lang.Object

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

Constructor Detail

FilesResource

public FilesResource()

Method Detail

sendFile

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

Adds a new file to representation version. URI to created resource will be returned in response as content location. Consumes multipart content - form data:

• "mimeType" - file mime type
• "fileName" - file name
• "data" - binary stream of file content (required)

Write permissions required.

Parameters:

globalId - cloud id of the record (required).

schema - schema of representation (required).

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

mimeType - mime type of file

data - binary stream of file content (required)

fileName - name of creating file. If fileName does not provided by POST request fileName will assigned automatically by service.

Returns:

empty response with tag (content md5) and URI to the created resource 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 - specified representation version is persistent and modifying its files is not allowed.

eu.europeana.cloud.service.mcs.exception.FileAlreadyExistsException - specified file already exist.