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.