NAME

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

SYNOPSIS

  # All operations return a ::Result object
  my $result = $solr->select(...);

  $result or die $result->solrError; # error reported by Solr
  $result or die $result->errors;    # any error caught by this object

  # Lots of trace information included
  $result->showTimings;

  # ::Document containing the requested fields from a select() search
  my $doc1   = $result->selected(0);

  # ::Document containing the highlight info from a selected document
  my $hl1    = $result->highlighted($doc1);

  # Some operations have helper methods
  my $result = $solr->queryTerm(...);
  print Dumper $result->terms;

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->errors()

All errors collected by this object into one string.

$obj->httpError()

$obj->params()

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

$obj->request([REQUEST])

$obj->response([RESPONSE])

$obj->serverError()

$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

in response to a select()

$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

in response to a queryTerms()

$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.94, built on January 31, 2013. Website: http://perl.overmeer.net

LICENSE

Copyrights 2012-2013 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