SOAP::Deserializer(3)					User Contributed Perl Documentation				     SOAP::Deserializer(3)

NAME

       SOAP::Deserializer - the means by which the toolkit manages the conversion of XML into an object managable by a developer

DESCRIPTION

       SOAP::Deserializer 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". 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.

EXAMPLES

   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;
	   <foo>
	     <person>
	       <foo>123</foo>
	       <foo>456</foo>
	     </person>
	     <person>
	       <foo>789</foo>
	       <foo>012</foo>
	     </person>
	   </foo>
	   END_XML

	   my $som = SOAP::Deserializer->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)

perl v5.12.1							    2008-03-15						     SOAP::Deserializer(3)