org.omg.CosNotifyChannelAdmin

Interface SequenceProxyPullSupplierOperations

public interface SequenceProxyPullSupplierOperations extends ProxySupplierOperations, SequencePullSupplierOperations

The SequenceProxyPullSupplier interface supports connections to the channel by consumers who will pull events from the channel as sequences of Structured Events. Through inheritance of the ProxySupplier interface, the SequenceProxyPullSupplier interface supports administration of various QoS properties, administration of a list of associated filter objects, and a readonly attribute containing the reference of the ConsumerAdmin object which created it. In addition, this inheritance implies that a SequenceProxyPullSupplier instance supports an operation which will return the list of event types which the proxy supplier will potentially by supplying, and an operation which can return information about the instances ability to accept a per-event QoS request. The SequenceProxyPullSupplier interface also inherits from the SequencePullSupplier interface defined in the CosNotifyComm module. This interface supports the operations which enable a consumer of sequences of Structured Events to pull them from the SequenceProxyPullSupplier, and also the operation which can be invoked to close down the connection from the consumer to the SequenceProxyPullSupplier. In addition, since the SequencePullSupplier interface inherits from the NotifySubscribe interface, a SequenceProxyPullSupplier can be notified whenever the list of event types which its associated consumer is interested in receiving changes. This notification occurs via the callback mechanism described in section 2.3. Lastly, the SequenceProxyPullSupplier interface defines a method that can be invoked by a pull-style consumer of sequences of Structured Events in order to establish a connection between the consumer and a notification channel over which the consumer will proceed to receive events.
Method Summary
voidconnect_sequence_pull_consumer(SequencePullConsumer pull_consumer)
The connect_sequence_pull_consumer operation accepts as an input parameter the reference to an object supporting the SequencePullConsumer interface defined within the CosNotifyComm module.

Method Detail

connect_sequence_pull_consumer

public void connect_sequence_pull_consumer(SequencePullConsumer pull_consumer)
The connect_sequence_pull_consumer operation accepts as an input parameter the reference to an object supporting the SequencePullConsumer interface defined within the CosNotifyComm module. This reference is that of a consumer which plans to pull events from the channel to which the target object is associated in the form of sequences of Structured Events. This operation is thus invoked in order to establish a connection between a pull-style consumer of events in the form of sequences of Structured Events, and the notification channel. Once established, the consumer can proceed to receive events from the channel by invoking the pull_structured_events or try_pull_structured_events operations supported by the target SequenceProxyPullSupplier instance. If the target object of this operation is already connected to a pull consumer object, the AlreadyConnected exception will be raised.

Parameters: pull_consumer Push consumer to connect to the proxy

Throws: CosEventChannelAdmin::AlreadyConnected The proxy is already connected