org.apache.jackrabbit.oak.plugins.blob.datastore

Class DataStoreBlobStore

java.lang.Object

org.apache.jackrabbit.oak.plugins.blob.datastore.DataStoreBlobStore

All Implemented Interfaces:

org.apache.jackrabbit.core.data.DataStore, org.apache.jackrabbit.oak.api.blob.BlobAccessProvider, BlobTrackingStore, TypedDataStore, SharedDataStore, org.apache.jackrabbit.oak.spi.blob.BlobStore, org.apache.jackrabbit.oak.spi.blob.GarbageCollectableBlobStore

public class DataStoreBlobStore
extends Object
implements org.apache.jackrabbit.core.data.DataStore, org.apache.jackrabbit.oak.spi.blob.BlobStore, org.apache.jackrabbit.oak.spi.blob.GarbageCollectableBlobStore, BlobTrackingStore, TypedDataStore, org.apache.jackrabbit.oak.api.blob.BlobAccessProvider

BlobStore wrapper for DataStore. Wraps Jackrabbit 2 DataStore and expose them as BlobStores It also handles inlining binaries if there size is smaller than DataStore.getMinRecordLength()

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DataStoreBlobStore.BlobId

Nested classes/interfaces inherited from interface org.apache.jackrabbit.oak.plugins.blob.SharedDataStore

SharedDataStore.Type

Field Summary

Fields

Modifier and Type	Field and Description
protected com.google.common.cache.LoadingCache<String,byte[]>	cache
static int	DEFAULT_CACHE_SIZE
protected org.apache.jackrabbit.core.data.DataStore	delegate
static String	MEM_CACHE_NAME
protected org.apache.jackrabbit.oak.spi.blob.stats.BlobStatsCollector	stats

Constructor Summary

Constructors

Constructor and Description
DataStoreBlobStore(org.apache.jackrabbit.core.data.DataStore delegate)
DataStoreBlobStore(org.apache.jackrabbit.core.data.DataStore delegate, boolean encodeLengthInId)
DataStoreBlobStore(org.apache.jackrabbit.core.data.DataStore delegate, boolean encodeLengthInId, int cacheSizeInMB)

Method Summary

