org.apache.jackrabbit.aws.ext.ds

Class S3Backend

java.lang.Object

org.apache.jackrabbit.aws.ext.ds.S3Backend

All Implemented Interfaces:

org.apache.jackrabbit.core.data.Backend

public class S3Backend
extends Object
implements org.apache.jackrabbit.core.data.Backend

A data store backend that stores data on Amazon S3.

Constructor Summary

Constructors

Constructor and Description
S3Backend()

Method Summary

Methods

Modifier and Type	Method and Description
void	close()
Set<org.apache.jackrabbit.core.data.DataIdentifier>	deleteAllOlderThan(long min)
void	deleteRecord(org.apache.jackrabbit.core.data.DataIdentifier identifier)
boolean	exists(org.apache.jackrabbit.core.data.DataIdentifier identifier) Check if record identified by identifier exists in Amazon S3.
boolean	exists(org.apache.jackrabbit.core.data.DataIdentifier identifier, boolean touch)
Iterator<org.apache.jackrabbit.core.data.DataIdentifier>	getAllIdentifiers()
String	getBucket()
long	getLastModified(org.apache.jackrabbit.core.data.DataIdentifier identifier)
long	getLength(org.apache.jackrabbit.core.data.DataIdentifier identifier)
void	init(org.apache.jackrabbit.core.data.CachingDataStore store, String homeDir, Properties prop)
void	init(org.apache.jackrabbit.core.data.CachingDataStore store, String homeDir, String config) Initialize S3Backend.
InputStream	read(org.apache.jackrabbit.core.data.DataIdentifier identifier)
void	setBucket(String bucket)
void	setProperties(Properties properties) Properties used to configure the backend.
void	write(org.apache.jackrabbit.core.data.DataIdentifier identifier, File file) It uploads file to Amazon S3.
void	writeAsync(org.apache.jackrabbit.core.data.DataIdentifier identifier, File file, org.apache.jackrabbit.core.data.AsyncUploadCallback callback)

Methods inherited from class java.lang.Object

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

Constructor Detail

S3Backend

public S3Backend()

Method Detail

init

public void init(org.apache.jackrabbit.core.data.CachingDataStore store,
        String homeDir,
        String config)
          throws org.apache.jackrabbit.core.data.DataStoreException

Initialize S3Backend. It creates AmazonS3Client and TransferManager from aws.properties. It creates S3 bucket if it doesn't pre-exist in S3.

Specified by:

init in interface org.apache.jackrabbit.core.data.Backend

Throws:

org.apache.jackrabbit.core.data.DataStoreException

init

public void init(org.apache.jackrabbit.core.data.CachingDataStore store,
        String homeDir,
        Properties prop)
          throws org.apache.jackrabbit.core.data.DataStoreException

Throws:

org.apache.jackrabbit.core.data.DataStoreException

write

public void write(org.apache.jackrabbit.core.data.DataIdentifier identifier,
         File file)
           throws org.apache.jackrabbit.core.data.DataStoreException

It uploads file to Amazon S3. If file size is greater than 5MB, this method uses parallel concurrent connections to upload.

Specified by:

write in interface org.apache.jackrabbit.core.data.Backend

Throws:

org.apache.jackrabbit.core.data.DataStoreException

writeAsync

public void writeAsync(org.apache.jackrabbit.core.data.DataIdentifier identifier,
              File file,
              org.apache.jackrabbit.core.data.AsyncUploadCallback callback)
                throws org.apache.jackrabbit.core.data.DataStoreException

Specified by:

writeAsync in interface org.apache.jackrabbit.core.data.Backend

Throws:

org.apache.jackrabbit.core.data.DataStoreException

exists

public boolean exists(org.apache.jackrabbit.core.data.DataIdentifier identifier)
               throws org.apache.jackrabbit.core.data.DataStoreException

Check if record identified by identifier exists in Amazon S3.

Specified by:

exists in interface org.apache.jackrabbit.core.data.Backend

Throws:

org.apache.jackrabbit.core.data.DataStoreException

exists

public boolean exists(org.apache.jackrabbit.core.data.DataIdentifier identifier,
             boolean touch)
               throws org.apache.jackrabbit.core.data.DataStoreException

Specified by:

exists in interface org.apache.jackrabbit.core.data.Backend

Throws:

org.apache.jackrabbit.core.data.DataStoreException

read

public InputStream read(org.apache.jackrabbit.core.data.DataIdentifier identifier)
                 throws org.apache.jackrabbit.core.data.DataStoreException

Specified by:

read in interface org.apache.jackrabbit.core.data.Backend

Throws:

org.apache.jackrabbit.core.data.DataStoreException

getAllIdentifiers

public Iterator<org.apache.jackrabbit.core.data.DataIdentifier> getAllIdentifiers()
                                                                           throws org.apache.jackrabbit.core.data.DataStoreException

Specified by:

getAllIdentifiers in interface org.apache.jackrabbit.core.data.Backend

Throws:

org.apache.jackrabbit.core.data.DataStoreException

getLastModified

public long getLastModified(org.apache.jackrabbit.core.data.DataIdentifier identifier)
                     throws org.apache.jackrabbit.core.data.DataStoreException

Specified by:

getLastModified in interface org.apache.jackrabbit.core.data.Backend

Throws:

org.apache.jackrabbit.core.data.DataStoreException

getLength

public long getLength(org.apache.jackrabbit.core.data.DataIdentifier identifier)
               throws org.apache.jackrabbit.core.data.DataStoreException

Specified by:

getLength in interface org.apache.jackrabbit.core.data.Backend

Throws:

org.apache.jackrabbit.core.data.DataStoreException

deleteRecord

public void deleteRecord(org.apache.jackrabbit.core.data.DataIdentifier identifier)
                  throws org.apache.jackrabbit.core.data.DataStoreException

Specified by:

deleteRecord in interface org.apache.jackrabbit.core.data.Backend

Throws:

org.apache.jackrabbit.core.data.DataStoreException

deleteAllOlderThan

public Set<org.apache.jackrabbit.core.data.DataIdentifier> deleteAllOlderThan(long min)
                                                                       throws org.apache.jackrabbit.core.data.DataStoreException

Specified by:

deleteAllOlderThan in interface org.apache.jackrabbit.core.data.Backend

Throws:

org.apache.jackrabbit.core.data.DataStoreException

close

public void close()

Specified by:

close in interface org.apache.jackrabbit.core.data.Backend

getBucket

public String getBucket()

setBucket

public void setBucket(String bucket)

setProperties

public void setProperties(Properties properties)

Properties used to configure the backend. If provided explicitly before init is invoked then these take precedence

Parameters:

properties - to configure S3Backend