NAME

Catalyst::Model::Xapian - Catalyst model for Search::Xapian.

SYNOPSIS

    my ($it,$res)= $c->comp('MyApp::M::Xapian')->search(
      $c->req->param('q'),
      $c->req->param('page') ||0 ,
      $c->req->param('itemsperpage')||0
    );
    $c->stash->{searchresults}=$res;
    $c->stash->{iterator}=$it;

DESCRIPTION

This model class wraps Search::Xapian to provide a friendly, paged interface to Xapian (www.xapian.org) indexes. This class adds a little extra convenience on top of the Search::Xapian class. It expects you to use the QueryParser, and sets up some keywords based on the standard omega keywords (id, host, date, month, year,title), so that you can do searches like

  'fubar site:microsoft.com'

CONFIG OPTIONS

db: Path to the index directory. will default to <MyApp>/index.
language: Language to use for stemming. Defaults to english
page_size: Default page sizes for Data::Page. Defaults to 10.
utf8_query: Queries are passed as utf8 strings. defaults to 1.
order_by_date: Sets weighting to order by docid descending rather than the usual BM25 weighting. Off by default.

METHODS

new: Constructor. sets up the db and qp accessors. Is called automatically by Catalyst at startup.
search <q>,[<page>],[<page_size>]: perform a search using the Xapian QueryBuilder. expands the document data using extract_data. You can override the page size per query by passing page size as a final argument to the function. returns a Data::Page object and an arrayref to the extracted document data.
prepare_enq <enq>: Prepare enquire object before getting mset. Allows you to modify ordering and such in your subclass.
extract_data <item> <query>: Extract data from a Search::Xapian::Document. Defaults to using Storable::thaw.
qp: Query Parser. The Search::Xapian::QueryParser object used to parse the query.

AUTHOR

Marcus Ramberg <mramberg@cpan.org>

LICENSE

This library is free software . You can redistribute it and/or modify it under the same terms as perl itself.