---
name: "SOAP::WSDL::Deserializer::SOM"
section: "3pm"
platform: "linux"
package: "libsoap-wsdl-perl"
version: "3.004-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/SOAP::WSDL::Deserializer::SOM"
---

# SOAP::WSDL::Deserializer::SOM(3pm)

Deserializer SOAP messages into SOM objects

## 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\>

## REPOSITORY INFORMATION

```
 $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 $
```