org.omg.CosNotifyChannelAdmin
Class EventChannelPOATie

java.lang.Object
  extended by org.omg.PortableServer.Servant
      extended by org.omg.CosNotifyChannelAdmin.EventChannelPOA
          extended by org.omg.CosNotifyChannelAdmin.EventChannelPOATie
All Implemented Interfaces:
org.omg.CORBA.portable.InvokeHandler, EventChannelOperations, AdminPropertiesAdminOperations, QoSAdminOperations

public class EventChannelPOATie
extends EventChannelPOA

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.


Constructor Summary
EventChannelPOATie(EventChannelOperations tieObject)
          Constructor
EventChannelPOATie(EventChannelOperations tieObject, org.omg.PortableServer.POA poa)
          Constructor
 
Method Summary
 org.omg.PortableServer.POA _default_POA()
          _default_POA method
 EventChannelOperations _delegate()
          Get the delegate
 void _delegate(EventChannelOperations delegate_)
          Set the delegate
 ConsumerAdmin default_consumer_admin()
          Read accessor for default_consumer_admin attribute
 FilterFactory default_filter_factory()
          Read accessor for default_filter_factory attribute
 SupplierAdmin default_supplier_admin()
          Read accessor for default_supplier_admin attribute
 void destroy()
          Operation destroy
 ConsumerAdmin for_consumers()
          Operation for_consumers
 SupplierAdmin for_suppliers()
          Operation for_suppliers
 Property[] get_admin()
          Operation get_admin
 int[] get_all_consumeradmins()
          Operation get_all_consumeradmins
 int[] get_all_supplieradmins()
          Operation get_all_supplieradmins
 ConsumerAdmin get_consumeradmin(int id)
          Operation get_consumeradmin
 Property[] get_qos()
          Operation get_qos
 SupplierAdmin get_supplieradmin(int id)
          Operation get_supplieradmin
 EventChannelFactory MyFactory()
          Read accessor for MyFactory attribute
 ConsumerAdmin new_for_consumers(InterFilterGroupOperator op, org.omg.CORBA.IntHolder id)
          Operation new_for_consumers
 SupplierAdmin new_for_suppliers(InterFilterGroupOperator op, org.omg.CORBA.IntHolder id)
          Operation new_for_suppliers
 void set_admin(Property[] admin)
          Operation set_admin
 void set_qos(Property[] qos)
          Operation set_qos
 void validate_qos(Property[] required_qos, NamedPropertyRangeSeqHolder available_qos)
          Operation validate_qos
 
Methods inherited from class org.omg.CosNotifyChannelAdmin.EventChannelPOA
_all_interfaces, _invoke, _this, _this
 
Methods inherited from class org.omg.PortableServer.Servant
_get_delegate, _get_interface_def, _is_a, _non_existent, _object_id, _orb, _poa, _set_delegate, _this_object, _this_object
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

EventChannelPOATie

public EventChannelPOATie(EventChannelOperations tieObject)
Constructor


EventChannelPOATie

public EventChannelPOATie(EventChannelOperations tieObject,
                          org.omg.PortableServer.POA poa)
Constructor

Method Detail

_delegate

public EventChannelOperations _delegate()
Get the delegate


_delegate

public void _delegate(EventChannelOperations delegate_)
Set the delegate


_default_POA

public org.omg.PortableServer.POA _default_POA()
_default_POA method

Overrides:
_default_POA in class org.omg.PortableServer.Servant

MyFactory

public EventChannelFactory MyFactory()
Read accessor for MyFactory attribute

Returns:
Channel's factory

default_consumer_admin

public ConsumerAdmin default_consumer_admin()
Read accessor for default_consumer_admin attribute

Returns:
the default consumer admin

default_supplier_admin

public SupplierAdmin default_supplier_admin()
Read accessor for default_supplier_admin attribute

Returns:
the default supplier admin

default_filter_factory

public FilterFactory default_filter_factory()
Read accessor for default_filter_factory attribute

Returns:
the default filter factory

new_for_consumers

public ConsumerAdmin new_for_consumers(InterFilterGroupOperator op,
                                       org.omg.CORBA.IntHolder id)
Operation new_for_consumers

Parameters:
op - Operator of Filters' composition (between consumer filters and proxies filters)
id - Id of the new consumer admin
Returns:
The new consumer Admin

new_for_suppliers

public SupplierAdmin new_for_suppliers(InterFilterGroupOperator op,
                                       org.omg.CORBA.IntHolder id)
Operation new_for_suppliers

Parameters:
op - Operator of Filters' composition (between supplier filters and proxies filters)
id - Id of the new consumer admin
Returns:
The new supplier Admin

get_consumeradmin

public ConsumerAdmin get_consumeradmin(int id)
                                throws AdminNotFound
Operation get_consumeradmin

Parameters:
id - Id of consumer admin to retreive
Returns:
The requested consumer admin
Throws:
AdminNotFound - Id doesn't correspond to any consumer admin

get_supplieradmin

public SupplierAdmin get_supplieradmin(int id)
                                throws AdminNotFound
Operation get_supplieradmin

Parameters:
id - Id of supplier admin to retreive
Returns:
The requested supplier admin
Throws:
AdminNotFound - Id doesn't correspond to any supplier admin

get_all_consumeradmins

public int[] get_all_consumeradmins()
Operation get_all_consumeradmins

Returns:
Array of all consumer admin ID

get_all_supplieradmins

public int[] get_all_supplieradmins()
Operation get_all_supplieradmins

Returns:
Array of all supplier admin ID

get_qos

public Property[] get_qos()
Operation get_qos

Returns:
Object QosProperties

set_qos

public void set_qos(Property[] qos)
             throws UnsupportedQoS
Operation set_qos

Parameters:
qos - QosProperties to assign to object
Throws:
UnsupportedQoS

validate_qos

public void validate_qos(Property[] required_qos,
                         NamedPropertyRangeSeqHolder available_qos)
                  throws UnsupportedQoS
Operation validate_qos

Throws:
UnsupportedQoS

get_admin

public Property[] get_admin()
Operation get_admin

Returns:
All Admin Properties

set_admin

public void set_admin(Property[] admin)
               throws UnsupportedAdmin
Operation set_admin

Parameters:
admin - Array of admin property
Throws:
UnsupportedAdmin - If implementation doesn't support a property

for_consumers

public ConsumerAdmin for_consumers()
Operation for_consumers


for_suppliers

public SupplierAdmin for_suppliers()
Operation for_suppliers


destroy

public void destroy()
Operation destroy