org.omg.CosNotifyChannelAdmin
Interface SequenceProxyPullSupplierOperations

All Superinterfaces:

FilterAdminOperations, NotifySubscribeOperations, ProxySupplierOperations, QoSAdminOperations, SequencePullSupplierOperations

All Known Subinterfaces:

SequenceProxyPullSupplier

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 that created it. In addition, this inheritance implies that a SequenceProxyPullSupplier instance supports an operation that will return the list of event types, which the proxy supplier will potentially be supplying, and an operation that 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 that enable a consumer of sequences of Structured Events to pull them from the SequenceProxyPullSupplier, and the operation that 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.

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) This operation is 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.

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

This operation is 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.

Parameters:

pull_consumer - The reference to an object supporting the SequencePullConsumer interface defined within the CosNotifyComm module. This reference is that of a consumer that plans to pull events from the channel to which the target object is associated in the form of sequences of Structured Events.

Throws:

AlreadyConnected - If the target object of this operation is already connected to a pull consumer object.