|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface EventChannelOperations
The EventChannel interface encapsulates the behaviors supported by a Notification Service event channel. This interface inherits from the EventChannel interface defined within the CosEventChannelAdmin module of the OMG Event Service, making an instance of the Notification Service EventChannel interface fully backward compatible with an OMG Event Service style untyped event channel. Inheritance of the EventChannel interface defined within the CosEventChannelAdmin module enables an instance of the EventChannel interface defined within the CosNotifyChannelAdmin module to create event service style ConsumerAdmin and SupplierAdmin instances. These instances can subsequently be used to create pure event service style proxy interfaces, which support connections to pure event service style suppliers and consumers. Note that while Notification Service style proxies and admin objects have unique identifiers associated with them, enabling their references to be obtained by invoking operations on the Notification Service style admin and event channel interfaces, Event Service style proxies and admin objects do not have associated unique identifiers, and thus cannot be returned by invoking an operation on the Notification Service style admin or event channel interfaces. The EventChannel interface defined within the CosNotifyChannelAdmin module also inherits from the QoSAdmin and the AdminPropertiesAdmin interfaces defined within the CosNotification module. Inheritance of these interfaces enables a Notification Service style event channel to manage lists of associated QoS and administrative properties, respectively. Locally, the EventChannel interface supports a readonly attribute which maintains a reference to the EventChannelFactory instance that created it. In addition, each instance of the EventChannel interface has an associated default ConsumerAdmin and an associated default SupplierAdmin instance, both of which exist upon creation of the channel and which have the unique identifier of zero (note that admin object identifiers only need to be unique among a given type of admin, implying that the identifiers assigned to ConsumerAdmin objects can overlap those assigned to SupplierAdmin objects). The EventChannel interface supports readonly attributes which maintain references to these default admin objects. The EventChannel interface supports operations which create new ConsumerAdmin and SupplierAdmin instances. In addition, the EventChannel interface supports operations which can return references to the ConsumerAdmin and SupplierAdmin instances associated with a given EventChannel instance, given the unique identifier of an admin object as input. Finally, the EventChannel interface supports operations which return the sequence of unique identifiers of all ConsumerAdmin and SupplierAdmin instances associated with a given EventChannel instance.
Method Summary | |
---|---|
ConsumerAdmin |
default_consumer_admin()
The default_consumer_admin attribute is a readonly attribute which maintains a reference to the default ConsumerAdmin instance associated with the target EventChannel instance. |
FilterFactory |
default_filter_factory()
The default_filter_factory attribute is a readonly attribute which maintains an object reference to the default factory to be used by the EventChannel instance with which it is associated for creating filter objects. |
SupplierAdmin |
default_supplier_admin()
The default_supplier_admin attribute is a readonly attribute which maintains a reference to the default SupplierAdmin instance associated with the target EventChannel instance. |
int[] |
get_all_consumeradmins()
The get_all_consumeradmins operation takes no input parameters and returns a sequence of the unique identifiers assigned to all Notification Service style ConsumerAdmin instances which have been created by the target EventChannel instance. |
int[] |
get_all_supplieradmins()
The get_all_supplieradmins operation takes no input parameters and returns a sequence of the unique identifiers assigned to all Notification Service style SupplierAdmin instances which have been created by the target EventChannel instance. |
ConsumerAdmin |
get_consumeradmin(int id)
The get_consumeradmin operation returns a reference to one of the ConsumerAdmin instances associated with the target EventChannel instance. |
SupplierAdmin |
get_supplieradmin(int id)
The get_supplieradmin operation returns a reference to one of the SupplierAdmin instances associated with the target EventChannel instance. |
EventChannelFactory |
MyFactory()
The MyFactory attribute is a readonly attribute which maintains the object reference of the event channel factory that created a given Notification Service EventChannel instance. |
ConsumerAdmin |
new_for_consumers(InterFilterGroupOperator op,
org.omg.CORBA.IntHolder id)
The new_for_consumers operation is invoked to create a new Notification Service style ConsumerAdmin instance. |
SupplierAdmin |
new_for_suppliers(InterFilterGroupOperator op,
org.omg.CORBA.IntHolder id)
The new_for_suppliers operation is invoked to create a new Notification Service style SupplierAdmin instance. |
Methods inherited from interface org.omg.CosNotification.QoSAdminOperations |
---|
get_qos, set_qos, validate_qos |
Methods inherited from interface org.omg.CosNotification.AdminPropertiesAdminOperations |
---|
get_admin, set_admin |
Methods inherited from interface org.omg.CosEventChannelAdmin.EventChannelOperations |
---|
destroy, for_consumers, for_suppliers |
Method Detail |
---|
EventChannelFactory MyFactory()
ConsumerAdmin default_consumer_admin()
SupplierAdmin default_supplier_admin()
FilterFactory default_filter_factory()
ConsumerAdmin new_for_consumers(InterFilterGroupOperator op, org.omg.CORBA.IntHolder id)
op
- Operator of Filters' composition (between consumer filters and proxies filters)id
- Id of the new consumer admin
SupplierAdmin new_for_suppliers(InterFilterGroupOperator op, org.omg.CORBA.IntHolder id)
op
- Operator of Filters' composition (between supplier filters and proxies filters)id
- Id of the new consumer admin
ConsumerAdmin get_consumeradmin(int id) throws AdminNotFound
id
- Id of consumer admin to retreive
AdminNotFound
- Id doesn't correspond to any consumer adminSupplierAdmin get_supplieradmin(int id) throws AdminNotFound
id
- Id of supplier admin to retreive
AdminNotFound
- Id doesn't correspond to any supplier adminint[] get_all_consumeradmins()
int[] get_all_supplieradmins()
|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |