org.omg.CosNotifyChannelAdmin
Interface StructuredProxyPullConsumer
- All Superinterfaces:
- FilterAdmin, FilterAdminOperations, org.omg.CORBA.portable.IDLEntity, NotifyPublish, NotifyPublishOperations, org.omg.CORBA.Object, ProxyConsumer, ProxyConsumerOperations, QoSAdmin, QoSAdminOperations, java.io.Serializable, StructuredProxyPullConsumerOperations, StructuredPullConsumer, StructuredPullConsumerOperations
- All Known Implementing Classes:
- _StructuredProxyPullConsumerStub
public interface StructuredProxyPullConsumer
- extends StructuredProxyPullConsumerOperations, ProxyConsumer, StructuredPullConsumer, org.omg.CORBA.Object, org.omg.CORBA.portable.IDLEntity
The StructuredProxyPullConsumer interface supports connections to the channel by
suppliers who will make events available for pulling to the channel as Structured
Events. Through inheritance of the ProxyConsumer interface, the
StructuredProxyPullConsumer 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 StructuredProxyPullConsumer 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 StructuredProxyPullConsumer interface also inherits from the
StructuredPullConsumer 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 StructuredProxyPullConsumer. In addition, since the
StructuredPullConsumer interface inherits from the NotifyPublish interface, a
supplier can inform the StructuredProxyPullConsumer to which it is connected
whenever the list of event types it plans to supply to the channel changes.
Lastly, the StructuredProxyPullConsumer interface defines a method that can be
invoked by a pull-style supplier 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 StructuredProxyPullConsumer interface also defines a pair of
operations which can suspend and resume the connection between a
StructuredProxyPullConsumer instance and its associated StructuredPullSupplier.
During the time such a connection is suspended, the StructuredProxyPullConsumer
will not attempt to pull events from its associated StructuredPullSupplier.