WWW::Search::NetFind3pm
Class for searching netfind originally based on google.pm. netfind is the same as aol search.
Usage
use WWW::Search; my $Search = new WWW::Search('NetFind'); # cAsE matters my $Query = WWW::Search::escape_query("search engine consultant"); $Search->native_query($Query); while (my $Result = $Search->next_result()) { print $Result->url, "\n"; }
Overview
This class is a NetFind (AOL) specialization of WWW::Search. It handles making and interpreting NetFind searches. http://search.aol.com.
NetFinds returns 100 Hits per page.
This class exports no public interface; all interaction should be done through the WWW::Search manpage objects.
Aol search
Please note that searching at search.aol.com produces results from both the Open Source Directory and the licensed Inktomi search engine. Results from Open Source Directory are presented first followed by results from Inktomi.
If there are no results from the Open Source Directory, then results are presented from Inktomi alone. Those results that start with "MATCHING SITES" are from the Open Source Directory and those that start with "MATCHING WEB PAGES" are from the Inktomi engine.
If you are interested in results only from Inktomi, then force the search to use the web.adp query like so:
$search->native_query(WWW::Search::escape_query($query),{search_url=>'http://netfind.aol.com/web.adp'});If you are interested in results only from the Open Source Directory, refer to the OpenDirectory.pm module.
How does it work?
"native_setup_search" is called (from "WWW::Search::setup_search") before we do anything. It initializes our private variables (which all begin with underscore) and sets up a URL to the first results page in "{_next_url}".
"native_retrieve_some" is called (from "WWW::Search::retrieve_some") whenever more hits are needed. It calls "WWW::Search::http_request" to fetch the page specified by "{_next_url}". It then parses this page, appending any search hits it finds to "{cache}". If it finds a ``next'' button in the text, it sets "{_next_url}" to point to the page for the next set of results, otherwise it sets it to undef to indicate we''re done.
Testing
This module adheres to the "WWW::Search" test suite mechanism.
Legalese
THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
VERSION HISTORY 1.8 Changed the root search from netfind.aol.com to search.aol.com because netfind.aol.com seemed very unresponsive and the searches timed out frequently. Also changed to the new format using $self->hash_to_cgi_string($self->{_options});
1.5 Formatting change 10/08/99
0.7 First release 09/19/99
Releases
2 releases since Debian 2.2 (Potato); the text changed 1 time.