Class: Elasticsearch::DSL::Search::Queries::Bool

Inherits:
Object
  • Object
show all
Includes:
BaseComponent
Defined in:
lib/elasticsearch/dsl/search/queries/bool.rb

Overview

A compound query which matches documents based on combinations of queries

See the integration test for a working example.

Examples:

Defining a bool query with multiple conditions


search do
  query do
    bool do
      must do
        term category: 'men'
      end

      must do
        term size:  'xxl'
      end

      should do
        term color: 'red'
      end

      must_not do
        term manufacturer: 'evil'
      end
    end
  end
end

See Also:

Instance Method Summary collapse

Methods included from BaseComponent

included, #initialize

Instance Method Details

#filter(*args, &block) ⇒ Object



80
81
82
83
84
85
86
# File 'lib/elasticsearch/dsl/search/queries/bool.rb', line 80

def filter(*args, &block)
  @hash[name][:filter] ||= []
  if filter = block ? Filter.new(*args, &block) : args.first
    @hash[name][:filter] << filter.to_hash
  end
  self
end

#must(*args, &block) ⇒ Object



59
60
61
62
63
64
# File 'lib/elasticsearch/dsl/search/queries/bool.rb', line 59

def must(*args, &block)
  @hash[name][:must] ||= []
  value = args.empty? ? Query.new(*args, &block).to_hash : args.first.to_hash
  @hash[name][:must].push(value).flatten! unless @hash[name][:must].include?(value)
  self
end

#must_not(*args, &block) ⇒ Object



66
67
68
69
70
71
# File 'lib/elasticsearch/dsl/search/queries/bool.rb', line 66

def must_not(*args, &block)
  @hash[name][:must_not] ||= []
  value = args.empty? ? Query.new(*args, &block).to_hash : args.first.to_hash
  @hash[name][:must_not].push(value).flatten! unless @hash[name][:must_not].include?(value)
  self
end

#should(*args, &block) ⇒ Object



73
74
75
76
77
78
# File 'lib/elasticsearch/dsl/search/queries/bool.rb', line 73

def should(*args, &block)
  @hash[name][:should] ||= []
  value = args.empty? ? Query.new(*args, &block).to_hash : args.first.to_hash
  @hash[name][:should].push(value).flatten! unless @hash[name][:should].include?(value)
  self
end

#to_hashObject



88
89
90
91
92
93
94
95
96
97
# File 'lib/elasticsearch/dsl/search/queries/bool.rb', line 88

def to_hash
  @hash[name].update(@args.to_hash) if @args.respond_to?(:to_hash)

  if @block
    call
  else
    @hash[name] = @args unless @args.nil? || @args.empty?
  end
  @hash
end