www::opensearch::response(3pm) [debian man page]

WWW::OpenSearch::Response(3pm)				User Contributed Perl Documentation			    WWW::OpenSearch::Response(3pm)

NAME

       WWW::OpenSearch::Response - Encapsulate a response received from an A9 OpenSearch compatible engine

SYNOPSIS

	   use WWW::OpenSearch;

	   my $url = "http://bulkfeeds.net/opensearch.xml";
	   my $engine = WWW::OpenSearch->new($url);

	   # Retrieve page 4 of search results for "iPod"
	   my $response = $engine->search("iPod",{ startPage => 4 });
	   for my $item (@{$response->feed->items}) {
	       print $item->{description};
	   }

	   # Retrieve page 3 of results
	   $response = $response->previous_page;

	   # Retrieve page 5 of results
	   $response = $response->next_page;

DESCRIPTION

       WWW::OpenSearch::Response is a module designed to encapsulate a response received from an A9 OpenSearch compatible engine.  See
       http://opensearch.a9.com/spec/1.1/response/ for details.

CONSTRUCTOR

   new( $response )
       Constructs a new instance of WWW::OpenSearch::Response from the WWWW::OpenSearch:Response returned by the search request.

METHODS

   parse_response( )
       Parses the content of the HTTP response using XML::Feed. If successful, parse_feed( ) is also called.

   parse_feed( )
       Parses the XML::Feed originally parsed from the HTTP response content.  Sets the pager object appropriately.

   previous_page( ) / next_page( )
       Performs another search on the parent object, returning a WWW::OpenSearch::Response instance containing the previous/next page of results.
       If the current response includes a &lt;link rel="previous/next" href="..." /&gt; tag, the page will simply be the parsed content of the URL
       specified by the tag's href attribute. However, if the current response does not include the appropriate link, a new query is constructed
       using the startPage or startIndex query arguments.

   _get_link( $type )
       Gets the href attribute of the first link whose rel attribute is equal to $type.

ACCESSORS

   feed( )
   pager( )
AUTHOR

       o   Tatsuhiko Miyagawa <miyagawa@bulknews.net>

       o   Brian Cassidy <bricas@cpan.org>

COPYRIGHT AND LICENSE

       Copyright 2005-2010 by Tatsuhiko Miyagawa and Brian Cassidy

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

perl v5.10.1							    2010-05-25					    WWW::OpenSearch::Response(3pm)

Check Out this Related Man Page

WWW::OpenSearch::Description(3pm)			User Contributed Perl Documentation			 WWW::OpenSearch::Description(3pm)

NAME

       WWW::OpenSearch::Description - Encapsulate an OpenSearch Description provided by an A9 OpenSearch compatible engine

SYNOPSIS

	   use WWW::OpenSearch;

	   my $url = "http://bulkfeeds.net/opensearch.xml";
	   my $engine = WWW::OpenSearch->new($url);
	   my $description = $engine->description;

	   my $format	= $description->Format;   # or $description->format
	   my $longname = $description->LongName; # or $description->longname

DESCRIPTION

       WWW::OpenSearch::Description is a module designed to encapsulate an OpenSearch Description provided by an A9 OpenSearch compatible engine.
       See http://opensearch.a9.com/spec/1.1/description/ for details.

CONSTRUCTOR

   new( [ $xml ] )
       Constructs a new instance of WWW::OpenSearch::Description. If scalar parameter $xml is provided, data will be automatically loaded from it
       using load( $xml ).

METHODS

   load( $xml )
       Loads description data by parsing provided argument using XML::LibXML.

   urls( )
       Return all of the urls associated with this description in an array.

   get_best_url( )
       Attempts to retrieve the best URL associated with this description, based on the following content types (from most preferred to least
       preferred):

       o   application/atom+xml

       o   application/rss+xml

       o   text/xml

   get_url_by_type( $type )
       Retrieves the first WWW::OpenSearch::URL associated with this description whose type is equal to $type.

ACCESSORS

   version( )
   ns( )
   AdultContent( )
   Attribution( )
   Contact( )
   Description( )
   Developer( )
   Format( )
   InputEncoding( )
   Image( )
   Language( )
   LongName( )
   OutputEncoding( )
   Query( )
   SampleSearch( )
   ShortName( )
   SyndicationRight( )
   Tags( )
   Url( )
AUTHOR

       o   Tatsuhiko Miyagawa <miyagawa@bulknews.net>

       o   Brian Cassidy <bricas@cpan.org>

COPYRIGHT AND LICENSE

       Copyright 2005-2010 by Tatsuhiko Miyagawa and Brian Cassidy

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

perl v5.10.1							    2010-05-25					 WWW::OpenSearch::Description(3pm)

Linux and UNIX Man Pages

www::opensearch::response(3pm) [debian man page]

Check Out this Related Man Page