MOLDURAS Y CUBREJUNTAS:

TheEventChannelinterface encapsulates the behaviors supported by a Notification Service event channel. This interface inherits from theEventChannelinterface defined within theCosEventChannelAdminmodule of the OMG Event Service, making an instance of the Notification ServiceEventChannelinterface fully backward compatible with an OMG Event Service style untyped event channel. Inheritance of theEventChannelinterface defined within the

CosEventChannelAdminmodule enables an instance of theEventChannel

interface defined within theCosNotifyChannelAdminmodule to create event service styleConsumerAdminandSupplierAdmininstances. 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.

TheEventChannelinterface defined within theCosNotifyChannelAdminmodule also inherits from theQoSAdminand theAdminPropertiesAdmininterfaces defined within theCosNotificationmodule. Inheritance of these interfaces enables a Notification Service style event channel to manage lists of associated QoS and administrative properties, respectively.

Locally, theEventChannelinterface supports a readonly attribute that maintains a reference to theEventChannelFactoryinstance that created it. In addition, each instance of theEventChannelinterface has an associated defaultConsumerAdmin

and an associated defaultSupplierAdmininstance, 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 toConsumerAdminobjects can overlap those assigned to

SupplierAdminobjects). TheEventChannelinterface supports readonly attributes which maintain references to these default admin objects.

TheEventChannelinterface supports operations that create newConsumerAdmin

andSupplierAdmininstances. In addition, theEventChannelinterface supports operations which can return references to theConsumerAdminandSupplierAdmin

instances associated with a givenEventChannelinstance, given the unique identifier of an admin object as input. Finally, theEventChannelinterface supports operations, which return the sequence of unique identifiers of allConsumerAdminand

SupplierAdmininstances associated with a givenEventChannelinstance.

3.4.17.1 MyFactory

TheMyFactoryattribute is a readonly attribute that maintains the object reference of the event channel factory, which created a given Notification ServiceEventChannel

instance.

3.4.17.2 default_consumer_admin

Thedefault_consumer_adminattribute is a readonly attribute that maintains a reference to the defaultConsumerAdmininstance associated with the target

EventChannelinstance. EachEventChannelinstance has an associated default

ConsumerAdmininstance, which exists upon creation of the channel and is assigned the unique identifier of zero. Subsequently, clients can create additional Event Service styleConsumerAdmininstances by invoking the inheritedfor_consumers

operation, and additional Notification Service styleConsumerAdmininstances by invoking thenew_for_consumersoperation defined by theEventChannel

3.4.17.3 default_supplier_admin

Thedefault_supplier_adminattribute is a readonly attribute that maintains a reference to the defaultSupplierAdmininstance associated with the target

EventChannelinstance. EachEventChannelinstance has an associated default

SupplierAdmininstance, which exists upon creation of the channel and is assigned the unique identifier of zero. Subsequently, clients can create additional Event Service styleSupplierAdmininstances by invoking the inheritedfor_suppliersoperation, and additional Notification Service styleSupplierAdmininstances by invoking the

new_for_suppliersoperation defined by theEventChannelinterface.

3.4.17.4 default_filter_factory

Thedefault_filter_factoryattribute is a readonly attribute that maintains an object reference to the default factory to be used by theEventChannelinstance with which it’s associated for creating filter objects. If the target channel does not support a default filter factory, the attribute will maintain the value of OBJECT_NIL.

3.4.17.5 new_for_consumers

Thenew_for_consumersoperation is invoked to create a new Notification Service styleConsumerAdmininstance. The operation accepts as an input parameter a boolean flag, which indicates whether AND or OR semantics will be used when combining the filter objects associated with the newly createdConsumerAdmin

instance with those associated with a supplier proxy, which was created by the

ConsumerAdminduring the evaluation of each event against a set of filter objects. The new instance is assigned a unique identifier by the targetEventChannelinstance that is unique among allConsumerAdmininstances currently associated with the channel. Upon completion, the operation returns the reference to the new

ConsumerAdmininstance as the result of the operation, and the unique identifier assigned to the newConsumerAdmininstance as the output parameter.

3.4.17.6 new_for_suppliers

Thenew_for_suppliersoperation is invoked to create a new Notification Service styleSupplierAdmininstance. The operation accepts as an input parameter a boolean flag, which indicates whether AND or OR semantics will be used when combining the filter objects associated with the newly createdSupplierAdmininstance with those associated with a consumer proxy, which was created by theSupplierAdminduring the evaluation of each event against a set of filter objects. The new instance is assigned a unique identifier by the targetEventChannelinstance that is unique among all

SupplierAdmininstances currently associated with the channel. Upon completion, the operation returns the reference to the newSupplierAdmininstance as the result of the operation, and the unique identifier assigned to the newSupplierAdmin

3.4.17.7 get_consumeradmin

Theget_consumeradminoperation returns a reference to one of the

ConsumerAdmininstances associated with the targetEventChannelinstance. The operation accepts as an input parameter a numeric value which is intended to be the unique identifier of one of theConsumerAdmininstances associated with the target

EventChannelinstance. If this turns out to be the case, the object reference of the associatedConsumerAdmininstance is returned as the operation result. Otherwise, theAdminNotFoundexception is raised.

Note that while a Notification Service style event channel can support both Event Service and Notification Service styleConsumerAdmininstances, only Notification Service styleConsumerAdmininstances have associated unique identifiers.

3.4.17.8 get_supplieradmin

Theget_supplieradminoperation returns a reference to one of theSupplierAdmin

instances associated with the targetEventChannelinstance. The operation accepts as an input parameter a numeric value which is intended to be the unique identifier of one of theSupplierAdmininstances associated with the targetEventChannelinstance. If this turns out to be the case, the object reference of the associatedSupplierAdmin

instance is returned as the operation result. Otherwise, theAdminNotFound exception is raised.

Note that while a Notification Service style event channel can support both Event Service and Notification Service styleSupplierAdmininstances, only Notification Service styleSupplierAdmininstances have associated unique identifiers.

3.4.17.9 get_all_consumeradmins

Theget_all_consumeradminsoperation takes no input parameters and returns a sequence of the unique identifiers assigned to all Notification Service style

ConsumerAdmininstances, which have been created by the targetEventChannel

instance.

3.4.17.10 get_all_supplieradmins

Theget_all_supplieradminsoperation takes no input parameters and returns a sequence of the unique identifiers assigned to all Notification Service style

SupplierAdmininstances which have been created by the targetEventChannel

instance.