This subsection describes the notes on using the methods of the SOAPFault interface.

• If the following methods are issued for the SOAPFault objects for which the fault codes are not explicitly specified, the value that is automatically set up by the Cosminexus JAX-WS functionality is returned:
  
  • getFaultCode()
  • getFaultCodeAsName()
  • getFaultCodeAsQName()
• If the following methods are issued for the SOAPFault objects for which the fault codes are not explicitly specified, the fault string "Fault string, and possibly fault code, not set" that is automatically set up by the Cosminexus JAX-WS functionality is returned:
  
  • getFaultString()
  • getFaultReasonTexts()
• In the SOAP 1.1 format, if the getFaultStringLocale() method is issued for the SOAPFault objects for which the fault codes are not explicitly specified, null is returned.
• In the SOAP 1.2 format, if the getFaultReasonLocales() method or the getFaultStringLocale() method is issued for the SOAPFault objects for which the fault codes are not explicitly specified, the value that is automatically set up by the Cosminexus JAX-WS functionality is returned.
• Do not specify null in the arguments of the following methods. If null is specified, the operations are not guaranteed.
  
  • setFaultCode(Name faultCodeQName)
  • setFaultCode(QName faultCodeQName)
  • setFaultCode(String faultCode)
  • setFaultString(String faultString)
  • setFaultString(String faultString, Locale locale)
  • setFaultRole(String uri)
• Specify a Namespace-qualified fault code in the arguments of the following methods. If a Namespace-unqualified fault code is specified with the local name only, the operations are not guaranteed.
  
  • setFaultCode(Name faultCodeQName)
  • setFaultCode(QName faultCodeQName)
  • setFaultCode(String faultCode)
• Do not specify null in the locale argument of the setFaultString(String faultString, Locale locale) method. If specified, the operations are not guaranteed.
• Do not specify null in the text argument of the addFaultReasonText(String text, Locale locale) method. If specified, the operations are not guaranteed.
• If null is specified in the arguments of the getFaultReasonText(Locale locale) method, null is returned.
• The locale obtained by the getFaultReasonLocales() method or the getFaultStringLocale() method might differ from the locale set up in the xml:lang attribute of the received SOAP fault.
• Specify a string with the URI format in the uri argument of the setFaultRole(String uri) method. If a string with a non-URI format is specified, the operations are not guaranteed.