Base class for all operations. More...

#include <SUIT_Operation.h>

Inheritance diagram for SUIT_Operation:

Public Types
enum	OperationState { Waiting, Running, Suspended }
enum	ExecStatus { Rejected, Accepted }
enum	Flags { None = 0x00, Transaction = 0x01 }
Public Slots
void	start ()
	Starts operation.
void	abort ()
	Aborts operation.
void	commit ()
	Commits operation.
void	resume ()
	Resumes operation.
void	suspend ()
	Suspend operation.
Signals
void	started (SUIT_Operation *)
void	aborted (SUIT_Operation *)
void	committed (SUIT_Operation *)
void	stopped (SUIT_Operation *)
void	resumed (SUIT_Operation *)
void	suspended (SUIT_Operation *)
void	callSlot ()
Public Member Functions
	SUIT_Operation (SUIT_Application *)
	Constructor.
virtual	~SUIT_Operation ()
	Destructor.
OperationState	state () const
	Gets state of operation.
bool	isActive () const
	Verifies whether operation is an active for study.
bool	isRunning () const
	Verifies whether operation is an runned one (state()==Running)
SUIT_Study *	study () const
	Returns operation study.
virtual void	setStudy (SUIT_Study *theStudy)
	Sets operation study.
SUIT_Application *	application () const
	Gets application.
virtual void	setApplication (SUIT_Application *theApp)
	Sets application.
virtual bool	isValid (SUIT_Operation *theOtherOp) const
	Verifies whether given operator is valid for this one.
virtual bool	isGranted () const
	Verifies whether this operator can be always started above any already runnig one.
bool	setSlot (const QObject theReceiver, const char theSlot)
	Sets slot which is called when operation is started.
void	setFlags (const int)
	Sets the flags of operation.
void	clearFlags (const int)
	Clears the flags of operation.
bool	testFlags (const int) const
	Test the flags of operation.
virtual QString	operationName () const
	Name of the operation.
int	execStatus () const
	Gets execution status.
Protected Member Functions
virtual bool	isReadyToStart () const
	Verifies whether operator is ready to start.
virtual void	stopOperation ()
	Virtual method called when operation is started.
virtual void	startOperation ()
	Virtual method called when operation is started.
virtual void	abortOperation ()
	Virtual method called when operation aborted.
virtual void	commitOperation ()
	Virtual method called when operation committed.
virtual void	resumeOperation ()
	Virtual method called when operation resumed.
virtual void	suspendOperation ()
	Virtual method called when operation suspended.
virtual bool	openTransaction ()
	Opens transaction for data modifications.
virtual bool	abortTransaction ()
	Aborts transaction and all performed data modifications.
virtual bool	hasTransaction () const
	Returns TRUE if transaction is opened.
virtual bool	commitTransaction (const QString &=QString())
	Commits transaction and all performed data modifications.
void	setExecStatus (const int)
	Sets execution status.
void	setState (const OperationState)
	Sets state of operation.
void	start (SUIT_Operation *, const bool=false)
	Starts operator above this one.
Private Types
typedef QPointer< SUIT_Study >	StudyPtr
Private Attributes
SUIT_Application *	myApp
	application for this operation
int	myFlags
	operation flags
StudyPtr	myStudy
	study for this operation
OperationState	myState
	Operation state.
ExecStatus	myExecStatus
	Execution status.
Friends
class	SUIT_Study

Detailed Description

Base class for all operations. If you perform an action it is reasonable to create operation intended for this. This is a base class for all operations which provides mechanism for correct starting operations, starting operations above already started ones, committing operations and so on. To create own operation it is reasonable to inherit it from this class and redefines virtual methods to provide own behavior Main virtual methods are

virtual bool isReadyToStart();
virtual void startOperation();
virtual void abortOperation();
virtual void commitOperation();
virtual void resumeOperation();
virtual void suspendOperation();

Member Typedef Documentation

typedef QPointer<SUIT_Study> SUIT_Operation.StudyPtr [private]

Member Enumeration Documentation

enum SUIT_Operation::OperationState

Enum describes state of operation

Enumerator:

Waiting	Operation is not used (it is not run or suspended)
Running	Operation is started.
Suspended	Operation is started but suspended (other operation is performed above it)

enum SUIT_Operation::ExecStatus

Enum describes execution status of operation. Execution status often used after ending work of operation which was started from this one. In this case this operation can ask previously started operation whether it finished successfully.

Enumerator:

Rejected	Operation has not performed any action (modification of data model for example)
Accepted	Operation has performed an actions and must be stopped.

enum SUIT_Operation::Flags

Enum describes setting of the operation.

Enumerator:

None	None options.
Transaction	Automatically open (commit/abort) transaction during start (commit/abort).

Constructor & Destructor Documentation

SUIT_Operation::SUIT_Operation ( SUIT_Application * app )

Parameters:

SUIT_Application - application for this operation

Constructs an empty operation. Constructor should work very fast because many operators may be created after starting application but only several from them may be used. As result this constructor stores given application in myApp field and set Waiting status.

SUIT_Operation::~SUIT_Operation ( ) [virtual]

Member Function Documentation

SUIT_Operation::OperationState SUIT_Operation::state ( ) const

Returns:: Value from OperationState enumeration

