com.redhat.lightblue.migrator

Class ConsistencyCheckerController

java.lang.Object

java.lang.Thread

com.redhat.lightblue.migrator.AbstractController

com.redhat.lightblue.migrator.ConsistencyCheckerController

All Implemented Interfaces:

MonitoredThread, Runnable

public class ConsistencyCheckerController
extends AbstractController
implements MonitoredThread

There is one consistency checker controller for each entity. Consistency checker controller is created and initialized from a MigrationConfiguration. The migration configuration gives the period with which the consistency checker runs. The consistency checker operates using a timestamp field. Every time it wakes up, it attempts to process documents that were created/modified after the last run time, and before (now-period). When the consistency checker wakes up, it creates a migration job for every (period) length time slice. The consistency checker always leaves the last period unprocessed. This is to allow for any time discrepancies between nodes updating the database. If a node updates a record with a timestamp that is smaller than the current latest record, the consistency checker will miss that in the next run if the current maximum was used as the starting value of the next run.

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Thread

Thread.State, Thread.UncaughtExceptionHandler

Field Summary

Fields inherited from class com.redhat.lightblue.migrator.AbstractController

controller, lbClient, locking, migrationConfiguration, migratorClass, migratorThreads, myLocks

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Constructor and Description
ConsistencyCheckerController(Controller controller, MigrationConfiguration migrationConfiguration)

Method Summary

Modifier and Type	Method and Description
protected List<MigrationJob>	createJobs(Date startDate, Date endDate, ActiveExecution ae) Create a migration job or jobs to process records created between the given dates.
Date	getEndDate(Date startDate, long period) Returns the end date given the start date end the period.
protected Date	getNow() This is simply here so that we can override it in the tests, and change the current time
static long	parsePeriod(String periodStr) Returns the period in msecs
void	ping(String msg)
void	registerThreadMonitor(ThreadMonitor monitor)
void	run()

Methods inherited from class com.redhat.lightblue.migrator.AbstractController

createMigrator, getController, getMigrationConfiguration, getMigratorThreads, lock, reloadMigrationConfiguration, unlock

Methods inherited from class java.lang.Thread

activeCount, checkAccess, clone, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, toString, yield

Methods inherited from class java.lang.Object

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

Constructor Detail

ConsistencyCheckerController

public ConsistencyCheckerController(Controller controller,
                                    MigrationConfiguration migrationConfiguration)

Method Detail

parsePeriod

public static long parsePeriod(String periodStr)

Returns the period in msecs

registerThreadMonitor

public void registerThreadMonitor(ThreadMonitor monitor)

Specified by:

registerThreadMonitor in interface MonitoredThread

ping

public void ping(String msg)

Specified by:

ping in interface MonitoredThread

getEndDate

public Date getEndDate(Date startDate,
                       long period)

Returns the end date given the start date end the period. The end date is startDate+period, but only if endDate is at least one period ago. That is, we always leave the last incomplete period unprocessed. Override this to control the job generation algorithm

getNow

protected Date getNow()

This is simply here so that we can override it in the tests, and change the current time

createJobs

protected List<MigrationJob> createJobs(Date startDate,
                                        Date endDate,
                                        ActiveExecution ae)
                                 throws Exception

Create a migration job or jobs to process records created between the given dates. startDate is inclusive, end date is exclusive

Throws:

Exception

run

public void run()

Specified by:

run in interface Runnable

Overrides:

run in class Thread