org.duracloud.glacierstorage

Class GlacierStorageProvider

java.lang.Object

org.duracloud.storage.provider.StorageProviderBase

org.duracloud.s3storage.S3StorageProvider

org.duracloud.glacierstorage.GlacierStorageProvider

All Implemented Interfaces:

StorageProvider

public class GlacierStorageProvider
extends S3StorageProvider

Provides content storage backed by Amazon's Glacier storage system.

Author:

Bill Branan Date: Dec 6, 2012

Nested Class Summary

Nested classes/interfaces inherited from class org.duracloud.storage.provider.StorageProviderBase

StorageProviderBase.SpaceDeleteWorker

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	INVALID_OBJECT_STATE

Fields inherited from class org.duracloud.s3storage.S3StorageProvider

MAX_ITEM_COUNT, s3Client

Fields inherited from class org.duracloud.storage.provider.StorageProviderBase

ACL_DELIM, ACL_GROUP_READ, ACL_GROUP_WRITE, ACL_USER_READ, ACL_USER_WRITE

Fields inherited from interface org.duracloud.storage.provider.StorageProvider

DEFAULT_MAX_RESULTS, DEFAULT_MIMETYPE, ISO8601_DATE_FORMAT, PROPERTIES_CONTENT_CHECKSUM, PROPERTIES_CONTENT_CREATOR, PROPERTIES_CONTENT_FILE_CREATED, PROPERTIES_CONTENT_FILE_LAST_ACCESSED, PROPERTIES_CONTENT_FILE_MODIFIED, PROPERTIES_CONTENT_FILE_PATH, PROPERTIES_CONTENT_MD5, PROPERTIES_CONTENT_MIMETYPE, PROPERTIES_CONTENT_MODIFIED, PROPERTIES_CONTENT_SIZE, PROPERTIES_COPY_SOURCE, PROPERTIES_COPY_SOURCE_STORE, PROPERTIES_SPACE_ACL, PROPERTIES_SPACE_ACL_GROUP, PROPERTIES_SPACE_ACL_PUBLIC, PROPERTIES_SPACE_COUNT, PROPERTIES_SPACE_CREATED, PROPERTIES_SPACE_SIZE, PROPERTIES_STREAMING_HOST

Constructor Summary

Constructors

Constructor and Description
GlacierStorageProvider(com.amazonaws.services.s3.AmazonS3Client s3Client, String accessKey)
GlacierStorageProvider(String accessKey, String secretKey)

Method Summary

Methods

Modifier and Type	Method and Description
String	copyContent(String sourceSpaceId, String sourceContentId, String destSpaceId, String destContentId) This method copies the content item found in source-space with the id of source-content-id into the dest-space, naming it to dest-content-id.
void	createSpace(String spaceId) Creates a new space.
InputStream	getContent(String spaceId, String contentId) Gets content from a space.
void	setContentProperties(String spaceId, String contentId, Map<String,String> contentProperties) Sets the properties associated with content.
protected void	setNewSpaceLifecycle(String spaceId, com.amazonaws.services.s3.model.BucketLifecycleConfiguration config)

Methods inherited from class org.duracloud.s3storage.S3StorageProvider

addContent, deleteContent, doesContentExist, doSetSpaceProperties, getAllSpaceProperties, getBucketName, getContentProperties, getETagValue, getNewBucketName, getSpaceContents, getSpaceContentsChunked, getSpaceCount, getSpaceFree, getSpaceId, getSpaces, getWithSpace, isSpace, removeCalculatedProperties, removeSpace, spaceExists, wait

Methods inherited from class org.duracloud.storage.provider.StorageProviderBase

deleteSpace, deleteSpaceSync, getSpaceACLs, getSpaceDeleteWorker, getSpaceProperties, packACLs, setNewSpaceProperties, setSpaceACLs, setWrappedStorageProvider, throwIfSpaceExists, throwIfSpaceNotExist, throwIfSpaceNotExist, unpackACLs

Methods inherited from class java.lang.Object

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

Field Detail

INVALID_OBJECT_STATE

protected static final String INVALID_OBJECT_STATE

See Also:

Constant Field Values

Constructor Detail

GlacierStorageProvider

public GlacierStorageProvider(String accessKey,
                      String secretKey)

GlacierStorageProvider

public GlacierStorageProvider(com.amazonaws.services.s3.AmazonS3Client s3Client,
                      String accessKey)

Method Detail

createSpace

public void createSpace(String spaceId)

Creates a new space. Depending on the storage implementation, the spaceId may be changed somewhat to comply with the naming rules of the underlying storage provider. The same spaceId value used here can be used in all other methods, as the conversion will be applied internally, however a call to getSpaces() may not include a space with exactly this same name. Performs the usual space creation activities, then sets up lifecycle policies on the S3 bucket which indicate that all content should be archived in AWS Glacier as quickly as possible after it lands in the bucket.

Specified by:

createSpace in interface StorageProvider

Overrides:

createSpace in class S3StorageProvider

Parameters:

spaceId - - ID of the space

setNewSpaceLifecycle

protected void setNewSpaceLifecycle(String spaceId,
                        com.amazonaws.services.s3.model.BucketLifecycleConfiguration config)

copyContent

public String copyContent(String sourceSpaceId,
                 String sourceContentId,
                 String destSpaceId,
                 String destContentId)

This method copies the content item found in source-space with the id of source-content-id into the dest-space, naming it to dest-content-id.

Specified by:

copyContent in interface StorageProvider

Overrides:

copyContent in class S3StorageProvider

Parameters:

sourceSpaceId - of content to copy

sourceContentId - of content to copy

destSpaceId - where copied content will end up

destContentId - given to copied content

Returns:

MD5 checksum of destination content item

getContent

public InputStream getContent(String spaceId,
                     String contentId)

Gets content from a space.

Specified by:

getContent in interface StorageProvider

Overrides:

getContent in class S3StorageProvider

Parameters:

spaceId - - ID of the space

contentId - - ID of the content in the space

Returns:

the content stream

setContentProperties

public void setContentProperties(String spaceId,
                        String contentId,
                        Map<String,String> contentProperties)

Sets the properties associated with content. This effectively removes all of the current content properties and adds a new set of properties. Some properties, such as system properties provided by the underlying storage system, cannot be updated or removed. Some of the values which cannot be updated or removed: Content-MD5 ETag Last-Modified Content-Type cannot be removed, but it can be updated

Specified by:

setContentProperties in interface StorageProvider

Overrides:

setContentProperties in class S3StorageProvider

Parameters:

spaceId - - ID of the space

contentId - - ID of the content in the space

contentProperties - - new content properties