Java™ Platform
Standard Ed. 6

javax.xml.ws.soap
Class SOAPFaultException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by java.lang.RuntimeException
              extended by javax.xml.ws.WebServiceException
                  extended by javax.xml.ws.ProtocolException
                      extended by javax.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 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.

Since:
JAX-WS 2.0
See Also:
SOAPFault, SOAPBinding.getSOAPFactory(), ProtocolException, Serialized Form

Constructor Summary
SOAPFaultException(SOAPFault fault)
          Constructor for SOAPFaultException
 
Method Summary
 SOAPFault getFault()
          Gets the embedded SOAPFault instance.
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

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 Detail

getFault

public SOAPFault getFault()
Gets the embedded SOAPFault instance.

Returns:
javax.xml.soap.SOAPFault SOAP fault element

Java™ Platform
Standard Ed. 6

Submit a bug or feature
For further API reference and developer documentation, see Java SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2008 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.