org.omg.CosNotifyChannelAdmin
Interface SequenceProxyPullSupplierOperations

All Superinterfaces:
FilterAdminOperations, NotifySubscribeOperations, ProxySupplierOperations, QoSAdminOperations, SequencePullSupplierOperations
All Known Subinterfaces:
SequenceProxyPullSupplier
All Known Implementing Classes:
_SequenceProxyPullSupplierStub, SequenceProxyPullSupplierImpl, SequenceProxyPullSupplierPOA, SequenceProxyPullSupplierPOATie

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 instance?s 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
 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.
 
Methods inherited from interface org.omg.CosNotifyChannelAdmin.ProxySupplierOperations
lifetime_filter, lifetime_filter, MyAdmin, MyType, obtain_offered_types, priority_filter, priority_filter, validate_event_qos
 
Methods inherited from interface org.omg.CosNotification.QoSAdminOperations
get_qos, set_qos, validate_qos
 
Methods inherited from interface org.omg.CosNotifyFilter.FilterAdminOperations
add_filter, get_all_filters, get_filter, remove_all_filters, remove_filter
 
Methods inherited from interface org.omg.CosNotifyComm.SequencePullSupplierOperations
disconnect_sequence_pull_supplier, pull_structured_events, try_pull_structured_events
 
Methods inherited from interface org.omg.CosNotifyComm.NotifySubscribeOperations
subscription_change
 

Method Detail

connect_sequence_pull_consumer

void connect_sequence_pull_consumer(SequencePullConsumer pull_consumer)
                                    throws AlreadyConnected
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
AlreadyConnected