SOAP::Fault

This class gives you access to a fault generated on the server side. To create a fault message, you can simply die on the server side, and the SOAP processor will wrap your message as a faultstring element and transfer the fault on the client side. But in some cases, you need to have more control over this process, and the SOAP::Fault class gives it to you. To use it, simply die with the SOAP::Fault object as a parameter:

die SOAP::Fault->faultcode('Server.Custom') # Will be qualified ->faultstring('Died in server method') ->faultdetail(bless {code => 1} => 'BadError') ->faultactor('http://www.soaplite.com/custom');

The faultdetail( ) and faultactor( ) methods are optional, and since faultcode and faultstring are required to represent a fault message, SOAP::Lite will use default values ("Server" and "Application error") if not specified.