RtecEventChannelAdmin::ProxyPushSupplier Interface Reference

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

import "RtecEventChannelAdmin.idl";

Inheritance diagram for RtecEventChannelAdmin::ProxyPushSupplier:

[legend]Collaboration diagram for RtecEventChannelAdmin::ProxyPushSupplier:

[legend]List of all members.

Public Member Functions
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::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!!)

void RtecEventChannelAdmin::ProxyPushSupplier::resume_connection

(

)

Resume the reception of events.

---

The documentation for this interface was generated from the following file:

• RtecEventChannelAdmin.idl

---