# Auto-generated file -- DO NOT EDIT!!!!!

=head1 NAME

KinoSearch::Search::RequiredOptionalQuery - Join results for two Queries, one required, one optional.

=head1 SYNOPSIS

    my $foo_and_maybe_bar = KinoSearch::Search::RequiredOptionalQuery->new(
        required_query => $foo_query,
        optional_query => $bar_query,
    );
    my $hits = $searcher->hits( query => $foo_and_maybe_bar );
    ...



=head1 DESCRIPTION

Join results for two Queries, one required, one optional.

RequiredOptionalQuery joins the result sets of one Query which MUST match,
and one Query which SHOULD match.  When only the required Query matches,
its score is passed along; when both match, the scores are summed.

=head1 CONSTRUCTORS

=head2 new( I<[labeled params]> )

    my $reqopt_query = KinoSearch::Search::RequiredOptionalQuery->new(
        required_query => $foo_query,    # required
        optional_query => $bar_query,    # required
    );

=over

=item *

B<required_query> - Query must must match.

=item *

B<optional_query> - Query which should match.

=back



=head1 METHODS

=head2 get_required_query()

Getter for the required Query.

=head2 set_required_query(required_query)

Setter for the required Query.

=head2 get_optional_query()

Getter for the optional Query.

=head2 set_optional_query(optional_query)

Setter for the optional Query.





=head1 INHERITANCE

KinoSearch::Search::RequiredOptionalQuery isa L<KinoSearch::Search::PolyQuery> isa L<KinoSearch::Search::Query> isa L<KinoSearch::Obj>.


=head1 COPYRIGHT AND LICENSE

Copyright 2005-2009 Marvin Humphrey

This program is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.

=cut