eu.europeana.corelib.web.service.impl

Class MediaStorageServiceImpl

java.lang.Object

eu.europeana.corelib.web.service.impl.MediaStorageServiceImpl

All Implemented Interfaces:

MediaStorageService

public class MediaStorageServiceImpl
extends Object
implements MediaStorageService

Service for retrieving media (e.g. thumbnails) from an object storage like Amazons S3 or IBM Cloud S3

Constructor Summary

Constructors

Constructor and Description
MediaStorageServiceImpl(eu.europeana.features.ObjectStorageClient objectStorageClient)

Method Summary

Modifier and Type	Method and Description
Boolean	checkIfExists(String id) Checks if a particular file with the provided id is present in the media storage
byte[]	convertPayloadToByteArray(org.jclouds.io.Payload payload) Helper class to convert payload to an array of bytes
void	createOrModify(MediaFile mediaFile) Deprecated. September 2018, no longer needed/required
void	delete(String id) Deprecated. September 2018, no longer needed/required
MediaFile	retrieveAsMediaFile(String id, String originalUrl, boolean withContent) Retrieves a file from media storage with or without the content.
eu.europeana.domain.StorageObject	retrieveAsStorageObject(String id, boolean withContent) Retrieves a file from media storage with or without the content.
byte[]	retrieveContent(String id) Retrieves only the content of a media file (so no metadata)
eu.europeana.domain.ObjectMetadata	retrieveMetaData(String id) Retrieves only the metadata of a media file

Methods inherited from class java.lang.Object

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

Constructor Detail

MediaStorageServiceImpl

public MediaStorageServiceImpl(eu.europeana.features.ObjectStorageClient objectStorageClient)

Method Detail

checkIfExists

public Boolean checkIfExists(String id)

Description copied from interface: MediaStorageService

Checks if a particular file with the provided id is present in the media storage

Specified by:

checkIfExists in interface MediaStorageService

Parameters:

id - the id of the file

Returns:

true if the file is present, false if it is not

See Also:

MediaStorageService.checkIfExists(String)

retrieveAsMediaFile

public MediaFile retrieveAsMediaFile(String id,
                                     String originalUrl,
                                     boolean withContent)

Description copied from interface: MediaStorageService

Retrieves a file from media storage with or without the content.

Specified by:

retrieveAsMediaFile in interface MediaStorageService

Parameters:

id - the id of the file

withContent - boolean which indicates whether the actual contents should be retrieved, or only the metadata of the file

Returns:

an object which contains all the metadata of the file and optionally the actual content

See Also:

MediaStorageService.retrieveAsMediaFile(String, String, boolean)

retrieveAsStorageObject

public eu.europeana.domain.StorageObject retrieveAsStorageObject(String id,
                                                                 boolean withContent)

Description copied from interface: MediaStorageService

Retrieves a file from media storage with or without the content. Note that this method is a bit faster than retrieveAsMediaFile, but does require you to process a payload to access the actual file content (@see convertPayloadToByteArray) which makes it equally fast.

Specified by:

retrieveAsStorageObject in interface MediaStorageService

Parameters:

id - the id of the file

withContent - boolean which indicates whether the actual contents should be retrieved, or only the metadata of the file

Returns:

an object which contains all the metadata of the file and optionally the actual content

See Also:

MediaStorageService.retrieveAsStorageObject(String, boolean)

convertPayloadToByteArray

public byte[] convertPayloadToByteArray(org.jclouds.io.Payload payload)
                                 throws IOException

Description copied from interface: MediaStorageService

Helper class to convert payload to an array of bytes

Specified by:

convertPayloadToByteArray in interface MediaStorageService

Returns:

array of bytes representing the payload object

Throws:

IOException

See Also:

MediaStorageService.convertPayloadToByteArray(Payload)

retrieveContent

public byte[] retrieveContent(String id)

Description copied from interface: MediaStorageService

Retrieves only the content of a media file (so no metadata)

Specified by:

retrieveContent in interface MediaStorageService

Parameters:

id - the id of the file

Returns:

an array of bytes representing only the media content of the file

See Also:

MediaStorageService.retrieveContent(String)

retrieveMetaData

public eu.europeana.domain.ObjectMetadata retrieveMetaData(String id)

Description copied from interface: MediaStorageService

Retrieves only the metadata of a media file

Specified by:

retrieveMetaData in interface MediaStorageService

Parameters:

id - the id of the file

Returns:

ObjectMetadata object

See Also:

MediaStorageService.retrieveMetaData(String)

createOrModify

@Deprecated
public void createOrModify(MediaFile mediaFile)

Deprecated. September 2018, no longer needed/required

Description copied from interface: MediaStorageService

If the file does not exists in the DB it creates it, otherwise it will be updated.

Specified by:

createOrModify in interface MediaStorageService

Parameters:

mediaFile - the new/modified MediaFile

See Also:

MediaStorageService.createOrModify(MediaFile)

delete

@Deprecated
public void delete(String id)

Deprecated. September 2018, no longer needed/required

Description copied from interface: MediaStorageService

Deletes a file with a given id.

Specified by:

delete in interface MediaStorageService

Parameters:

id - the id of the file

See Also:

MediaStorageService.delete(String)