Mark Overmeer > Apache-Solr-0.92 > Apache::Solr::Result

Download:
Apache-Solr-0.92.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  2
View/Report Bugs
Module Version: 0.92   Source   Latest Release: Apache-Solr-0.98

NAME ^

Apache::Solr::Result - Apache Solr (Lucene) result container

SYNOPSIS ^

  my $result = $solr->select(...);
  my $result = $solr->queryTerm(...);
  $result or die $result->error;  # $result is object but false

METHODS ^

Constructors

Apache::Solr::Result->new(OPTIONS)
 -Option  --Default
  endpoint  <required>
  params    <required>
  request   undef
  response  undef
endpoint => URI
params => ARRAY
request => HTTP::Request object
response => HTTP::Response object

Accessors

$obj->decoded([HASH])
$obj->elapse()

Number of seconds used to receive a decoded answer.

$obj->endpoint()

The URI where the request is sent to.

$obj->params()

List of (expanded) parameters used to call the solr server.

$obj->request([REQUEST])
$obj->response([RESPONSE])
$obj->solrError()
$obj->solrQTime()

Elapse (as reported by the server) to handle the request. In seconds!

$obj->solrStatus()
$obj->start()

The timestamp of the moment the call has started, including the creation of the message to be sent.

$obj->success()

Returns true if the command has successfully completed.

example:

   my $result = $sorl->commit;
   $result->success or die;
   $result or die;          # same, via overloading
   $solr->commit or die;    # same, also overloading

Response information

$obj->highlighted(DOCUMENT)

Return information which relates to the selected DOCUMENT.

$obj->nrSelected()

Returns the number of selected documents, as result of a Apache::Solr::select() call. Probably many of those documents are not loaded (yet).

$obj->selected(RANK [,CLIENT])

Returns information about the query by Apache::Solr::select() on position RANK. Returned is a HASH, which can have fields 'doc' and 'hl' (maybe more later)

The first request will take a certain number of "rows". If you pass the CLIENT, this routine will automatically collect more of the selected answers.

example:

   my $r = $solr->select(rows => 10, ...);
   $r or die;

   if(my $last = $r->selected(9)) {...}

   my $elf = $r->selected(11);         # error
   my $elf = $r->selected(11, $solr);  # auto-collects more
$obj->terms(FIELD [, TERMS])

Returns the results of a 'terms' query (see Apache::Solr::queryTerms()), which is a HASH.

When TERMS are specified, a new table is set.

In Solr XML (at least upto v4.0) the results are presented as lst, not arr So: their sort order is lost.

Helpers

$obj->replaceParams(HASH, OLDPARAMS)
$obj->selectedPage(PAGENR)
$obj->selectedPageLoad(RANK, CLIENT)
$obj->selectedPageNr(RANK)
$obj->selectedPageSize()
$obj->selectedPages()
$obj->showTimings([FILEHANDLE])

Print timing informat to the FILEHANDLE, by default the selected file-handle (probably STDOUT).

OVERLOADING ^

overload: stringification()

SEE ALSO ^

This module is part of Apache-Solr distribution version 0.92, built on December 06, 2012. Website: http://perl.overmeer.net

LICENSE ^

Copyrights 2012 by [Mark Overmeer]. For other contributors see ChangeLog.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See http://www.perl.com/perl/misc/Artistic.html

syntax highlighting: