Creating a Data Object for Nested XML Elements

WSDL Tutorials - Herong's Tutorial Examples - Version 2.03, by Dr. Herong Yang

WSDL Tutorials - Herong's Tutorial Examples

∟Using WSDL in Perl with SOAP::Lite 0.710

∟Creating a Data Object for Nested XML Elements

This section provides a tutorial example on how to create a SOAP::Data object to represent nested XML elements with one or more sub elements. The parent element's value should be the reference of an extra container object.

If you want to create a SOAP::Data object to represent nest XML elements - an XML element with one or more sub elements, you need to remember more rules:

Sub elements should be represented as individual SOAP:Data data objects first.
Sub element data objects should be grouped into a SOAP::Data container object.
The reference of the container object should be used as the value for the parent SOAP::Data object.

Here is an example of using SOAP::Data to create nested XML element:

#- SOAP_Data_Nested_Elements.pl
#- Copyright (c) 2009 by Dr. Herong Yang, herongyang.com
#- All rights reserved
#
   use SOAP::Lite;

#- Creating data objects for sub elements
   $guest1 = SOAP::Data->new(name=>'Guest', value=>'Herong Yang');
   $guest2 = SOAP::Data->name('Guest')->value('Joe Smith');

#- Creating the container object for the sub element list
   $list = SOAP::Data->new();
   $list->value($guest1, $guest2);

#- Creating the parent element
   $element = SOAP::Data->new();
   $element->name('RegistrationRequest');
   $element->uri('http://www.herongyang.com/Service/');
   $element->prefix('hy');
   $element->attr({'event'=>'OpenGame', 'date'=>'2008-08-08'});
   $element->value(\$list);

#- Dumping the element as an XML string
   $serializer = SOAP::Serializer->new();
   $serializer->readable('true');
   $xml = $serializer->serialize($element);
   print $xml;

Execution result of SOAP_Data_Nested_Elements.pl:

<?xml version="1.0" encoding="UTF-8"?>
<hy:RegistrationRequest
    xmlns:hy="http://www.herongyang.com/Service/"
    date="2008-08-08"
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
    event="OpenGame"
    xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <Guest xsi:type="xsd:string">Herong Yang</Guest>
  <Guest xsi:type="xsd:string">Joe Smith</Guest>
</hy:RegistrationRequest>

Conclusion, adding a sub element requires the reference of an extra container object.

Last update: 2009.

Table of Contents

About This Book

Introduction to WSDL 2.0

WSDL 2.0 Document Structure and Syntax

WSDL Version 2.0 Part 2: Adjuncts

WSDL 2.0 Document Examples with SOAP Binding

WSDL 20 Programming APIs and Testing Tools

Introduction to WSDL 1.1

WSDL 1.1 Document Structure and Syntax

WSDL 1.1 Binding Extension for SOAP 1.1