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.
Method Summary
voidconnect_structured_pull_consumer(StructuredPullConsumer pull_consumer)
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.

Method Detail

connect_structured_pull_consumer

public void connect_structured_pull_consumer(StructuredPullConsumer pull_consumer)
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