1Lucy::Docs::Tutorial::QUuseerryOCbojnetcrtisbLTuuutcteyod:r:iPDaeolrc(ls3:)D:oTcuutmoernitaalt:i:oQnueryObjectsTutorial(3)
2
6 Lucy::Docs::Tutorial::QueryObjectsTutorial - Use Query objects instead
7 of query strings.
8
10 Until now, our search app has had only a single search box. In this
11 tutorial chapter, weXll move towards an Xadvanced searchX interface, by
12 adding a XcategoryX drop-down menu. Three new classes will be
13 required:
14 • QueryParser - Turn a query string into a Query object.
16 • TermQuery - Query for a specific term within a specific field.
18 • ANDQuery - XANDX together multiple Query objects to produce an
20 intersected result set.
21 Adaptations to indexer.pl
23 Our new XcategoryX field will be a StringType field rather than a
24 FullTextType field, because we will only be looking for exact matches.
25 It needs to be indexed, but since we wonXt display its value, it
26 doesnXt need to be stored.
27 my $cat_type = Lucy::Plan::StringType->new( stored => 0 );
29 $schema->spec_field( name => 'category', type => $cat_type );
30 There will be three possible values: XarticleX, XamendmentX, and
32 XpreambleX, which weXll hack out of the source fileXs name during our
33 "parse_file" subroutine:
34 my $category
36 = $filename =~ /art/ ? 'article'
37 : $filename =~ /amend/ ? 'amendment'
38 : $filename =~ /preamble/ ? 'preamble'
39 : die "Can't derive category for $filename";
40 return {
41 title => $title,
42 content => $bodytext,
43 url => "/us_constitution/$filename",
44 category => $category,
45 };
46 Adaptations to search.cgi
48 The XcategoryX constraint will be added to our search interface using
49 an HTML XselectX element (this routine will need to be integrated into
50 the HTML generation section of search.cgi):
51 # Build up the HTML "select" object for the "category" field.
53 sub generate_category_select {
54 my $cat = shift;
55 my $select = qq|
56 <select name="category">
57 <option value="">All Sections</option>
58 <option value="article">Articles</option>
59 <option value="amendment">Amendments</option>
60 </select>|;
61 if ($cat) {
62 $select =~ s/"$cat"/"$cat" selected/;
63 }
64 return $select;
65 }
66 WeXll start off by loading our new modules and extracting our new CGI
68 parameter.
69 use Lucy::Search::QueryParser;
71 use Lucy::Search::TermQuery;
72 use Lucy::Search::ANDQuery;
73 ...
75 my $category = decode( "UTF-8", $cgi->param('category') || '' );
77 QueryParserXs constructor requires a XschemaX argument. We can get
79 that from our IndexSearcher:
80 # Create an IndexSearcher and a QueryParser.
82 my $searcher = Lucy::Search::IndexSearcher->new(
83 index => $path_to_index,
84 );
85 my $qparser = Lucy::Search::QueryParser->new(
86 schema => $searcher->get_schema,
87 );
88 Previously, we have been handing raw query strings to IndexSearcher.
90 Behind the scenes, IndexSearcher has been using a QueryParser to turn
91 those query strings into Query objects. Now, we will bring QueryParser
92 into the foreground and parse the strings explicitly.
93 my $query = $qparser->parse($q);
95 If the user has specified a category, weXll use an ANDQuery to join our
97 parsed query together with a TermQuery representing the category.
98 if ($category) {
100 my $category_query = Lucy::Search::TermQuery->new(
101 field => 'category',
102 term => $category,
103 );
104 $query = Lucy::Search::ANDQuery->new(
105 children => [ $query, $category_query ]
106 );
107 }
108 Now when we execute the queryX
110 # Execute the Query and get a Hits object.
112 my $hits = $searcher->hits(
113 query => $query,
114 offset => $offset,
115 num_wanted => $page_size,
116 );
117 X weXll get a result set which is the intersection of the parsed query
119 and the category query.
120 Using TermQuery with full text fields
122 When querying full text fields, the easiest way is to create query
123 objects using QueryParser. But sometimes you want to create TermQuery
124 for a single term in a FullTextType field directly. In this case, we
125 have to run the search term through the fieldXs analyzer to make sure
126 it gets normalized in the same way as the fieldXs content.
127 sub make_term_query {
129 my ($field, $term) = @_;
130 my $token;
132 my $type = $schema->fetch_type($field);
133 if ( $type->isa('Lucy::Plan::FullTextType') ) {
135 # Run the term through the full text analysis chain.
136 my $analyzer = $type->get_analyzer;
137 my $tokens = $analyzer->split($term);
138 if ( @$tokens != 1 ) {
140 # If the term expands to more than one token, or no
141 # tokens at all, it will never match a token in the
142 # full text field.
143 return Lucy::Search::NoMatchQuery->new;
144 }
145 $token = $tokens->[0];
147 }
148 else {
149 # Exact match for other types.
150 $token = $term;
151 }
152 return Lucy::Search::TermQuery->new(
154 field => $field,
155 term => $token,
156 );
157 }
158 Congratulations!
160 YouXve made it to the end of the tutorial.
161 See Also
163 For additional thematic documentation, see the Apache Lucy Cookbook.
164 ANDQuery has a companion class, ORQuery, and a close relative,
166 RequiredOptionalQuery.
167perl v5.34.0 L2u0c2y2:-:0D1o-c2s1::Tutorial::QueryObjectsTutorial(3)