Package jakarta.xml.ws.soap

Class SOAPFaultException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

jakarta.xml.ws.WebServiceException

jakarta.xml.ws.ProtocolException

jakarta.xml.ws.soap.SOAPFaultException

All Implemented Interfaces:

Serializable

public class SOAPFaultException
extends ProtocolException

The SOAPFaultException exception represents a SOAP 1.1 or 1.2 fault.

A SOAPFaultException wraps a Jakarta SOAP with Attachments' SOAPFault that manages the SOAP-specific representation of faults. The createFault method of jakarta.xml.soap.SOAPFactory may be used to create an instance of jakarta.xml.soap.SOAPFault for use with the constructor. SOAPBinding contains an accessor for the SOAPFactory used by the binding instance.

Note that the value of getFault is the only part of the exception used when searializing a SOAP fault.

Refer to the SOAP specification for a complete description of SOAP faults.

Since:

1.6, JAX-WS 2.0

See Also:

• SOAPFault
• SOAPBinding.getSOAPFactory()
• ProtocolException
• Serialized Form

Constructor Summary

Constructors

Constructor	Description
SOAPFaultException(SOAPFault fault)	Constructor for SOAPFaultException

Method Summary

Modifier and Type	Method	Description
SOAPFault	getFault()	Gets the embedded SOAPFault instance.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

SOAPFaultException

public SOAPFaultException(SOAPFault fault)

Constructor for SOAPFaultException

Parameters:

fault - SOAPFault representing the fault

See Also:

• SOAPFactory.createFault(java.lang.String, javax.xml.namespace.QName)

Method Details

getFault

public SOAPFault getFault()

Gets the embedded SOAPFault instance.

Returns:

jakarta.xml.soap.SOAPFault SOAP fault element