org.omg.CosNotifyChannelAdmin
Interface SequenceProxyPullConsumerOperations

All Superinterfaces:

FilterAdminOperations, NotifyPublishOperations, ProxyConsumerOperations, QoSAdminOperations, SequencePullConsumerOperations

All Known Subinterfaces:

SequenceProxyPullConsumer

public interface SequenceProxyPullConsumerOperations
extends ProxyConsumerOperations, SequencePullConsumerOperations

The SequenceProxyPullConsumer interface supports connections to the channel by suppliers who will make events available for pulling to the channel as sequences of Structured Events. Through inheritance of the ProxyConsumer interface, the SequenceProxyPullConsumer interface supports administration of various QoS properties, administration of a list of associated filter objects, and a readonly attribute containing the reference of the SupplierAdmin object which created it. In addition, this inheritance implies that a SequenceProxyPullConsumer instance supports an operation which will return the list of event types which consumers connected to the same channel are interested in receiving, and an operation which can return information about the instance?s ability to accept a per-event QoS request.

The SequenceProxyPullConsumer interface also inherits from the SequencePullConsumer interface defined in the CosNotifyComm module. This interface supports the operation which can be invoked to close down the connection from the supplier to the SequenceProxyPullConsumer. In addition, since the SequencePullConsumer interface inherits from the NotifyPublish interface, a supplier can inform the SequenceProxyPullConsumer to which it is connected whenever the list of event types it plans to supply to the channel changes.

Lastly, the SequenceProxyPullConsumer interface defines a method that can be invoked by a pull-style supplier of sequences of Structured Events in order to establish a connection between the supplier and a notification channel over which the supplier will proceed to send events. The SequenceProxyPullConsumer interface also defines a pair of operations which can suspend and resume the connection between a SequenceProxyPullConsumer instance and its associated SequencePullSupplier. During the time such a connection is suspended, the SequenceProxyPullConsumer will not attempt to pull events from its associated SequencePullSupplier.

Method Summary

void	connect_sequence_pull_supplier(SequencePullSupplier pull_supplier) This operation is invoked in order to establish a connection between a pull-style supplier of events in the form of sequences of Structured Events, and the notification channel.
void	resume_connection() The resume_connection operation causes the target object supporting the SequenceProxyPullConsumer interface to resume attempting to pull events (using pull or try_pull) from the SequencePullSupplier instance connected to it.
void	suspend_connection() The suspend_connection operation causes the target object supporting the SequenceProxyPullConsumer interface to stop attempting to pull events (using pull or try_pull) from the SequencePullSupplier instance connected to it.

Methods inherited from interface org.omg.CosNotifyChannelAdmin.ProxyConsumerOperations

MyAdmin, MyType, obtain_subscription_types, 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.SequencePullConsumerOperations

disconnect_sequence_pull_consumer

Methods inherited from interface org.omg.CosNotifyComm.NotifyPublishOperations

offer_change

Method Detail

resume_connection

void resume_connection()
                       throws ConnectionAlreadyActive,
                              NotConnected

The resume_connection operation causes the target object supporting the SequenceProxyPullConsumer interface to resume attempting to pull events (using pull or try_pull) from the SequencePullSupplier instance connected to it. This operation takes no input parameters and returns no values.

Throws:

ConnectionAlreadyActive - If the connection has not been previously suspended using this operation by invoking suspend_connection (described above).

NotConnected - If no SequencePullSupplier has been connected to the target object when this operation is invoked.

suspend_connection

void suspend_connection()
                        throws ConnectionAlreadyInactive,
                               NotConnected

The suspend_connection operation causes the target object supporting the SequenceProxyPullConsumer interface to stop attempting to pull events (using pull or try_pull) from the SequencePullSupplier instance connected to it. This operation takes no input parameters and returns no values.

Throws:

ConnectionAlreadyInactive - If the connection has been previously suspended using this operation and not resumed by invoking resume_connection (described below).

NotConnected - If no SequencePullSupplier has been connected to the target object when this operation is invoked.

connect_sequence_pull_supplier

void connect_sequence_pull_supplier(SequencePullSupplier pull_supplier)
                                    throws AlreadyConnected,
                                           TypeError

This operation is invoked in order to establish a connection between a pull-style supplier of events in the form of sequences of Structured Events, and the notification channel. Once established, the channel can proceed to receive events from the supplier by invoking the pull_structured_events or try_pull_structured_events operations supported by the supplier (whether the channel will invoke pull_structured_events or try_pull_structured_events, and the frequency with which it will perform such invocations, is a detail that is specific to the implementation of the channel).

Parameters:

pull_supplier - The reference to an object supporting the SequencePullSupplier interface defined within the CosNotifyComm module. This reference is that of a supplier that plans to make events available for pulling to the channel with 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 supplier object.

TypeError - If the pull supplier being connected does not meet additional requirements, which may be imposed by this implementation on the interface supported by a pull supplier (e.g., it may be designed to invoke some operation other than pull_structured_events or try_pull_structured_events in order to receive events).