Main Page   Namespace List   Class Hierarchy   Alphabetical List   Compound List   File List   Namespace Members   Compound Members   File Members   Related Pages  

RtecEventChannelAdmin::ProxyPushSupplier Interface Reference

Interface used to implement the Abstract Session pattern for the consumers. More...

import "RtecEventChannelAdmin.idl";

Inheritance diagram for RtecEventChannelAdmin::ProxyPushSupplier:

Inheritance graph
[legend]
Collaboration diagram for RtecEventChannelAdmin::ProxyPushSupplier:

Collaboration graph
[legend]
List of all members.

Public Methods

void connect_push_consumer (in RtecEventComm::PushConsumer push_consumer, in ConsumerQOS qos) raises (AlreadyConnected, TypeError)
 Connect a consumer with the Event Channel.

void suspend_connection ()
void resume_connection ()
 Resume the reception of events.


Detailed Description

Interface used to implement the Abstract Session pattern for the consumers.

Each consumer converse with the Event Channel via a different object that implements the ProxyPushSupplier interface. This is a common idiom in CORBA, as it allows the identification of the remove consumer efficiently.


Member Function Documentation

void RtecEventChannelAdmin::ProxyPushSupplier::connect_push_consumer in RtecEventComm::PushConsumer    push_consumer,
in ConsumerQOS    qos
raises (AlreadyConnected, TypeError)
 

Connect a consumer with the Event Channel.

The ConsumerQOS argument is used to setup the filtering and QoS properties of the consumer.

Parameters:
push_consumer  The consumer that will receive the events.
qos  The QoS properties for this consumer
Exceptions:
CORBA::BAD_PARAM  if push_consumer is nil
AlreadyConnected  if this operation is invoked multiple times
Todo:
The TypeError exception is not used and should be removed.

void RtecEventChannelAdmin::ProxyPushSupplier::resume_connection  
 

Resume the reception of events.

void RtecEventChannelAdmin::ProxyPushSupplier::suspend_connection  
 

Calling this method is more efficient than dropping the events when received by the consumer, and less expensive than disconnecting and connecting again (but it is not free!!)


The documentation for this interface was generated from the following file:
Generated on Fri Apr 2 18:32:31 2004 for TAO_RTEvent by doxygen1.2.18