Net::Amazon::Response.3pm

Langue: en

Version: 2007-05-31 (ubuntu - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

NAME

Net::Amazon::Response - Baseclass for responses from Amazon's web service

SYNOPSIS

     $resp = $ua->request($request);
 
     if($resp->is_success()) { 
         print $resp->as_string();
     }
 
     if($resp->is_error()) {
         print $resp->message();
     }
  
     if($resp->is_success()) { 
         for my $property ($resp->properties) {
             print $property->as_string(), "\n";
         }
     }
 
 

DESCRIPTION

"Net::Amazon::Response" is the baseclass for responses coming back from the useragent's "request" method. Responses are typically not of type "Net::Amazon::Response" but one of its subclasses "Net::Amazon::Response::*". However, for basic error handling and dumping content, "Net::Amazon::Response"'s methods are typically used, because we typically don't know what type of object we're actually dealing with.

METHODS

is_success()
Returns true if the request was successful. This doesn't mean any objects have been found, it just indicates a successful roundtrip.
is_error()
Returns true if an error occurred. Use "message()" to determine what kind of error.
properties()
Returns the list of "Net::Amazon::Property" objects which were found by the query.
as_string()
Dumps the content of the response.
message()
Returns the error message as a string in case an error occurred. In case several errors occurred, they're stringed together. Look up "messages()" if you need them separated.
messages()
Returns all error messages for a response as a reference to an array of string messages.

SEE ALSO

AUTHOR

Mike Schilli, <m@perlmeister.com> Copyright 2003 by Mike Schilli <m@perlmeister.com>

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.