org.apache.jackrabbit.oak.plugins.blob

Class AbstractSharedCachingDataStore

java.lang.Object

org.apache.jackrabbit.core.data.AbstractDataStore

org.apache.jackrabbit.oak.plugins.blob.AbstractSharedCachingDataStore

All Implemented Interfaces:

org.apache.jackrabbit.core.data.DataStore, org.apache.jackrabbit.core.data.MultiDataStoreAware, TypedDataStore, SharedDataStore

Direct Known Subclasses:

CachingFileDataStore

public abstract class AbstractSharedCachingDataStore
extends org.apache.jackrabbit.core.data.AbstractDataStore
implements org.apache.jackrabbit.core.data.MultiDataStoreAware, SharedDataStore, TypedDataStore

Cache files locally and stage files locally for async uploads. Configuration:

 <DataStore class="org.apache.jackrabbit.oak.plugins.blob.AbstractCachingDataStore">
     <param name="path"/>
     <param name="cacheSize" value="68719476736"/>
     <param name="stagingSplitPercentage" value="10"/>
     <param name="uploadThreads" value="10"/>
     <param name="stagingPurgeInterval" value="300"/>
     <param name="stagingRetryInterval " value="600"/>
 </DataStore>
 

Nested Class Summary

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 org.apache.jackrabbit.oak.spi.blob.AbstractSharedBackend	backend The delegate backend
protected ExecutorService	executor
protected com.google.common.util.concurrent.ListeningExecutorService	listeningExecutor
protected ScheduledExecutorService	schedulerExecutor

Fields inherited from class org.apache.jackrabbit.core.data.AbstractDataStore

DIGEST

Constructor Summary

Constructors

Constructor and Description
AbstractSharedCachingDataStore()

Method Summary

Modifier and Type	Method and Description
void	addMetadataRecord(File f, String name) Adds the root record.
void	addMetadataRecord(InputStream stream, String name) ------------------------ SharedDataStore methods -----------------------------------------
org.apache.jackrabbit.core.data.DataRecord	addRecord(InputStream inputStream)
org.apache.jackrabbit.core.data.DataRecord	addRecord(InputStream inputStream, org.apache.jackrabbit.oak.spi.blob.BlobOptions blobOptions) Add a record with specified options.
void	clearInUse() ------------------------ unimplemented methods -------------------------------------------
void	close()
protected abstract org.apache.jackrabbit.oak.spi.blob.AbstractSharedBackend	createBackend()
void	deleteAllMetadataRecords(String prefix) Deletes all records matching the given prefix.
int	deleteAllOlderThan(long l)
boolean	deleteMetadataRecord(String name) Deletes the root record represented by the given parameters.
void	deleteRecord(org.apache.jackrabbit.core.data.DataIdentifier dataIdentifier)
boolean	exists(org.apache.jackrabbit.core.data.DataIdentifier identifier) Look in the backend for a record matching the given identifier.
Iterator<org.apache.jackrabbit.core.data.DataIdentifier>	getAllIdentifiers() In rare cases may include some duplicates in cases where async staged uploads complete during iteration.
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.
protected CompositeDataStoreCache	getCache()
org.apache.jackrabbit.core.data.DataRecord	getMetadataRecord(String name) Retrieves the metadata record with the given name
protected byte[]	getOrCreateReferenceKey()
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
@Nullable org.apache.jackrabbit.core.data.DataRecord	getRecordIfStored(org.apache.jackrabbit.core.data.DataIdentifier dataIdentifier)
List<DataStoreCacheStatsMBean>	getStats()
SharedDataStore.Type	getType() Gets the type.
void	init(String homeDir)
void	setCacheSize(long cacheSize)
void	setPath(String path) ------------------------- setters ----------------------------------------------
void	setStagingPurgeInterval(int stagingPurgeInterval)
void	setStagingRetryInterval(int stagingRetryInterval)
void	setStagingSplitPercentage(int stagingSplitPercentage)
void	setStatisticsProvider(org.apache.jackrabbit.oak.stats.StatisticsProvider statisticsProvider)
void	setUploadThreads(int uploadThreads)
void	updateModifiedDateOnAccess(long l)

