org.dasein.cloud.aws.storage
Class S3

java.lang.Object
  org.dasein.cloud.storage.AbstractBlobStoreSupport
      org.dasein.cloud.aws.storage.S3

All Implemented Interfaces:

org.dasein.cloud.AccessControlledService, org.dasein.cloud.storage.BlobStoreSupport

public class S3
extends org.dasein.cloud.storage.AbstractBlobStoreSupport

Field Summary

static int	MAX_BUCKETS
static org.dasein.util.uom.storage.Storage<org.dasein.util.uom.storage.Byte>	MAX_OBJECT_SIZE
static int	MAX_OBJECTS

Fields inherited from interface org.dasein.cloud.storage.BlobStoreSupport

ANY, CREATE_BUCKET, DOWNLOAD, GET_BUCKET, LIST_BUCKET, LIST_BUCKET_CONTENTS, MAKE_PUBLIC, REMOVE_BUCKET, UPLOAD

Constructor Summary

S3(AWSCloud provider)

Method Summary

boolean	allowsNestedBuckets()
boolean	allowsPublicSharing()
boolean	allowsRootObjects()
org.dasein.cloud.storage.Blob	createBucket(String bucketName, boolean findFreeName)
boolean	exists(String bucketName)
protected void	get(String bucket, String object, File toFile, org.dasein.cloud.storage.FileTransfer transfer)
org.dasein.cloud.storage.Blob	getBucket(String bucketName)
org.dasein.cloud.util.NamingConstraints	getBucketNameRules()
int	getMaxBuckets()
org.dasein.util.uom.storage.Storage<org.dasein.util.uom.storage.Byte>	getMaxObjectSize()
int	getMaxObjectsPerBucket()
org.dasein.cloud.storage.Blob	getObject(String bucketName, String objectName)
org.dasein.cloud.util.NamingConstraints	getObjectNameRules()
org.dasein.util.uom.storage.Storage<org.dasein.util.uom.storage.Byte>	getObjectSize(String bucket, String object)
String	getProviderTermForBucket(Locale locale)
String	getProviderTermForObject(Locale locale)
String	getSignedObjectUrl(String bucket, String object, String expiresEpochInSeconds)
boolean	isPublic(String bucket, String object)
boolean	isSubscribed()
Collection<org.dasein.cloud.storage.Blob>	list(String bucket)
void	makePublic(String bucket)
void	makePublic(String bucket, String object)
String[]	mapServiceAction(org.dasein.cloud.identity.ServiceAction action)
void	move(String sourceBucket, String object, String targetBucket)
protected void	put(String bucket, String object, File file)
protected void	put(String bucket, String object, String content)
void	removeBucket(String bucket)
void	removeObject(String bucket, String name)
String	renameBucket(String oldName, String newName, boolean findFreeName)
void	renameObject(String bucket, String object, String newName)
org.dasein.cloud.storage.Blob	upload(File source, String bucket, String fileName)

Methods inherited from class org.dasein.cloud.storage.AbstractBlobStoreSupport

clearBucket, copy, copy, copyFile, download, getChecksum

Methods inherited from class java.lang.Object

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

Field Detail

MAX_BUCKETS

public static final int MAX_BUCKETS

See Also:

Constant Field Values

MAX_OBJECTS

public static final int MAX_OBJECTS

See Also:

Constant Field Values

MAX_OBJECT_SIZE

public static final org.dasein.util.uom.storage.Storage<org.dasein.util.uom.storage.Byte> MAX_OBJECT_SIZE

Constructor Detail

S3

public S3(AWSCloud provider)

Method Detail

allowsNestedBuckets

public boolean allowsNestedBuckets()
                            throws org.dasein.cloud.CloudException,
                                   org.dasein.cloud.InternalException

Throws:

org.dasein.cloud.CloudException

org.dasein.cloud.InternalException

allowsRootObjects

public boolean allowsRootObjects()
                          throws org.dasein.cloud.CloudException,
                                 org.dasein.cloud.InternalException

Throws:

org.dasein.cloud.CloudException

org.dasein.cloud.InternalException

allowsPublicSharing

public boolean allowsPublicSharing()
                            throws org.dasein.cloud.CloudException,
                                   org.dasein.cloud.InternalException

