Class: Searchkick::Results
- Inherits:
-
Object
- Object
- Searchkick::Results
- Extended by:
- Forwardable
- Includes:
- Enumerable
- Defined in:
- lib/searchkick/results.rb
Instance Attribute Summary collapse
-
#klass ⇒ Object
readonly
Returns the value of attribute klass.
-
#options ⇒ Object
readonly
Returns the value of attribute options.
-
#response ⇒ Object
readonly
Returns the value of attribute response.
Instance Method Summary collapse
- #aggregations ⇒ Object
- #aggs ⇒ Object
- #clear_scroll ⇒ Object
- #current_page ⇒ Object
- #entry_name(options = {}) ⇒ Object
- #error ⇒ Object
- #first_page? ⇒ Boolean
- #highlights(multiple: false) ⇒ Object
- #hits ⇒ Object
-
#initialize(klass, response, options = {}) ⇒ Results
constructor
A new instance of Results.
- #last_page? ⇒ Boolean
- #misspellings? ⇒ Boolean
- #model_name ⇒ Object
- #next_page ⇒ Object
- #offset_value ⇒ Object (also: #offset)
- #out_of_range? ⇒ Boolean
- #padding ⇒ Object
- #per_page ⇒ Object (also: #limit_value)
- #previous_page ⇒ Object (also: #prev_page)
- #results ⇒ Object
- #scroll ⇒ Object
- #scroll_id ⇒ Object
- #suggestions ⇒ Object
- #took ⇒ Object
- #total_count ⇒ Object (also: #total_entries)
- #total_pages ⇒ Object (also: #num_pages)
- #with_highlights(multiple: false) ⇒ Object
- #with_hit ⇒ Object
Constructor Details
#initialize(klass, response, options = {}) ⇒ Results
Returns a new instance of Results.
12 13 14 15 16 |
# File 'lib/searchkick/results.rb', line 12 def initialize(klass, response, = {}) @klass = klass @response = response @options = end |
Instance Attribute Details
#klass ⇒ Object (readonly)
Returns the value of attribute klass.
8 9 10 |
# File 'lib/searchkick/results.rb', line 8 def klass @klass end |
#options ⇒ Object (readonly)
Returns the value of attribute options.
8 9 10 |
# File 'lib/searchkick/results.rb', line 8 def @options end |
#response ⇒ Object (readonly)
Returns the value of attribute response.
8 9 10 |
# File 'lib/searchkick/results.rb', line 8 def response @response end |
Instance Method Details
#aggregations ⇒ Object
104 105 106 |
# File 'lib/searchkick/results.rb', line 104 def aggregations response["aggregations"] end |
#aggs ⇒ Object
108 109 110 111 112 113 114 115 116 117 118 119 120 121 |
# File 'lib/searchkick/results.rb', line 108 def aggs @aggs ||= begin if aggregations aggregations.dup.each do |field, filtered_agg| buckets = filtered_agg[field] # move the buckets one level above into the field hash if buckets filtered_agg.delete(field) filtered_agg.merge!(buckets) end end end end end |
#clear_scroll ⇒ Object
258 259 260 261 262 263 264 265 266 267 |
# File 'lib/searchkick/results.rb', line 258 def clear_scroll begin # try to clear scroll # not required as scroll will expire # but there is a cost to open scrolls Searchkick.client.clear_scroll(scroll_id: scroll_id) rescue Elasticsearch::Transport::Transport::Error # do nothing end end |
#current_page ⇒ Object
156 157 158 |
# File 'lib/searchkick/results.rb', line 156 def current_page [:page] end |
#entry_name(options = {}) ⇒ Object
135 136 137 138 139 140 141 142 143 |
# File 'lib/searchkick/results.rb', line 135 def entry_name( = {}) if .empty? # backward compatibility model_name.human.downcase else default = [:count] == 1 ? model_name.human : model_name.human.pluralize model_name.human(.reverse_merge(default: default)) end end |
#error ⇒ Object
127 128 129 |
# File 'lib/searchkick/results.rb', line 127 def error response["error"] end |
#first_page? ⇒ Boolean
188 189 190 |
# File 'lib/searchkick/results.rb', line 188 def first_page? previous_page.nil? end |
#highlights(multiple: false) ⇒ Object
208 209 210 211 212 |
# File 'lib/searchkick/results.rb', line 208 def highlights(multiple: false) hits.map do |hit| hit_highlights(hit, multiple: multiple) end end |
#hits ⇒ Object
200 201 202 203 204 205 206 |
# File 'lib/searchkick/results.rb', line 200 def hits if error raise Searchkick::Error, "Query error - use the error method to view it" else @response["hits"]["hits"] end end |
#last_page? ⇒ Boolean
192 193 194 |
# File 'lib/searchkick/results.rb', line 192 def last_page? next_page.nil? end |
#misspellings? ⇒ Boolean
220 221 222 |
# File 'lib/searchkick/results.rb', line 220 def misspellings? @options[:misspellings] end |
#model_name ⇒ Object
131 132 133 |
# File 'lib/searchkick/results.rb', line 131 def model_name klass.model_name end |
#next_page ⇒ Object
184 185 186 |
# File 'lib/searchkick/results.rb', line 184 def next_page current_page < total_pages ? (current_page + 1) : nil end |
#offset_value ⇒ Object Also known as: offset
174 175 176 |
# File 'lib/searchkick/results.rb', line 174 def offset_value (current_page - 1) * per_page + padding end |
#out_of_range? ⇒ Boolean
196 197 198 |
# File 'lib/searchkick/results.rb', line 196 def out_of_range? current_page > total_pages end |
#padding ⇒ Object
165 166 167 |
# File 'lib/searchkick/results.rb', line 165 def padding [:padding] end |
#per_page ⇒ Object Also known as: limit_value
160 161 162 |
# File 'lib/searchkick/results.rb', line 160 def per_page [:per_page] end |
#previous_page ⇒ Object Also known as: prev_page
179 180 181 |
# File 'lib/searchkick/results.rb', line 179 def previous_page current_page > 1 ? (current_page - 1) : nil end |
#results ⇒ Object
18 19 20 |
# File 'lib/searchkick/results.rb', line 18 def results @results ||= with_hit.map(&:first) end |
#scroll ⇒ Object
228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 |
# File 'lib/searchkick/results.rb', line 228 def scroll raise Searchkick::Error, "Pass `scroll` option to the search method for scrolling" unless scroll_id if block_given? records = self while records.any? yield records records = records.scroll end records.clear_scroll else params = { scroll: [:scroll], scroll_id: scroll_id } begin # TODO Active Support notifications for this scroll call Searchkick::Results.new(@klass, Searchkick.client.scroll(params), @options) rescue Elasticsearch::Transport::Transport::Errors::NotFound => e if e.class.to_s =~ /NotFound/ && e. =~ /search_context_missing_exception/i raise Searchkick::Error, "Scroll id has expired" else raise e end end end end |
#scroll_id ⇒ Object
224 225 226 |
# File 'lib/searchkick/results.rb', line 224 def scroll_id @response["_scroll_id"] end |
#suggestions ⇒ Object
94 95 96 97 98 99 100 101 102 |
# File 'lib/searchkick/results.rb', line 94 def suggestions if response["suggest"] response["suggest"].values.flat_map { |v| v.first["options"] }.sort_by { |o| -o["score"] }.map { |o| o["text"] }.uniq elsif [:suggest] || [:term] == "*" # TODO remove 2nd term [] else raise "Pass `suggest: true` to the search method for suggestions" end end |
#took ⇒ Object
123 124 125 |
# File 'lib/searchkick/results.rb', line 123 def took response["took"] end |
#total_count ⇒ Object Also known as: total_entries
145 146 147 148 149 150 151 152 153 |
# File 'lib/searchkick/results.rb', line 145 def total_count if [:total_entries] [:total_entries] elsif response["hits"]["total"].is_a?(Hash) response["hits"]["total"]["value"] else response["hits"]["total"] end end |
#total_pages ⇒ Object Also known as: num_pages
169 170 171 |
# File 'lib/searchkick/results.rb', line 169 def total_pages (total_count / per_page.to_f).ceil end |
#with_highlights(multiple: false) ⇒ Object
214 215 216 217 218 |
# File 'lib/searchkick/results.rb', line 214 def with_highlights(multiple: false) with_hit.map do |result, hit| [result, hit_highlights(hit, multiple: multiple)] end end |
#with_hit ⇒ Object
22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 |
# File 'lib/searchkick/results.rb', line 22 def with_hit @with_hit ||= begin if [:load] # results can have different types results = {} hits.group_by { |hit, _| hit["_index"] }.each do |index, grouped_hits| klasses = if @klass [@klass] else index_alias = index.split("_")[0..-2].join("_") Array(([:index_mapping] || {})[index_alias]) end raise Searchkick::Error, "Unknown model for index: #{index}" unless klasses.any? results[index] = {} klasses.each do |klass| results[index].merge!(results_query(klass, grouped_hits).to_a.index_by { |r| r.id.to_s }) end end missing_ids = [] # sort results = hits.map do |hit| result = results[hit["_index"]][hit["_id"].to_s] if result && !([:load].is_a?(Hash) && [:load][:dumpable]) if (hit["highlight"] || [:highlight]) && !result.respond_to?(:search_highlights) highlights = hit_highlights(hit) result.define_singleton_method(:search_highlights) do highlights end end end [result, hit] end.select do |result, hit| missing_ids << hit["_id"] unless result result end if missing_ids.any? warn "[searchkick] WARNING: Records in search index do not exist in database: #{missing_ids.join(", ")}" end results else hits.map do |hit| result = if hit["_source"] hit.except("_source").merge(hit["_source"]) elsif hit["fields"] hit.except("fields").merge(hit["fields"]) else hit end if hit["highlight"] || [:highlight] highlight = Hash[hit["highlight"].to_a.map { |k, v| [base_field(k), v.first] }] [:highlighted_fields].map { |k| base_field(k) }.each do |k| result["highlighted_#{k}"] ||= (highlight[k] || result[k]) end end result["id"] ||= result["_id"] # needed for legacy reasons [HashWrapper.new(result), hit] end end end end |