Michael Schilli > Net-Amazon-0.35 > Net::Amazon::Response

Download:
Net-Amazon-0.35.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  5
Open  2
View/Report Bugs
Source   Latest Release: Net-Amazon-0.62

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.

SEE ALSO ^

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.

syntax highlighting: