Java EE 5 SDK

Class SOAPFaultException

  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by java.lang.RuntimeException
              extended by javax.xml.rpc.soap.SOAPFaultException
All Implemented Interfaces:

public class SOAPFaultException
extends RuntimeException

The SOAPFaultException exception represents a SOAP fault.

The message part in the SOAP fault maps to the contents of faultdetail element accessible through the getDetail method on the SOAPFaultException. The method createDetail on the javax.xml.soap.SOAPFactory creates an instance of the javax.xml.soap.Detail.

The faultstring provides a human-readable description of the SOAP fault. The faultcode element provides an algorithmic mapping of the SOAP fault.

Refer to SOAP 1.1 and WSDL 1.1 specifications for more details of the SOAP faults.

Rahul Sharma
See Also:
Detail, SOAPFactory.createDetail(), Serialized Form

Constructor Summary
SOAPFaultException(QName faultcode, String faultstring, String faultactor, Detail faultdetail)
          Constructor for the SOAPFaultException
Method Summary
 Detail getDetail()
          Gets the detail element.
 String getFaultActor()
          Gets the faultactor element.
 QName getFaultCode()
          Gets the faultcode element.
 String getFaultString()
          Gets the faultstring element.
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


public SOAPFaultException(QName faultcode,
                          String faultstring,
                          String faultactor,
                          Detail faultdetail)
Constructor for the SOAPFaultException

faultCode - QName for the SOAP faultcode
faultstring - faultstring element of SOAP fault
faultactor - faultactor element of SOAP fault
faultdetail - faultdetail element of SOAP fault
See Also:
Method Detail


public QName getFaultCode()
Gets the faultcode element. The faultcode element provides an algorithmic mechanism for identifying the fault. SOAP defines a small set of SOAP fault codes covering basic SOAP faults.

QName of the faultcode element


public String getFaultString()
Gets the faultstring element. The faultstring provides a human-readable description of the SOAP fault and is not intended for algorithmic processing.

faultstring element of the SOAP fault


public String getFaultActor()
Gets the faultactor element. The faultactor element provides information about which SOAP node on the SOAP message path caused the fault to happen. It indicates the source of the fault.

faultactor element of the SOAP fault


public Detail getDetail()
Gets the detail element. The detail element is intended for carrying application specific error information related to the SOAP Body.

detail - element of the SOAP fault
See Also:

Java EE 5 SDK

Submit a bug or feature

Copyright 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.

Scripting on this page tracks web page traffic, but does not change the content in any way.