SOAP::Lite for Perl

Mailing Lists

The following mailing lists relate to the SOAP::Lite Perl Module project.

• Announcements list - This list is a low volume mailing that only SOAP::Lite project leads can post to. Subscribers of this list will receive announcements about the SOAP::Lite project, such as releases, recently discovered bygs and vulnerabilities, etc.
  (go to Subscribe/Unsubscribe/Preferences)
• User Support and Discussion - This list is for those seeking support (and wishing to provide support) for the SOAP::Lite Perl Module.
  (go to Subscribe/Unsubscribe/Preferences)
• Development mailing list - This list is for those contributing to and those wishing to follow the continued development of the SOAP::Lite code base.
  (go to Subscribe/Unsubscribe/Preferences)

Installation Instructions

Unix Users

To install, download the latest version of SOAP::Lite and follow the standard Perl module installation procedures by entering the very familiar command sequence:

perl Makefile.PL
make
make test
make install

       

If you have CPAN.pm module installed and you are connected to the Internet, then run the following sequence of commands:

perl -MCPAN -e shell
> install SOAP::Lite

Or even:

perl -MCPAN -e 'install SOAP::Lite'

Windows Users

Windows users should use 'nmake' instead of make. For example:

perl Makefile.PL
nmake
nmake test
nmake install

Makefile.PL Command Line Options and Usage

Usage: perl Makefile.PL 

Possible options are:
 
  --noprompt            Disable interactive dialog
  --alltests            Perform extra testing
  --help, -?            Display this help text
 
  [Do not] install prerequisites for appropriate module:
 
  --[no]install-SOAP-Lite                    --[no]Lite
  --[no]install-SOAP-Transport-HTTPS-Client  --[no]HTTPS-Client
  --[no]install-SOAP-Transport-MAILTO-Client --[no]MAILTO-Client
  --[no]install-SOAP-Transport-FTP-Client    --[no]FTP-Client
  --[no]install-SOAP-Transport-HTTP-Daemon   --[no]HTTP-Daemon
  --[no]install-SOAP-Transport-HTTP-Apache   --[no]HTTP-Apache
  --[no]install-SOAP-Transport-HTTP-FCGI     --[no]HTTP-FCGI
  --[no]install-SOAP-Transport-POP3-Server   --[no]POP3-Server
  --[no]install-SOAP-Transport-IO-Server     --[no]IO-Server
  --[no]install-SOAP-Transport-MQ            --[no]MQ
  --[no]install-SOAP-Transport-JABBER        --[no]JABBER
  --[no]install-SOAP-MIMEParser              --[no]MIMEParser
  --[no]install-SOAP-Transport-TCP           --[no]TCP
  --[no]install-SOAP-Transport-HTTP          --[no]HTTP

Use perl Makefile.PL --noprompt to disable interactive configuration. Follow these instructions to install SOAP::Lite on your hosting account.

Composing messages with raw XML...

I was faced with the dilemna of having an XML document that I had scraped from a web page that I wanted to encode into a SOAP Envelope, but I couldn't figure out how to do it, so I asked the SOAP::Lite mailing list (a long time ago) and got my answer. And since several others (including this one, and this one) have asked the same question. Since the question is so popular - here is how you do it...

How to access attributes in a response

This message send to the SOAP::Lite Message Board asks a question not easily (relatively) determined from the reference in the back of Programming Web Services with Perl, "How to you access an attribute found in a response?"

Override the root element of the response

Last week I showed how to override the root element of a request, but did not show a way to do the same thing for the root element of a response. So, read on if you would like to know how to modify the response's namespace, namespace prefix, encoding style, etc. It is not very intuitive, or pretty for that matter, but at least it is relatively simple.

How to easily turn on/off debugging information

One thing I find myself constantly doing with my SOAP::Lite clients is commenting in and out the "+trace => 'debug'" from the "use SOAP::Lite" call so that I can turn on and off debugging information. This became so annoying to me that I decided to programitize it. Now I just turn debugging on and off with a command line flag.

How To Specify Multiple Namespaces

Someone asked on the SOAP::Lite message board about how to specify multiple namespaces in a request. The following little code snippet answers that question. The trick is using the SOAP::Data->attr() subroutine...

How do you modify the root element of a request?

SOAP::Lite's API allows you to call remote Web service operations easily within your code. Simply instantiate an instance of a service, and execute (or call) the remote method directly from your service instance. For example, a call might look like "$soap->myMethod(arguments)." However, while this convention makes for a nice API, by calling the method in this way you give up control over the attributes of the root SOAP Body element. So how do you change the namespace, the prefix, or attributes of the root element?

How to nest XML elements using SOAP::Lite

Someone posted a message to the SOAP::Lite newsgroup asking a common question: How do you nest XML elements using SOAP::Lite's SOAP::Data constructs. It is a simple problem, but enough people have problems with it that I figured I would detail the answer here.

Working with multirefs, Axis, and SOAP::Lite

A posting (which is not archived in the group for some reason) in the SOAP::Lite message board raised yet again the shortcomings of SOAP::Lite and how it parses and interprets WSDL. It also brought to light a horrible SOAP Fault returned by Axis which led the poster and I in a completely mistaken direction when trying to solve the problem...