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

Net::Amazon, Net::Amazon::Response, Net::Amazon::Property, Net::Amazon::Request, Net::Amazon::Property::Book, Net::Amazon::Property::VideoGames, Net::Amazon::Property::CE, Net::Amazon::Property::Music, Net::Amazon::Property::Software, Net::Amazon::Property::DVD, Net::Amazon::Response::Blended, Net::Amazon::Response::Manufacturer, Net::Amazon::Response::Seller, Net::Amazon::Response::EAN, Net::Amazon::Response::Director, Net::Amazon::Response::ISBN, Net::Amazon::Response::BrowseNode, Net::Amazon::Response::Power, Net::Amazon::Response::Wishlist, Net::Amazon::Response::Exchange, Net::Amazon::Response::Publisher, Net::Amazon::Response::MusicLabel, Net::Amazon::Response::Keyword, Net::Amazon::Response::ASIN, Net::Amazon::Response::Title, Net::Amazon::Response::UPC, Net::Amazon::Response::Artist, Net::Amazon::Response::Similar, Net::Amazon::Response::Actor, Net::Amazon::Response::Author, Net::Amazon::Response::TextStream, Net::Amazon::Attribute::ReviewSet, Net::Amazon::Attribute::Review, Net::Amazon::Validate::ItemSearch, Net::Amazon::Validate::Type, Net::Amazon::Validate::Type::SellerListingSearch, Net::Amazon::Validate::Type::CartModify, Net::Amazon::Validate::Type::ItemSearch, Net::Amazon::Validate::Type::CartCreate, Net::Amazon::Validate::Type::TagLookup, Net::Amazon::Validate::Type::SimilarityLookup, Net::Amazon::Validate::Type::BrowseNodeLookup, Net::Amazon::Validate::Type::CustomerContentSearch, Net::Amazon::Validate::Type::SellerLookup, Net::Amazon::Validate::Type::SellerListingLookup, Net::Amazon::Validate::Type::CustomerContentLookup, Net::Amazon::Validate::Type::ListLookup, Net::Amazon::Validate::Type::CartAdd, Net::Amazon::Validate::Type::TransactionLookup, Net::Amazon::Validate::Type::ListSearch, Net::Amazon::Validate::Type::CartGet, Net::Amazon::Validate::Type::ItemLookup, Net::Amazon::Validate::Type::CartClear, Net::Amazon::Validate::Type::Help, Net::Amazon::Validate::ItemSearch::jp::Sort, Net::Amazon::Validate::ItemSearch::jp::Manufacturer, Net::Amazon::Validate::ItemSearch::jp::ISPUPostalCode, Net::Amazon::Validate::ItemSearch::jp::EAN, Net::Amazon::Validate::ItemSearch::jp::Keywords, Net::Amazon::Validate::ItemSearch::jp::Director, Net::Amazon::Validate::ItemSearch::jp::PostalCode, Net::Amazon::Validate::ItemSearch::jp::AudienceRating, Net::Amazon::Validate::ItemSearch::jp::Availability, Net::Amazon::Validate::ItemSearch::jp::MaximumPrice, Net::Amazon::Validate::ItemSearch::jp::BrowseNode, Net::Amazon::Validate::ItemSearch::jp::Power, Net::Amazon::Validate::ItemSearch::jp::Conductor, Net::Amazon::Validate::ItemSearch::jp::Composer, Net::Amazon::Validate::ItemSearch::jp::DeliveryMethod, Net::Amazon::Validate::ItemSearch::jp::Magazines, Net::Amazon::Validate::ItemSearch::jp::Performer, Net::Amazon::Validate::ItemSearch::jp::Count, Net::Amazon::Validate::ItemSearch::jp::Publisher, Net::Amazon::Validate::ItemSearch::jp::State, Net::Amazon::Validate::ItemSearch::jp::MusicLabel, Net::Amazon::Validate::ItemSearch::jp::Brand, Net::Amazon::Validate::ItemSearch::jp::MinimumPrice, Net::Amazon::Validate::ItemSearch::jp::ItemPage, Net::Amazon::Validate::ItemSearch::jp::Title, Net::Amazon::Validate::ItemSearch::jp::Condition, Net::Amazon::Validate::ItemSearch::jp::MerchantId, Net::Amazon::Validate::ItemSearch::jp::Artist, Net::Amazon::Validate::ItemSearch::jp::Actor, Net::Amazon::Validate::ItemSearch::jp::Author, Net::Amazon::Validate::ItemSearch::jp::Orchestra, Net::Amazon::Validate::ItemSearch::jp::TextStream, Net::Amazon::Validate::ItemSearch::jp::Format, Net::Amazon::Validate::ItemSearch::us::Sort, Net::Amazon::Validate::ItemSearch::us::Manufacturer, Net::Amazon::Validate::ItemSearch::us::Browsenode, Net::Amazon::Validate::ItemSearch::us::Keywords, Net::Amazon::Validate::ItemSearch::us::Director, Net::Amazon::Validate::ItemSearch::us::Neighborhood, Net::Amazon::Validate::ItemSearch::us::PostalCode, Net::Amazon::Validate::ItemSearch::us::AudienceRating, Net::Amazon::Validate::ItemSearch::us::Availability, Net::Amazon::Validate::ItemSearch::us::MaximumPrice, Net::Amazon::Validate::ItemSearch::us::BrowseNode, Net::Amazon::Validate::ItemSearch::us::Power, Net::Amazon::Validate::ItemSearch::us::Conductor, Net::Amazon::Validate::ItemSearch::us::Composer, Net::Amazon::Validate::ItemSearch::us::Magazines, Net::Amazon::Validate::ItemSearch::us::Performer, Net::Amazon::Validate::ItemSearch::us::City, Net::Amazon::Validate::ItemSearch::us::Count, Net::Amazon::Validate::ItemSearch::us::Publisher, Net::Amazon::Validate::ItemSearch::us::State, Net::Amazon::Validate::ItemSearch::us::MusicLabel, Net::Amazon::Validate::ItemSearch::us::Brand, Net::Amazon::Validate::ItemSearch::us::MinimumPrice, Net::Amazon::Validate::ItemSearch::us::Keyword, Net::Amazon::Validate::ItemSearch::us::ItemPage, Net::Amazon::Validate::ItemSearch::us::Title, Net::Amazon::Validate::ItemSearch::us::Condition, Net::Amazon::Validate::ItemSearch::us::UPC, Net::Amazon::Validate::ItemSearch::us::MerchantId, Net::Amazon::Validate::ItemSearch::us::Artist, Net::Amazon::Validate::ItemSearch::us::MPAARating, Net::Amazon::Validate::ItemSearch::us::Actor, Net::Amazon::Validate::ItemSearch::us::Author, Net::Amazon::Validate::ItemSearch::us::Orchestra, Net::Amazon::Validate::ItemSearch::us::TextStream, Net::Amazon::Validate::ItemSearch::us::Format, Net::Amazon::Validate::ItemSearch::ca::Sort, Net::Amazon::Validate::ItemSearch::ca::Manufacturer, Net::Amazon::Validate::ItemSearch::ca::EAN, Net::Amazon::Validate::ItemSearch::ca::Keywords, Net::Amazon::Validate::ItemSearch::ca::Director, Net::Amazon::Validate::ItemSearch::ca::AudienceRating, Net::Amazon::Validate::ItemSearch::ca::MaximumPrice, Net::Amazon::Validate::ItemSearch::ca::BrowseNode, Net::Amazon::Validate::ItemSearch::ca::Power, Net::Amazon::Validate::ItemSearch::ca::Conductor, Net::Amazon::Validate::ItemSearch::ca::Composer, Net::Amazon::Validate::ItemSearch::ca::Count, Net::Amazon::Validate::ItemSearch::ca::Publisher, Net::Amazon::Validate::ItemSearch::ca::MusicLabel, Net::Amazon::Validate::ItemSearch::ca::Brand, Net::Amazon::Validate::ItemSearch::ca::MinimumPrice, Net::Amazon::Validate::ItemSearch::ca::ItemPage, Net::Amazon::Validate::ItemSearch::ca::Title, Net::Amazon::Validate::ItemSearch::ca::Condition, Net::Amazon::Validate::ItemSearch::ca::MerchantId, Net::Amazon::Validate::ItemSearch::ca::Artist, Net::Amazon::Validate::ItemSearch::ca::Actor, Net::Amazon::Validate::ItemSearch::ca::Author, Net::Amazon::Validate::ItemSearch::de::Sort, Net::Amazon::Validate::ItemSearch::de::Manufacturer, Net::Amazon::Validate::ItemSearch::de::ISPUPostalCode, Net::Amazon::Validate::ItemSearch::de::EAN, Net::Amazon::Validate::ItemSearch::de::Keywords, Net::Amazon::Validate::ItemSearch::de::Director, Net::Amazon::Validate::ItemSearch::de::PostalCode, Net::Amazon::Validate::ItemSearch::de::AudienceRating, Net::Amazon::Validate::ItemSearch::de::Availability, Net::Amazon::Validate::ItemSearch::de::MaximumPrice, Net::Amazon::Validate::ItemSearch::de::BrowseNode, Net::Amazon::Validate::ItemSearch::de::Power, Net::Amazon::Validate::ItemSearch::de::Conductor, Net::Amazon::Validate::ItemSearch::de::Composer, Net::Amazon::Validate::ItemSearch::de::DeliveryMethod, Net::Amazon::Validate::ItemSearch::de::Magazines, Net::Amazon::Validate::ItemSearch::de::Performer, Net::Amazon::Validate::ItemSearch::de::Count, Net::Amazon::Validate::ItemSearch::de::Publisher, Net::Amazon::Validate::ItemSearch::de::State, Net::Amazon::Validate::ItemSearch::de::MusicLabel, Net::Amazon::Validate::ItemSearch::de::Brand, Net::Amazon::Validate::ItemSearch::de::MinimumPrice, Net::Amazon::Validate::ItemSearch::de::ItemPage, Net::Amazon::Validate::ItemSearch::de::Title, Net::Amazon::Validate::ItemSearch::de::Condition, Net::Amazon::Validate::ItemSearch::de::MerchantId, Net::Amazon::Validate::ItemSearch::de::Artist, Net::Amazon::Validate::ItemSearch::de::MPAARating, Net::Amazon::Validate::ItemSearch::de::Actor, Net::Amazon::Validate::ItemSearch::de::Author, Net::Amazon::Validate::ItemSearch::de::Orchestra, Net::Amazon::Validate::ItemSearch::de::TextStream, Net::Amazon::Validate::ItemSearch::de::Format, Net::Amazon::Validate::ItemSearch::fr::Sort, Net::Amazon::Validate::ItemSearch::fr::Manufacturer, Net::Amazon::Validate::ItemSearch::fr::ISPUPostalCode, Net::Amazon::Validate::ItemSearch::fr::EAN, Net::Amazon::Validate::ItemSearch::fr::Keywords, Net::Amazon::Validate::ItemSearch::fr::Director, Net::Amazon::Validate::ItemSearch::fr::PostalCode, Net::Amazon::Validate::ItemSearch::fr::AudienceRating, Net::Amazon::Validate::ItemSearch::fr::Availability, Net::Amazon::Validate::ItemSearch::fr::MaximumPrice, Net::Amazon::Validate::ItemSearch::fr::BrowseNode, Net::Amazon::Validate::ItemSearch::fr::Power, Net::Amazon::Validate::ItemSearch::fr::Conductor, Net::Amazon::Validate::ItemSearch::fr::Composer, Net::Amazon::Validate::ItemSearch::fr::DeliveryMethod, Net::Amazon::Validate::ItemSearch::fr::Magazines, Net::Amazon::Validate::ItemSearch::fr::Performer, Net::Amazon::Validate::ItemSearch::fr::Count, Net::Amazon::Validate::ItemSearch::fr::Publisher, Net::Amazon::Validate::ItemSearch::fr::State, Net::Amazon::Validate::ItemSearch::fr::MusicLabel, Net::Amazon::Validate::ItemSearch::fr::Brand, Net::Amazon::Validate::ItemSearch::fr::MinimumPrice, Net::Amazon::Validate::ItemSearch::fr::ItemPage, Net::Amazon::Validate::ItemSearch::fr::Title, Net::Amazon::Validate::ItemSearch::fr::Condition, Net::Amazon::Validate::ItemSearch::fr::MerchantId, Net::Amazon::Validate::ItemSearch::fr::Artist, Net::Amazon::Validate::ItemSearch::fr::Actor, Net::Amazon::Validate::ItemSearch::fr::Author, Net::Amazon::Validate::ItemSearch::fr::Orchestra, Net::Amazon::Validate::ItemSearch::fr::Format, Net::Amazon::Validate::ItemSearch::uk::Sort, Net::Amazon::Validate::ItemSearch::uk::Manufacturer, Net::Amazon::Validate::ItemSearch::uk::ISPUPostalCode, Net::Amazon::Validate::ItemSearch::uk::EAN, Net::Amazon::Validate::ItemSearch::uk::Keywords, Net::Amazon::Validate::ItemSearch::uk::Director, Net::Amazon::Validate::ItemSearch::uk::PostalCode, Net::Amazon::Validate::ItemSearch::uk::AudienceRating, Net::Amazon::Validate::ItemSearch::uk::Availability, Net::Amazon::Validate::ItemSearch::uk::MaximumPrice, Net::Amazon::Validate::ItemSearch::uk::BrowseNode, Net::Amazon::Validate::ItemSearch::uk::Power, Net::Amazon::Validate::ItemSearch::uk::Conductor, Net::Amazon::Validate::ItemSearch::uk::Composer, Net::Amazon::Validate::ItemSearch::uk::DeliveryMethod, Net::Amazon::Validate::ItemSearch::uk::Magazines, Net::Amazon::Validate::ItemSearch::uk::Performer, Net::Amazon::Validate::ItemSearch::uk::Count, Net::Amazon::Validate::ItemSearch::uk::Publisher, Net::Amazon::Validate::ItemSearch::uk::State, Net::Amazon::Validate::ItemSearch::uk::MusicLabel, Net::Amazon::Validate::ItemSearch::uk::Brand, Net::Amazon::Validate::ItemSearch::uk::MinimumPrice, Net::Amazon::Validate::ItemSearch::uk::ItemPage, Net::Amazon::Validate::ItemSearch::uk::Title, Net::Amazon::Validate::ItemSearch::uk::Condition, Net::Amazon::Validate::ItemSearch::uk::MerchantId, Net::Amazon::Validate::ItemSearch::uk::Artist, Net::Amazon::Validate::ItemSearch::uk::Actor, Net::Amazon::Validate::ItemSearch::uk::Author, Net::Amazon::Validate::ItemSearch::uk::Orchestra, Net::Amazon::Validate::ItemSearch::uk::TextStream, Net::Amazon::Validate::ItemSearch::uk::Format, Net::Amazon::Request::Blended, Net::Amazon::Request::Sort, Net::Amazon::Request::Manufacturer, Net::Amazon::Request::Seller, Net::Amazon::Request::EAN, Net::Amazon::Request::Director, Net::Amazon::Request::ISBN, Net::Amazon::Request::BrowseNode, Net::Amazon::Request::Power, Net::Amazon::Request::Wishlist, Net::Amazon::Request::Exchange, Net::Amazon::Request::Publisher, Net::Amazon::Request::MusicLabel, Net::Amazon::Request::Keyword, Net::Amazon::Request::ASIN, Net::Amazon::Request::Title, Net::Amazon::Request::UPC, Net::Amazon::Request::Artist, Net::Amazon::Request::Similar, Net::Amazon::Request::Actor, Net::Amazon::Request::Author, Net::Amazon::Request::TextStream, Net::Amazon::Result::Seller, Net::Amazon::Result::Seller::Listing

Source Code: Net::Amazon::Response


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.