soap::deserializer(3) [suse man page]

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)

SOAP::WSDL::Deserializer::Hash(3pm)			User Contributed Perl Documentation		       SOAP::WSDL::Deserializer::Hash(3pm)

NAME

       SOAP::WSDL::Deserializer::Hash - Deserializer SOAP messages into perl hash refs

SYNOPSIS

	use SOAP::WSDL;
	use SOAP::WSDL::Deserializer::Hash;

DESCRIPTION

       Deserializer for creating perl hash refs as result of a SOAP call.

   Output structure
       The XML structure is converted into a perl data structure consisting of hash and or list references. List references are used for holding
       array data.

       SOAP::WSDL::Deserializer::Hash creates list references always at the maximum depth possible.

       Examples:

	XML:
	<MyDataArray>
	   <MyData>1</MyData>
	   <MyData>1</MyData>
	</MyDataArray>

	Perl:
	{
	    MyDataArray => {
		MyData => [ 1, 1 ]
	    }
	}

	XML:
	<DeepArray>
	   <MyData><int>1<int>/MyData>
	   <MyData><int>1<int>/MyData>
	</DeepArray>

	Perl:
	{
	    MyDataArray => {
		MyData => [
		   { int => 1 },
		   { int => 1 }
		]
	    }
	}

       List reference creation is triggered by the second occurance of an element.  XML Array types with one element only will not be represented
       as list references.

USAGE

       All you need to do is to use SOAP::WSDL::Deserializer::Hash.

       SOAP::WSDL::Deserializer::Hash autoregisters itself for SOAP1.1 messages

       You may register SOAP::WSDLDeserializer::Hash for other SOAP Versions by calling

	SOAP::Factory::Deserializer->register('1.2',
	   SOAP::WSDL::Deserializer::Hash)

Limitations
       o   Namespaces

	   All namespaces are ignored.

       o   XML attributes

	   All XML attributes are ignored.

   Differences from other SOAP::WSDL::Deserializer classes
       o   generate_fault

	   SOAP::WSDL::Deserializer::Hash will die with a SOAP::WSDL::Fault11 object when a parse error appears

METHODS

   deserialize
       Deserializes the message.

   generate_fault
       Generates a SOAP::WSDL::SOAP::Typelib::Fault11 object and returns it.

LICENSE AND COPYRIGHT

       Copyright 2004-2008 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: Hash.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/Hash.pm $

perl v5.10.1							    2010-12-21				       SOAP::WSDL::Deserializer::Hash(3pm)