Module: Elasticsearch::Model

Extended by:
ClassMethods
Defined in:
lib/elasticsearch/model.rb,
lib/elasticsearch/model/proxy.rb,
lib/elasticsearch/model/client.rb,
lib/elasticsearch/model/naming.rb,
lib/elasticsearch/model/adapter.rb,
lib/elasticsearch/model/version.rb,
lib/elasticsearch/model/indexing.rb,
lib/elasticsearch/model/response.rb,
lib/elasticsearch/model/callbacks.rb,
lib/elasticsearch/model/importing.rb,
lib/elasticsearch/model/searching.rb,
lib/elasticsearch/model/multimodel.rb,
lib/elasticsearch/model/serializing.rb,
lib/elasticsearch/model/response/base.rb,
lib/elasticsearch/model/response/result.rb,
lib/elasticsearch/model/adapters/default.rb,
lib/elasticsearch/model/adapters/mongoid.rb,
lib/elasticsearch/model/response/records.rb,
lib/elasticsearch/model/response/results.rb,
lib/elasticsearch/model/adapters/multiple.rb,
lib/elasticsearch/model/response/pagination.rb,
lib/elasticsearch/model/adapters/active_record.rb

Overview

Elasticsearch integration for Ruby models

‘Elasticsearch::Model` contains modules for integrating the Elasticsearch search and analytical engine with ActiveModel-based classes, or models, for the Ruby programming language.

It facilitates importing your data into an index, automatically updating it when a record changes, searching the specific index, setting up the index mapping or the model JSON serialization.

When the ‘Elasticsearch::Model` module is included in your class, it automatically extends it with the functionality; see Model.included. Most methods are available via the `__elasticsearch__` class and instance method proxies.

It is possible to include/extend the model with the corresponding modules directly, if that is desired:

MyModel.__send__ :extend,  Elasticsearch::Model::Client::ClassMethods
MyModel.__send__ :include, Elasticsearch::Model::Client::InstanceMethods
MyModel.__send__ :extend,  Elasticsearch::Model::Searching::ClassMethods
# ...

Defined Under Namespace

Modules: Adapter, Callbacks, ClassMethods, Client, Importing, Indexing, Naming, Proxy, Response, Searching, Serializing Classes: Multimodel, NotImplemented, Registry

Constant Summary collapse

METHODS = 
[:search, :mapping, :mappings, :settings, :index_name, :document_type, :import]
VERSION = 
"0.1.8"

Class Method Summary collapse

Methods included from ClassMethods

client, client=, search

Class Method Details

.included(base) ⇒ Object

Adds the ‘Elasticsearch::Model` functionality to the including class.

  • Creates the ‘__elasticsearch__` class and instance methods, pointing to the proxy object

  • Includes the necessary modules in the proxy classes

  • Sets up delegation for crucial methods such as ‘search`, etc.

Examples:

Include the module in the ‘Article` model definition


class Article < ActiveRecord::Base
  include Elasticsearch::Model
end

Inject the module into the ‘Article` model during run time


Article.__send__ :include, Elasticsearch::Model


87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
 
# File 'lib/elasticsearch/model.rb', line 87

def self.included(base)
  base.class_eval do
    include Elasticsearch::Model::Proxy

    Elasticsearch::Model::Proxy::ClassMethodsProxy.class_eval do
      include Elasticsearch::Model::Client::ClassMethods
      include Elasticsearch::Model::Naming::ClassMethods
      include Elasticsearch::Model::Indexing::ClassMethods
      include Elasticsearch::Model::Searching::ClassMethods
    end

    Elasticsearch::Model::Proxy::InstanceMethodsProxy.class_eval do
      include Elasticsearch::Model::Client::InstanceMethods
      include Elasticsearch::Model::Naming::InstanceMethods
      include Elasticsearch::Model::Indexing::InstanceMethods
      include Elasticsearch::Model::Serializing::InstanceMethods
    end

    Elasticsearch::Model::Proxy::InstanceMethodsProxy.class_eval <<-CODE, __FILE__, __LINE__ + 1
      def as_indexed_json(options={})
        target.respond_to?(:as_indexed_json) ? target.__send__(:as_indexed_json, options) : super
      end
    CODE

    # Delegate important methods to the `__elasticsearch__` proxy, unless they are defined already
    #
    class << self
      METHODS.each do |method|
        delegate method, to: :__elasticsearch__ unless self.public_instance_methods.include?(method)
      end
    end

    # Mix the importing module into the proxy
    #
    self.__elasticsearch__.class_eval do
      include Elasticsearch::Model::Importing::ClassMethods
      include Adapter.from_class(base).importing_mixin
    end

    # Add to the registry if it's a class (and not in intermediate module)
    Registry.add(base) if base.is_a?(Class)
  end
end