Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

soap::wsdl::deserializer::som(3pm) [debian man page]

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

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:

       o   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.

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

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

Check Out this Related 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)
Man Page