Provided by: libnet-amazon-perl_0.62-2_all
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.
AUTHOR
Mike Schilli, <m@perlmeister.com>
COPYRIGHT AND LICENSE
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.