org.omg.CosNotifyChannelAdmin
Interface StructuredProxyPullSupplierOperations
public
interface
StructuredProxyPullSupplierOperations
extends ProxySupplierOperations, StructuredPullSupplierOperations
The StructuredProxyPullSupplier interface supports connections to the channel by
consumers who will pull events from the channel as Structured Events. Through
inheritance of the ProxySupplier interface, the StructuredProxyPullSupplier
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
StructuredProxyPullSupplier 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 instances ability to accept a per-event QoS
request.
The StructuredProxyPullSupplier interface also inherits from the
StructuredPullSupplier interface defined in the CosNotifyComm module. This
interface supports the operations which enable a consumer of Structured Events to pull
them from the StructuredProxyPullSupplier, and also the operation which can be
invoked to close down the connection from the consumer to the
StructuredProxyPullSupplier. In addition, since the StructuredPullSupplier
interface inherits from the NotifySubscribe interface, a StructuredProxyPullSupplier
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 StructuredProxyPullSupplier interface defines a method that can be
invoked by a pull-style consumer 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.
The connect_structured_pull_consumer operation accepts as an input parameter the
reference to an object supporting the StructuredPullConsumer 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
Structured Events. This operation is thus invoked in order to establish a connection
between a pull-style consumer of events in the form of Structured Events, and the
notification channel. Once established, the consumer can proceed to receive events
from the channel by invoking the pull_structured_event or try_pull_structured_event
operations supported by the target StructuredProxyPullSupplier 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