Cosminexus V9 アプリケーションサーバ メッセージ(構築/運用/開発用)

[目次][前へ][次へ]

6.5 KDCGFで始まるメッセージ

Webサービスセキュリティ機能で出力されるKDCGF0001からKDCGF9999までのメッセージについて説明します。

KDCGFで始まるメッセージは,SOAPFault形式で出力されます。SOAPFault形式のメッセージには,次に示す四つの項目があります。

FaultCode
FaultCodeが出力されます。FaultCodeは,名前空間URIとローカル部で構成されます。KDCGFで始まるメッセージのFaultCodeの名前空間URIには,「{http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd}」が出力されます。ローカル部には,エラーの要因を示す文字列が出力されます。
FaultCodeの値は,次の方法で取得できます。
  • サーバ側の場合
    SOAP 1.1の場合は,SOAP Faultメッセージのfaultcode要素からFaultCodeを取得できます。
    SOAP 1.2の場合は,SOAP Faultメッセージのsoapenv12:Subcode要素(soapenv12:Code要素の子要素)に含まれるsoapenv12:Value要素からFaultCodeを取得できます。なお,soapenv12:Code要素のsoapenv12:Vaule要素の値は,soapenv12:Senderです。
  • クライアント側の場合
    SOAP通信基盤が提供するC4Faultクラス,またはJAX-WS機能が提供するjavax.xml.ws.soap.SOAPFaultExceptionクラスを使用してFaultCodeを取得できます。
SOAP通信基盤が提供するAPIの仕様については,マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「13. SOAP通信基盤が提供するAPI」を参照してください。
JAX-WS機能でフォルトをバインディングする方法については,マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「10.2 JAX-WSエンジンの動作」を参照してください。

FaultString
メッセージIDおよびメッセージの本文が出力されます。メッセージIDの見方については,「6.1 メッセージの記述形式」を参照してください。
FaultStringは次の方法で取得できます。
  • サーバ側の場合
    SOAP 1.1の場合は,SOAP Faultメッセージのfaultstring要素からFaultStringを取得できます。
    SOAP 1.2の場合は,SOAP Faultメッセージのsoapenv12:Reason要素のsoapenv12:Text要素からFaultStringを取得できます。
  • クライアント側の場合
    SOAP通信基盤が提供するC4Faultクラス,またはJAX-WS機能が提供するjavax.xml.ws.soap.SOAPFaultExceptionクラスを使用してFaultStringを取得できます。

FaultActor
Faultの生成者が出力されます。
FaultActorは次の方法で取得できます。
  • サーバ側の場合
    SOAP 1.1の場合は,SOAP Faultメッセージのfaultactor要素からFaultActorを取得できます。
    SOAP 1.2の場合は,SOAP Faultメッセージのsoapenv12:Role要素からFaultActorを取得できます。
  • クライアント側の場合
    SOAP通信基盤が提供するC4Faultクラス,またはJAX-WS機能が提供するjavax.xml.ws.soap.SOAPFaultExceptionクラスを使用してFaultActorを取得できます。

FaultDetails
Faultの詳細が出力されます。
FaultDetailsは次の方法で取得できます。
  • サーバ側の場合
    SOAP 1.1の場合は,SOAP Faultメッセージのdetail要素からFaultDetailsを取得できます。
    SOAP 1.2の場合は,SOAP Faultメッセージのsoapenv12:Detail要素からFaultDetailsを取得できます。
  • クライアント側の場合
    SOAP通信基盤が提供するC4Faultクラス,またはJAX-WS機能が提供するjavax.xml.ws.soap.SOAPFaultExceptionクラスを使用してFaultDetailsを取得できます。
<この節の構成>
KDCGF0001-E
KDCGF0002-E
KDCGF0003-E
KDCGF0004-E
KDCGF0005-E
KDCGF0006-E
KDCGF0007-E
KDCGF0008-E
KDCGF0009-E
KDCGF0010-E