/ 
XML-Compile-SOAP-AnyEvent-0.01
River stage zero No dependents
/ XML::Compile::Transport::SOAPHTTP_AnyEvent

NAME

XML::Compile::Transport::SOAPHTTP_AnyEvent - exchange XML via AnyEvent::HTTP

SYNOPSIS

use XML::Compile::Transport::SOAPHTTP_AnyEvent;

my $http = XML::Compile::Transport::SOAPHTTP_AnyEvent->new(@options);
my $send = $http->compileClient(@options2);

my $call = $wsdl->compileClient
  ( operation => 'some-port-name'
  , transport => $send
  , async     => 1      # required!
  );

sub handler
  { my ($xmlout, $trace) = @_;
    # so something
  };

$call->($xmlin, _callback => \&handler);

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.

In contrairy to XML::Compile::Transport::SOAPHTTP, this implementation can be used in various event-driven environments, via AnyEvent::HTTP.

METHODS

XML::Compile::Transport::SOAPHTTP_AnyEvent->new(OPTIONS)

    Option          --Default
any_event_params  []

    . any_event_params => ARRAY

      Options passed to AnyEvent::HTTP, for instance timeout and proxy. The ARRAY is a list of PAIRS.

Accessors

$obj->anyEventParams

Handlers

$obj->compileClient(OPTIONS)

    Compile an HTTP client handler. Returned is a subroutine which is called with a text represenation of the XML request, or an XML::LibXML tree. In SCALAR context, an XML::LibXML parsed tree of the answer message is returned. In LIST context, that answer is followed by a HASH which contains trace information.

    Option   --Default
action     ''
header     <created>
kind       'request-response'
method     'POST'
mime_type  <depends on soap version>
mpost_id   42
soap       'SOAP11'

    . action => URI

    . header => HTTP::Headers object

    . kind => DIRECTION

      What kind of interactie, based on the four types defined by WSDL(1): notification-operation (server initiated, no answer required), one-way (client initiated, no answer required), request-response (client initiated, the usual in both directions), solicit-response (server initiated "challenge").

    . method => 'POST'|'M-POST'

      With POST, you get the standard HTTP exchange. The M-POST is implements the (Microsoft) HTTP Extension Framework. Some servers accept both, other require a specific request.

    . mime_type => STRING

    . mpost_id => INTEGER

      With method M-POST, the header extension fields require (any) number to be grouped.

    . soap => 'SOAP11'|'SOAP12'|OBJECT

$obj->headerAddVersions(HEADER)

XML::Compile::Transport::SOAPHTTP_AnyEvent->headerAddVersions(HEADER)

    Adds some lines about module versions, which may help debugging or error reports. This is called when a new client or server is being created.

SEE ALSO

This module is part of XML-Compile-SOAP-AnyEvent distribution version 0.01, built on November 01, 2010. Website: http://perl.overmeer.net/xml-compile/

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

Copyrights 2010 by Aleksey Mashanov/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