documentation/manual/nl/module_specs/Zend_Search_Lucene-Searching.xml

   1 <sect1 id="zend.search.lucene.searching">
   2     <title>Het doorzoeken van een index</title>
   3
   4     <sect2 id="zend.search.lucene.searching.query-parser">
   5         <title>Opbouwen van Queries</title>
   6
   7         <para>
   8             Er zijn twee manieren om door een index te zoeken. De eerste methode gebruikt de Query Parser om een query op te bouwen van een string. De tweede bied de mogelijkheid je eigen queries te maken via de Zend_Search_Lucene API.
   9         </para>
  10
  11         <para>
  12         Alvorens te kiezen voor de aangeboden Query Parser, hou het volgende in gedachte:
  13
  14             <orderedlist>
  15                 <listitem>
  16                   <para>
  17                     Wanneer je query string door je applicatie wordt opgebouwd dan moet je serieus overwegen om je queries op te bouwen met de query API. Met andere woorden: De query parser is bedoeld voor door mensen ingevoerde tekst, niet voor applicatie-gerelateerde tekst.
  18                   </para>
  19                 </listitem>
  20                 <listitem>
  21                   <para>
  22                     Untokenized velden worden het best direct aan queries toegevoegd, en niet via de query parser. Wanneerde waarde van een veld via een applicatie wordt gegenereerd, dan dienen de query clases ook op die manier tot stand te komen voor dit veld.
  23                     De query parser gebruikt een analyzer om door mensen ingegeven strings to converteren van tekst naar termen. Waardes gegenereerd door een programma, zoals data, trefwoorden, etc. dienen consistent door het programma gegenereerd te worden.
  24                   </para>
  25                 </listitem>
  26                 <listitem>
  27                   <para>
  28                     In een query formulier dienen velden die over het algemeen tekst bevatten de query parser te gebruiken. Alle andere velden, zoals datum ranges, trefwoorden etc. kunnen het beste direct via de query API worden toegevoegd. Een veld met een gelimiteerde set van waarden, die kan worden geselecteerd via een pull-down menu, horen niet via een query string toegevoegd en geparsed worden, maar via een TermQuery clausule.
  29                   </para>
  30                 </listitem>
  31             </orderedlist>
  32
  33         </para>
  34
  35         <para>
  36             Beide manieren gebruiken dezelfde API methode om door de index te zoeken:
  37         </para>
  38         <programlisting role="php"><![CDATA[<?php
  39
  40 require_once('Zend/Search/Lucene.php');
  41
  42 $index = new Zend_Search_Lucene('/data/my_index');
  43
  44 $index->find($query);
  45
  46 ?>]]></programlisting>
  47         <para>
  48             De <code>Zend_Search_Lucene::find()</code> methode herkent automatisch het invoer type en gebruikt de query parser om het juiste Zend_Search_Lucene_Search_Query object
  49             van een string te maken.
  50         </para>
  51
  52         <para>
  53             Het is belangrijk om te zien dat <code>find()</code> case sensitive is. Standaard normaliseert LuceneIndexCreation.jar alle documenten naar kleine letters. Dit kan uitgezet worden met een command line switch (type LuceneIndexCreation.jar zonder argumenten voor hulp). De case van de tekst die aan <code>find()</code> wordt doorgegeven moet overeenkomen met die in de index. Als de index is genormaliseerd naar kleine letters, dan dient alle tekst die aan <code>find()</code> wordt doorgegeven worden onderworpen aan <code>strtolower()</code>, anders worden mogelijk geen resultaten gevonden.
  54         </para>
  55     </sect2>
  56
  57     <sect2 id="zend.search.lucene.searching.results">
  58         <title>Zoek resultaten</title>
  59         <para>
  60             Het zoek resultaat is een array van Zend_Search_Lucene_Search_QueryHit objecten.  Ieder van deze objecten heeft twee eigenschappen: <code>$hit->document</code> is een documentnummer binnen de index en <code>$hit->score</code> is een score van het resultaat binnen het volledige zoekresultaat. Resultaat wordt geordend op score (hoogste score komt eerst).
  61         </para>
  62
  63         <para>
  64             Het Zend_Search_Lucene_Search_QueryHit object bied daarnaast ook ieder veld van het gevonden Zend_Search_Lucene_Document als een eigenschap. In het volgende voorbeeld wordt een resultaat teruggegeven en heeft het document twee velden: title en author.
  65         </para>
  66         <programlisting role="php"><![CDATA[<?php
  67
  68 require_once('Zend/Search/Lucene.php');
  69
  70 $index = new Zend_Search_Lucene('/data/my_index');
  71
  72 $hits = $index->find($query);
  73
  74 foreach ($hits as $hit) {
  75     echo $hit->id;
  76     echo $hit->score;
  77
  78     echo $hit->title;
  79     echo $hit->author;
  80 }
  81
  82 ?>]]></programlisting>
  83
  84         <para>
  85         Het originele Zend_Search_Lucene_Document object kan ook worden teruggegeven vanuit de Zend_Search_Lucene_Search_QueryHit.
  86
  87         Je kan opgeslagen delen van het document verkrijgen door gebruik te maken van de <code>getDocument()</code>methode van het index object en dan de <code>getFieldValue()</code> methode te gebruiken:
  88         </para>
  89         <programlisting role="php"><![CDATA[<?php
  90
  91 require_once('Zend/Search/Lucene.php');
  92
  93 $index = new Zend_Search_Lucene('/data/my_index');
  94
  95 $hits = $index->find($query);
  96 foreach ($hits as $hit) {
  97     // geef een Zend_Search_Lucene_Document object terug voor dit resultaat
  98     echo $document = $hit->getDocument();
  99
 100     // geef een Zend_Search_Lucene_Field object terug
 101     // uit het Zend_Search_Lucene_Document
 102     echo $document->getField('title');
 103
 104     // geef de string waarde terug van een Zend_Search_Lucene_Field object
 105     echo $document->getFieldValue('title');
 106
 107     // hetzelfde als getFieldValue()
 108     echo $document->title;
 109 }
 110
 111 ?>]]></programlisting>
 112         <para>
 113         De velden die beschikbaar zijn via het Zend_Search_Lucene_Document object worden besloten tijdens het indexeren. De document velden worden ofwel geindexeerd, ofwel geindexeerd en opgeslagen, in het document door de indexeringsapplicatie (bijvoorbeeld LuceneIndexCreation.jar).
 114         </para>
 115
 116         <para>
 117         Let op dat de document identiteit ('path' in het voorbeeld) ook wordt opgeslagen in de index en vanuit de index opgehaald dient te worden.
 118         </para>
 119
 120     </sect2>
 121
 122
 123     <sect2 id="zend.search.lucene.searching.results-scoring">
 124         <title>Resultaten Scoring</title>
 125         <para>
 126             Zend_Search_Lucene gebruikt hetzelfde score algoritme als Java Lucene.
 127             Zoek resultaten worden geordend op score, met de hoogste score als eerst.
 128         </para>
 129
 130         <para>
 131             Een verschillende score betekent dat een document meer overeenkomt met de zoekopdracht dan de andere.
 132         </para>
 133
 134         <para>
 135             Ruwweg genomen wordt de zoekopdracht vaker gevonden in documenten met een hogere score dan in documenten met een lagere score.
 136         </para>
 137
 138         <para>
 139             Score kan worden verkregen via de <code>score</code> eigenschap van het resultaat:
 140         </para>
 141         <programlisting role="php"><![CDATA[<?php
 142 $hits = $index->find($query);
 143
 144 foreach ($hits as $hit) {
 145     echo $hit->id;
 146     echo $hit->score;
 147 }
 148
 149 ?>]]></programlisting>
 150
 151         <para>
 152             Zend_Search_Lucene_Search_Similarity klasse wordt gebruikt om de score te berekenen. Zie <link linkend="zend.search.lucene.extending.scoring">Uitbreidbaarheid. Scoring Algoritmes</link> sectie voor details.
 153         </para>
 154
 155     </sect2>
 156
 157 </sect1>
 158