Herong's Tutorial Notes on Web Service and SOAP
Dr. Herong Yang, Version 4.00

soapversion('1.2') and envprefix('soap12') Must Used Together

This section provides a tutorial example on how to set the Envelope element under a named namespace of 'http://www.w3.org/2003/05/soap-envelope' - Using soapversion('1.2') and envprefix('soap12') together!

The first issue is to set the Envelope element under a named namespace of "http://www.w3.org/2003/05/soap-envelope". I did 3 tests before finding the solution:

1. Using soapversion('1.1') only.

#- GetSpeech_localhost_v11.pl
#- Copyright (c) 2009 by Dr. Herong Yang, herongyang.com
#- All rights reserved
#
   use SOAP::Lite +trace;
   my $client = SOAP::Lite->new()
      ->soapversion('1.1')
      ->readable(true)
      ->proxy('http://localhost/WSShakespeare.asmx');

   my $som = $client->call('GetSpeech', "To be, or not to be");

Result of GetSpeech_localhost_v11.pl:

POST http://localhost/WSShakespeare.asmx HTTP/1.1
Accept: text/xml
Accept: multipart/*
Accept: application/soap
Content-Length: 505
Content-Type: text/xml; charset=utf-8
SOAPAction: "#GetSpeech"

<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    soap:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetSpeech>
      <c-gensym3 xsi:type="xsd:string">To be, or not to be</c-gensym3>
    </GetSpeech>
  </soap:Body>
</soap:Envelope>

2. Using soapversion('1.2') only.

#- GetSpeech_localhost_v12.pl
#- Copyright (c) 2009 by Dr. Herong Yang, herongyang.com
#- All rights reserved
#
   use SOAP::Lite +trace;
   my $client = SOAP::Lite->new()
      ->soapversion('1.2')
      ->readable(true)
      ->proxy('http://localhost/WSShakespeare.asmx');

   my $som = $client->call('GetSpeech', "To be, or not to be");

Result of GetSpeech_localhost_v12.pl:

POST http://localhost/WSShakespeare.asmx HTTP/1.1
Accept: text/xml
Accept: multipart/*
Accept: application/soap
Content-Length: 485
Content-Type: application/soap; charset=utf-8
SOAPAction: "#GetSpeech"

<?xml version="1.0" encoding="UTF-8"?>
<Envelope
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    soap:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <Body>
    <GetSpeech>
      <c-gensym3 xsi:type="xsd:string">To be, or not to be</c-gensym3>
    </GetSpeech>
  </Body>
</Envelope>

3. Using soapversion('1.2') and envprefix('soap12').

#- GetSpeech_localhost_v12_envprevix.pl
#- Copyright (c) 2009 by Dr. Herong Yang, herongyang.com
#- All rights reserved
#
   use SOAP::Lite +trace;
   my $client = SOAP::Lite->new()
      ->soapversion('1.2')
      ->envprefix('soap12')
      ->readable(true)
      ->proxy('http://localhost/WSShakespeare.asmx');

   my $som = $client->call('GetSpeech', "To be, or not to be");

Result of GetSpeech_localhost_v12_envprevix.pl:

POST http://localhost/WSShakespeare.asmx HTTP/1.1
Accept: text/xml
Accept: multipart/*
Accept: application/soap
Content-Length: 573
Content-Type: application/soap; charset=utf-8
SOAPAction: "#GetSpeech"

<?xml version="1.0" encoding="UTF-8"?>
<soap12:Envelope
    xmlns:soap12="http://www.w3.org/2003/05/soap-envelope"
    soap:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
    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">
  <soap12:Body>
    <GetSpeech>
      <c-gensym3 xsi:type="xsd:string">To be, or not to be</c-gensym3>
    </GetSpeech>
  </soap12:Body>
</soap12:Envelope>

What your conclusion based on these tests? Here is what I think:

  • If you use soapversion('1.1') only, SOAP::Lite generates Envelope under the named namespace of xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/". This is correct for a SOAP 1.1 request.
  • If you use soapversion('1.2') only, SOAP::Lite generates Envelope under no namespace at all. This is incorrect for SOAP 1.2.
  • If you use soapversion('1.2') and envprefix('soap12') together, SOAP::Lite generates Envelope under the named namespace of xmlns:soap12="http://www.w3.org/2003/05/soap-envelope". This is correct for SOAP 1.2.

So if you want to do SOAP 1.2, remember to use soapversion('1.2') and envprefix('soap12') together!

Last update: 2009.

Sections in This Chapter

Installing SOAP::Lite 0.710 to Support SOAP 1.2

Features in SOAP::Lite 0.710

Methods on SOAP::Lite 0.710 Client Object

Testing SOAP::Lite Client Objects

Request Differences between SOAP 1.1 and SOAP 1.2

GetSpeech_localhost.pl - Testing GetSpeech on Local Host

soapversion('1.2') and envprefix('soap12') Must Used Together

default_ns() - Setting Default namespace for Body Elements

SOAP::Data - Utility Class to Generate XML Elements

SOAPAction - Not Needed, But No Way to Remove It

Unsupported Media Type: "application/soap"

DEFAULT_HTTP_CONTENT_TYPE='application/soap+xml'

content_type() method in the HTTP::Headers Class

GetSpeech_SOAP_1_2.pl - SOAP::Lite for SOAP 1.2 Web Service

Dr. Herong Yang, updated in 2009
soapversion('1.2') and envprefix('soap12') Must Used Together