#include <CubeDataThreadTester.h>

Inheritance diagram for Isis::CubeDataThreadTester:

Collaboration diagram for Isis::CubeDataThreadTester:

Public Slots
void	ReadBrick (void requester, int cubeId, const Isis::Brick data)
	This is called when a brick is read.
void	ReadWriteBrick (void requester, int cubeId, Isis::Brick data)
	This is called when a brick is given for R/W.
void	BrickChanged (int cubeId, const Isis::Brick *data)
	This is called when a brick is written.

Signals
void	RequestReadCube (int cubeId, int startSample, int startLine, int endSample, int endLine, int band, void *caller)
	Ask for a brick for reading.
void	RequestReadWriteCube (int cubeId, int startSample, int startLine, int endSample, int endLine, int band, void *caller)
	Ask for a brick for reading and writing.
void	NotifyDoneWithData (int, const Isis::Brick *)
	Let the cube data thread know we're no longer working with a particular brick.

Public Member Functions
	CubeDataThreadTester (CubeDataThread *)
	This initializes a CubeDataThreadTester.
virtual	~CubeDataThreadTester ()
	This cleans up the cube data thread.
int	NumberOfTestsDone ()
	Returns the number of tests done (testing methods count as several)
CubeDataThread *	DataThread ()
	Returns the cube data thread being tested.
void	Connect ()
	This connects this class' signals and slots with CubeDataThread's signals and slots.
void	ReadCubeTest (int)
	This tests a basic read.
void	ReadCubeTest2 (int, int)
	This tests two basic reads with no conflicts.
void	ReadCubeTest3 (int)
	This tests an overlapping read.
void	WriteCubeTest (int)
	This tests a basic write.
void	WriteCubeTest2 (int, int)
	This tests two non-conflicting writes.
void	WriteCubeTest3 (int)
	This tests two conflicting* writes.
void	WriteCubeTest3BreakDeadlock ()
	This test breaks the deadlock caused by the third write test.
void	NotifyChangeTest (int)
	This test tests this automatic change notifications.

Private Member Functions
void	run ()
	This thread is centered completely around its event loop.

Private Attributes
int	p_numTestsDone
	The count of completed tests.
CubeDataThread *	p_cubeDataThread
	The data thread being tested.
bool	p_execStarted
	True if this thread is started.
bool	p_notifyDone
	True if we will notify done on the next brick received for R/W.
QVector< QPair< int, const Isis::Brick * > > *	p_cachedDoneBricks
	A list of bricks we haven't send the done signal for.

Detailed Description

Author: ????-??-?? Steven Lambright

Definition at line 18 of file CubeDataThreadTester.h.

Constructor & Destructor Documentation

Isis::CubeDataThreadTester::CubeDataThreadTester ( CubeDataThread * testObject )

This initializes a CubeDataThreadTester.

The CubeDataThread given is the subject of the tests.

Parameters

testObject The CubeDataThread instance to be tested

Definition at line 27 of file CubeDataThreadTester.cpp.

References p_cachedDoneBricks, p_cubeDataThread, p_execStarted, p_notifyDone, and p_numTestsDone.

Isis::CubeDataThreadTester::~CubeDataThreadTester ( )

virtual

This cleans up the cube data thread.

Definition at line 72 of file CubeDataThreadTester.cpp.

References p_execStarted.

Member Function Documentation

void Isis::CubeDataThreadTester::BrickChanged	(	int	cubeId,
		const Isis::Brick *	data
	)

slot

This is called when a brick is written.

Parameters

cubeId	Cube identifier
data	Brick of data read

Definition at line 354 of file CubeDataThreadTester.cpp.

References Isis::Buffer::at(), NotifyDoneWithData(), p_numTestsDone, and Isis::Buffer::size().

Referenced by NotifyChangeTest().

void Isis::CubeDataThreadTester::Connect ( )

This connects this class' signals and slots with CubeDataThread's signals and slots.

Definition at line 46 of file CubeDataThreadTester.cpp.

References NotifyDoneWithData(), p_cubeDataThread, ReadBrick(), ReadWriteBrick(), RequestReadCube(), and RequestReadWriteCube().

CubeDataThread* Isis::CubeDataThreadTester::DataThread ( )

