org.apache.jackrabbit.oak.plugins.index.lucene

Class IndexCopier

java.lang.Object

org.apache.jackrabbit.oak.plugins.index.lucene.IndexCopier

All Implemented Interfaces:

Closeable, AutoCloseable, CopyOnReadStatsMBean

public class IndexCopier
extends Object
implements CopyOnReadStatsMBean, Closeable

Copies index files to/from the local disk and the datastore.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	IndexCopier.COWDirectoryTracker

Field Summary

Fields

Modifier and Type	Field and Description
static Set<String>	REMOTE_ONLY

Fields inherited from interface org.apache.jackrabbit.oak.plugins.index.lucene.CopyOnReadStatsMBean

TYPE

Constructor Summary

Constructors

Constructor and Description
IndexCopier(Executor executor, File indexRootDir)
IndexCopier(Executor executor, File indexRootDir, boolean prefetchEnabled)

Method Summary

Modifier and Type	Method and Description
void	close()
void	copyDone()
boolean	deleteFile(Directory dir, String fileName, boolean copiedFromRemote)
void	doneCopy(org.apache.jackrabbit.oak.plugins.index.lucene.directory.LocalIndexFile file, long start)
void	foundInvalidFile()
int	getCopyInProgressCount()
String[]	getCopyInProgressDetails()
String	getCopyInProgressSize()
int	getDeletedFilesCount()
int	getDownloadCount()
String	getDownloadSize()
long	getDownloadTime()
String	getGarbageCollectedSize()
String[]	getGarbageDetails()
String	getGarbageSize()
File	getIndexDir(org.apache.jackrabbit.oak.plugins.index.search.IndexDefinition definition, String indexPath, String dirName)
TabularData	getIndexPathMapping()
int	getInvalidFileCount()
long	getLocalIndexDirSize()
String	getLocalIndexSize()
int	getMaxCopyInProgressCount()
int	getMaxScheduledForCopyCount()
static long	getNewestLocalFSTimestampFor(Set<String> names, Directory localDir) This method would return the latest modification timestamp from the set of filenames on the file system.
int	getReaderLocalReadCount()
int	getReaderRemoteReadCount()
int	getScheduledForCopyCount()
String	getSkippedFromUploadSize()
int	getUploadCount()
String	getUploadSize()
long	getUploadTime()
int	getWriterLocalReadCount()
int	getWriterRemoteReadCount()
boolean	isClosed()
boolean	isCopyInProgress(org.apache.jackrabbit.oak.plugins.index.lucene.directory.LocalIndexFile file)
static boolean	isFileModifiedBefore(String name, Directory localDir, long millis)
boolean	isPrefetchEnabled()
void	readFromLocal(boolean reader)
void	readFromRemote(boolean reader)
void	scheduledForCopy()
void	skippedUpload(long skippedFilesSize)
long	startCopy(org.apache.jackrabbit.oak.plugins.index.lucene.directory.LocalIndexFile file)
void	waitForCopyCompletion(org.apache.jackrabbit.oak.plugins.index.lucene.directory.LocalIndexFile file, long timeoutMillis) Waits for maximum of timeoutMillis while checking if file isn't being copied already.
Directory	wrapForRead(String indexPath, LuceneIndexDefinition definition, Directory remote, String dirName)
Directory	wrapForWrite(LuceneIndexDefinition definition, Directory remote, boolean reindexMode, String dirName, IndexCopier.COWDirectoryTracker cowDirectoryTracker)

Methods inherited from class java.lang.Object

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

Field Detail

REMOTE_ONLY

public static final Set<String> REMOTE_ONLY

Constructor Detail

IndexCopier

public IndexCopier(Executor executor,
                   File indexRootDir)
            throws IOException

Throws:

IOException

IndexCopier

public IndexCopier(Executor executor,
                   File indexRootDir,
                   boolean prefetchEnabled)
            throws IOException

Throws:

IOException

Method Detail

wrapForRead

public Directory wrapForRead(String indexPath,
                             LuceneIndexDefinition definition,
                             Directory remote,
                             String dirName)
                      throws IOException

Throws:

IOException

wrapForWrite

public Directory wrapForWrite(LuceneIndexDefinition definition,
                              Directory remote,
                              boolean reindexMode,
                              String dirName,
                              IndexCopier.COWDirectoryTracker cowDirectoryTracker)
                       throws IOException

Throws:

IOException

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException

isClosed

public boolean isClosed()

getIndexDir

public File getIndexDir(org.apache.jackrabbit.oak.plugins.index.search.IndexDefinition definition,
                        String indexPath,
                        String dirName)
                 throws IOException

Throws:

IOException

deleteFile

public boolean deleteFile(Directory dir,
                          String fileName,
                          boolean copiedFromRemote)

getNewestLocalFSTimestampFor

public static long getNewestLocalFSTimestampFor(Set<String> names,
                                                Directory localDir)

