# Licensed to the Apache Software Foundation (ASF) under one or more
# contributor license agreements. See the NOTICE file distributed with
# this work for additional information regarding copyright ownership.
# The ASF licenses this file to You under the Apache License, Version 2.0
# (the "License"); you may not use this file except in compliance with
# the License. You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
=head1 NAME
Lucy::Docs::Tutorial::FieldType - Specify per-field properties and
behaviors.
=head1 DESCRIPTION
The Schema we used in the last chapter specifies three fields:
my $type = Lucy::Plan::FullTextType->new(
analyzer => $polyanalyzer,
);
$schema->spec_field( name => 'title', type => $type );
$schema->spec_field( name => 'content', type => $type );
$schema->spec_field( name => 'url', type => $type );
Since they are all defined as "full text" fields, they are all searchable --
including the C<url> field, a dubious choice. Some URLs contain meaningful
information, but these don't, really:
http://example.com/us_constitution/amend1.txt
We may as well not bother indexing the URL content. To achieve that we need
to assign the C<url> field to a different FieldType.
=head2 StringType
Instead of FullTextType, we'll use a
L<StringType|Lucy::Plan::StringType>, which doesn't use an
Analyzer to break up text into individual fields. Furthermore, we'll mark
this StringType as unindexed, so that its content won't be searchable at all.
my $url_type = Lucy::Plan::StringType->new( indexed => 0 );
$schema->spec_field( name => 'url', type => $url_type );
To observe the change in behavior, try searching for C<us_constitution> both
before and after changing the Schema and re-indexing.
=head2 Toggling 'stored'
For a taste of other FieldType possibilities, try turning off C<stored> for
one or more fields.
my $content_type = Lucy::Plan::FullTextType->new(
analyzer => $polyanalyzer,
stored => 0,
);
Turning off C<stored> for either C<title> or C<url> mangles our results page,
but since we're not displaying C<content>, turning it off for C<content> has
no effect -- except on index size.
=head2 Analyzers up next
Analyzers play a crucial role in the behavior of FullTextType fields. In our
next tutorial chapter, L<Lucy::Docs::Tutorial::Analysis>, we'll see how
changing up the Analyzer changes search results.