#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

History: 2016-06-21 Kris Becker - Properly forward declare QPair as struct not class

Definition at line 25 of file CubeDataThreadTester.h.

Constructor & Destructor Documentation

◆ CubeDataThreadTester()

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 33 of file CubeDataThreadTester.cpp.

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

◆ ~CubeDataThreadTester()

Isis::CubeDataThreadTester::~CubeDataThreadTester ( )

virtual

This cleans up the cube data thread.

Definition at line 78 of file CubeDataThreadTester.cpp.

References p_execStarted.

Member Function Documentation

◆ BrickChanged

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 360 of file CubeDataThreadTester.cpp.

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

Referenced by NotifyChangeTest().

◆ Connect()

void Isis::CubeDataThreadTester::Connect ( )

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

Definition at line 52 of file CubeDataThreadTester.cpp.

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

◆ DataThread()

CubeDataThread * Isis::CubeDataThreadTester::DataThread ( )

inline

Returns the cube data thread being tested.

Definition at line 38 of file CubeDataThreadTester.h.

References p_cubeDataThread.

◆ NotifyChangeTest()

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 206 of file CubeDataThreadTester.cpp.

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

◆ NotifyDoneWithData

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().

◆ NumberOfTestsDone()

int Isis::CubeDataThreadTester::NumberOfTestsDone ( )

inline

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

Definition at line 33 of file CubeDataThreadTester.h.

References p_numTestsDone.

◆ ReadBrick

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 228 of file CubeDataThreadTester.cpp.

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

Referenced by Connect().

◆ ReadCubeTest()

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 99 of file CubeDataThreadTester.cpp.

References RequestReadCube().

◆ ReadCubeTest2()

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 111 of file CubeDataThreadTester.cpp.

References p_notifyDone, and RequestReadCube().

◆ ReadCubeTest3()

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 126 of file CubeDataThreadTester.cpp.

References p_notifyDone, and RequestReadCube().

◆ ReadWriteBrick

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 283 of file CubeDataThreadTester.cpp.

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

Referenced by Connect().

◆ RequestReadCube

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().

◆ RequestReadWriteCube

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

Referenced by Connect(), NotifyChangeTest(), WriteCubeTest(), WriteCubeTest2(), and WriteCubeTest3().

◆ run()

void Isis::CubeDataThreadTester::run ( )

private

This thread is centered completely around its event loop.

returns the cube id

Definition at line 89 of file CubeDataThreadTester.cpp.

References p_execStarted.

◆ WriteCubeTest()

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

This tests a basic write.

This performs 2 tests.

Parameters

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

Definition at line 141 of file CubeDataThreadTester.cpp.

References RequestReadCube(), and RequestReadWriteCube().

◆ WriteCubeTest2()

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

This tests two non-conflicting writes.

This performs 2 tests.

Parameters

cubeId1	Cube for first write
cubeId2	Cube for second write

Definition at line 154 of file CubeDataThreadTester.cpp.

References p_notifyDone, and RequestReadWriteCube().

◆ WriteCubeTest3()

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

This tests two conflicting* writes.

This causes a deadlock!

This performs a test, deadlocks, and once the deadlock is broken (via WriteCubeTest3BreakDeadlock), finishes another test.

Parameters

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

Definition at line 172 of file CubeDataThreadTester.cpp.

References p_notifyDone, and RequestReadWriteCube().

◆ WriteCubeTest3BreakDeadlock()

void Isis::CubeDataThreadTester::WriteCubeTest3BreakDeadlock ( )

This test breaks the deadlock caused by the third write test.

Definition at line 186 of file CubeDataThreadTester.cpp.

References NotifyDoneWithData(), and p_cachedDoneBricks.

Member Data Documentation

◆ p_cachedDoneBricks

QVector< QPair<int, const Isis::Brick *> >* Isis::CubeDataThreadTester::p_cachedDoneBricks

private

A list of bricks we haven't send the done signal for.

Definition at line 111 of file CubeDataThreadTester.h.

Referenced by CubeDataThreadTester(), ReadBrick(), ReadWriteBrick(), and WriteCubeTest3BreakDeadlock().

◆ p_cubeDataThread

CubeDataThread* Isis::CubeDataThreadTester::p_cubeDataThread

private

The data thread being tested.

Definition at line 102 of file CubeDataThreadTester.h.

Referenced by Connect(), CubeDataThreadTester(), DataThread(), and NotifyChangeTest().

◆ p_execStarted

bool Isis::CubeDataThreadTester::p_execStarted

private

True if this thread is started.

Definition at line 105 of file CubeDataThreadTester.h.

Referenced by CubeDataThreadTester(), run(), and ~CubeDataThreadTester().

◆ p_notifyDone

bool Isis::CubeDataThreadTester::p_notifyDone

private

True if we will notify done on the next brick received for R/W.

Definition at line 108 of file CubeDataThreadTester.h.

Referenced by CubeDataThreadTester(), ReadBrick(), ReadCubeTest2(), ReadCubeTest3(), ReadWriteBrick(), WriteCubeTest2(), and WriteCubeTest3().

◆ p_numTestsDone

int Isis::CubeDataThreadTester::p_numTestsDone

private

The count of completed tests.

Definition at line 99 of file CubeDataThreadTester.h.

Referenced by BrickChanged(), CubeDataThreadTester(), NumberOfTestsDone(), ReadBrick(), and ReadWriteBrick().

The documentation for this class was generated from the following files:

src/base/objs/CubeDataThread/CubeDataThreadTester.h
src/base/objs/CubeDataThread/CubeDataThreadTester.cpp

Public Slots

Signals

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ CubeDataThreadTester()

◆ ~CubeDataThreadTester()

Member Function Documentation

◆ BrickChanged

◆ Connect()

◆ DataThread()

◆ NotifyChangeTest()

◆ NotifyDoneWithData

◆ NumberOfTestsDone()

◆ ReadBrick

◆ ReadCubeTest()

◆ ReadCubeTest2()

◆ ReadCubeTest3()

◆ ReadWriteBrick

◆ RequestReadCube

◆ RequestReadWriteCube

◆ run()

◆ WriteCubeTest()

◆ WriteCubeTest2()

◆ WriteCubeTest3()

◆ WriteCubeTest3BreakDeadlock()

Member Data Documentation

◆ p_cachedDoneBricks

◆ p_cubeDataThread

◆ p_execStarted

◆ p_notifyDone

◆ p_numTestsDone