This method would return the latest modification timestamp from the set of filenames on the file system. The parameter localDir is expected to be an instance of FSDirectory (or wrapped one in FilterDirectory. If this assumption doesn't hold, the method would return -1. Each of file names are expected to be existing in localDir. If this fails the method shall return -1. In case of any error while computing modified timestamps on the file system, the method shall return -1.

Parameters:

names - file names to evaluate on local FS

localDir - Directory implementation to be used to get the files

Returns:

latest timestamp or -1 (with logs) in case of any doubt

isFileModifiedBefore

public static boolean isFileModifiedBefore(String name,
                                           Directory localDir,
                                           long millis)

Parameters:

name - file name to evaluate on local FS

localDir - Directory implementation to be used to get the file

millis - timestamp to compare file's modified timestamp against

Returns:

true if file referred to be name is modified before millis; false otherwise

startCopy

public long startCopy(org.apache.jackrabbit.oak.plugins.index.lucene.directory.LocalIndexFile file)

isCopyInProgress

public boolean isCopyInProgress(org.apache.jackrabbit.oak.plugins.index.lucene.directory.LocalIndexFile file)

waitForCopyCompletion

public void waitForCopyCompletion(org.apache.jackrabbit.oak.plugins.index.lucene.directory.LocalIndexFile file,
                                  long timeoutMillis)

Waits for maximum of timeoutMillis while checking if file isn't being copied already. The method can return before timeoutMillis if it got interrupted. So, if required then the caller should check using isCopyInProgress and wait again.

Parameters:

file -

timeoutMillis -

doneCopy

public void doneCopy(org.apache.jackrabbit.oak.plugins.index.lucene.directory.LocalIndexFile file,
                     long start)

skippedUpload

public void skippedUpload(long skippedFilesSize)

scheduledForCopy

public void scheduledForCopy()

copyDone

public void copyDone()

readFromRemote

public void readFromRemote(boolean reader)

readFromLocal

public void readFromLocal(boolean reader)

foundInvalidFile

public void foundInvalidFile()

getIndexPathMapping

public TabularData getIndexPathMapping()

Specified by:

getIndexPathMapping in interface CopyOnReadStatsMBean

isPrefetchEnabled

public boolean isPrefetchEnabled()

Specified by:

isPrefetchEnabled in interface CopyOnReadStatsMBean

getReaderLocalReadCount

public int getReaderLocalReadCount()

Specified by:

getReaderLocalReadCount in interface CopyOnReadStatsMBean

getReaderRemoteReadCount

public int getReaderRemoteReadCount()

Specified by:

getReaderRemoteReadCount in interface CopyOnReadStatsMBean

getWriterLocalReadCount

public int getWriterLocalReadCount()

Specified by:

getWriterLocalReadCount in interface CopyOnReadStatsMBean

getWriterRemoteReadCount

public int getWriterRemoteReadCount()

Specified by:

getWriterRemoteReadCount in interface CopyOnReadStatsMBean

getInvalidFileCount

public int getInvalidFileCount()

getDownloadSize

public String getDownloadSize()

Specified by:

getDownloadSize in interface CopyOnReadStatsMBean

getDownloadTime

public long getDownloadTime()

Specified by:

getDownloadTime in interface CopyOnReadStatsMBean

getDownloadCount

public int getDownloadCount()

Specified by:

getDownloadCount in interface CopyOnReadStatsMBean

getUploadCount

public int getUploadCount()

Specified by:

getUploadCount in interface CopyOnReadStatsMBean

getUploadSize

public String getUploadSize()

Specified by:

getUploadSize in interface CopyOnReadStatsMBean

getUploadTime

public long getUploadTime()

Specified by:

getUploadTime in interface CopyOnReadStatsMBean

getLocalIndexSize

public String getLocalIndexSize()

Specified by:

getLocalIndexSize in interface CopyOnReadStatsMBean

getLocalIndexDirSize

public long getLocalIndexDirSize()

Specified by:

getLocalIndexDirSize in interface CopyOnReadStatsMBean

getGarbageDetails

public String[] getGarbageDetails()

Specified by:

getGarbageDetails in interface CopyOnReadStatsMBean

getGarbageSize

public String getGarbageSize()

Specified by:

getGarbageSize in interface CopyOnReadStatsMBean

getScheduledForCopyCount

public int getScheduledForCopyCount()

Specified by:

getScheduledForCopyCount in interface CopyOnReadStatsMBean

getCopyInProgressCount

public int getCopyInProgressCount()

Specified by:

getCopyInProgressCount in interface CopyOnReadStatsMBean

getCopyInProgressSize

public String getCopyInProgressSize()

Specified by:

getCopyInProgressSize in interface CopyOnReadStatsMBean

getMaxCopyInProgressCount

public int getMaxCopyInProgressCount()

Specified by:

getMaxCopyInProgressCount in interface CopyOnReadStatsMBean

getMaxScheduledForCopyCount

public int getMaxScheduledForCopyCount()

Specified by:

getMaxScheduledForCopyCount in interface CopyOnReadStatsMBean

getSkippedFromUploadSize

public String getSkippedFromUploadSize()

Specified by:

getSkippedFromUploadSize in interface CopyOnReadStatsMBean

getCopyInProgressDetails

public String[] getCopyInProgressDetails()

Specified by:

getCopyInProgressDetails in interface CopyOnReadStatsMBean

getDeletedFilesCount

public int getDeletedFilesCount()

Specified by:

getDeletedFilesCount in interface CopyOnReadStatsMBean

getGarbageCollectedSize

public String getGarbageCollectedSize()

Specified by:

getGarbageCollectedSize in interface CopyOnReadStatsMBean