22.1.6 SOAPFaultインタフェース
SOAPFaultインタフェースのメソッドを使用する場合の注意事項を示します。
-
フォルトコードが明示的に設定されていないSOAPFaultオブジェクトに対して次のメソッドを発行した場合,Application ServerのJAX-WS機能が自動的に設定した値が返されます。
-
getFaultCode()
-
getFaultCodeAsName()
-
getFaultCodeAsQName()
-
-
フォルトコードが明示的に設定されていないSOAPFaultオブジェクトに対して次のメソッドを発行した場合,Application ServerのJAX-WS機能が自動的に設定したフォルト文字列"Fault string, and possibly fault code, not set"が返されます。
-
getFaultString()
-
getFaultReasonTexts()
-
-
SOAP 1.1形式の場合に,フォルトコードが明示的に設定されていないSOAPFaultオブジェクトに対してgetFaultStringLocale()メソッドを発行した場合,nullが返されます。
-
SOAP 1.2形式の場合に,フォルトコードが明示的に設定されていないSOAPFaultオブジェクトに対してgetFaultReasonLocales()メソッドまたはgetFaultStringLocale()メソッドを発行した場合,Application ServerのJAX-WS機能が自動的に設定した値が返されます。
-
次に示すメソッドの引数にはnullを指定しないでください。nullを指定した場合の動作は保証されません。
-
setFaultCode(Name faultCodeQName)
-
setFaultCode(QName faultCodeQName)
-
setFaultCode(String faultCode)
-
setFaultString(String faultString)
-
setFaultString(String faultString, Locale locale)
-
setFaultRole(String uri)
-
-
次に示すメソッドの引数には,名前空間で修飾されたフォルトコードを指定してください。名前空間で修飾されていない,ローカル名だけのフォルトコードを指定した場合の動作は保証されません。
-
setFaultCode(Name faultCodeQName)
-
setFaultCode(QName faultCodeQName)
-
setFaultCode(String faultCode)
-
-
setFaultString(String faultString, Locale locale)メソッドのlocale引数にnullを指定しないでください。指定した場合の動作は保証されません。
-
addFaultReasonText(String text, Locale locale)メソッドのtext引数にnullを指定しないでください。指定した場合の動作は保証されません。
-
getFaultReasonText(Locale locale)メソッドの引数にnullを指定した場合,nullが返されます。
-
getFaultReasonLocales()メソッドまたはgetFaultStringLocale()メソッドが取得したロケールは,受信したSOAPフォルトのxml:lang属性に設定されているロケールと異なる場合があります。
-
setFaultRole(String uri)メソッドのuri引数には,URI形式の文字列を指定してください。URI形式以外の文字列を指定した場合の動作は保証されません。