TGo4TestRunnable Class Reference

Example of a user defined runnable subclass. More...

#include <TGo4TestRunnable.h>

Inheritance diagram for TGo4TestRunnable:

Public Member Functions
	TGo4TestRunnable ()
	TGo4TestRunnable (const char *name, TGo4ThreadManager *man, Int_t mode=0)
	TGo4TestRunnable (const TGo4TestRunnable &right)
virtual	~TGo4TestRunnable ()
Public Member Functions inherited from TGo4Runnable
	TGo4Runnable (const char *name, TGo4ThreadManager *man)
	TGo4Runnable (const TGo4Runnable &right)
virtual	~TGo4Runnable ()
TGo4Thread *	GetThread () const
TGo4ThreadManager *	GetThreadManager () const
void	SetThread (TGo4Thread *gthread)

Protected Member Functions
Int_t	Run (void *ptr) override
	The working function which runs in the thread.
void	ThreadCatch (TGo4Exception &ex) override
	catch for exceptions occurring in workfunc
void	UnexpectedCatch () override
	catch for all unexpected exceptions happening in workfunc
Protected Member Functions inherited from TGo4Runnable
	TGo4Runnable ()
virtual Int_t	PostRun (void *ptr)
	Function which is called once after the Run()method on threadstop.
virtual Int_t	PreRun (void *ptr)
	Function which is called once before the Run() method on threadstart.

Private Attributes
Int_t	fiMode {0}
	mode number which can be used to create runnables with different actions in Workfunc; useful for testing without creating new subclasses of runnable...
TH1D *	fxHisto {nullptr}

Additional Inherited Members
Protected Attributes inherited from TGo4Runnable
TGo4Thread *	fxGo4Thread {nullptr}
	Backlink to thread which runs this.
TGo4ThreadManager *	fxManager {nullptr}
	The threadmanager which is responsible for our thread.

Detailed Description

Example of a user defined runnable subclass.

Method Run() must be implemented. Methods ThreadCatch and UnexpectedCatch can be overridden to change default exception behaviour. This runnable is able to do different actions depending on the fiMode parameter set in the ctor (good for easy testing). However, the usual way is to create a dedicated runnable class for a dedicated purpose and pass different runnable classes to the different go4 threads (see Go4TaskHandler package for examples).

Different actions in this runnable: fiMode == 0: Dummy printout a message every 5 seconds. fiMode == 1: Kill and create sleep 30s, then kill other threads- sleep 5s, then create other threads again fiMode == 2: Stop and start sleep 10s, then stop other threads- sleep 10s, then start other threads again fiMode == 3: Aborting all sleep 30s, then abort application by means of exception fiMode == 4: Histogramming creates histogram, fills it with random gaussian and draws it on pad depending on the runnable name ("Maker1", "Maker2"), different pads are used Maker 1 deletes histogram again each time, Maker 2 keeps initial histogram sleeps of 2s are used to slow down the action fiMode == 5: Recreator Cancel and recreate one thread by name ("First Thread") every 15 s. fiMode == 6: Exception tester sleep 60s, then throw different thread exceptions (latest: Restart exception) fiMode == 7: Histogram without drawing create histogram, fill it with random and delete it again for memory alloc tests independent from root gui fiMode default: Undefined throw logic exception

NOTE1: Members of the runnable (histogram, canvas) are not deleted when the TThread is killed. The runnable exists independent from the thread. NOTE2: The user just has to create own runnables and a threadmanager subclasses, subclassing of TGo4Thread or other parts of the package are not required!

Author

J. Adamczewski(at)gsi.de

Go4 project-DVEE-GSI Darmstadt

Germany

Version

0.9

Since

jul 2000-oct 2001

Definition at line 64 of file TGo4TestRunnable.h.

Constructor & Destructor Documentation

TGo4TestRunnable() [1/3]

TGo4TestRunnable::TGo4TestRunnable

(

)

Definition at line 31 of file TGo4TestRunnable.cxx.

References TGo4Runnable::TGo4Runnable(), and GO4TRACE.

Referenced by TGo4TestRunnable(), and Run().

TGo4TestRunnable() [2/3]

TGo4TestRunnable::TGo4TestRunnable

(

const TGo4TestRunnable &

right

)

Definition at line 36 of file TGo4TestRunnable.cxx.

References TGo4Runnable::TGo4Runnable(), TGo4TestRunnable(), fiMode, and GO4TRACE.

TGo4TestRunnable() [3/3]

TGo4TestRunnable::TGo4TestRunnable	(	const char *	name,
		TGo4ThreadManager *	man,
		Int_t	mode = 0 )

Definition at line 41 of file TGo4TestRunnable.cxx.

References TGo4Runnable::TGo4Runnable(), fiMode, and GO4TRACE.

~TGo4TestRunnable()

TGo4TestRunnable::~TGo4TestRunnable ( )

virtual

Definition at line 47 of file TGo4TestRunnable.cxx.

References GO4TRACE.

Member Function Documentation

Run()

Int_t TGo4TestRunnable::Run ( void * ptr )

overrideprotectedvirtual

The working function which runs in the thread.

Implements TGo4Runnable.

Definition at line 52 of file TGo4TestRunnable.cxx.

References TGo4TestRunnable(), TGo4Thread::Cancel(), TGo4ThreadHandler::Cancel(), TGo4ThreadHandler::Create(), TGo4Log::Debug(), fiMode, TGo4Runnable::fxGo4Thread, fxHisto, TGo4Runnable::fxManager, GO4TRACE, TGo4ThreadHandler::Start(), TGo4ThreadHandler::Stop(), and TGo4Runnable::TGo4Thread.

ThreadCatch()

void TGo4TestRunnable::ThreadCatch ( TGo4Exception & ex )

overrideprotectedvirtual

catch for exceptions occurring in workfunc

Reimplemented from TGo4Runnable.

Definition at line 312 of file TGo4TestRunnable.cxx.

References GO4TRACE, and TGo4Runnable::ThreadCatch().

UnexpectedCatch()

void TGo4TestRunnable::UnexpectedCatch ( )

overrideprotectedvirtual

catch for all unexpected exceptions happening in workfunc

Reimplemented from TGo4Runnable.

Definition at line 326 of file TGo4TestRunnable.cxx.

References GO4TRACE, and TGo4Runnable::UnexpectedCatch().

Field Documentation

fiMode

Int_t TGo4TestRunnable::fiMode {0}

private

mode number which can be used to create runnables with different actions in Workfunc; useful for testing without creating new subclasses of runnable...

Definition at line 103 of file TGo4TestRunnable.h.

Referenced by TGo4TestRunnable(), TGo4TestRunnable(), and Run().

fxHisto

TH1D* TGo4TestRunnable::fxHisto {nullptr}

private

Definition at line 106 of file TGo4TestRunnable.h.

Referenced by Run().

---

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

• Go4ThreadManagerExample/TGo4TestRunnable.h
• Go4ThreadManagerExample/TGo4TestRunnable.cxx