net.openhft.chronicle.map

Interface EngineReplicationLangBytes.EngineModificationIterator

Enclosing interface:

EngineReplicationLangBytes

public static interface EngineReplicationLangBytes.EngineModificationIterator

Holds a record of which entries have modification. Each remote map supported will require a corresponding ModificationIterator instance

Method Summary

Methods

Modifier and Type	Method and Description
void	dirtyEntries(long fromTimeStamp) Dirties all entries with a modification time equal to fromTimeStamp or newer.
boolean	hasNext()
boolean	nextEntry(EngineReplicationLangBytes.EngineEntryCallback callback) A non-blocking call that provides the entry that has changed to callback.onEntry().
void	setModificationNotifier(EngineReplicationLangBytes.EngineReplicationModificationNotifier modificationNotifier) the modificationNotifier is called when ever there is a change applied to the modification iterator

Method Detail

hasNext

boolean hasNext()

Returns:

true if the is another entry to be received via nextEntry(EngineReplicationLangBytes.EngineEntryCallback)

nextEntry

boolean nextEntry(@NotNull
                EngineReplicationLangBytes.EngineEntryCallback callback)
                  throws InterruptedException

A non-blocking call that provides the entry that has changed to callback.onEntry().

Parameters:

callback - a callback which will be called when a new entry becomes available.

Returns:

true if the entry was accepted by the callback.onEntry() method, false if the entry was not accepted or was not available

Throws:

InterruptedException

dirtyEntries

void dirtyEntries(long fromTimeStamp)
                  throws InterruptedException

Dirties all entries with a modification time equal to fromTimeStamp or newer. It means all these entries will be considered as "new" by this ModificationIterator and iterated once again no matter if they have already been.

This functionality is used to publish recently modified entries to a new remote node as it connects.

Parameters:

fromTimeStamp - the timestamp from which all entries should be dirty

Throws:

InterruptedException

setModificationNotifier

void setModificationNotifier(@NotNull
                           EngineReplicationLangBytes.EngineReplicationModificationNotifier modificationNotifier)

the modificationNotifier is called when ever there is a change applied to the modification iterator

Parameters:

modificationNotifier - gets notified when a change occurs