# perldoc > SOAP::Deserializer

## NAME
    [SOAP::Deserializer](https://www.chedong.com/phpMan.php/perldoc/SOAP%3A%3ADeserializer/markdown) - the means by which the toolkit manages the conversion of XML into an object
    manageable by a developer

## DESCRIPTION
    [SOAP::Deserializer](https://www.chedong.com/phpMan.php/perldoc/SOAP%3A%3ADeserializer/markdown) provides the means by which incoming XML is decoded into a Perl data
    structure.

## METHODS
    context
        This provides access to the calling context of "[SOAP::Deserializer](https://www.chedong.com/phpMan.php/perldoc/SOAP%3A%3ADeserializer/markdown)". In a client side
        context the often means a reference to an instance of [SOAP::Lite](https://www.chedong.com/phpMan.php/perldoc/SOAP%3A%3ALite/markdown). In a server side context
        this means a reference to a [SOAP::Server](https://www.chedong.com/phpMan.php/perldoc/SOAP%3A%3AServer/markdown) instance.

## EXAMPLES
  DESERIALIZING RAW XML INTO A [SOAP::SOM](https://www.chedong.com/phpMan.php/perldoc/SOAP%3A%3ASOM/markdown) OBJECT
    A useful utility for [SOAP::Deserializer](https://www.chedong.com/phpMan.php/perldoc/SOAP%3A%3ADeserializer/markdown) is for parsing raw XML documents or fragments into a
    [SOAP::SOM](https://www.chedong.com/phpMan.php/perldoc/SOAP%3A%3ASOM/markdown) object. [SOAP::Lite](https://www.chedong.com/phpMan.php/perldoc/SOAP%3A%3ALite/markdown) developers use this technique to write unit tests for the
    [SOAP::Lite](https://www.chedong.com/phpMan.php/perldoc/SOAP%3A%3ALite/markdown) module itself. It is a lot more efficient for testing aspects of the toolkit than
    generating client calls over the network. This is a perfect way for developers to write unit
    tests for their custom data types for example.

    Here is an example of how raw XML content can be parsed into a [SOAP::SOM](https://www.chedong.com/phpMan.php/perldoc/SOAP%3A%3ASOM/markdown) object by using
    [SOAP::Deserializer](https://www.chedong.com/phpMan.php/perldoc/SOAP%3A%3ADeserializer/markdown):

        $xml = <<END_XML;
        <foo>
          <person>
            <foo>123</foo>
            <foo>456</foo>
          </person>
          <person>
            <foo>789</foo>
            <foo>012</foo>
          </person>
        </foo>
        END_XML

        my $som = [SOAP::Deserializer](https://www.chedong.com/phpMan.php/perldoc/SOAP%3A%3ADeserializer/markdown)->deserialize($xml);

## COPYRIGHT
    Copyright (C) 2000-2004 Paul Kulchenko. All rights reserved.

    This library is free software; you can redistribute it and/or modify it under the same terms as
    Perl itself.

## AUTHORS
    Byrne Reese (<byrne@majordojo.com>)