Methods inherited from class org.apache.jackrabbit.core.data.AbstractDataStore

encodeHexString, getRecordFromReference, getReferenceFromIdentifier

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.jackrabbit.core.data.DataStore

getMinRecordLength

Field Detail

backend

protected org.apache.jackrabbit.oak.spi.blob.AbstractSharedBackend backend

The delegate backend

listeningExecutor

protected com.google.common.util.concurrent.ListeningExecutorService listeningExecutor

schedulerExecutor

protected ScheduledExecutorService schedulerExecutor

executor

protected ExecutorService executor

Constructor Detail

AbstractSharedCachingDataStore

public AbstractSharedCachingDataStore()

Method Detail

init

public void init(String homeDir)
          throws org.apache.jackrabbit.core.data.DataStoreException

Specified by:

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

Throws:

org.apache.jackrabbit.core.data.DataStoreException

createBackend

protected abstract org.apache.jackrabbit.oak.spi.blob.AbstractSharedBackend createBackend()

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

Overrides:

getRecord in class org.apache.jackrabbit.core.data.AbstractDataStore

Throws:

org.apache.jackrabbit.core.data.DataStoreException

getRecordIfStored

@Nullable
public @Nullable org.apache.jackrabbit.core.data.DataRecord getRecordIfStored(org.apache.jackrabbit.core.data.DataIdentifier dataIdentifier)
                                                                                 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

addRecord

public org.apache.jackrabbit.core.data.DataRecord addRecord(InputStream inputStream)
                                                     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

addRecord

public org.apache.jackrabbit.core.data.DataRecord addRecord(InputStream inputStream,
                                                            org.apache.jackrabbit.oak.spi.blob.BlobOptions blobOptions)
                                                     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

getAllIdentifiers

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

In rare cases may include some duplicates in cases where async staged uploads complete during iteration.

Specified by:

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

Returns:

Iterator over all ids available

Throws:

org.apache.jackrabbit.core.data.DataStoreException

deleteRecord

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

Specified by:

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

Throws:

org.apache.jackrabbit.core.data.DataStoreException

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

exists

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

Look in the backend for a record matching the given identifier. Returns true if such a record exists.

Parameters:

identifier - - An identifier for the record.

Returns:

true if a record for the provided identifier can be found.

getStats

public List<DataStoreCacheStatsMBean> getStats()

getCache

protected CompositeDataStoreCache getCache()

setPath

public void setPath(String path)

------------------------- setters ----------------------------------------------

setCacheSize

public void setCacheSize(long cacheSize)

setStagingSplitPercentage

public void setStagingSplitPercentage(int stagingSplitPercentage)

setUploadThreads

public void setUploadThreads(int uploadThreads)

setStagingPurgeInterval

public void setStagingPurgeInterval(int stagingPurgeInterval)

setStagingRetryInterval

public void setStagingRetryInterval(int stagingRetryInterval)

setStatisticsProvider

public void setStatisticsProvider(org.apache.jackrabbit.oak.stats.StatisticsProvider statisticsProvider)

addMetadataRecord

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

------------------------ SharedDataStore methods -----------------------------------------

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

getOrCreateReferenceKey

protected byte[] getOrCreateReferenceKey()
                                  throws org.apache.jackrabbit.core.data.DataStoreException

Overrides:

getOrCreateReferenceKey in class org.apache.jackrabbit.core.data.AbstractDataStore

Throws:

org.apache.jackrabbit.core.data.DataStoreException

clearInUse

public void clearInUse()

------------------------ unimplemented methods -------------------------------------------

Specified by:

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

updateModifiedDateOnAccess

public void updateModifiedDateOnAccess(long l)

Specified by:

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

deleteAllOlderThan

public int deleteAllOlderThan(long l)
                       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