org.omg.CosNotifyChannelAdmin
Interface ProxyPushConsumerOperations
- All Superinterfaces:
- FilterAdminOperations, NotifyPublishOperations, ProxyConsumerOperations, PushConsumerOperations, QoSAdminOperations
- All Known Subinterfaces:
- ProxyPushConsumer
- All Known Implementing Classes:
- _ProxyPushConsumerStub, ProxyPushConsumerImpl, ProxyPushConsumerPOA, ProxyPushConsumerPOATie
public interface ProxyPushConsumerOperations
- extends ProxyConsumerOperations, PushConsumerOperations
The ProxyPushConsumer interface supports connections to the channel by suppliers
who will push events to the channel as untyped Anys.
Through inheritance of the ProxyConsumer interface, the ProxyPushConsumer
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
ProxyPushConsumer 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 ProxyPushConsumer interface also inherits from the PushConsumer interface
defined within the CosNotifyComm module. This interface supports the push
operation which the supplier connected to a ProxyPushConsumer instance will
invoke to send an event to the channel in the form of an Any, and the operation
required to disconnect the ProxyPushConsumer from its associated supplier. In
addition, since the inherited PushConsumer interface inherits the
CosNotifyComm::NotifyPublish interface, a supplier connected to an instance
supporting the ProxyPushConsumer interface can inform it whenever the list of event
types the supplier plans to supply changes.
Finally, the ProxyPushConsumer interface defines the operation which can be
invoked by a push supplier to establish the connection over which the push supplier
will send events to the channel. Note that this can be either a pure event service style,
or a notification service style push supplier.
Method Summary |
void |
connect_any_push_supplier(PushSupplier push_supplier)
The connect_any_push_supplier operation accepts as an input parameter the reference
to an object supporting the PushSupplier interface defined within the
CosEventComm module of the OMG Event Service. |
connect_any_push_supplier
void connect_any_push_supplier(PushSupplier push_supplier)
throws AlreadyConnected
- The connect_any_push_supplier operation accepts as an input parameter the reference
to an object supporting the PushSupplier interface defined within the
CosEventComm module of the OMG Event Service. 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 untyped Anys. This operation is thus invoked in order to
establish a connection between a push-style supplier of events in the form of Anys, and
the notification channel. Once established, the supplier can proceed to send events to
the channel by invoking the push operation supported by the target
ProxyPushConsumer instance. If the target object of this operation is already
connected to a push supplier object, the AlreadyConnected exception will be raised.
Note that because the PushSupplier interface defined in the CosNotifyComm module
inherits from the PushSupplier interface defined in the CosEventComm module, the
input parameter to this operation could be either a pure event service style, or a
notification service style push supplier. The only difference between the two are that
the latter also supports the NotifySubscribe interface, and thus can be the target of
subscription_change invocations. The implementation of the ProxyPushConsumer
interface should attempt to narrow the input parameter to
CosNotifyComm::PushSupplier in order to determine which style of push supplier is
connecting to it.
- Throws:
AlreadyConnected