/ 
XML-Compile-SOAP-2.11
River stage two • 30 direct dependents • 35 total dependents
/ XML::Compile::SOAP::Trace

NAME

XML::Compile::SOAP::Trace - help displaying trace details.

SYNOPSIS

my ($answer, $trace) = $call->(%params);
#now $trace is a XML::Compile::SOAP::Trace

my $req = $trace->request;   # HTTP message which was sent
my $res = $trace->response;  # HTTP message received

my $start = $trace->date;
my $dura  = $trace->elapse;

$trace->printTimings;
$trace->printRequest;
$trace->printResponse;

DESCRIPTION

This help module simplifies user access to the trace data, as produced by a SOAP call (client side).

METHODS

Constructors

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

    Called by the SOAP call implementation; not for normal users.

Accessors

$obj->date

    Returns the date string which represent the moment that the call was initiated.

$obj->elapse([KIND])

    Returns the time in seconds (with hires, sub-second detail) of a part of the SOAP communication. Some values may be undef. Elapse without argument will return the total time elapsed.

    As KINDs are defined encode (the time required by the translator build by XML::Compile::Schema to translate Perl into an XML::LibXML tree), transport, and decode (from XML::LibXML tree into Perl)>. The transport components are also provided seperately, as stringify (by XML::LibXML to convert a tree into text), connect (for the network message exchange by HTTP::Daemon), and parse (parsing answer string into XML)

    See printTimings().

    example:

    print $trace->elapse('decode');

$obj->error

    Often contains an error message, when something went wrong.

$obj->request

    Returns the HTTP::Request object used for this SOAP call. This might be quite useful during debugging, because a lot of the processing is hidden for the user... but you may want to see or log what is actually begin send.

$obj->response

    Returns the HTTP::Response object, returned by the remote server. In some erroneous cases, the client library will create an error response without any message was exchanged.

$obj->start

    Returns the (platform dependent) time value which represent the moment that the call was initiated. See Time::HiRes method time.

Printing

$obj->printRequest

$obj->printResponse

$obj->printTimings

    Print an overview on various timings to the selected filehandle.

SEE ALSO

This module is part of XML-Compile-SOAP distribution version 2.11, built on March 02, 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::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 2007-2010 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