Modifier and Type	Method and Description
void	addMetadataRecord(File f, String name) Adds the root record.
void	addMetadataRecord(InputStream stream, String name) Adds the root record.
org.apache.jackrabbit.core.data.DataRecord	addRecord(InputStream stream)
org.apache.jackrabbit.core.data.DataRecord	addRecord(InputStream input, org.apache.jackrabbit.oak.spi.blob.BlobOptions options) Add a record with specified options.
void	addTracker(BlobTracker tracker) Registers a tracker in the data store.
void	clearCache()
void	clearInUse()
void	close()
@Nullable org.apache.jackrabbit.oak.api.Blob	completeBlobUpload(@NotNull String uploadToken)
long	countDeleteChunks(List<String> chunkIds, long maxLastModifiedTime)
void	deleteAllMetadataRecords(String prefix) Deletes all records matching the given prefix.
int	deleteAllOlderThan(long min)
boolean	deleteChunks(List<String> chunkIds, long maxLastModifiedTime)
boolean	deleteMetadataRecord(String name) Deletes the root record represented by the given parameters.
protected String	extractBlobId(String encodedBlobId)
Iterator<String>	getAllChunkIds(long maxLastModifiedTime)
Iterator<org.apache.jackrabbit.core.data.DataIdentifier>	getAllIdentifiers()
List<org.apache.jackrabbit.core.data.DataRecord>	getAllMetadataRecords(String prefix) Gets the all root records.
Iterator<org.apache.jackrabbit.core.data.DataRecord>	getAllRecords() Retrieved an iterator over all DataRecords.
String	getBlobId(@NotNull String reference)
long	getBlobLength(String encodedBlobId)
long	getBlockSizeMin()
org.apache.jackrabbit.oak.cache.CacheStats	getCacheStats()
protected org.apache.jackrabbit.core.data.DataRecord	getDataRecord(String blobId)
org.apache.jackrabbit.core.data.DataStore	getDataStore()
@Nullable URI	getDownloadURI(@NotNull org.apache.jackrabbit.oak.api.Blob blob, @NotNull org.apache.jackrabbit.oak.api.blob.BlobDownloadOptions downloadOptions)
InputStream	getInputStream(String encodedBlobId)
org.apache.jackrabbit.core.data.DataRecord	getMetadataRecord(String name) Retrieves the metadata record with the given name
int	getMinRecordLength()
org.apache.jackrabbit.core.data.DataRecord	getRecord(org.apache.jackrabbit.core.data.DataIdentifier identifier)
org.apache.jackrabbit.core.data.DataRecord	getRecordForId(org.apache.jackrabbit.core.data.DataIdentifier identifier) Retrieves the record for the given identifier
org.apache.jackrabbit.core.data.DataRecord	getRecordFromReference(String reference)
org.apache.jackrabbit.core.data.DataRecord	getRecordIfStored(org.apache.jackrabbit.core.data.DataIdentifier identifier)
String	getReference(@NotNull String encodedBlobId)
protected InputStream	getStream(String blobId)
@Nullable BlobTracker	getTracker() Gets the traker registered in the data store.
SharedDataStore.Type	getType() Gets the type.
void	init(String homeDir)
@Nullable org.apache.jackrabbit.oak.api.blob.BlobUpload	initiateBlobUpload(long maxUploadSizeInBytes, int maxNumberOfURIs)
int	readBlob(String encodedBlobId, long pos, byte[] buff, int off, int length)
Iterator<String>	resolveChunks(String blobId)
void	setBlobStatsCollector(org.apache.jackrabbit.oak.spi.blob.stats.BlobStatsCollector stats)
void	setBlockSize(int x)
void	setMaxCachedBinarySize(int maxCachedBinarySize)
void	startMark()
int	sweep()
String	toString()
void	updateModifiedDateOnAccess(long before)
String	writeBlob(InputStream stream)
String	writeBlob(InputStream stream, org.apache.jackrabbit.oak.spi.blob.BlobOptions options)
String	writeBlob(String tempFileName)

Methods inherited from class java.lang.Object

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

Field Detail

delegate

protected final org.apache.jackrabbit.core.data.DataStore delegate

stats

protected org.apache.jackrabbit.oak.spi.blob.stats.BlobStatsCollector stats

cache

protected final com.google.common.cache.LoadingCache<String,byte[]> cache

DEFAULT_CACHE_SIZE

public static final int DEFAULT_CACHE_SIZE

See Also:

Constant Field Values

MEM_CACHE_NAME

public static final String MEM_CACHE_NAME

See Also:

Constant Field Values

Constructor Detail

DataStoreBlobStore

public DataStoreBlobStore(org.apache.jackrabbit.core.data.DataStore delegate)

DataStoreBlobStore

public DataStoreBlobStore(org.apache.jackrabbit.core.data.DataStore delegate,
                          boolean encodeLengthInId)

DataStoreBlobStore

public DataStoreBlobStore(org.apache.jackrabbit.core.data.DataStore delegate,
                          boolean encodeLengthInId,
                          int cacheSizeInMB)

Method Detail

getRecordIfStored

public org.apache.jackrabbit.core.data.DataRecord getRecordIfStored(org.apache.jackrabbit.core.data.DataIdentifier identifier)
                                                             throws org.apache.jackrabbit.core.data.DataStoreException

Specified by:

getRecordIfStored in interface org.apache.jackrabbit.core.data.DataStore

Throws:

org.apache.jackrabbit.core.data.DataStoreException

getRecord

public org.apache.jackrabbit.core.data.DataRecord getRecord(org.apache.jackrabbit.core.data.DataIdentifier identifier)
                                                     throws org.apache.jackrabbit.core.data.DataStoreException

Specified by:

