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. |
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