NAME

XML::Compile::SOAP::HTTPServer - create SOAP over HTTP daemon

INHERITANCE

XML::Compile::SOAP::HTTPServer
  is a XML::Compile::SOAP::Server

XML::Compile::SOAP::HTTPServer
  is a HTTP::Daemon

SYNOPSIS

my $server = XML::Compile::SOAP::HTTPServer->new(@options);
$server->run;

DESCRIPTION

This module handles the exchange of (XML) messages, according to the rules of SOAP (any version). The module does not known how to parse or compose XML, but only worries about the HTTP aspects.

The server is as flexible as possible: accept M-POST (HTTP Extension Framework) and POST (standard HTTP) for any message. It can be used for any SOAP1.1 and SOAP1.2 mixture.

METHODS

XML::Compile::SOAP::HTTPServer->new(OPTIONS)

As OPTIONS, you can pass anything the HTTP::Daemon method new() understands. You may also provide a prepared daemon object.

Option      --Default
daemon        <created>
role          'NEXT'
support_soap  'ANY'

. daemon => HTTP::Daemon

Use the already created daemon object.

. role => URI

In SOAP1.1, the term is 'actor', but SOAP1.2 has renamed this into 'role': the role [the daemon] plays in the transport protocol.

. support_soap => 'SOAP11'|'SOAP12'|'ANY'

Which versions of SOAP to support. Quite an amount of preparations must be made to start a server, which can be reduced by enforcing a single SOAP type.

Attributes

$obj->soapImplementation(VERSION)

Handlers

$obj->actionHandler(SOAPACTION, SOAPVERSION, [DECODER, ENCODER, CALLBACK])

Returned is the request DECODER, the answer ENCODER, and the CALLBACK related to the specified SOAPACTION and SOAPVERSION. With 5 arguments, new settings are defined for these, otherwise the current settings are returned.

$obj->getSoapAction(REQUEST)

Collect the soap action URI from the request, with undef on failure.

$obj->run(OPTIONS)

SEE ALSO

This module is part of XML-Compile-SOAP distribution version 0.55, built on October 03, 2007. Website: http://perl.overmeer.net/xml-compile/

LICENSE

Copyrights 2007 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