getRecord in interface org.apache.jackrabbit.core.data.DataStore

Throws:

org.apache.jackrabbit.core.data.DataStoreException

getRecordFromReference

public org.apache.jackrabbit.core.data.DataRecord getRecordFromReference(String reference)
                                                                  throws org.apache.jackrabbit.core.data.DataStoreException

Specified by:

getRecordFromReference in interface org.apache.jackrabbit.core.data.DataStore

Throws:

org.apache.jackrabbit.core.data.DataStoreException

addRecord

public org.apache.jackrabbit.core.data.DataRecord addRecord(InputStream stream)
                                                     throws org.apache.jackrabbit.core.data.DataStoreException

Specified by:

addRecord in interface org.apache.jackrabbit.core.data.DataStore

Throws:

org.apache.jackrabbit.core.data.DataStoreException

updateModifiedDateOnAccess

public void updateModifiedDateOnAccess(long before)

Specified by:

updateModifiedDateOnAccess in interface org.apache.jackrabbit.core.data.DataStore

deleteAllOlderThan

public int deleteAllOlderThan(long min)
                       throws org.apache.jackrabbit.core.data.DataStoreException

Specified by:

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

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.DataStore

Throws:

org.apache.jackrabbit.core.data.DataStoreException

init

public void init(String homeDir)
          throws javax.jcr.RepositoryException

Specified by:

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

Throws:

javax.jcr.RepositoryException

getMinRecordLength

public int getMinRecordLength()

Specified by:

getMinRecordLength in interface org.apache.jackrabbit.core.data.DataStore

close

public void close()
           throws org.apache.jackrabbit.core.data.DataStoreException

Specified by:

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

Throws:

org.apache.jackrabbit.core.data.DataStoreException

writeBlob

public String writeBlob(InputStream stream)
                 throws IOException

Specified by:

writeBlob in interface org.apache.jackrabbit.oak.spi.blob.BlobStore

Throws:

IOException

writeBlob

public String writeBlob(InputStream stream,
                        org.apache.jackrabbit.oak.spi.blob.BlobOptions options)
                 throws IOException

Specified by:

writeBlob in interface org.apache.jackrabbit.oak.spi.blob.BlobStore

Throws:

IOException

readBlob

public int readBlob(String encodedBlobId,
                    long pos,
                    byte[] buff,
                    int off,
                    int length)
             throws IOException

Specified by:

readBlob in interface org.apache.jackrabbit.oak.spi.blob.BlobStore

Throws:

IOException

getBlobLength

public long getBlobLength(String encodedBlobId)
                   throws IOException

Specified by:

getBlobLength in interface org.apache.jackrabbit.oak.spi.blob.BlobStore

Throws:

IOException

getBlobId

public String getBlobId(@NotNull
                        @NotNull String reference)

Specified by:

getBlobId in interface org.apache.jackrabbit.oak.spi.blob.BlobStore

getReference

public String getReference(@NotNull
                           @NotNull String encodedBlobId)

Specified by:

getReference in interface org.apache.jackrabbit.oak.spi.blob.BlobStore

getInputStream

public InputStream getInputStream(String encodedBlobId)
                           throws IOException

Specified by:

getInputStream in interface org.apache.jackrabbit.oak.spi.blob.BlobStore

Throws:

IOException

setBlockSize

public void setBlockSize(int x)

Specified by:

setBlockSize in interface org.apache.jackrabbit.oak.spi.blob.GarbageCollectableBlobStore

writeBlob

public String writeBlob(String tempFileName)
                 throws IOException

Specified by:

writeBlob in interface org.apache.jackrabbit.oak.spi.blob.GarbageCollectableBlobStore

Throws:

IOException

sweep

public int sweep()
          throws IOException

Specified by:

sweep in interface org.apache.jackrabbit.oak.spi.blob.GarbageCollectableBlobStore

Throws:

IOException

startMark

public void startMark()
               throws IOException

Specified by:

