9.3.8　エラー情報を取得する

(1)　サービスリクエスタ側の実装例

getFaultInfo()メソッドを使用して，フォルト情報の格納クラスを取得する場合の，サービスリクエスタ側の実装の例を次に示します。

• SOAP1.1の場合

  /**
   * Sample Program
   */
  {
      try {
          ：
        // Webサービス呼び出し
          ：
      } catch (CSCMsgServerFaultException_Exception e) {
        // CSC内部で例外またはユーザ定義例外が発生
   
        // CSCで定義している例外オブジェクトを取得
        CSCMsgServerFaultException faultInfo = e.getFaultInfo();
   
        // 例外情報を出力
        System.err.println("errorCode="
                             + faultInfo.getErrorCode());
        System.err.println("errorMessage="
                             + faultInfo.getErrorMessage());
        System.err.println("processInstanceID="
                             + faultInfo.getProcessInstanceID());
        System.err.println("faultCode="
                             + faultInfo.getCscmsgFaultCode());
        System.err.println("faultActor="
                             + faultInfo.getCscmsgFaultActor());
        System.err.println("faultString="
                             + faultInfo.getCscmsgFaultString());
        System.err.println("faultName="
                             + faultInfo.getFaultName());
        byte[] faultDetail = faultInfo.getCscmsgFaultDetail();
        try {
          if(faultDetail != null) {
            System.err.println("faultDetail="
                             + new String(faultDetail, "UTF-8"));
          }
        } catch (UnsupportedEncodingException e1) {
          e1.printStackTrace();
        }
      } catch (SOAPFaultException e) {
          ：
      }
  }

• SOAP1.2の場合

  /**
   * Sample Program
   */
  {
      try {
          ：
        // Webサービス呼び出し
          ：
      } catch (CSCMsgServerFault12Exception_Exception e) {
        // CSC内部で例外またはユーザ定義例外が発生
   
        // CSCで定義しているフォルト情報のオブジェクトを取得
        CSCMsgServerFault12Exception faultInfo = e.getFaultInfo();
   
        // 例外情報を出力 
        System.err.println("errorCode="
                             + faultInfo.getErrorCode());
        System.err.println("errorMessage="
                             + faultInfo.getErrorMessage());
        System.err.println("processInstanceID="
                             + faultInfo.getProcessInstanceID());
        CscmsgFaultCode code = faultInfo.getCscmsgFaultCode();
        if (code == null) {
          System.err.println("Code=" + code);
        } else {
          List<String> values = code.getValues();
          for(String value : values) {
            System.err.println("Code Value=" + value);
          }
        }
        CscmsgFaultReason reason = faultInfo.getCscmsgFaultReason();
        if (reason == null) {
          System.err.println("Reason=" + reason);
        } else {
          List<CscmsgFaultReasonText> texts = 
            reason.getCscmsgFaultReasonText(); 
          Locale locale = Locale.getDefault();
          for(CscmsgFaultReasonText text : texts) {
            if(locale.equals(text.getLocale())) {
              System.err.println("Reason=" + text.getText());
            }
          }
        }
        System.err.println("Role="
                             + faultInfo.getCscmsgFaultRole());
        System.err.println("Node="
                             + faultInfo.getCscmsgFaultNode());
        System.err.println("faultName="
                             + faultInfo.getFaultName());
        byte[] faultDetail = faultInfo.getCscmsgFaultDetail();
        try {
          if(faultDetail != null) {
            System.err.println("faultDetail="
                             + new String(faultDetail, "UTF-8"));
          }
        } catch (UnsupportedEncodingException e1) {
          e1.printStackTrace();
        }
      } catch (SOAPFaultException e) {
          ：
      }
  }

SOAPエンベロープのdetail情報には，Webサービスからの例外（SOAP Fault）の場合には，サービス（SOAP Fault発行元）が返してきたSOAP Faultの情報とHCSC-Messagingが設定したエラーメッセージ，およびエラーコードが含まれます。

HCSC-Messagingで検出した例外（Exception）の場合や，Webサービス以外のサービスからの例外（Exception）の場合には，HCSC-Messagingで検出したエラーのエラーコードとエラー情報が含まれます。

各メソッドについて，次に説明します。

ページの先頭へ

(2)　エラー情報（SOAP Fault）の形式

エラー情報（SOAP Fault）の形式を次の表に示します。

表9‒9　エラー情報（SOAP Fault）の形式

