Net::Amazon::Validate::ItemSearch - Validate ItemSearch requests.


Net-Amazon documentation  | view source Contained in the Net-Amazon distribution.

Index


NAME

Top

Net::Amazon::Validate::ItemSearch - Validate ItemSearch requests.

SYNOPSIS

Top

  Net::Amazon::Validate::ItemSearch;

  my $valid   = Net::Amazon::Validate::ItemSearch::factory(search_index => 'Actor');
  my $option  = $itemsearch_valid->user_or_default($input);
  my $default = $itemsearch_valid->default();

DESCRIPTION

Top

Net::Amazon::Validate::ItemSearch is a class used to verify ItemSearch operation based on the current version of the WSDL and locale. For example if an Artist search is executed the user can search against Classical, Merchants, or Music.

METHODS

factory(search_index => type)

Constructs a new Net::Amazon::Validate::ItemSearch object, used to validate user input for a SearchIndex. Valid types include Actor, Artist, AudienceRating, Author Brand, BrowseNode, City, Composer, Condition, Conductor, Count, Cuisine, DeliveryMethod, Director, ISPUPostalCode, ItemPage, Keywords, MPAARating, Manufacturer, MaximumPrice, MerchantId, MinimumPrice, MusicLabel, Neighborhood, Orchestra, Power, Publisher, Sort, TextStream and Title. Which departments these search indexes are valid for is dependent upon locale.

default()

Return the default value for a given SearchIndex. Default are determined in order of preference and existence from the following list: Books, Music, DVD, Software. If none of those items are valid for a given SearchIndex then the first valid department of said SearchIndex is used.

user_or_default( $input )

If user input is specified it validates the input, and return it, otherwise it returns the default value for the SearchIndex.

AUTHORS

Top

Christopher Boumenot, <boumenot@gmail.com>

COPYRIGHT AND LICENSE

Top

NAME

Top

Net::Amazon::Validate::ItemSearch - Validate user supplied options against known valid options.

SYNOPSIS

Top

  use Net::Amazon::Validate::ItemSearch;

  # ...

  my $valid = Net::Amazon::Validate::ItemSearch::factory(search_index => 'Actor');
  $valid->user_or_default($input);
  $valid->default();

DESCRIPTION

Top

METHODS

Asin()

The item's ASIN number.

Please check the subclasses of Net::Amazon::Validate for specialized methods.

TODO

Top

I should probably add a function to dispatch calls automatically, that way the user doesn't have to explicity call a function to verify an option. It would make it very easy to write loops to validate input.

BUGS

Top

This library was designed to validate ResponseGroup requests only. Support for other parameters were autogenerated but not verified. The biggest problems are with the intrepration of 'Integers 1 to 30', 'A Merchant ID', or 'Amazon (the default value)'.

AUTHOR

Top

Christopher Boumenot, <boumenot@gmail.com>

COPYRIGHT AND LICENSE

Top


Net-Amazon documentation  | view source Contained in the Net-Amazon distribution.