Throws:

org.dasein.cloud.CloudException

org.dasein.cloud.InternalException

createBucket

@Nonnull
public org.dasein.cloud.storage.Blob createBucket(@Nonnull
                                                          String bucketName,
                                                          boolean findFreeName)
                                           throws org.dasein.cloud.InternalException,
                                                  org.dasein.cloud.CloudException

Throws:

org.dasein.cloud.InternalException

org.dasein.cloud.CloudException

exists

public boolean exists(@Nonnull
                      String bucketName)
               throws org.dasein.cloud.InternalException,
                      org.dasein.cloud.CloudException

Throws:

org.dasein.cloud.InternalException

org.dasein.cloud.CloudException

getBucket

public org.dasein.cloud.storage.Blob getBucket(@Nonnull
                                               String bucketName)
                                        throws org.dasein.cloud.InternalException,
                                               org.dasein.cloud.CloudException

Throws:

org.dasein.cloud.InternalException

org.dasein.cloud.CloudException

getObject

public org.dasein.cloud.storage.Blob getObject(@Nullable
                                               String bucketName,
                                               @Nonnull
                                               String objectName)
                                        throws org.dasein.cloud.InternalException,
                                               org.dasein.cloud.CloudException

Throws:

org.dasein.cloud.InternalException

org.dasein.cloud.CloudException

getSignedObjectUrl

public String getSignedObjectUrl(@Nonnull
                                 String bucket,
                                 @Nonnull
                                 String object,
                                 @Nonnull
                                 String expiresEpochInSeconds)
                          throws org.dasein.cloud.InternalException,
                                 org.dasein.cloud.CloudException

Throws:

org.dasein.cloud.InternalException

org.dasein.cloud.CloudException

getObjectSize

@Nullable
public org.dasein.util.uom.storage.Storage<org.dasein.util.uom.storage.Byte> getObjectSize(@Nullable
                                                                                                    String bucket,
                                                                                                    @Nullable
                                                                                                    String object)
                                                                                    throws org.dasein.cloud.InternalException,
                                                                                           org.dasein.cloud.CloudException

Throws:

org.dasein.cloud.InternalException

org.dasein.cloud.CloudException

getMaxBuckets

public int getMaxBuckets()
                  throws org.dasein.cloud.CloudException,
                         org.dasein.cloud.InternalException

Throws:

org.dasein.cloud.CloudException

org.dasein.cloud.InternalException

get

protected void get(@Nullable
                   String bucket,
                   @Nonnull
                   String object,
                   @Nonnull
                   File toFile,
                   @Nullable
                   org.dasein.cloud.storage.FileTransfer transfer)
            throws org.dasein.cloud.InternalException,
                   org.dasein.cloud.CloudException

Specified by:

get in class org.dasein.cloud.storage.AbstractBlobStoreSupport

Throws:

org.dasein.cloud.InternalException

org.dasein.cloud.CloudException

getMaxObjectSize

public org.dasein.util.uom.storage.Storage<org.dasein.util.uom.storage.Byte> getMaxObjectSize()

getMaxObjectsPerBucket

public int getMaxObjectsPerBucket()
                           throws org.dasein.cloud.CloudException,
                                  org.dasein.cloud.InternalException

Throws:

org.dasein.cloud.CloudException

org.dasein.cloud.InternalException

getProviderTermForBucket

@Nonnull
public String getProviderTermForBucket(@Nonnull
                                               Locale locale)

getProviderTermForObject

@Nonnull
public String getProviderTermForObject(@Nonnull
                                               Locale locale)

isPublic

public boolean isPublic(@Nullable
                        String bucket,
                        @Nullable
                        String object)
                 throws org.dasein.cloud.CloudException,
                        org.dasein.cloud.InternalException

Throws:

org.dasein.cloud.CloudException

org.dasein.cloud.InternalException

isSubscribed

public boolean isSubscribed()
                     throws org.dasein.cloud.CloudException,
                            org.dasein.cloud.InternalException

Throws:

org.dasein.cloud.CloudException

org.dasein.cloud.InternalException

list

@Nonnull
public Collection<org.dasein.cloud.storage.Blob> list(@Nullable
                                                              String bucket)
                                               throws org.dasein.cloud.CloudException,
                                                      org.dasein.cloud.InternalException