Gets state of operation (see OperationState enumeration)

References myState.

bool SUIT_Operation::isActive ( ) const

Returns:: TRUE if operation is active, FALSE otherwise

Verifies whether operation is an active on. Returns TRUE if this operator is active for study

References SUIT_Study.activeOperation(), and study().

bool SUIT_Operation::isRunning ( ) const

Returns:: TRUE if operation is active, FALSE otherwise

Verifies whether operation is an running. Returns TRUE if state of operator is Running

References Running, and state().

SUIT_Study * SUIT_Operation::study ( ) const

Returns:: Pointer to study

Get study corresponding to this operation i.e. study which starts this operation.

References myStudy.

void SUIT_Operation::setStudy ( SUIT_Study * theStudy ) [virtual]

Parameters:

theStudy - study corresponding to this operation

Sets study corresponding to this operation i.e. study which starts this operation.

References myStudy.

SUIT_Application * SUIT_Operation::application ( ) const

Returns:: Pointer to application

Gets application for this operation

References myApp.

void SUIT_Operation::setApplication ( SUIT_Application * theApp ) [virtual]

Parameters:

theApp - application for this operation

Gets application for this operation

References myApp.

bool SUIT_Operation::isValid ( SUIT_Operation * theOtherOp ) const [virtual]

Parameters:

theOtherOp - other operation

Returns:: Returns TRUE if the given operator is valid for this one

Verifies whether given operator is valid for this one (i.e. can be started "above" this operator)

bool SUIT_Operation::isGranted ( ) const [virtual]

Returns:: Returns TRUE if current operation must not be checked for ActiveOperation->IsValid( this )

This method must be redefined in derived operation if operation of derived class must be always can start above any launched one. Default implementation returns FALSE, so it is being checked for IsValid, but some operations may overload IsGranted() In this case they will always start, no matter what operation is running.

bool SUIT_Operation::setSlot	(	const QObject *	theReceiver,
		const char *	theSlot
	)

Parameters:

theReceiver	- object containing slot
theSlot	- slot of theReceiver object

Returns:: TR if slot was connected successfully, FALSE otherwise

Sets slot which is called when operation is started. There is no point in using this method. It would be better to inherit own operator from base one and redefine startOperation method

References callSlot().

void SUIT_Operation::setFlags ( const int f )

Parameters:

f	- flags of operation to be set

Sets flags of operation (see Flags enumeration)

References myFlags.

void SUIT_Operation::clearFlags ( const int f )

Parameters:

f	- flags of operation to be cleared

Clears flags of operation (see Flags enumeration)

References myFlags.

bool SUIT_Operation::testFlags ( const int f ) const

Parameters:

f	- flags of operation to be tested

Returns TRUE if the specified flags setted in the operation (see Flags enumeration)

References myFlags.

QString SUIT_Operation::operationName ( ) const [virtual]

Returns string name of the operation. This name will be used for automatically commited transaction.

int SUIT_Operation::execStatus ( ) const

Returns:: Execution status

Gets execution status

References myExecStatus.

void SUIT_Operation.started ( SUIT_Operation * ) [signal]

void SUIT_Operation.aborted ( SUIT_Operation * ) [signal]

void SUIT_Operation.committed ( SUIT_Operation * ) [signal]

void SUIT_Operation.stopped ( SUIT_Operation * ) [signal]

void SUIT_Operation.resumed ( SUIT_Operation * ) [signal]

void SUIT_Operation.suspended ( SUIT_Operation * ) [signal]

void SUIT_Operation.callSlot ( ) [signal]

void SUIT_Operation::start ( ) [slot]

Public slot. Verifies whether operation can be started and starts operation. This slot is not virtual and cannot be redefined. Redefine startOperation method to change behavior of operation. There is no point in using this method. It would be better to inherit own operator from base one and redefine startOperation method instead.

References SUIT_Study.start(), started(), startOperation(), and study().

void SUIT_Operation::abort ( ) [slot]

Public slot. Aborts operation. This slot is not virtual and cannot be redefined. Redefine abortOperation method to change behavior of operation instead

References SUIT_Study.abort(), aborted(), abortOperation(), myState, stopOperation(), stopped(), study(), and Waiting.

void SUIT_Operation::commit ( ) [slot]

Public slot. Commits operation. This slot is not virtual and cannot be redefined. Redefine commitOperation method to change behavior of operation instead

References SUIT_Study.commit(), commitOperation(), committed(), myState, stopOperation(), stopped(), study(), and Waiting.

void SUIT_Operation::resume ( ) [slot]

Public slot. Resumes operation. This slot is called when operation is resumed after previous suspending. This slot is not virtual and cannot be redefined. Redefine resumeOperation method to change behavior of operation instead

References myState, SUIT_Study.resume(), resumed(), resumeOperation(), Running, and study().

void SUIT_Operation::suspend ( ) [slot]

Public slot. Suspend operation. This slot is called when operation is suspended (for starting other one, for example) This slot is not virtual and cannot be redefined. Redefine suspendOperation method to change behavior of operation instead

References myState, study(), SUIT_Study.suspend(), suspended(), Suspended, and suspendOperation().

bool SUIT_Operation::isReadyToStart ( ) const [protected, virtual]