startMark in interface org.apache.jackrabbit.oak.spi.blob.GarbageCollectableBlobStore

Throws:

IOException

clearInUse

public void clearInUse()

Specified by:

clearInUse in interface org.apache.jackrabbit.core.data.DataStore

Specified by:

clearInUse in interface org.apache.jackrabbit.oak.spi.blob.GarbageCollectableBlobStore

clearCache

public void clearCache()

Specified by:

clearCache in interface org.apache.jackrabbit.oak.spi.blob.GarbageCollectableBlobStore

getBlockSizeMin

public long getBlockSizeMin()

Specified by:

getBlockSizeMin in interface org.apache.jackrabbit.oak.spi.blob.GarbageCollectableBlobStore

getAllChunkIds

public Iterator<String> getAllChunkIds(long maxLastModifiedTime)
                                throws Exception

Specified by:

getAllChunkIds in interface org.apache.jackrabbit.oak.spi.blob.GarbageCollectableBlobStore

Throws:

Exception

deleteChunks

public boolean deleteChunks(List<String> chunkIds,
                            long maxLastModifiedTime)
                     throws Exception

Specified by:

deleteChunks in interface org.apache.jackrabbit.oak.spi.blob.GarbageCollectableBlobStore

Throws:

Exception

countDeleteChunks

public long countDeleteChunks(List<String> chunkIds,
                              long maxLastModifiedTime)
                       throws Exception

Specified by:

countDeleteChunks in interface org.apache.jackrabbit.oak.spi.blob.GarbageCollectableBlobStore

Throws:

Exception

resolveChunks

public Iterator<String> resolveChunks(String blobId)
                               throws IOException

Specified by:

resolveChunks in interface org.apache.jackrabbit.oak.spi.blob.GarbageCollectableBlobStore

Throws:

IOException

addMetadataRecord

public void addMetadataRecord(InputStream stream,
                              String name)
                       throws org.apache.jackrabbit.core.data.DataStoreException

Description copied from interface: SharedDataStore

Adds the root record.

Specified by:

addMetadataRecord in interface SharedDataStore

Parameters:

stream - the stream

name - the name of the root record

Throws:

org.apache.jackrabbit.core.data.DataStoreException - the data store exception

addMetadataRecord

public void addMetadataRecord(File f,
                              String name)
                       throws org.apache.jackrabbit.core.data.DataStoreException

Description copied from interface: SharedDataStore

Adds the root record.

Specified by:

addMetadataRecord in interface SharedDataStore

Parameters:

f - the file

name - the name of the root record

Throws:

org.apache.jackrabbit.core.data.DataStoreException - the data store exception

getMetadataRecord

public org.apache.jackrabbit.core.data.DataRecord getMetadataRecord(String name)

Description copied from interface: SharedDataStore

Retrieves the metadata record with the given name

Specified by:

getMetadataRecord in interface SharedDataStore

Parameters:

name - the name of the record

Returns:

getAllMetadataRecords

public List<org.apache.jackrabbit.core.data.DataRecord> getAllMetadataRecords(String prefix)

Description copied from interface: SharedDataStore

Gets the all root records.

Specified by:

getAllMetadataRecords in interface SharedDataStore

Returns:

the all root records

deleteMetadataRecord

public boolean deleteMetadataRecord(String name)

Description copied from interface: SharedDataStore

Deletes the root record represented by the given parameters.

Specified by:

deleteMetadataRecord in interface SharedDataStore

Parameters:

name - the name of the root record

Returns:

success/failure

deleteAllMetadataRecords

public void deleteAllMetadataRecords(String prefix)

Description copied from interface: SharedDataStore

Deletes all records matching the given prefix.

Specified by:

deleteAllMetadataRecords in interface SharedDataStore

Parameters:

prefix - metadata type identifier

getAllRecords

public Iterator<org.apache.jackrabbit.core.data.DataRecord> getAllRecords()
                                                                   throws org.apache.jackrabbit.core.data.DataStoreException

