eu.europeana.features

Class SwiftObjectStorageClient

java.lang.Object

eu.europeana.features.SwiftObjectStorageClient

All Implemented Interfaces:

ObjectStorageClient

public class SwiftObjectStorageClient
extends Object
implements ObjectStorageClient

Created by jeroen on 14-12-16.

Constructor Summary

Constructors

Constructor and Description
SwiftObjectStorageClient(String authUrl, String userName, String password, String containerName, String regionName, String tenantName) Create a new Swift client and setup connection

Method Summary

Modifier and Type	Method and Description
void	close() Terminate all connections and shut down this client
void	delete(String objectName) Deletes an object, if present.
Optional<StorageObject>	get(String objectName) Gets the StorageObject including its body.
Optional<StorageObject>	get(String objectName, boolean verify) Gets the StorageObject including its body.
String	getBucketName()
byte[]	getContent(String objectName) Get the content of the specified object and return it as a byte array.
ObjectMetadata	getMetaData(String objectName) Get the metadata of the specified object
String	getName()
Optional<StorageObject>	getWithoutBody(String objectName) Gets the StorageObject metadata without its body.
boolean	isAvailable(String id) This method is not recommended as it is inefficient.
List<StorageObject>	list()
String	put(StorageObject storageObject) Creates or updates a StorageObject.
String	put(String key, org.jclouds.io.Payload value) Creates or updates a StorageObject.

Methods inherited from class java.lang.Object

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

Constructor Detail

SwiftObjectStorageClient

public SwiftObjectStorageClient(String authUrl,
                                String userName,
                                String password,
                                String containerName,
                                String regionName,
                                String tenantName)

Create a new Swift client and setup connection

Parameters:

authUrl -

userName -

password -

containerName -

regionName -

tenantName -

Method Detail

getName

public String getName()

Specified by:

getName in interface ObjectStorageClient

Returns:

the name of this object storage provider

See Also:

ObjectStorageClient.getName()

getBucketName

public String getBucketName()

Specified by:

getBucketName in interface ObjectStorageClient

Returns:

the name of the bucket

See Also:

ObjectStorageClient.getBucketName()

list

public List<StorageObject> list()

Specified by:

list in interface ObjectStorageClient

Returns:

an List.

See Also:

ObjectStorageClient.list()

isAvailable

public boolean isAvailable(String id)

This method is not recommended as it is inefficient. Better try to retrieve the object directly. If it fails then the object is not available.

Specified by:

isAvailable in interface ObjectStorageClient

Returns:

true if it exists, false if it does not exist

See Also:

ObjectStorageClient.isAvailable(String)

put

public String put(String key,
                  org.jclouds.io.Payload value)

Description copied from interface: ObjectStorageClient

Creates or updates a StorageObject.

Specified by:

put in interface ObjectStorageClient

Parameters:

key - corresponds to StorageObject.getName().

value - corresponds to StorageObject.getPayload().

Returns:

StorageObject.getETag() of the object.

See Also:

ObjectStorageClient.put(String, Payload)

put

public String put(StorageObject storageObject)

Description copied from interface: ObjectStorageClient

Creates or updates a StorageObject.

Specified by:

put in interface ObjectStorageClient

Parameters:

storageObject - corresponds to StorageObject.getName().

Returns:

StorageObject.getETag() of the object.

See Also:

ObjectStorageClient.put(StorageObject)

getWithoutBody

public Optional<StorageObject> getWithoutBody(String objectName)

Description copied from interface: ObjectStorageClient

Gets the StorageObject metadata without its body.

Specified by:

getWithoutBody in interface ObjectStorageClient

Parameters:

objectName - corresponds to StorageObject.getName().

Returns:

the StorageObject or empty Optional, if not found.

See Also:

ObjectStorageClient.getWithoutBody(String)

get

public Optional<StorageObject> get(String objectName)

Description copied from interface: ObjectStorageClient

Gets the StorageObject including its body. Note that as of version 1.3 we no longer verify if the object was retrieved correctly. To do this you need to use ObjectStorageClient.get(String, boolean) method

Specified by:

get in interface ObjectStorageClient

Parameters:

objectName - corresponds to StorageObject.getName().

Returns:

the StorageObject or empty Optional, if not found.

See Also:

ObjectStorageClient.get(String)

get

public Optional<StorageObject> get(String objectName,
                                   boolean verify)
                            throws ContentValidationException

Description copied from interface: ObjectStorageClient

Gets the StorageObject including its body.

Specified by:

get in interface ObjectStorageClient

Parameters:

objectName - corresponds to StorageObject.getName().

verify - if true then the MD5 hash of the downloaded content is compared to the known MD5 hash stored on the server

Returns:

the StorageObject or empty Optional, if not found.

Throws:

ContentValidationException - thrown when verification of the validity of downloaded content fails.

See Also:

ObjectStorageClient.get(String, boolean)

getContent

public byte[] getContent(String objectName)

Description copied from interface: ObjectStorageClient

Get the content of the specified object and return it as a byte array. This is the recommended (fastest) method of retrieving media content like images.

Specified by:

getContent in interface ObjectStorageClient

Parameters:

objectName - corresponds to StorageObject.getName().

Returns:

byte array representing the retrieved object, or empty byte array if no object was retrieved

See Also:

ObjectStorageClient.getContent(String)

getMetaData

public ObjectMetadata getMetaData(String objectName)

Description copied from interface: ObjectStorageClient

Get the metadata of the specified object

Specified by:

getMetaData in interface ObjectStorageClient

Parameters:

objectName - corresponds to StorageObject.getName().

Returns:

ObjectMetadata of the requests object

delete

public void delete(String objectName)

Description copied from interface: ObjectStorageClient

Deletes an object, if present.

Specified by:

delete in interface ObjectStorageClient

Parameters:

objectName - corresponds to StorageObject.getName().

See Also:

ObjectStorageClient.delete(String)

close

public void close()

Description copied from interface: ObjectStorageClient

Terminate all connections and shut down this client

Specified by:

close in interface ObjectStorageClient

See Also:

ObjectStorageClient.close()