Gecko [ www.vortexaion.com ]

Name	Size	Permission	Date
Lite	[ DIR ]	drwxrwxrwx	2024-07-26 17:39
Transport	[ DIR ]	drwxrwxrwx	2024-07-26 17:39
Client.pod	2.94 KB	-rw-rw-rw-	2018-05-15 00:35
Constants.pm	8.16 KB	-rw-rw-rw-	2018-05-15 00:35
Data.pod	9.55 KB	-rw-rw-rw-	2018-05-15 00:35
Deserializer.pod	1.92 KB	-rw-rw-rw-	2018-05-15 00:35
Fault.pod	3.74 KB	-rw-rw-rw-	2018-05-15 00:35
Header.pod	1.34 KB	-rw-rw-rw-	2018-05-15 00:35
Lite.pm	182.35 KB	-rw-rw-rw-	2018-05-15 00:35
Packager.pm	16.88 KB	-rw-rw-rw-	2018-05-15 00:35
SOM.pod	12.03 KB	-rw-rw-rw-	2018-05-15 00:35
Schema.pod	5.44 KB	-rw-rw-rw-	2018-05-15 00:35
Serializer.pod	12.91 KB	-rw-rw-rw-	2018-05-15 00:35
Server.pod	11.83 KB	-rw-rw-rw-	2018-05-15 00:35
Test.pm	11.61 KB	-rw-rw-rw-	2018-05-15 00:35
Trace.pod	7.09 KB	-rw-rw-rw-	2018-05-15 00:35
Transport.pod	25.11 KB	-rw-rw-rw-	2018-05-15 00:35
Utils.pod	1.04 KB	-rw-rw-rw-	2018-05-15 00:35

Rename

# ======================================================================
#
# Copyright (C) 2000-2004 Paul Kulchenko (paulclinger@yahoo.com)
# SOAP::Lite is free software; you can redistribute it
# and/or modify it under the same terms as Perl itself.
#
# ======================================================================

=pod

=head1 NAME

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

=head1 DESCRIPTION

SOAP::Deserializer provides the means by which incoming XML is decoded into a Perl data structure.

=head1 METHODS

=over

=item context

This provides access to the calling context of C<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.

=back

=head1 EXAMPLES

=head2 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);

=head1 COPYRIGHT

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

=head1 AUTHORS

Byrne Reese (byrne@majordojo.com)

=cut