要素		名称	内容
SOAP1.1	SOAP1.2
faultcode	Code	Faultコード	JAX-WSエンジンに依存する値です。 違反コードを出力します。
faultstring	−	Fault文字列	JAX-WSエンジンに依存する値です。 エラーメッセージを出力します。
−	Reason	Fault理由	JAX-WSエンジンに依存する値です。 エラーメッセージを出力します。
faultactor	Role	Fault生成者	JAX-WSエンジンに依存する値です。値はありません。
−	Node	Faultノード	JAX-WSエンジンに依存する値です。値はありません。
detail※1	Detail※2	Fault詳細	wsdl:faultに対応する内容です。

表9‒10　エラー情報（SOAP Fault）の詳細（SOAP1.1）

フィールド名	説明
	サービス部品，ビジネスプロセス，サービスアダプタ，または連携するHCSCサーバからのエラー（フォルト）	HCSCサーバで検知したエラー（例外）
errorMessage	次に示すエラーの内容です。 HCSCサーバ内で検知したエラー サービス部品，ビジネスプロセス，およびサービスアダプタからのエラー
errorCode	次に示す例外の内容に対応するエラーコードです。 HCSCサーバ内で検知したエラー サービス部品，ビジネスプロセス，およびサービスアダプタからのエラー
processInstanceID	ビジネスプロセスのインスタンスIDの情報です。 ビジネスプロセスでエラーが発生した場合に値が設定されます。
cscmsgFaultCode	サービス部品（Webサービス），ビジネスプロセス，またはサービスアダプタからのFaultCode情報です。	−
cscmsgFaultString	サービス部品（Webサービス），ビジネスプロセス，またはサービスアダプタからのFaultString情報です。	−
cscmsgFaultActor	サービス部品（Webサービス），ビジネスプロセス，またはサービスアダプタからのFaultActor情報です。	−
cscmsgFaultDetail	サービス部品（Webサービス），ビジネスプロセス，またはサービスアダプタからのDetail情報です。	−
faultName	サービス部品（WebサービスまたはSessionBean）またはビジネスプロセスからのフォルト名（例外名）情報です。 次の場合に値が設定されます。 サービス部品（WebサービスまたはSessionBean）からのユーザ定義例外のSOAP Faultの場合 ビジネスプロセスからのフォルトの場合 SOAP Fault動作定義ファイルにtargetNamespaceのURIを定義したWebサービスからのSOAP Faultの場合，値は設定されません。SOAP Fault動作定義ファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.6.1　SOAP Fault動作定義ファイル」を参照してください。	−

表9‒11　エラー情報（SOAP Fault）の詳細（SOAP1.2）

フィールド名	説明
	サービス部品，ビジネスプロセス，サービスアダプタ，または連携するHCSCサーバからのエラー（フォルト）	HCSCサーバで検知したエラー（例外）
errorMessage	次に示すエラーの内容です。 HCSCサーバ内で検知したエラー サービス部品，ビジネスプロセス，およびサービスアダプタからのエラー
errorCode	次に示す例外の内容に対応するエラーコードです。 HCSCサーバ内で検知したエラー サービス部品，ビジネスプロセス，およびサービスアダプタからのエラー
processInstanceID	ビジネスプロセスのインスタンスIDの情報です。 ビジネスプロセスでエラーが発生した場合に値が設定されます。
cscmsgFaultCode	サービス部品（Webサービス），ビジネスプロセス，またはサービスアダプタからのFaultCode情報です。	−
cscmsgFaultReason	サービス部品（Webサービス），ビジネスプロセス，またはサービスアダプタからのFaultReason情報です。	−
cscmsgFaultRole	サービス部品（Webサービス），ビジネスプロセス，またはサービスアダプタからのRole情報です。	−
cscmsgFaultDetail	サービス部品（Webサービス），ビジネスプロセス，またはサービスアダプタからのDetail情報です。	−
faultName	サービス部品（WebサービスまたはSessionBean）またはビジネスプロセスからのフォルト名（例外名）情報です。 次の場合に値が設定されます。 サービス部品（WebサービスまたはSessionBean）からのユーザ定義例外のSOAP Faultの場合 ビジネスプロセスからのフォルトの場合 SOAP Fault動作定義ファイルにtargetNamespaceのURIを定義したWebサービスからのSOAP Faultの場合，値は設定されません。SOAP Fault動作定義ファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.6.1　SOAP Fault動作定義ファイル」を参照してください。	−

ページの先頭へ