Mark Overmeer > XML-Compile-SOAP-Daemon > XML::Compile::SOAP::Daemon::LWPutil



Annotate this POD


Open  1
View/Report Bugs
Module Version: 3.12   Source  


XML::Compile::SOAP::Daemon::LWPutil - LWP helper routines


   is a Exporter


  # used by ::Daemon::NetServer
  #     and ::Daemon::AnyDaemon




Collect the soap action URI from the request, with undef on failure. Officially, the "SOAPAction" has no other purpose than the ability to route messages over HTTP: it should not be linked to the portname of the message (although it often can).

lwp_add_header($field, $content, ...)
lwp_handle_connection($connection, %options)
lwp_http11_connection($daemon, $socket)

Initialize a HTTP/1.1 connect on the client $socket.

lwp_make_response( $request, $rc, $msg, $body, [$postproc] )
lwp_run_request( $request, $handler, [$connection, $postproc] )

Handle one $request (HTTP::Request object), which was received from the CLIENT (string). When the request has been received, the $handler is called. Returns the status, the status as text message, and the output as XML::LibXML::Document.


Initialize LWP usage based on a created $socket.

lwp_wsdl_response( [$wsdlfile|$response] )

Set the result of WSDL query responses, either to a response which is created internally containing $wsdlfile, or to an already complete $response object (HTTP::Response). The response object is returned.


Postprocessing responses

The LWP based daemons provide a postprocess option to their run() methods. The parameter is a CODE reference.

When defined, the CODE is called when the response message is ready to be returned to the client:

  $code->($request, $response, $status, \$body)

The source $requests is passed as first parameter. The $response is an HTTP::Response object, with all headers but without the body. The $status is the result code of the handler. A value of 200 (HTTP_OK from HTTP::Status) indicates successful processing of the request. When the status is not HTTP_OK you may skip the postprocessing.

The $body are the bytes which will be added as body to the response after this postprocessing has been done. You may change the body. Be warned that the body is not a (latin1 or utf-8) string but already encoded into a byte string.


This module is part of XML-Compile-SOAP-Daemon distribution version 3.12, built on May 13, 2016. Website:

Please post questions or ideas to the mailinglist at . For live contact with other developers, visit the #xml-compile channel on


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

syntax highlighting: