NAME

INHERITANCE

 XML::Compile::SOAP::WSA
   is a XML::Compile::SOAP::Extension

SYNOPSIS

 # load the module
 use XML::Compile::SOAP::WSA;
 my $wsa  = XML::Compile::SOAP::WSA->new(version => '1.0');

 # you may need some constants (rarely)
 use XML::Compile::SOAP::WSA::Util ':wsa10';

 # use WSA via WSDL
 my $wsdl = XML::Compile::WSDL11->new(...);
 my $call = $wsdl->compileClient('some_operation');

 # wsa header fields start with wsa_
 my ($data, $trace) = $call->(wsa_MessageID => 'xyz', %data);

 print $wsdl->operation('myop')->wsaAction;

DESCRIPTION

The basic SOAP design uses the URI and the "soapAction" header of HTTP (in case it uses HTTP, by far the most often used transport mechanism) However, when the server is hidden behind firewalls and proxies, these fields are rewritten or replaced. This means that the definitions by the WSDL for the client can differ from the configuration of the server. This is where WSA comes into play.

When WSA is enabled, header fields are added. Automatically, the obligatory "wsa_To" and "wsa_Action" fields will be added to each request, although you may change their values with call parameters.

Warning: this being a very recent module, thing may not work. There is no real-life experience with the code, as yet. Please contact the author when you are succesful or discovered problems.

METHODS

 Option --Default
 version  <required>

SEE ALSO

All modules in this suite: XML::Compile, XML::Compile::SOAP, XML::Compile::SOAP12, XML::Compile::SOAP::Daemon, XML::Compile::SOAP::WSA, XML::Compile::Tester, XML::Compile::Cache, XML::Compile::Dumper, XML::Compile::RPC, and XML::Rewrite, XML::eXistDB, XML::LibXML::Simple.

Please post questions or ideas to the mailinglist at http://lists.scsys.co.uk/cgi-bin/mailman/listinfo/xml-compile For life contact with other developers, visit the "#xml-compile" channel on "irc.perl.org".

LICENSE

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See http://www.perl.com/perl/misc/Artistic.html