Class: TRequestBasedMemberFunctionConnectionTo

Declaration: Notification.h

Taxonomy Categories:

• System Services
• Foundation Services
• Notification

Member Functions:

• TRequestBasedMemberFunctionConnectionTo
• ~TRequestBasedMemberFunctionConnectionTo
• GetReceiver
• GetDefaultFunction
• SetReceiver
• AddInterest
• AdoptInterest

Interface Category:

Inherits From:

Inherited By:

Purpose:

Instantiation:

Deriving Classes:

Concurrency:

Resource Use:

Member Function: TRequestBasedMemberFunctionConnectionTo::TRequestBasedMemberFunctionConnectionTo

1. TRequestBasedMemberFunctionConnectionTo (AReceiver * theReceiver, TRequestProcessor * processorToUse)
2. TRequestBasedMemberFunctionConnectionTo (AReceiver * theReceiver, TRequestProcessor * processorToUse, MemberFunction defaultFunction)
3. TRequestBasedMemberFunctionConnectionTo (AReceiver * theReceiver, TRequestProcessor * processorToUse, MemberFunction defaultFunction, const TInterest & theInterest)
4. TRequestBasedMemberFunctionConnectionTo ()

Interface Category:

Purpose:

1. Creates a new request based member function connection with no default notification member function pointer. The request processor is not adopted, it is aliased. The request process is used to serialize the notifications that a receiver object will get with other requests made against the object. Thus, the receiver object does not have to deal with concurrency issues.
2. Creates a new request based member function with the specified member function to be used as the default notification handler. The request processor is not adopted, it is aliased. The request process is used to serialize the notifications that a receiver object will get with other requests made against the object. Thus, the receiver object does not have to deal with concurrency issues.
3. Creates a new request based member function with the specified member function to be used as the default notification handler and the interest to be added as the initial interest. The request processor is not adopted, it is aliased. The request process is used to serialize the notifications that a receiver object will get with other requests made against the object. Thus, the receiver object does not have to deal with concurrency issues.
4. Default constructor.

Calling Context:

1. Call this function directly.
2. Call this function directly.
3. Call this function directly.
4. Called by the stream-in operators and directly.

Parameters:

• AReceiver * theReceiver -The object to receive the notifications.
• TRequestProcessor * processorToUse -The aliased request processor to be used to dispatch the notifications to the receiver object.
• AReceiver * theReceiver -The object to receive the notifications.
• TRequestProcessor * processorToUse -The aliased request processor to be used to dispatch the notifications to the receiver object.
• MemberFunction defaultFunction -The member function of the object that will be called to handle notifications on interests that do not have their own specified member function.
• AReceiver * theReceiver -The object to receive the notifications.
• TRequestProcessor * processorToUse -The aliased request processor to be used to dispatch the notifications to the receiver object.
• MemberFunction defaultFunction -The member function of the object that will be called to handle notifications on interests that do not have their own specified member function.
• const TInterest & -The initial interest.
• Takes no parameters.

Return Value:

Exceptions:

Concurrency:

Other Considerations:

Member Function: TRequestBasedMemberFunctionConnectionTo::~TRequestBasedMemberFunctionConnectionTo

Interface Category:

Purpose:

Calling Context:

Parameters:

• Takes no parameters.

Return Value:

Exceptions:

Concurrency:

Other Considerations:

Member Function: TRequestBasedMemberFunctionConnectionTo::GetReceiver

Interface Category:

Purpose:

Calling Context:

Parameters:

• Takes no parameters.

Return Value:

Exceptions:

Concurrency:

Other Considerations:

Member Function: TRequestBasedMemberFunctionConnectionTo::GetDefaultFunction

Interface Category:

Purpose:

Calling Context:

Parameters:

• Takes no parameters.

Return Value:

Exceptions:

Concurrency:

Other Considerations:

Member Function: TRequestBasedMemberFunctionConnectionTo::SetReceiver

1. void SetReceiver (AReceiver * theReceiver)
2. void SetReceiver (AReceiver * theReceiver, MemberFunction defaultFunction)

Interface Category:

Purpose:

1. Changes the object that will receive the notifications.
2. Changes the object that will receive the notifications and the default notification handler member function.

Calling Context:

1. Call this function directly.
2. Call this function directly.

Parameters:

• AReceiver * theReceiver -The object to receive the notifications.
• AReceiver * theReceiver -The object to receive the notifications.
• MemberFunction defaultFunction -The default notification handler member function.

Return Value:

Exceptions:

Concurrency:

Other Considerations:

Member Function: TRequestBasedMemberFunctionConnectionTo::AddInterest

1. virtual void AddInterest (const TInterest &)
2. void AddInterest (const TInterest &, MemberFunction)

Interface Category:

Purpose:

1. Adds an interest for a notification. A new interest is added by a client of a notifier to express the desire to receive notifications that are generated and that are associated with this interest. If the connection is already connected to the notifier, then the receiver will immediately begin to receive the notifications associated with this interest. The default notification handler member function of the object will be called for notifications associated with this interest.
2. Adds an interest for a notification. A new interest is added by a client of a notifier to express the desire to receive notifications that are generated and that are associated with this interest. If the connection is already connected to the notifier, then the receiver will immediately begin to receive the notifications associated with this interest. The specified member function will be invoked against the object when notifications associated with this interest arrive.

Calling Context:

1. Call this function directly.
2. Call this function directly.

Parameters:

• const TInterest & -The interest specifying which notifications to receive.
• const TInterest & -The interest specifying which notifications to receive.
• MemberFunction -The notification handler member function for notifications associated with this interest.

Return Value:

Exceptions:

Concurrency:

Other Considerations:

Member Function: TRequestBasedMemberFunctionConnectionTo::AdoptInterest

1. virtual void AdoptInterest (TInterest *)
2. void AdoptInterest (TInterest *, MemberFunction)

Interface Category:

Purpose:

1. Adopts an existing interest into the connection's own collection of interests. A new interest is added by a client of a notifier to express the desire to receive notifications that are generated and that are associated with this interest. If the connection is already connected to the notifier, then the receiver will immediately begin to receive the notifications associated with this interest. The default notification handler member function of the object will be called for notifications associated with this interest.
2. 2.Adopts an existing interest into the connection's own collection of interests. A new interest is added by a client of a notifier to express the desire to receive notifications that are generated and that are associated with this interest. If the connection is already connected to the notifier, then the receiver will immediately begin to receive the notifications associated with this interest. The specified member function will be invoked against the object when notifications associated with this interest arrive.

Calling Context:

1. Call this function directly.
2. Call this function directly.

Parameters:

• TInterest * -The interest specifying which notifications to receive.
• TInterest * -The interest specifying which notifications to receive.
• MemberFunction -The notification handler member function for notifications associated with this interest.

Return Value:

Exceptions:

Concurrency:

Other Considerations: