rwsf::SoapFaultException
Group: Fault Processing
rwsf::SoapFaultExceptionrwsf::SoapFault
Local Index
Members
Header File
#include <rw/rwsf/soapworx/SoapFault.h>
Description
rwsf::SoapFaultException represents generic SOAP faults in the proxy. If a fault is defined in the WSDL, a special class is generated for it; however, if it is not defined, an instance of rwsf::SoapFaultException is thrown from the client.
You may request the fault either by using the why() method from its base class rwsf::Exception, or by using this class' own getFault() method. The why() method returns the SOAP fault as string, while the getFault() method returns a rwsf::SoapFault object which allows you to access individual parts of the fault such as the fault code and fault string. See rwsf::SoapFault.
For an example on how generic and specific faults are caught, run the Fault example in your installdir\examples\webservices\Fault directory.
The following code shows how a generated client implementation catches a rwsf::SoapFaultException in its invoke() methods. This excerpt is from the generated client for the DayofWeek example in your installdir\examples\webservices\DayofWeek directory.
void invoke_getDayOfWeek(DayOfWeekBindingProxy& proxy) //1
{
RWDate date_in;
RWCString dayOfWeek_ret;
rwsf::CallInfo callInfo;
try {
dayOfWeek_ret = proxy.getDayOfWeek(callInfo, date_in);
} catch(const rwsf::SoapFaultException& e) { //2
std::cout << "Fault Code: "
<< e.getFault().getFaultcode().asString() << std::endl;
std::cout << "Fault String: "
<< e.getFault().getFaultstring() << std::endl;
}
}
| //1 | invoke() method is implemented here. |
| //2 | Writes the Faultcode and Faultstring to stdout. |
For more information on faults and exception handling, Section 7.3.6, "Error Reporting and Faults," in the HydraExpress Web Service Development Guide
Public Constructor
SoapFaultException(const rwsf::SoapFault& fault);
Initializes a rwsf::FaultException with the message fault.
rwsf::SoapFault getFault() const;
Returns the SOAP fault.
©2004-2007 Copyright Quovadx, Inc. All Rights Reserved.
Quovadx and Rogue Wave are registered trademarks of Quovadx, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.
Contact Rogue Wave about documentation or support issues.