The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
XML-Compile-WSA-0.90
River stage one • 1 direct dependent • 3 total dependents
++
/ XML::Compile::SOAP::WSA

NAME

XML::Compile::SOAP::WSA - SOAP Web Service Addressing

INHERITANCE

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

SYNOPSIS

 # use WSA via WSDL, wsa header fields start with wsa_
 use XML::Compile::WSDL11;     # first
 use XML::Compile::SOAP::WSA;  # hooks into wsdl

 my $wsa  = XML::Compile::SOAP::WSA->new(version => '1.0');
 my $wsdl = XML::Compile::WSDL11->new(...);
 my $call = $wsdl->compileClient('some_operation');
 my ($data, $trace) = $call->(wsa_MessageID => 'xyz', %data);

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

DESCRIPTION

The Web Service Addressing protocol is used to select certain service and port on a SOAP server, just like the "Host" header in HTTP.

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. This works both for soap clients (created with XML::Compile::SOAP) as for the soap server (created with XML::Compile::SOAP::Daemon): simply require the WSA module to get the hooks installed.

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.

See documentation in the base class.

METHODS

See documentation in the base class.

Constructors

See documentation in the base class.

XML::Compile::SOAP::WSA->new(OPTIONS)
 -Option --Default
  version  <required>
version => '0.9'|'1.0'|MODULE

Explicitly state which version WSA needs to be produced. You may use a version number (where 0.9 is used to represent the "submission" specification). You may also use the MODULE name, which is a namespace constant, provided via ::Util. The only option is currently WSA10MODULE.

WSDL11

See documentation in the base class.

$obj->wsdl11Init(WSDL, ARGS)
XML::Compile::SOAP::WSA->wsdl11Init(WSDL, ARGS)

See "WSDL11" in XML::Compile::SOAP::Extension

SOAP11

See documentation in the base class.

$obj->soap11ClientWrapper(OPERATION, CALL, ARGS)

See "SOAP11" in XML::Compile::SOAP::Extension

$obj->soap11HandlerWrapper(OPERATION, CALLBACK, ARGS)

See "SOAP11" in XML::Compile::SOAP::Extension

$obj->soap11OperationInit(OPERATION, ARGS)
XML::Compile::SOAP::WSA->soap11OperationInit(OPERATION, ARGS)

See "SOAP11" in XML::Compile::SOAP::Extension

Attributes

$obj->version()

Returns the version number.

$obj->wsaNS()

Returns the namespace used for this WSA version.

SEE ALSO

Web Services Addressing 1.0 - Core

http://www.w3.org/TR/ws-addr-core, 9 May 2006

Web Services Addressing 1.0 - SOAP Binding

http://www.w3.org/TR/ws-addr-soap, 9 May 2006

Web Services Addressing 1.0 - WSDL Binding

http://www.w3.org/TR/ws-addr-wsdl, 29 May 2006

SYNOPSYS

See documentation in the base class.

SEE ALSO

This module is part of XML-Compile-WSA distribution version 0.90, built on October 01, 2013. Website: http://perl.overmeer.net/xml-compile/

Other distributions in this suite: XML::Compile, XML::Compile::SOAP, XML::Compile::SOAP12, XML::Compile::SOAP::Daemon, XML::Compile::SOAP::WSA, XML::Compile::C14N, XML::Compile::WSS, XML::Compile::WSS::Signature, XML::Compile::Tester, XML::Compile::Cache, XML::Compile::Dumper, XML::Compile::RPC, XML::Rewrite and XML::LibXML::Simple.

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

LICENSE

Copyrights 2010-2013 by [Mark Overmeer]. For other contributors see ChangeLog.

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