Net::Amazon::Response(3p)

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.