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

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