File Doc Category Size Date Package
SOAPFaultException.java API Doc Java SE 6 API 1790 Tue Jun 10 00:27:16 BST 2008 javax.xml.ws.soap

SOAPFaultException

java.lang.Object
- java.lang.Throwable
  - java.lang.Exception
    - java.lang.RuntimeException
      - javax.xml.ws.WebServiceException
        javax.xml.ws.ProtocolException

public class SOAPFaultException extends ProtocolException

The SOAPFaultException exception represents a SOAP 1.1 or 1.2 fault.

A SOAPFaultException wraps a SAAJ SOAPFault that manages the SOAP-specific representation of faults. The createFault method of javax.xml.soap.SOAPFactory may be used to create an instance of javax.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.

see: javax.xml.soap.SOAPFault
see: javax.xml.ws.soap.SOAPBinding#getSOAPFactory
see: javax.xml.ws.ProtocolException
since: JAX-WS 2.0

Fields Summary
private SOAPFault
fault
Constructors Summary
public SOAPFaultException(SOAPFault fault)
Constructor for SOAPFaultException
param
fault SOAPFault representing the fault
see
javax.xml.soap.SOAPFactory#createFault
super(fault.getFaultString()); this.fault = fault;
Methods Summary
public javax.xml.soap.SOAPFault getFault()
Gets the embedded SOAPFault instance.
return
javax.xml.soap.SOAPFault SOAP fault element
return this.fault;