Section: User Contributed Perl Documentation (3pm)
Return to Main Contents
SOAP::Deserializer - the means by which the toolkit manages the conversion of XML into an object manageable by a developer
SOAP::Deserializer provides the means by which incoming XML
is decoded into a Perl data structure.
This provides access to the calling context of "SOAP::Deserializer". In a client side context the often means a reference to an instance of SOAP::Lite. In a server side context this means a reference to a SOAP::Server instance.
DESERIALIZING RAW XML INTO A SOAP::SOM OBJECT
A useful utility for SOAP::Deserializer is for parsing raw XML
documents or fragments into a SOAP::SOM
object. SOAP::Lite developers use this technique to write unit tests for the SOAP::Lite 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 object by using SOAP::Deserializer:
$xml = <<END_XML;
my $som = SOAP::Deserializer->deserialize($xml);
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.
Byrne Reese (firstname.lastname@example.org
- DESERIALIZING RAW XML INTO A SOAP::SOM OBJECT