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
All Rights Reserved. Copyright (C) 2012, 2015, Hitachi, Ltd.