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.
