XML::Compile::Transport::SOAPHTTP - exchange XML-SOAP via HTTP
XML::Compile::Transport::SOAPHTTP is a XML::Compile::Transport is a XML::Compile::SOAP::Extension
use XML::Compile::Transport::SOAPHTTP; my $http = XML::Compile::Transport::SOAPHTTP->new(@options); my $send = $http->compileClient(@options2); my $call = $wsdl->compileClient ( operation => 'some-port-name' , transport => $send ); my ($xmlout, $trace) = $call->($xmlin);
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.
Create a SOAP-over-HTTP handler, implemented as a wrapper around LWP::UserAgent.
If you need to change UserAgent settings (for instance at runtime), you can always directly access the internal
LWP::UserAgent object via userAgent().
timeout options are only used when an default internal
LWP::UserAgent is created; this is only once in a program. Later instantiations of this ::SOAPHTTP will share that default agent, even though these passed parameters have different parameters. If that is not what you want, then pass your own
user_agent object to the constructor to avoid the use of the default.
-Option --Defined in --Default address XML::Compile::Transport 'http://localhost' charset XML::Compile::Transport 'utf-8' keep_alive <true> timeout 180 user_agent <created when needed>
When connection can be re-used.
The maximum time for a single connection before the client will close it. The server may close it earlier. Do not set the timeout too long, because you want objects to be cleaned-up.
If you do not pass your own user agent, a default will be created for you.
Returns the User Agent which will be used. You may change the configuration of the AGENT (the returned LWP::UserAgent object) or provide one yourself. See also new(user_agent).
Changes to the agent configuration can be made before or after the compilation, or even inbetween SOAP calls.
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 --Defined in --Default action '' header <created> hook XML::Compile::Transport <undef> kind 'request-response' method 'POST' mime_type <depends on soap version> mpost_id 42 soap 'SOAP11' xml_format XML::Compile::Transport 0
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").
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.
M-POST, the header extension fields require (any) number to be grouped.
example: create a client
my $trans = XML::Compile::Transport::SOAPHTTP->new ( address => 'http://www.stockquoteserver.com/StockQuote' ); my $call = $trans->compileClient ( action => 'http://example.com/GetLastTradePrice' ); # $request and $answer are XML::LibXML trees! # see XML::Compile::SOAP::Client::compileClient() for wrapper which # converts from and to Perl data structures. my ($answer, $trace) = $call->($request); my $answer = $call->($request); # drop $trace info immediately
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.
This module is part of XML-Compile-SOAP distribution version 2.38, built on August 22, 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
Copyrights 2007-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