inline

Returns the cube data thread being tested.

Definition at line 31 of file CubeDataThreadTester.h.

References p_cubeDataThread.

void Isis::CubeDataThreadTester::NotifyChangeTest ( int cubeId )

This test tests this automatic change notifications.

This performs 2 tests.

Parameters

cubeId The identifier given by the data thread for the file to test

Definition at line 200 of file CubeDataThreadTester.cpp.

References Isis::CubeDataThread::AddChangeListener(), BrickChanged(), p_cubeDataThread, and RequestReadWriteCube().

void Isis::CubeDataThreadTester::NotifyDoneWithData	(	int	,
		const Isis::Brick *
	)

signal

Let the cube data thread know we're no longer working with a particular brick.

Referenced by BrickChanged(), Connect(), ReadBrick(), ReadWriteBrick(), and WriteCubeTest3BreakDeadlock().

int Isis::CubeDataThreadTester::NumberOfTestsDone ( )

inline

Returns the number of tests done (testing methods count as several)

Definition at line 26 of file CubeDataThreadTester.h.

References p_numTestsDone.

void Isis::CubeDataThreadTester::ReadBrick	(	void *	requester,
		int	cubeId,
		const Isis::Brick *	data
	)

slot

This is called when a brick is read.

Parameters

requester	Pointer to requesting class
cubeId	Cube identifier
data	Brick of data read

Definition at line 222 of file CubeDataThreadTester.cpp.

References Isis::Buffer::at(), NotifyDoneWithData(), p_cachedDoneBricks, p_notifyDone, p_numTestsDone, and Isis::Buffer::size().

Referenced by Connect().

void Isis::CubeDataThreadTester::ReadCubeTest ( int cubeId )

This tests a basic read.

This performs 1 test.

Parameters

cubeId The identifier given by the data thread for the file to test

Definition at line 93 of file CubeDataThreadTester.cpp.

References RequestReadCube().

void Isis::CubeDataThreadTester::ReadCubeTest2	(	int	cubeId1,
		int	cubeId2
	)

This tests two basic reads with no conflicts.

This performs 2 tests.

Parameters

cubeId1	Cube for first read
cubeId2	Cube for second read

Definition at line 105 of file CubeDataThreadTester.cpp.

References p_notifyDone, and RequestReadCube().

void Isis::CubeDataThreadTester::ReadCubeTest3 ( int cubeId )

This tests an overlapping read.

This performs 2 tests.

Parameters

cubeId The identifier given by the data thread for the file to test

Definition at line 120 of file CubeDataThreadTester.cpp.

References p_notifyDone, and RequestReadCube().

void Isis::CubeDataThreadTester::ReadWriteBrick	(	void *	requester,
		int	cubeId,
		Isis::Brick *	data
	)

slot

This is called when a brick is given for R/W.

Parameters

requester	Pointer to requesting class
cubeId	Cube identifier
data	Brick of data read

Definition at line 277 of file CubeDataThreadTester.cpp.

References Isis::Buffer::at(), NotifyDoneWithData(), p_cachedDoneBricks, p_notifyDone, p_numTestsDone, and Isis::Buffer::size().

Referenced by Connect().

void Isis::CubeDataThreadTester::RequestReadCube	(	int	cubeId,
		int	startSample,
		int	startLine,
		int	endSample,
		int	endLine,
		int	band,
		void *	caller
	)

signal

Ask for a brick for reading.

Parameters

cubeId	Cube identifier
startSample	Brick starting sample
startLine	Brick starting line
endSample	Brick ending sample
endLine	Brick ending line
band	Brick band
caller	A this pointer

Referenced by Connect(), ReadCubeTest(), ReadCubeTest2(), ReadCubeTest3(), and WriteCubeTest().

void Isis::CubeDataThreadTester::RequestReadWriteCube	(	int	cubeId,
		int	startSample,
		int	startLine,
		int	endSample,
		int	endLine,
		int	band,
		void *	caller
	)

signal

Ask for a brick for reading and writing.

Parameters

cubeId	Cube identifier
startSample	Brick starting sample
startLine	Brick starting line
endSample	Brick ending sample
endLine	Brick ending line
band	Brick band
caller	A this pointer