NAME¶
SOAP::WSDL::Deserializer::SOM - Deserializer SOAP messages into SOM objects
SYNOPSIS¶
use SOAP::WSDL;
use SOAP::WSDL::Deserializer::SOM;
use SOAP::WSDL::Factory::Deserializer;
SOAP::WSDL::Factory::Deserializer->register( '1.1', __PACKAGE__ );
DESCRIPTION¶
Deserializer for creating SOAP::Lite's SOM object as result of a SOAP call.
This package is here for two reasons:
- •
- Compatibility
You don't have to change the rest of your SOAP::Lite based app when
switching to SOAP::WSDL, but can just use SOAP::WSDL::Deserializer::SOM to
get back the same objects as you were used to.
- •
- Completeness
SOAP::Lite covers much more of the SOAP specification than SOAP::WSDL.
SOAP::WSDL::Deserializer::SOM can be used for content which cannot be
deserialized by SOAP::WSDL::Deserializer::SOAP11. This may be XML
including mixed content, attachements and other XML data not (yet) handled
by SOAP::WSDL::Deserializer::SOAP11.
SOAP::WSDL::Deserializer::SOM is a subclass of SOAP::Deserializer from the
SOAP::Lite package.
METHODS¶
deserialize¶
Deserializes a XML sting into a SOAP::SOM object. Returns a SOAP::Fault object
on deserialization errors.
generate_fault¶
Dies with a SOAP::Fault object.
USAGE¶
SOAP::WSDL::Deserializer will not autoregister itself - to use it for a
particular SOAP version just use the following lines:
my $soap_version = '1.1'; # or '1.2', further versions may appear.
use SOAP::WSDL::Deserializer::SOM;
use SOAP::WSDL::Factory::Deserializer;
SOAP::WSDL::Factory::Deserializer->register( $soap_version, __PACKAGE__ );
DIFFERENCES FROM OTHER CLASSES¶
Differences from SOAP::Lite¶
- •
- No on_fault handler
You cannot specify what to do when an error occurs - SOAP::WSDL will return
a SOAP::Fault object on transport errors.
Differences from other SOAP::WSDL::Deserializer classes¶
- •
- generate_fault
SOAP::WSDL::Deserializer::SOM will die with a SOAP::Fault object on calls to
generate_fault.
This also means that a SOAP::Fault may be thrown as exception when
using
LICENSE AND COPYRIGHT¶
Copyright 2004-2007 Martin Kutter.
This file is part of SOAP-WSDL. You may distribute/modify it under the same
terms as perl itself.
AUTHOR¶
Martin Kutter <martin.kutter fen-net.de>
$Rev: 851 $
$LastChangedBy: kutterma $
$Id: SOM.pm 851 2009-05-15 22:45:18Z kutterma $
$HeadURL: https://soap-wsdl.svn.sourceforge.net/svnroot/soap-wsdl/SOAP-WSDL/trunk/lib/SOAP/WSDL/Deserializer/SOM.pm $