NAME

Dancer2::Plugin::ElasticSearch - Dancer2 plugin for obtaining Search::Elasticsearch handles

VERSION

version 0.004

SYNOPSIS

  use Dancer2::Plugin::ElasticSearch;
  get '/count_all_docs' => sub {
    return elastic->search(search_type => 'count',
                           body => { query => { match_all => {} } });
  }

DESCRIPTION

This Dancer2 plugin handles connection configuration and fork-and-thread safety for ElasticSearch connectors.

KEYWORDS

elastic

  elastic->ping;
  elastic('other')->ping;

Return a Search::Elasticsearch::Client subclass suitable for running queries against an ElasticSearch instance. Each thread is guaranteed to have its own client instances. If a connection already exists for a given configuration name, it is returned instead of being re-created. If a new connection is created, ping is immediately called to check it; this may throw an exception if there is in fact an issue with the cluster.

If a configuration name is not passed, "default" is assumed.

CONFIGURATION

  plugins:
    ElasticSearch:
      default:
        params:
          nodes: localhost:9200
      other:
        params: etc

The params hashref must contain a map of parameters that can be passed directly to the Search::Elasticsearch constructor. In the above example, calling elastic (or elastic('default')) will result in

  Search::Elasticsearch->new(nodes => 'localhost:9200');

INSTALLATION

You can install this module as you would any Perl module.

During installation, the unit tests will run queries against a local ElasticSearch instance if there is one (read-only queries, of course!). If you have no local ElasticSearch instance, but still wish to run the unit tests, set the D2_PLUGIN_ES variable to "$host:$port". If no instance can be reached, the tests will be safely skipped.

SEE ALSO

Search::Elasticsearch, Dancer2

AUTHOR

Fabrice Gabolde <fgabolde@weborama.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2018 by Weborama.

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