home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _40045e0213ec4f477778439b45194cb5 < prev    next >
Text File  |  2000-03-23  |  6KB  |  150 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>WWW::Search::NetFind - class for searching NetFind 
  5. Originally based on Google.pm. NetFind is the same
  6. as AOL search.</TITLE>
  7. <LINK REL="stylesheet" HREF="../../../../Active.css" TYPE="text/css">
  8. <LINK REV="made" HREF="mailto:">
  9. </HEAD>
  10.  
  11. <BODY>
  12. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  13. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  14. <STRONG><P CLASS=block> WWW::Search::NetFind - class for searching NetFind 
  15. Originally based on Google.pm. NetFind is the same
  16. as AOL search.</P></STRONG>
  17. </TD></TR>
  18. </TABLE>
  19.  
  20. <A NAME="__index__"></A>
  21. <!-- INDEX BEGIN -->
  22.  
  23. <UL>
  24.  
  25.     <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
  26.  
  27.     <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
  28.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  29.     <LI><A HREF="#aol search">AOL SEARCH</A></LI>
  30.     <LI><A HREF="#see also">SEE ALSO</A></LI>
  31.     <LI><A HREF="#how does it work">HOW DOES IT WORK?</A></LI>
  32.     <LI><A HREF="#testing">TESTING</A></LI>
  33.     <LI><A HREF="#author">AUTHOR</A></LI>
  34.     <LI><A HREF="#legalese">LEGALESE</A></LI>
  35.     <LI><A HREF="#bugs">BUGS</A></LI>
  36.     <LI><A HREF="#version history">VERSION HISTORY</A></LI>
  37. </UL>
  38. <!-- INDEX END -->
  39.  
  40. <HR>
  41. <P>
  42. <H1><A NAME="name">NAME</A></H1>
  43. <P>WWW::Search::NetFind - class for searching NetFind 
  44. Originally based on Google.pm. NetFind is the same
  45. as AOL search.</P>
  46. <P>
  47. <HR>
  48. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  49. <UL>
  50. <LI>Linux</LI>
  51. <LI>Solaris</LI>
  52. <LI>Windows</LI>
  53. </UL>
  54. <HR>
  55. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  56. <P>use WWW::Search;
  57. my $Search = new WWW::Search('NetFind'); # cAsE matters
  58. my $Query = WWW::Search::escape_query(``search engine consultant'');
  59. $Search->native_query($Query);
  60. while (my $Result = $Search-><CODE>next_result())</CODE> {
  61. print $Result->url, ``\n'';
  62. }</P>
  63. <P>
  64. <HR>
  65. <H1><A NAME="description">DESCRIPTION</A></H1>
  66. <P>This class is a NetFind (AOL) specialization of WWW::Search.
  67. It handles making and interpreting NetFind searches.
  68. <EM><A HREF="http://search.aol.com">http://search.aol.com</A></EM>.</P>
  69. <P>NetFinds returns 100 Hits per page.</P>
  70. <P>This class exports no public interface; all interaction should
  71. be done through <A HREF="../../../../site/lib/WWW/Search.html">the WWW::Search manpage</A> objects.</P>
  72. <P>
  73. <HR>
  74. <H1><A NAME="aol search">AOL SEARCH</A></H1>
  75. <P>Please note that searching at search.aol.com produces 
  76. results from both the Open Source Directory and the licensed
  77. Inktomi search engine. Results from Open Source Directory are
  78. presented first followed by results from Inktomi.</P>
  79. <P>If there are no results from the Open Source Directory, then
  80. results are presented from Inktomi alone. Those results
  81. that start with ``MATCHING SITES'' are from the Open Source
  82. Directory and those that start with ``MATCHING WEB PAGES'' 
  83. are from the Inktomi engine.</P>
  84. <P>If you are interested in results only from Inktomi, 
  85. then force the search to use the web.adp query like so:</P>
  86. <PRE>
  87.  $search->native_query(WWW::Search::escape_query($query),{search_url=>'<A HREF="http://netfind.aol.com/web.adp">http://netfind.aol.com/web.adp</A>'});</PRE>
  88. <P>If you are interested in results only from the Open Source
  89. Directory, refer to the OpenDirectory.pm module.</P>
  90. <P>
  91. <HR>
  92. <H1><A NAME="see also">SEE ALSO</A></H1>
  93. <P>To make new back-ends, see <A HREF="../../../../site/lib/WWW/Search.html">the WWW::Search manpage</A>.</P>
  94. <P>
  95. <HR>
  96. <H1><A NAME="how does it work">HOW DOES IT WORK?</A></H1>
  97. <P><CODE>native_setup_search</CODE> is called (from <CODE>WWW::Search::setup_search</CODE>)
  98. before we do anything.  It initializes our private variables (which
  99. all begin with underscore) and sets up a URL to the first results
  100. page in <CODE>{_next_url}</CODE>.</P>
  101. <P><CODE>native_retrieve_some</CODE> is called (from <CODE>WWW::Search::retrieve_some</CODE>)
  102. whenever more hits are needed.  It calls <CODE>WWW::Search::http_request</CODE>
  103. to fetch the page specified by <CODE>{_next_url}</CODE>.
  104. It then parses this page, appending any search hits it finds to 
  105. <CODE>{cache}</CODE>.  If it finds a ``next'' button in the text,
  106. it sets <CODE>{_next_url}</CODE> to point to the page for the next
  107. set of results, otherwise it sets it to undef to indicate we''re done.</P>
  108. <P>
  109. <HR>
  110. <H1><A NAME="testing">TESTING</A></H1>
  111. <P>This module adheres to the <CODE>WWW::Search</CODE> test suite mechanism.</P>
  112. <P>
  113. <HR>
  114. <H1><A NAME="author">AUTHOR</A></H1>
  115. <P>This backend is maintained and supported by Gil Vidals.
  116. <<A HREF="mailto:gil@positiongeek.com">gil@positiongeek.com</A>></P>
  117. <P>
  118. <HR>
  119. <H1><A NAME="legalese">LEGALESE</A></H1>
  120. <P>THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
  121. WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
  122. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.</P>
  123. <P>
  124. <HR>
  125. <H1><A NAME="bugs">BUGS</A></H1>
  126. <P>Since this is a new Backend there are undoubtly one. Report any ASAP.</P>
  127. <P>
  128. <HR>
  129. <H1><A NAME="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});">VERSION HISTORY
  130. 1.8
  131. Changed the root search from netfind.aol.com to search.aol.com
  132. because netfind.aol.com seemed very unresponsive and the
  133. searches timed out frequently. Also changed to the new format
  134. using $self->hash_to_cgi_string($self->{_options});</A></H1>
  135. <P>1.5
  136. Formatting change 10/08/99</P>
  137. <P>0.7
  138. First release  09/19/99</P>
  139. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  140. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  141. <STRONG><P CLASS=block> WWW::Search::NetFind - class for searching NetFind 
  142. Originally based on Google.pm. NetFind is the same
  143. as AOL search.</P></STRONG>
  144. </TD></TR>
  145. </TABLE>
  146.  
  147. </BODY>
  148.  
  149. </HTML>
  150.