Interstage Application Server アプリケーション作成ガイド （イベントサービス編）

4.1.1.3 例外処理

　プロパティ項目に、サポートされていない項目または誤った項目を設定した場合、呼び出したインタフェースが異常終了し、以下の詳細情報が設定されます。

	プロパティ項目	詳細情報	補足情報の設定個所
動的生成チャネル	QoS	ユーザ例外 UnsupportedQoS	qos_err
	Admin	ユーザ例外 UnsupportedAdmin	admin_err
静的生成チャネル	QoS	ユーザ例外 UnsupportedQoS	qos_err
メッセージ	QoS	システム例外 BAD_QOS	−

　イベントチャネルに対し、プロパティ項目の設定でエラーになった場合、QoSプロパティ項目の場合は、UnsupportedQoS例外のqos_errメンバに、Adminプロパティ項目の場合、UnsupportedAdmin例外のadmin_errメンバに、それぞれ補足情報が設定されます。アプリケーションは、詳細情報および補足情報を解析することにより、誤ったProperties情報の設定内容を判断することができます。
　UnsupportedQoS例外のqos_errメンバ、およびUnsupportedAdmin例外のadmin_errメンバは、PropertyErrorSeq型です。PropertyErrorSeq型はPropertyError構造体からなるシーケンス型です。PropertyError構造体は以下に示すようにcodeとnameで形成されています。

　イベントチャネルに対し、プロパティ項目の設定でエラーになった場合、PropertyError構造体のnameにエラーになったプロパティ項目名が設定され、codeに詳細コードが設定されます。設定される詳細コードとエラーの意味を以下に示します。

詳細コード	エラーの意味
UNAVAILABLE_VALUE	指定されたプロパティ項目のうち、設定範囲外の値が設定されていた項目があります。これらの項目は設定されませんでした。
BAD_PROPERTY	不正なプロパティ項目名が指定されました。
BAD_TYPE	プロパティ項目の値のデータ型に誤りがあります。
BAD_VALUE	不正な値が設定されました（create_channelメソッド発行時のみ）。

　例えば、存在しないQoSプロパティ項目を設定した場合、codeにはBAD_PROPERTYが設定されます。

　C++プログラムで静的生成イベントチャネルに対してQoSプロパティ項目の設定でエラーになった場合の例外処理方法と処理の流れを以下に説明します。

[プロパティ項目設定時の例外処理の例（C++の場合）]

    try{
        ... 
        channel->set_qos( *pQoS, env );                                  /* 1 */
        ... 
    } catch( CosNotification::UnsupportedQoS &ue ) {                     /* 2 */
        printf("UnsupportedQoS occured.\n"); 
        ErrCodeCheck( ue ); 
        ... 
    } 
    ... 

  void
  ErrCodeCheck( CosNotification::UnsupportedQoS ue ) 
  {
     /* ---- error qos length --------------------------------- */
     int  length; 
     char errcode[30]; 

     length = ue.qos_err().length();
     printf("PropertyErrorSeq length=[%d]\n", length );                   /* 3 */

     for( int i = 0 ; i < length ; i++ ){
         /* ---- error qos name -------------------------------- */
         printf("err name = [%s]\n",(char*)ue.qos_err()[i]->name );       /* 4 */

         /* ---- error_code ------------------------------------ */
         switch( ue.qos_err()[i]->code ){                                 /* 5 */
             case CosNotification::UNAVAILABLE_VALUE: 
                 strcpy( errcode, "UNAVAILABLE_VALUE" ); 
                 break; 
             case CosNotification::BAD_PROPERTY: 
                 strcpy( errcode, "BAD_PROPERTY" ); 
                 break; 
             case CosNotification::BAD_TYPE: 
                 strcpy( errcode, "BAD_TYPE" ); 
                 break; 
             default : 
                 strcpy( errcode, "error" ); 
         }
         printf( "err_code = [%s]\n", errcode ); 
     }
     return; 
  }

1. イベントチャネルに対しQoSプロパティ項目を設定します。
2. ユーザ例外UnsupportedQoSを受け取ります。
3. 設定されず、エラーになったQoSプロパティ項目数を表示します。
4. 設定されず、エラーになったQoSプロパティ項目名を表示します。
5. 詳細コードをチェックします。