Description copied from interface: SharedDataStore

Retrieved an iterator over all DataRecords.

Specified by:

getAllRecords in interface SharedDataStore

Returns:

iterator over DataRecords

Throws:

org.apache.jackrabbit.core.data.DataStoreException

getRecordForId

public org.apache.jackrabbit.core.data.DataRecord getRecordForId(org.apache.jackrabbit.core.data.DataIdentifier identifier)
                                                          throws org.apache.jackrabbit.core.data.DataStoreException

Description copied from interface: SharedDataStore

Retrieves the record for the given identifier

Specified by:

getRecordForId in interface SharedDataStore

Parameters:

identifier - the if of the record

Returns:

data record

Throws:

org.apache.jackrabbit.core.data.DataStoreException

getType

public SharedDataStore.Type getType()

Description copied from interface: SharedDataStore

Gets the type.

Specified by:

getType in interface SharedDataStore

Returns:

the type

addRecord

public org.apache.jackrabbit.core.data.DataRecord addRecord(InputStream input,
                                                            org.apache.jackrabbit.oak.spi.blob.BlobOptions options)
                                                     throws org.apache.jackrabbit.core.data.DataStoreException

Description copied from interface: TypedDataStore

Add a record with specified options.

Specified by:

addRecord in interface TypedDataStore

Returns:

Throws:

org.apache.jackrabbit.core.data.DataStoreException

toString

public String toString()

Overrides:

toString in class Object

getDataStore

public org.apache.jackrabbit.core.data.DataStore getDataStore()

getCacheStats

public org.apache.jackrabbit.oak.cache.CacheStats getCacheStats()

setMaxCachedBinarySize

public void setMaxCachedBinarySize(int maxCachedBinarySize)

setBlobStatsCollector

public void setBlobStatsCollector(org.apache.jackrabbit.oak.spi.blob.stats.BlobStatsCollector stats)

addTracker

public void addTracker(BlobTracker tracker)

Description copied from interface: BlobTrackingStore

Registers a tracker in the data store.

Specified by:

addTracker in interface BlobTrackingStore

getTracker

@Nullable
public @Nullable BlobTracker getTracker()

Description copied from interface: BlobTrackingStore

Gets the traker registered in the data store.

Specified by:

getTracker in interface BlobTrackingStore

Returns:

tracker

getStream

protected InputStream getStream(String blobId)
                         throws IOException

Throws:

IOException

getDataRecord

protected org.apache.jackrabbit.core.data.DataRecord getDataRecord(String blobId)
                                                            throws org.apache.jackrabbit.core.data.DataStoreException

Throws:

org.apache.jackrabbit.core.data.DataStoreException

extractBlobId

protected String extractBlobId(String encodedBlobId)

initiateBlobUpload

@Nullable
public @Nullable org.apache.jackrabbit.oak.api.blob.BlobUpload initiateBlobUpload(long maxUploadSizeInBytes,
                                                                                            int maxNumberOfURIs)
                                                                                     throws IllegalArgumentException

Specified by:

initiateBlobUpload in interface org.apache.jackrabbit.oak.api.blob.BlobAccessProvider

Throws:

IllegalArgumentException

completeBlobUpload

@Nullable
public @Nullable org.apache.jackrabbit.oak.api.Blob completeBlobUpload(@NotNull
                                                                                 @NotNull String uploadToken)
                                                                          throws IllegalArgumentException

Specified by:

completeBlobUpload in interface org.apache.jackrabbit.oak.api.blob.BlobAccessProvider

Throws:

IllegalArgumentException

getDownloadURI

@Nullable
public @Nullable URI getDownloadURI(@NotNull
                                              @NotNull org.apache.jackrabbit.oak.api.Blob blob,
                                              @NotNull
                                              @NotNull org.apache.jackrabbit.oak.api.blob.BlobDownloadOptions downloadOptions)

Specified by:

getDownloadURI in interface org.apache.jackrabbit.oak.api.blob.BlobAccessProvider