Throws:

org.dasein.cloud.CloudException

org.dasein.cloud.InternalException

makePublic

public void makePublic(@Nonnull
                       String bucket)
                throws org.dasein.cloud.InternalException,
                       org.dasein.cloud.CloudException

Throws:

org.dasein.cloud.InternalException

org.dasein.cloud.CloudException

makePublic

public void makePublic(@Nullable
                       String bucket,
                       @Nullable
                       String object)
                throws org.dasein.cloud.InternalException,
                       org.dasein.cloud.CloudException

Throws:

org.dasein.cloud.InternalException

org.dasein.cloud.CloudException

mapServiceAction

@Nonnull
public String[] mapServiceAction(@Nonnull
                                         org.dasein.cloud.identity.ServiceAction action)

move

public void move(@Nullable
                 String sourceBucket,
                 @Nullable
                 String object,
                 @Nullable
                 String targetBucket)
          throws org.dasein.cloud.InternalException,
                 org.dasein.cloud.CloudException

Throws:

org.dasein.cloud.InternalException

org.dasein.cloud.CloudException

put

protected void put(@Nullable
                   String bucket,
                   @Nonnull
                   String object,
                   @Nonnull
                   File file)
            throws org.dasein.cloud.CloudException,
                   org.dasein.cloud.InternalException

Specified by:

put in class org.dasein.cloud.storage.AbstractBlobStoreSupport

Throws:

org.dasein.cloud.CloudException

org.dasein.cloud.InternalException

put

protected void put(@Nullable
                   String bucket,
                   @Nonnull
                   String object,
                   @Nonnull
                   String content)
            throws org.dasein.cloud.CloudException,
                   org.dasein.cloud.InternalException

Specified by:

put in class org.dasein.cloud.storage.AbstractBlobStoreSupport

Throws:

org.dasein.cloud.CloudException

org.dasein.cloud.InternalException

removeBucket

public void removeBucket(@Nonnull
                         String bucket)
                  throws org.dasein.cloud.CloudException,
                         org.dasein.cloud.InternalException

Throws:

org.dasein.cloud.CloudException

org.dasein.cloud.InternalException

removeObject

public void removeObject(@Nullable
                         String bucket,
                         @Nonnull
                         String name)
                  throws org.dasein.cloud.CloudException,
                         org.dasein.cloud.InternalException

Throws:

org.dasein.cloud.CloudException

org.dasein.cloud.InternalException

renameBucket

@Nonnull
public String renameBucket(@Nonnull
                                   String oldName,
                                   @Nonnull
                                   String newName,
                                   boolean findFreeName)
                    throws org.dasein.cloud.CloudException,
                           org.dasein.cloud.InternalException

Throws:

org.dasein.cloud.CloudException

org.dasein.cloud.InternalException

renameObject

public void renameObject(@Nullable
                         String bucket,
                         @Nonnull
                         String object,
                         @Nonnull
                         String newName)
                  throws org.dasein.cloud.CloudException,
                         org.dasein.cloud.InternalException

Throws:

org.dasein.cloud.CloudException

org.dasein.cloud.InternalException

upload

@Nonnull
public org.dasein.cloud.storage.Blob upload(@Nonnull
                                                    File source,
                                                    @Nullable
                                                    String bucket,
                                                    @Nonnull
                                                    String fileName)
                                     throws org.dasein.cloud.CloudException,
                                            org.dasein.cloud.InternalException

Throws:

org.dasein.cloud.CloudException

org.dasein.cloud.InternalException

getBucketNameRules

@Nonnull
public org.dasein.cloud.util.NamingConstraints getBucketNameRules()
                                                           throws org.dasein.cloud.CloudException,
                                                                  org.dasein.cloud.InternalException

Throws:

org.dasein.cloud.CloudException

org.dasein.cloud.InternalException

getObjectNameRules

@Nonnull
public org.dasein.cloud.util.NamingConstraints getObjectNameRules()
                                                           throws org.dasein.cloud.CloudException,
                                                                  org.dasein.cloud.InternalException

Throws:

org.dasein.cloud.CloudException

org.dasein.cloud.InternalException