Class: TNotificationRequest

Declaration: Notification.h

Taxonomy Categories:

Member Functions:

Interface Category:

API.

Inherits From:

TRequest

Inherited By:

None.

Purpose:

An abstract derived class of the request processor's TRequest class. Instances of derived classes of this class are placed on a request queue. The HandleDo member function will be called when the request processor decides that the request should be performed.

Instantiation:

Always allocate on the heap.

Deriving Classes:

Derive from this class to implement an asynchronous notification request. Override HandleDo(MNotifier*) to implement the requests functionality.

Concurrency:

Not multithread safe.

Resource Use:

No special requirements.

Member Function: TNotificationRequest::~TNotificationRequest

virtual ~ TNotificationRequest ()

Interface Category:

API.

Purpose:

Destructor.

Calling Context:

Called to destroy an object. Call this function directly.

Parameters:

Takes no parameters.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TNotificationRequest::Do

virtual void Do ()

Interface Category:

API.

Purpose:

Executes the request. This is generally called by the request processor when the processor decides to execute the request.

Calling Context:

Call this function directly.

Parameters:

Takes no parameters.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TNotificationRequest::TNotificationRequest

TNotificationRequest ()

Interface Category:

API.

Purpose:

Default constructor.

Calling Context:

Called by the stream-in operators and directly.

Parameters:

Takes no parameters.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TNotificationRequest::HandleDo

virtual void HandleDo (MNotifier *)

Interface Category:

API.

Purpose:

The work in performing the request should be done in this member function. Derived classes of this class must override this member function.

Calling Context:

Call this function directly.

Parameters:

MNotifier * -The notifier that generated this notification request.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Click the icon to mail questions or corrections about this material to Taligent personnel.