view release on metacpan or  search on metacpan

lib/Apache/Solr.pod  view on Meta::CPAN

because they were removed from the indicated server version.

=back

=head3 Other helpers

=over 4

=item $obj-E<gt>B<endpoint>($action, %options)

Compute the address to be called (for HTTP)

 -Option--Default
  core    new(core)
  params  []

=over 2

=item core => $name

If no core is specified, the default of the server is addressed.

=item params => %params|\@params

The order of the parameters will be preserved when an ARRAY or parameters
is passed; you never know for a HASH.

=back

=item $obj-E<gt>B<request>($url, $result, $body, $ct)

Send a request to the server C<$url> and return the response
(an HTTP::Response object).  A trace of the activity is
added to the C<$result> object.  The C<$body> of the request
can be provided as bytes or reference to bytes (SCALAR). The
content-type C<$ct> must match the body bytes.

=back

=head1 DETAILS

=head2 Comparison with other implementations

=head3 Compared to WebService::Solr

WebService::Solr is a good module, with a lot of miles.  The main
differences is that C<Apache::Solr> has much more abstraction.

=over 4

=item * simplified parameter syntax, improving readibility

=item * real Perl-level boolean parameters, not 'C<true>' and 'C<false>'

=item * warnings for deprecated and ignored parameters

=item * smart result object with built-in trace and timing

=item * hidden paging of results

=item * flexible logging framework (Log::Report)

=item * both-way XML or both-way JSON, not requests in XML and answers in JSON

=item * access to plugings like terms and tika

=item * no Moose

=back

=head1 DIAGNOSTICS

=over 4

=item Fault: Cannot read document from $fn: $!

Cast by C<extractDocument()>

=item Fault: Read error for document $fn: $!

Cast by C<extractDocument()>

=item Fault: Solr request failed after $elapse seconds after $retries retries: $!

Cast by C<request()>

=item Alert: Solr request failed with $code, $retries retries left: $!

Cast by C<request()>

=item Error: Solr request failed with: $err

Cast by C<request()>

=item Warning: deprecated solr $message

Cast by C<deprecated()>

=item Error: extract requires document as file or string.

Cast by C<extractDocument()>

=item Error: extractDocument() requires Solr v1.4 or higher.

Cast by C<extractDocument()>

=item Error: field $field is not simple for a set.

Cast by C<expandSelect()>

=item Warning: ignored solr $message

Cast by C<ignored()>

=item Warning: removed solr $message

Cast by C<removed()>

=item Error: rollback not supported by your solr server version.

Cast by C<rollback()>