com.sleepycat.je.rep.stream

Class ReplicaSyncupReader

java.lang.Object

com.sleepycat.je.log.FileReader

com.sleepycat.je.rep.stream.ReplicaSyncupReader

public class ReplicaSyncupReader
extends FileReader

The ReplicaSyncupReader scans the log backwards for requested log entries. The reader must track whether it has passed a checkpoint, and therefore can not used the vlsn index to skip over entries. The ReplicaSyncupReader is not thread safe, and can only be used serially. It will stop at the finishLsn, which should be set using the GlobalCBVLSN.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ReplicaSyncupReader.SkipGapException

Nested classes/interfaces inherited from class com.sleepycat.je.log.FileReader

FileReader.EOFException, FileReader.ReadWindow

Field Summary

Fields inherited from class com.sleepycat.je.log.FileReader

cksumValidator, currentEntryHeader, currentEntryOffset, currentEntryPrevOffset, envImpl, eof, fileManager, forward, logger, nextEntryOffset, startLsn, window

Constructor Summary

Constructors

Constructor and Description
ReplicaSyncupReader(EnvironmentImpl envImpl, VLSNIndex vlsnIndex, long endOfLogLsn, int readBufferSize, VLSN startVLSN, long finishLsn, MatchpointSearchResults searchResults)

Method Summary

Modifier and Type	Method and Description
OutputWireRecord	findPrevSyncEntry(boolean startAtPrev) Backward scanning for finding an earlier candidate syncup matchpoint.
protected void	handleGapInBackwardsScan(long prevFileNum) TBW
protected boolean	isTargetEntry() Return true for ckpt entries, for syncable entries, and if we're in specific vlsn scan mode, any replicated entry.
protected boolean	processEntry(ByteBuffer entryBuffer) ProcessEntry does additional filtering before deciding whether to return an entry as a candidate for matching.
OutputWireRecord	scanBackwards(VLSN vlsn) Backward scanning for the replica's part in syncup.
static void	setFileGapHook(TestHook<Long> hook)

Methods inherited from class com.sleepycat.je.log.FileReader

entryIsReplicated, getAndResetNReads, getLastEntrySize, getLastLsn, getLastVlsn, getLogVersion, getNRepeatIteratorReads, getNumRead, initStartingPosition, makeWindow, readNextEntry, readNextEntryAllowExceptions, setAlwaysValidateChecksum, setBackwardPosition, setForwardPosition, skipData, skipEntry

Methods inherited from class java.lang.Object

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

Constructor Detail

ReplicaSyncupReader

public ReplicaSyncupReader(EnvironmentImpl envImpl,
                           VLSNIndex vlsnIndex,
                           long endOfLogLsn,
                           int readBufferSize,
                           VLSN startVLSN,
                           long finishLsn,
                           MatchpointSearchResults searchResults)
                    throws DatabaseException

Throws:

DatabaseException

Method Detail

scanBackwards

public OutputWireRecord scanBackwards(VLSN vlsn)
                               throws DatabaseException

Backward scanning for the replica's part in syncup.

Throws:

DatabaseException

findPrevSyncEntry

public OutputWireRecord findPrevSyncEntry(boolean startAtPrev)
                                   throws DatabaseException

Backward scanning for finding an earlier candidate syncup matchpoint.

Throws:

DatabaseException

isTargetEntry

protected boolean isTargetEntry()
                         throws DatabaseException

Return true for ckpt entries, for syncable entries, and if we're in specific vlsn scan mode, any replicated entry. There is an additional level of filtering in processEntry.

Overrides:

isTargetEntry in class FileReader

Returns:

true if this reader should process the current logrec further, via the processEntry() method. A logrec must be passed to processEntry if the full logrec (not just the header) must be de-serialized for further processing. Return false if no further processing is needed, in which case the current logrec will be skipped (i.e, not returned to the caller of readNextEntry().

Throws:

DatabaseException - from subclasses.

processEntry

protected boolean processEntry(ByteBuffer entryBuffer)

ProcessEntry does additional filtering before deciding whether to return an entry as a candidate for matching. If this is a record we are submitting as a matchpoint candidate, instantiate a WireRecord to house this log entry. If this is a non-replicated entry or a txn end that follows the candidate matchpoint, record whatever status we need to, but don't use it for comparisons. For example, suppose the log is like this: VLSN entry 10 LN 11 commit 12 LN -- ckpt end 13 commit 14 abort And that the master only has VLSNs 1-12. The replica will suggest vlsn 14 as the first matchpoint. The feeder will counter with a suggestion of vlsn 11, since it does not have vlsn 14. At that point, the ReplicaSyncupReader will scan backwards in the log, looking for vlsn 11. Although the reader should only return an entry when it gets to vlsn 11. The reader must process commits and ckpts that follow 11, so that they can be recorded in the searchResults, so the number of rolled back commits can be accurately reported.

Parameters:

entryBuffer - A ByteBuffer that the logrec data and is positioned at the start of the logrec body (i.e., just after the logrec header).

Returns:

true if this entry should be returned to the caller of readNextEntry().

handleGapInBackwardsScan

protected void handleGapInBackwardsScan(long prevFileNum)

TBW

Overrides:

handleGapInBackwardsScan in class FileReader

setFileGapHook

public static void setFileGapHook(TestHook<Long> hook)