#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. More...

void	ReadWriteBrick (void requester, int cubeId, Isis::Brick data)
	This is called when a brick is given for R/W. More...

void	BrickChanged (int cubeId, const Isis::Brick *data)
	This is called when a brick is written. More...

Signals
void	RequestReadCube (int cubeId, int startSample, int startLine, int endSample, int endLine, int band, void *caller)
	Ask for a brick for reading. More...

void	RequestReadWriteCube (int cubeId, int startSample, int startLine, int endSample, int endLine, int band, void *caller)
	Ask for a brick for reading and writing. More...

void	NotifyDoneWithData (int, const Isis::Brick *)
	Let the cube data thread know we're no longer working with a particular brick. More...

Public Member Functions
	CubeDataThreadTester (CubeDataThread *)
	This initializes a CubeDataThreadTester. More...

virtual	~CubeDataThreadTester ()
	This cleans up the cube data thread. More...

int	NumberOfTestsDone ()
	Returns the number of tests done (testing methods count as several) More...

CubeDataThread *	DataThread ()
	Returns the cube data thread being tested. More...

void	Connect ()
	This connects this class' signals and slots with CubeDataThread's signals and slots. More...

void	ReadCubeTest (int)
	This tests a basic read. More...

void	ReadCubeTest2 (int, int)
	This tests two basic reads with no conflicts. More...

void	ReadCubeTest3 (int)
	This tests an overlapping read. More...

void	WriteCubeTest (int)
	This tests a basic write. More...

void	WriteCubeTest2 (int, int)
	This tests two non-conflicting writes. More...

void	WriteCubeTest3 (int)
	This tests two conflicting* writes. More...

void	WriteCubeTest3BreakDeadlock ()
	This test breaks the deadlock caused by the third write test. More...

void	NotifyChangeTest (int)
	This test tests this automatic change notifications. More...

Detailed Description

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

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

◆ ~CubeDataThreadTester()

Isis::CubeDataThreadTester::~CubeDataThreadTester ( )

virtual

This cleans up the cube data thread.

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

References Isis::Buffer::at(), NotifyDoneWithData(), 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.

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

◆ DataThread()

CubeDataThread* Isis::CubeDataThreadTester::DataThread ( )

inline

Returns the cube data thread being tested.

◆ 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

References Isis::CubeDataThread::AddChangeListener(), BrickChanged(), 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)

◆ 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

References Isis::Buffer::at(), NotifyDoneWithData(), 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

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

References 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

References 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

References Isis::Buffer::at(), NotifyDoneWithData(), 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().

◆ 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

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

References 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

References RequestReadWriteCube().

◆ WriteCubeTest3BreakDeadlock()

void Isis::CubeDataThreadTester::WriteCubeTest3BreakDeadlock ( )

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

References NotifyDoneWithData().

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

/usgs/pkgs/isis3.9.0_docs/ISIS3/isis/src/base/objs/CubeDataThread/CubeDataThreadTester.h
/usgs/pkgs/isis3.9.0_docs/ISIS3/isis/src/base/objs/CubeDataThread/CubeDataThreadTester.cpp

Public Slots

Signals

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ CubeDataThreadTester()

◆ ~CubeDataThreadTester()

Member Function Documentation

◆ BrickChanged

◆ Connect()

◆ DataThread()

◆ NotifyChangeTest()

◆ NotifyDoneWithData

◆ NumberOfTestsDone()

◆ ReadBrick

◆ ReadCubeTest()

◆ ReadCubeTest2()

◆ ReadCubeTest3()

◆ ReadWriteBrick

◆ RequestReadCube

◆ RequestReadWriteCube

◆ WriteCubeTest()

◆ WriteCubeTest2()

◆ WriteCubeTest3()

◆ WriteCubeTest3BreakDeadlock()