org.omg.CosTypedNotifyChannelAdmin
Interface TypedEventChannelFactoryOperations

All Known Subinterfaces:

TypedEventChannelFactory

public interface TypedEventChannelFactoryOperations

Method Summary

TypedEventChannel	create_typed_channel(Property[] initial_QoS, Property[] initial_admin, IntHolder id) The create_typed_channel operation is invoked to create a new instance of the Notification Service style typed event channel.
int[]	get_all_typed_channels()
TypedEventChannel	get_typed_event_channel(int id)

Method Detail

get_typed_event_channel

TypedEventChannel get_typed_event_channel(int id)
                                          throws ChannelNotFound

Parameters:

id - A numeric value, which is supposed to be the unique identifier of a Notification Service typed event channel that has been created by this target object.

Returns:

The object reference of the Notification Service typed event channel corresponding to the input identifier.

Throws:

ChannelNotFound - If this input value does not correspond to any Notification Service typed event channel that has been created by this target object.

get_all_typed_channels

int[] get_all_typed_channels()

Returns:

A sequence of all of the unique numeric identifiers corresponding to Notification Service typed event channels which have been created by the target object.

create_typed_channel

TypedEventChannel create_typed_channel(Property[] initial_QoS,
                                       Property[] initial_admin,
                                       IntHolder id)
                                       throws UnsupportedQoS,
                                              UnsupportedAdmin

The create_typed_channel operation is invoked to create a new instance of the Notification Service style typed event channel.

Parameters:

initial_QoS - A list of name-value pairs which specify the initial QoS property settings for the new channel.

initial_admin - A list of name-value pairs which specify the initial administrative property settings for the new channel.

id - An output parameter containing a numeric identifier assigned to the newly created TypedEventChannel. This identifier is unique among all event channels created by this target object.

Returns:

The object reference to the newly created TypedEventChannel.

Throws:

UnsupportedQoS - If no implementation of the TypedEventChannel interface exists that can support all of the requested QoS property settings. This exception contains as data a sequence of data structures, each of which identifies the name of a QoS property in the input list, whose requested setting could not be satisfied, along with an error code and a range of settings for the property which could be satisfied.

UnsupportedAdmin - If no implementation of the TypedEventChannel interface exists that can support all of the requested administrative property settings. This exception contains as data a sequence of data structures, each of which identifies the name of an administrative property in the input list whose requested setting could not be satisfied, along with an error code and a range of settings for the property which could be satisfied.