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->printErrors;
        $trace->printTimings(\*STDERR);
        $trace->printRequest(pretty_print => 1);
        $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 separately, 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( [$error] )
           Often   contains  an  error  message,  when  something  went  wrong.   The  message  is  returned  as
           Log::Report::Exception.  Only the first error is returned, use errors() to get all.

           [2.31] When an $error is provided, it is added to the internal list of errors.  The $error  parameter
           may be a Log::Report::Exception, a Log::Report::Message or a simple string.

       $obj->errors()
           [2.31] Return all errors, which are Log::Report::Exception objects.  See also error().

       $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->responseDOM()
           Returns the XML::LibXML::Document top node of the response: the parsed text of  the  content  of  the
           received HTTP message.

       $obj->start()
           Returns  the  (platform dependent) time value which represent the moment that the call was initiated.
           See Time::HiRes method "time".

   Printing
       $obj->printErrors( [$fh] )
           The filehandle defaults to STDERR.

           If you want to see more output, try adding "<use Log::Report mode =" 3;>>

       $obj->printRequest( [$fh], %options )
            -Option      --Default
             pretty_print  0

           pretty_print => 0|1|2
             Use XML::Compile::Transport::compileClient(xml_format)  if  you  want  the  messages  to  be  shown
             readible.  The digits reflect XML::LibXML format settings: '0' is unchanged, '1' will show indented
             formatting, and '2' has even more whitespace in it.

       $obj->printResponse( [$fh], %options )
            -Option      --Default
             pretty_print  0

           pretty_print => 0|1|2
             Use  XML::Compile::Transport::compileClient(xml_format)  if  you  want  the  messages  to  be shown
             readible.

       $obj->printTimings( [$fh] )
           Print an overview on various timings to the selected filehandle.

SEE ALSO

       This module is part of XML-Compile-SOAP distribution version 3.28, built on  August  01,  2022.  Website:
       http://perl.overmeer.net/CPAN/

LICENSE

       Copyrights 2007-2022 by [Mark Overmeer <markov@cpan.org>]. 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://dev.perl.org/licenses/

perl v5.34.0                                       2022-08-04                     XML::Compile::SOAP::Trace(3pm)