Go4ThreadManager
Class TGo4ThreadManager

Direct Known Subclasses:

TGo4Task, TGo4TestThreadManager

class TGo4ThreadManager

derived from TNamed

base class for classes that
shall be accessed from a thread /runnable
instance

Author:

J. Adamczewski, Go4 project-DVEE-GSI Darmstadt, Germany, j.adamczewski@gsi.de

Version: 0.9

Since: jul 2000-oct 2001

Constructor Summary
	TGo4ThreadManager(const TGo4ThreadManager& right)
	TGo4ThreadManager(const char * name, Bool_t blockingmode, Bool_t autostart, Bool_t autocreate)           ctor parameters: blockingmode=true: gApplication is blocked by timer autostart=true: all thread runnables start their work on Initialization() autocreate=true: all threads added to handler in threadmanager ctor are created on Launch()
private	TGo4ThreadManager()

Destructor Summary
virtual synchronized	~TGo4ThreadManager()

Method Summary
Bool_t	BlockApp()           Blocks gSystem by means of the blocking timer
TGo4ThreadHandler*	GetWorkHandler()           Access to ThreadHandler for working threads
virtual Int_t	Initialization()
Bool_t	IsAppBlocking()           Returns true if threadmanager works in root system blocking mode
const Bool_t	IsInitDone()
const Bool_t	IsTerminateApp()
const Bool_t	IsTerminating()           returns termination status of Threadmanager
void	Launch()           This Method has to be called to create the startup threads and to turn on the application control timer.
synchronized TGo4ThreadManager&	operator=(const TGo4ThreadManager& right)
void	SetTimer(TGo4AppControlTimer* ctrltimer)           user can exchange the standard control timer by an own derived one by this method
virtual void	Terminate(Bool_t termapp)           deletes the Manager instance via Control timer.
virtual void	TerminateFast()           Alternative termination in case of error
Bool_t	UnBlockApp(Int_t mode)           Wakes up the control timer waiting for his condition; parameter mode specifies whether timer will block again at next turn (mode=0), timer will block when all threads are up (mode=1), or timer will not block again unless the next Block call, i.e. applicationrun flag is reset (mode=2)

Methods inherited from class TNamed

operator=, Clear, Clone, Compare, Copy, FillBuffer, GetName, GetTitle, Hash, IsSortable, SetName, SetNameTitle, SetTitle, ls, Print, Sizeof, Class, Class_Name, Class_Version, Dictionary, IsA, ShowMembers, Streamer, StreamerNVirtual, DeclFileName, ImplFileLine, ImplFileName, DeclFileLine

Field Detail

fbAppBlocking

protected Bool_t fbAppBlocking

true if threadmanager shall block root gSystem using
the AppControlTimer; false if gSystem shall never be
blocked (necessary for gui)

protected Bool_t fbAutoCreate

If true, TThreads of all go4threads in list shall be created automatically
on calling Launch().

protected Bool_t fbAutoStart

If true, workfunctions (runnable Run()) of all go4threads in list shall be
started automatically on Initialization. If false, TThreads may be running, but
workfunctions suspend in condition wait.

protected Bool_t fbInitDone

is set kTRUE after first Initialize is done

protected Bool_t fbTerminateApplication

If true, terminate complete application. If false,
only terminate threadmanager instance.

protected Bool_t fbTerminating

flag showing termination status

public const static const Long_t fglTIMERPERIOD

Period in ms for the application control timer

public const static const UInt_t fguTEXTLENGTH

Default textlength for char arrays

protected TGo4AppControlTimer* fxBlocker

Composition of Application control timer.

supplierCardinality 1

link aggregationByValue

clientCardinality 1

protected TGo4ThreadHandler* fxWorkHandler

Thread handler aggregate (threadsafe list of go4 threads)

supplierCardinality 1

link aggregationByValue

clientCardinality 1

public TGo4ThreadManager(const TGo4ThreadManager& right)

public TGo4ThreadManager(const char * name, Bool_t blockingmode, Bool_t autostart, Bool_t autocreate)

ctor parameters:
blockingmode=true: gApplication is blocked by timer
autostart=true: all thread runnables start their work on Initialization()
autocreate=true: all threads added to handler in threadmanager ctor are created on Launch()

private TGo4ThreadManager()

public virtual synchronized ~TGo4ThreadManager()

public Bool_t BlockApp()

Blocks gSystem by means of the blocking timer

public TGo4ThreadHandler* GetWorkHandler()

Access to ThreadHandler for working threads

public virtual Int_t Initialization()

public Bool_t IsAppBlocking()

Returns true if threadmanager works in root system blocking mode

public const Bool_t IsInitDone()

public const Bool_t IsTerminateApp()

public const Bool_t IsTerminating()

returns termination status of Threadmanager

public void Launch()

This Method has to be called to create the startup threads and to
turn on the application control timer.
Usually this is done at the end of the user's threadmanager constructor.
The idea is that no thread should be started unless the user initializations
are done; therefore, its up to the user to define when to Launch.

public synchronized TGo4ThreadManager& operator=(const TGo4ThreadManager& right)

public void SetTimer(TGo4AppControlTimer* ctrltimer)

user can exchange the standard control timer
by an own derived one by this method

public virtual void Terminate(Bool_t termapp)

deletes the Manager instance via Control timer.
If termap is true, also
terminates the root Application

public virtual void TerminateFast()

Alternative termination in case of error

public Bool_t UnBlockApp(Int_t mode)

Wakes up the control timer waiting for his condition;
parameter mode specifies whether timer will block
again at next turn (mode=0), timer will block when
all threads are up (mode=1), or timer will not block
again unless the next Block call, i.e. applicationrun flag is
reset (mode=2)

Association Links

to Class TGo4AppControlTimer

Composition of Application control timer.

Client Cardinality 1

Supplier Cardinality 1

Type aggregationByValue

to Class TGo4ThreadHandler

Thread handler aggregate (threadsafe list of go4 threads)

Client Cardinality 1

Supplier Cardinality 1

Type aggregationByValue