org.omg.CosNotifyChannelAdmin
Interface SequenceProxyPushConsumerOperations
public
interface
SequenceProxyPushConsumerOperations
extends ProxyConsumerOperations, SequencePushConsumerOperations
The SequenceProxyPushConsumer interface supports connections to the channel by
suppliers who will push events to the channel as sequences of Structured Events.
Through inheritance of the ProxyConsumer interface, the
SequenceProxyPushConsumer 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 SequenceProxyPushConsumer 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 instances ability to accept a per-event QoS request.
The SequenceProxyPushConsumer interface also inherits from the
SequencePushConsumer interface defined in the CosNotifyComm module. This
interface supports the operation which enables a supplier of sequences of Structured
Events to push them to the SequenceProxyPushConumer, and also the operation
which can be invoked to close down the connection from the supplier to the
SequenceProxyPushConsumer. In addition, since the SequencePushConsumer
interface inherits from the NotifyPublish interface, a supplier can inform the
SequenceProxyPushConsumer to which it is connected whenever the list of event
types it plans to supply to the channel changes.
Lastly, the SequenceProxyPushConsumer interface defines a method that can be
invoked by a push-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 connect_sequence_push_supplier operation accepts as an input parameter the
reference to an object supporting the SequencePushSupplier interface defined within
the CosNotifyComm module. This reference is that of a supplier which plans to push
events to the channel with 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 push-style supplier of events in the form of sequences of
Structured Events, and the notification channel. Once established, the supplier can
proceed to send events to the channel by invoking the push_structured_events
operation supported by the target SequenceProxyPushConsumer instance. If the
target object of this operation is already connected to a push supplier object, the
AlreadyConnected exception will be raised.
Parameters: push_supplier Push supplier to connect to the proxy
Throws: CosEventChannelAdmin::AlreadyConnected The proxy is already connected