eu.europeana.cloud.mcs.driver

Class FileServiceClient

java.lang.Object

eu.europeana.cloud.mcs.driver.FileServiceClient

public class FileServiceClient
extends Object

Exposes API related to files.

Constructor Summary

Constructors

Constructor and Description
FileServiceClient(String baseUrl) Constructs a FileServiceClient
FileServiceClient(String baseUrl, String username, String password) Creates instance of FileServiceClient.

Method Summary

Methods

Modifier and Type	Method and Description
void	deleteFile(String cloudId, String representationName, String version, String fileName) Deletes existed file.
InputStream	getFile(String cloudId, String representationName, String version, String fileName) Function returns file content.
InputStream	getFile(String cloudId, String representationName, String version, String fileName, String range) Function returns file content.
URI	modyfiyFile(String cloudId, String representationName, String version, InputStream data, String mediaType, String fileName, String expectedMd5) Modifies existed file with checking checksum.
URI	uploadFile(String cloudId, String representationName, String version, InputStream data, String mediaType) Uploads file content without checking checksum.
URI	uploadFile(String cloudId, String representationName, String version, InputStream data, String mediaType, String expectedMd5) Uploads file content with checking checksum.

Methods inherited from class java.lang.Object

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

Constructor Detail

FileServiceClient

public FileServiceClient(String baseUrl)

Constructs a FileServiceClient

Parameters:

baseUrl - url of the MCS Rest Service

FileServiceClient

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

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

Parameters:

baseUrl - URL of the MCS Rest Service

Method Detail

getFile

public InputStream getFile(String cloudId,
                  String representationName,
                  String version,
                  String fileName)
                    throws RepresentationNotExistsException,
                           FileNotExistsException,
                           DriverException,
                           MCSException

Function returns file content.

Parameters:

cloudId - id of returned file.

representationName - representation name of returned file.

version - version of returned file.

fileName - name of file.

Returns:

InputStream returned content.

Throws:

RepresentationNotExistsException - when requested representation (or representation version) does not exist.

FileNotExistsException - when requested file does not exist.

DriverException - call to service has not succeeded because of server side error.

MCSException - on unexpected situations.

getFile

public InputStream getFile(String cloudId,
                  String representationName,
                  String version,
                  String fileName,
                  String range)
                    throws RepresentationNotExistsException,
                           FileNotExistsException,
                           WrongContentRangeException,
                           DriverException,
                           MCSException

Function returns file content. By setting range parameter one can retrieve only a part of content.

Parameters:

cloudId - id of returned file.

representationName - representation name of returned file.

version - version of returned file.

fileName - name of file.

range - range of bytes to return. Range header can be found in Hypertext Transfer Protocol HTTP/1.1, section 14.35 Range).

Returns:

InputStream returned content.

Throws:

RepresentationNotExistsException - when requested representation (or representation version) does not exist.

FileNotExistsException - when requested file does not exist.

WrongContentRangeException - when wrong value in "Range" header.

DriverException - call to service has not succeeded because of server side error.

MCSException - on unexpected situations.

uploadFile

public URI uploadFile(String cloudId,
             String representationName,
             String version,
             InputStream data,
             String mediaType,
             String expectedMd5)
               throws IOException,
                      RepresentationNotExistsException,
                      CannotModifyPersistentRepresentationException,
                      DriverException,
                      MCSException

Uploads file content with checking checksum.

Parameters:

cloudId - id of uploaded file.

representationName - representation name of uploaded file.

version - version of uploaded file.

data - InputStream (content) of uploaded file.

mediaType - mediaType of uploaded file.

expectedMd5 - expected MD5 checksum.

Returns:

URI to uploaded file.

Throws:

IOException - when incorrect MD5 checksum.

RepresentationNotExistsException - when representation does not exist in specified version.

CannotModifyPersistentRepresentationException - when specified representation version is persistent and modifying its files is not allowed.

DriverException - call to service has not succeeded because of server side error.

MCSException - on unexpected situations.

uploadFile

public URI uploadFile(String cloudId,
             String representationName,
             String version,
             InputStream data,
             String mediaType)
               throws RepresentationNotExistsException,
                      CannotModifyPersistentRepresentationException,
                      DriverException,
                      MCSException

Uploads file content without checking checksum.

Parameters:

cloudId - id of uploaded file.

representationName - representation name of uploaded file.

version - version of uploaded file.

data - InputStream (content) of uploaded file.

mediaType - mediaType of uploaded file.

Returns:

URI of uploaded file.

Throws:

RepresentationNotExistsException - when representation does not exist in specified version.

CannotModifyPersistentRepresentationException - when specified representation version is persistent and modifying its files is not allowed.

DriverException - call to service has not succeeded because of server side error.

MCSException - on unexpected situations.

modyfiyFile

public URI modyfiyFile(String cloudId,
              String representationName,
              String version,
              InputStream data,
              String mediaType,
              String fileName,
              String expectedMd5)
                throws IOException,
                       RepresentationNotExistsException,
                       CannotModifyPersistentRepresentationException,
                       DriverException,
                       MCSException

Modifies existed file with checking checksum.

Parameters:

cloudId - id of modifying file.

representationName - representation name of modifying file.

version - version of modifying file.

data - InputStream (content) of modifying file.

mediaType - mediaType of modifying file.

fileName - name of modifying file.

expectedMd5 - expected MD5 checksum.

Returns:

URI to modified file.

Throws:

IOException - when checksum is incorrect.

RepresentationNotExistsException - when representation does not exist in specified version.

CannotModifyPersistentRepresentationException - when specified representation version is persistent and modifying its files is not allowed.

DriverException - call to service has not succeeded because of server side error.

MCSException - on unexpected situations.

deleteFile

public void deleteFile(String cloudId,
              String representationName,
              String version,
              String fileName)
                throws RepresentationNotExistsException,
                       FileNotExistsException,
                       CannotModifyPersistentRepresentationException,
                       DriverException,
                       MCSException

Deletes existed file.

Parameters:

cloudId - id of deleting file.

representationName - representation name of deleting file.

version - version of deleting file.

fileName - name of deleting file.

Throws:

RepresentationNotExistsException - when representation does not exist in specified version.

FileNotExistsException - when requested file does not exist.

CannotModifyPersistentRepresentationException - when specified representation version is persistent and modifying its files is not allowed.

DriverException - call to service has not succeeded because of server side error.

MCSException - on unexpected situations.