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

SOAPAction - Not Needed, But No Way to Remove It

This section describes why the SOAPAction header line is not needed in SOAP 1.2 - SOAPAction is replaced by the 'action' parameter of the application/soap-xml media type in SOAP 1.2.

According to RFC 3902 - 'The "application/soap+xml" media type', the SOAPAction HTTP header field in SOAP 1.1 has been replaced by the "action" parameter of the media type:

MIME media type name: application
MIME subtype name: soap+xml
Required parameters: none
Optional parameters:

"charset": This parameter has identical semantics to the charset
   parameter of the "application/xml" media type as specified in
   RFC 3023 [RFC3023].

"action": This optional parameter can be used to specify the URI
   that identifies the intent of the message.  In SOAP 1.2, it
   serves a similar purpose as the SOAPAction HTTP header field
   did in SOAP 1.1.  Namely, its value identifies the intent of
   the message.
...

So how to remove SOAPAction HTTP header with using SOAP::Lite? I did some research on the Internet, and found no suggestions. So I decided to leave it there. But it needs to be modified to make the .NET Web services server happy. Because they require a format of "$uri/$method", not "$uri#$method".

The solution is easy as we learned from previous SOAP 1.1 tutorials. The on_action() function can be used to provide a call back function to control the value of SOAPAction:

#- GetSpeech_localhost_SOAPAction.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')
      ->default_ns('http://xmlme.com/WebServices')
      ->on_action( sub {join '/', @_} )
      ->readable(true)
      ->proxy('http://localhost/WSShakespeare.asmx');

   my $som = $client->call('GetSpeech', 
      SOAP::Data->name("Request")
      ->value("To be, or not to be")
   );

Result of GetSpeech_localhost_SOAPAction.pl:

POST http://localhost/WSShakespeare.asmx HTTP/1.1
Accept: text/xml
Accept: multipart/*
Accept: application/soap
Content-Length: 606
Content-Type: application/soap; charset=utf-8
SOAPAction: http://xmlme.com/WebServices/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 xmlns="http://xmlme.com/WebServices">
      <Request xsi:type="xsd:string">To be, or not to be</Request>
    </GetSpeech>
  </soap12:Body>
</soap12:Envelope>

I think my entire GetSpeech SOAP 1.2 request is ready now. What do you think?

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
SOAPAction - Not Needed, But No Way to Remove It