3.21.5 EventChannelFactoryインタフェース

org.omg.CosNotifyChannelAdmin.EventChannelFactoryは、OMG-NotificationServiceで規定されたファクトリインタフェースです。NotificationService-APIを使用する場合は従来のEventFactoryインタフェースは使用できません。

名前

org.omg.CosNotifyChannelAdmin.EventChannelFactory.create_channel

形式

import  org.omg.CosNotifyChannelAdmin.*; 
public  interface EventChannelFactory extends org.omg.CORBA.Object {
      public  org.omg.CosNotifyChannelAdmin.EventChannel create_channel ( 
            org.omg.CosNotification.Property[]  initial_qos,
            org.omg.CosNotification.Property[]  initial_admin,
            org.omg.CORBA.IntHolder             id )
                throws org.omg.CosNotification.UnsupportedQoS,
                       org.omg.CosNotification.UnsupportedAdmin;
}

機能説明

initial_qos, initial_adminで指定されたQoSプロパティ項目およびAdminプロパティ項目を持つイベントチャネルを生成し、イベントチャネルのオブジェクトリファレンスを返します。QoSプロパティ項目およびAdminプロパティ項目の詳細については、“アプリケーション作成ガイド（イベントサービス編）”の“QoS機能”を参照してください。
ファクトリのオブジェクトリファレンスは、org.omg.CORBA.ORB.resolve_initial_references()メソッドのidentifierパラメタに以下の値を指定して獲得します。
“NotificationService”

パラメタ

initial_qos: イベントチャネルを生成するQoSプロパティ項目。

initial_admin: イベントチャネルを生成するAdminプロパティ項目。

id（outパラメタ）: イベントチャネルの識別IDが設定されます。

復帰値

正常終了した場合は、イベントチャネルのオブジェクトリファレンスを返します。
異常終了した場合は、例外が発生します。

ユーザ例外の場合は、以下の例外が発生します。

org.omg.CosNotification.UnsupportedQoS: 指定されたQoSプロパティ項目またはその値に誤りがあります。

org.omg.CosNotification.UnsupportedAdmin: 指定されたAdminプロパティ項目またはその値に誤りがあります。

システム例外の場合は、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、発生したシステム例外およびマイナーコードに対する対処を行ってください。

名前

org.omg.CosNotifyChannelAdmin.EventChannelFactory.get_all_channels

形式

import  org.omg.CosNotifyChannelAdmin.*; 
public  interface EventChannelFactory extends org.omg.CORBA.Object {
    public  int[]  get_all_channels ();
}

機能説明

イベントファクトリが管理している、すべてのイベントチャネルの識別IDをシーケンス型で返します。

復帰値

正常終了した場合は、イベントファクトリが管理している、すべてのイベントチャネルの識別IDがシーケンス型で返されます。
異常終了した場合は、例外が発生します。

システム例外の場合は、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、発生したシステム例外およびマイナーコードに対する対処を行ってください。

名前

org.omg.CosNotifyChannelAdmin.EventChannelFactory.get_event_channel

形式

import  org.omg.CosNotifyChannelAdmin.*; 
public  interface EventChannelFactory extends org.omg.CORBA.Object {
    public  org.omg.CosNotifyChannelAdmin.EventChannel get_event_channel ( 
        int  id )
        throws org.omg.CosNotifyChannelAdmin.ChannelNotFound;
}

機能説明

idで指定された識別IDを持つイベントチャネルのオブジェクトリファレンスを返します。

パラメタ

id: 取得するイベントチャネルの識別ID。

復帰値

正常終了した場合は、idで指定された識別IDを持つイベントチャネルのオブジェクトリファレンスが返されます。
異常終了した場合は、例外が発生します。

ユーザ例外の場合は、以下の例外が発生します。

org.omg.CosNotifyChannelAdmin.ChannelNotFound: 指定されたチャネルは存在しません。

システム例外の場合は、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、発生したシステム例外およびマイナーコードに対する対処を行ってください。

3.21.5 EventChannelFactoryインタフェース

3.21.5.1 org.omg.CosNotifyChannelAdmin.EventChannelFactory.create_channel()

3.21.5.2 org.omg.CosNotifyChannelAdmin.EventChannelFactory.get_all_channels()

3.21.5.3 org.omg.CosNotifyChannelAdmin.EventChannelFactory.get_event_channel()