NAME

SOAP::Message - Really simple SOAP

DESCRIPTION

Simple SOAP for the unwashed masses

SYNOPSIS

 use SOAP::Message;

 ## Procedural interface

 # Make SOAP
 
 my $message = SOAP::Message::create(
        
        version    => '1.1',
        body       => $xml_data,
        
 );
        
 # Receive SOAP
 
 my ( $header,$body ) = SOAP::Message::parse( $incoming );

 ## OO interface
 
 # Set some defaults up...
 
 my $object = SOAP::Message->new( version => '1.2', prefix => 'SOAP' );

 # Then just continue as normal...
 
 my $message = $object->create( body => $body, header => $header );
 
 # And for convenience...
 
 my ( $header, $body ) = $object->parse( $incoming );

OVERVIEW

90% of using SOAP appears to be jumping through many hoops to do something pretty simple - putting an XML wrapper around another piece of XML, or removing the XML wrapper around a piece of XML.

That's all this package does. And not particularly cleverly. And that's all it wants to do. Chances are it handles everything you need it to.

METHODS

create

Creates a new SOAP message. Accepts:

version - which can either be 1.1 or 1.2. Defaults to 1.1. This affects what the namespace will be:

 http://schemas.xmlsoap.org/soap/envelope/ - 1.1 
 http://www.w3.org/2003/05/soap-envelope - 1.2 

Optional.

body - which is the message body, and can be anything you fancy. Optional.

header - which is the header, and can be anything you want. Optional.

prefix - which is the prefix we use. Defaults to 'env'. Common examples soapenv, soap, env and so on. Optional. We don't perform any validation on this.

Returns a string containing your SOAP message.

parse

Parses a SOAP message in a string. Returns a list containing the header and the body as strings.

xml_parse

Like parse(), but returns XML::XPath::Nodeset objects instead.

new

Accepts the same arguments as create(), and sets them as the defaults for subsequent calls to create.

AUTHOR

Peter Sergeant - pete@clueball.com