javax.xml.rpc.soap

Class SOAPFaultException


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.

Version:
1.0

Constructor Summary

SOAPFaultException(QName faultcode, String faultstring, String faultactor, Detail detail)
Constructor for 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.

Constructor Details

SOAPFaultException

public SOAPFaultException(QName faultcode,
                          String faultstring,
                          String faultactor,
                          Detail detail)
Constructor for SOAPFaultException.
Parameters:
faultcode - QName for the SOAP faultcode
faultstring - faultstring element of SOAP fault
faultactor - faultactor element of SOAP fault
detail - faultdetail element of SOAP fault

Method Details

getDetail

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

getFaultActor

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.
Returns:
faultactor element of the SOAP fault

getFaultCode

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.
Returns:
QName of the faultcode element

getFaultString

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.
Returns:
faultstring element of the SOAP fault

Copyright B) 2005 Apache Web Services Project. All Rights Reserved.