Class: ActiveHash::Base
- Inherits:
-
Object
- Object
- ActiveHash::Base
- Extended by:
- ActiveModel::Naming
- Includes:
- ActiveModel::Conversion
- Defined in:
- lib/active_hash/base.rb
Direct Known Subclasses
Instance Attribute Summary collapse
-
#attributes ⇒ Object
readonly
Returns the value of attribute attributes.
Class Method Summary collapse
- .add_to_record_index(entry) ⇒ Object
- .all(options = {}) ⇒ Object
- .auto_assign_fields(array_of_hashes) ⇒ Object
-
.base_class ⇒ Object
Needed for ActiveRecord polymorphic associations.
- .compute_type(type_name) ⇒ Object
- .configuration_for_custom_finder(finder_name) ⇒ Object
- .count ⇒ Object
- .create(attributes = {}) ⇒ Object (also: add)
- .create!(attributes = {}) ⇒ Object
- .data ⇒ Object
- .data=(array_of_hashes) ⇒ Object
- .define_custom_find_all_method(field_name) ⇒ Object
- .define_custom_find_method(field_name) ⇒ Object
- .define_getter_method(field, default_value) ⇒ Object
- .define_interrogator_method(field) ⇒ Object
- .define_setter_method(field) ⇒ Object
- .delete_all ⇒ Object
- .exists?(record) ⇒ Boolean
- .field(field_name, options = {}) ⇒ Object
- .field_names ⇒ Object
- .fields(*args) ⇒ Object
- .find(id, *args) ⇒ Object
- .find_by_id(id) ⇒ Object
- .has_instance_method?(name) ⇒ Boolean
- .has_singleton_method?(name) ⇒ Boolean
- .insert(record) ⇒ Object
- .mark_clean ⇒ Object
- .mark_dirty ⇒ Object
- .method_missing(method_name, *args) ⇒ Object
- .next_id ⇒ Object
- .pluralize_table_names ⇒ Object
- .primary_key ⇒ Object
- .record_index ⇒ Object
- .reload ⇒ Object
- .reset_record_index ⇒ Object
- .respond_to?(method_name, include_private = false) ⇒ Boolean
- .the_meta_class ⇒ Object
- .transaction ⇒ Object
- .validate_field(field_name) ⇒ Object
- .validate_unique_id(record) ⇒ Object
- .where(options) ⇒ Object
Instance Method Summary collapse
- #[](key) ⇒ Object
- #[]=(key, val) ⇒ Object
- #cache_key ⇒ Object
- #destroyed? ⇒ Boolean
- #eql?(other) ⇒ Boolean (also: #==)
- #errors ⇒ Object
- #hash ⇒ Object
- #id ⇒ Object (also: #quoted_id)
- #id=(id) ⇒ Object
-
#initialize(attributes = {}) ⇒ Base
constructor
A new instance of Base.
- #marked_for_destruction? ⇒ Boolean
- #new_record? ⇒ Boolean
- #persisted? ⇒ Boolean
- #readonly? ⇒ Boolean
- #save(*args) ⇒ Object (also: #save!)
- #to_param ⇒ Object
- #valid? ⇒ Boolean
Constructor Details
#initialize(attributes = {}) ⇒ Base
Returns a new instance of Base.
376 377 378 379 380 381 382 |
# File 'lib/active_hash/base.rb', line 376 def initialize(attributes = {}) attributes.symbolize_keys! @attributes = attributes attributes.dup.each do |key, value| send "#{key}=", value end end |
Instance Attribute Details
#attributes ⇒ Object (readonly)
Returns the value of attribute attributes.
374 375 376 |
# File 'lib/active_hash/base.rb', line 374 def attributes @attributes end |
Class Method Details
.add_to_record_index(entry) ⇒ Object
107 108 109 |
# File 'lib/active_hash/base.rb', line 107 def add_to_record_index(entry) record_index.merge!(entry) end |
.all(options = {}) ⇒ Object
134 135 136 137 138 139 140 |
# File 'lib/active_hash/base.rb', line 134 def all(={}) if .has_key?(:conditions) where([:conditions]) else @records || [] end end |
.auto_assign_fields(array_of_hashes) ⇒ Object
319 320 321 322 323 324 325 326 327 328 329 330 331 |
# File 'lib/active_hash/base.rb', line 319 def auto_assign_fields(array_of_hashes) (array_of_hashes || []).inject([]) do |array, row| row.symbolize_keys! row.keys.each do |key| unless key.to_s == "id" array << key end end array end.uniq.each do |key| field key end end |
.base_class ⇒ Object
Needed for ActiveRecord polymorphic associations
336 337 338 |
# File 'lib/active_hash/base.rb', line 336 def base_class ActiveHash::Base end |
.compute_type(type_name) ⇒ Object
45 46 47 |
# File 'lib/active_hash/base.rb', line 45 def compute_type(type_name) self end |
.configuration_for_custom_finder(finder_name) ⇒ Object
243 244 245 246 247 248 249 250 251 |
# File 'lib/active_hash/base.rb', line 243 def configuration_for_custom_finder(finder_name) if finder_name.to_s.match(/^find_(all_)?by_(.*?)(!)?$/) && !($1 && $3) { :all? => !!$1, :bang? => !!$3, :fields => $2.split('_and_') } end end |
.count ⇒ Object
149 150 151 |
# File 'lib/active_hash/base.rb', line 149 def count all.length end |
.create(attributes = {}) ⇒ Object Also known as: add
119 120 121 122 123 124 |
# File 'lib/active_hash/base.rb', line 119 def create(attributes = {}) record = new(attributes) record.save mark_dirty record end |
.create!(attributes = {}) ⇒ Object
128 129 130 131 132 |
# File 'lib/active_hash/base.rb', line 128 def create!(attributes = {}) record = new(attributes) record.save! record end |
.data ⇒ Object
53 54 55 |
# File 'lib/active_hash/base.rb', line 53 def data _data end |
.data=(array_of_hashes) ⇒ Object
57 58 59 60 61 62 63 64 65 66 67 68 |
# File 'lib/active_hash/base.rb', line 57 def data=(array_of_hashes) mark_dirty @records = nil reset_record_index self._data = array_of_hashes if array_of_hashes auto_assign_fields(array_of_hashes) array_of_hashes.each do |hash| insert new(hash) end end end |
.define_custom_find_all_method(field_name) ⇒ Object
302 303 304 305 306 307 308 309 310 311 312 313 314 315 |
# File 'lib/active_hash/base.rb', line 302 def define_custom_find_all_method(field_name) method_name = :"find_all_by_#{field_name}" unless has_singleton_method?(method_name) .instance_eval do unless singleton_methods.include?(method_name) define_method(method_name) do |*args| = args. identifier = args[0] all.select { |record| record.send(field_name) == identifier } end end end end end |
.define_custom_find_method(field_name) ⇒ Object
287 288 289 290 291 292 293 294 295 296 297 298 |
# File 'lib/active_hash/base.rb', line 287 def define_custom_find_method(field_name) method_name = :"find_by_#{field_name}" unless has_singleton_method?(method_name) .instance_eval do define_method(method_name) do |*args| = args. identifier = args[0] all.detect { |record| record.send(field_name) == identifier } end end end end |
.define_getter_method(field, default_value) ⇒ Object
255 256 257 258 259 260 261 |
# File 'lib/active_hash/base.rb', line 255 def define_getter_method(field, default_value) unless has_instance_method?(field) define_method(field) do attributes[field].nil? ? default_value : attributes[field] end end end |
.define_interrogator_method(field) ⇒ Object
276 277 278 279 280 281 282 283 |
# File 'lib/active_hash/base.rb', line 276 def define_interrogator_method(field) method_name = :"#{field}?" unless has_instance_method?(method_name) define_method(method_name) do send(field).present? end end end |
.define_setter_method(field) ⇒ Object
265 266 267 268 269 270 271 272 |
# File 'lib/active_hash/base.rb', line 265 def define_setter_method(field) method_name = "#{field}=" unless has_instance_method?(method_name) define_method(method_name) do |new_val| attributes[field] = new_val end end end |
.delete_all ⇒ Object
160 161 162 163 164 |
# File 'lib/active_hash/base.rb', line 160 def delete_all mark_dirty reset_record_index @records = [] end |
.exists?(record) ⇒ Boolean
70 71 72 73 74 |
# File 'lib/active_hash/base.rb', line 70 def exists?(record) if record.id.present? record_index[record.id.to_s].present? end end |
.field(field_name, options = {}) ⇒ Object
195 196 197 198 199 200 201 202 203 204 |
# File 'lib/active_hash/base.rb', line 195 def field(field_name, = {}) validate_field(field_name) field_names << field_name define_getter_method(field_name, [:default]) define_setter_method(field_name) define_interrogator_method(field_name) define_custom_find_method(field_name) define_custom_find_all_method(field_name) end |
.field_names ⇒ Object
35 36 37 |
# File 'lib/active_hash/base.rb', line 35 def field_names @field_names ||= [] end |
.fields(*args) ⇒ Object
188 189 190 191 192 193 |
# File 'lib/active_hash/base.rb', line 188 def fields(*args) = args. args.each do |field| field(field, ) end end |
.find(id, *args) ⇒ Object
166 167 168 169 170 171 172 173 174 175 176 177 178 179 |
# File 'lib/active_hash/base.rb', line 166 def find(id, * args) case id when nil nil when :all all when Array id.map { |i| find(i) } else find_by_id(id) || begin raise RecordNotFound.new("Couldn't find #{name} with ID=#{id}") end end end |
.find_by_id(id) ⇒ Object
181 182 183 184 |
# File 'lib/active_hash/base.rb', line 181 def find_by_id(id) index = record_index[id.to_s] index and @records[index] end |
.has_instance_method?(name) ⇒ Boolean
360 361 362 |
# File 'lib/active_hash/base.rb', line 360 def has_instance_method?(name) instance_methods.map { |method| method.to_sym }.include?(name) end |
.has_singleton_method?(name) ⇒ Boolean
366 367 368 |
# File 'lib/active_hash/base.rb', line 366 def has_singleton_method?(name) singleton_methods.map { |method| method.to_sym }.include?(name) end |
.insert(record) ⇒ Object
76 77 78 79 80 81 82 83 84 |
# File 'lib/active_hash/base.rb', line 76 def insert(record) @records ||= [] record.attributes[:id] ||= next_id validate_unique_id(record) if dirty mark_dirty add_to_record_index({ record.id.to_s => @records.length }) @records << record end |
.mark_clean ⇒ Object
354 355 356 |
# File 'lib/active_hash/base.rb', line 354 def mark_clean self.dirty = false end |
.mark_dirty ⇒ Object
348 349 350 |
# File 'lib/active_hash/base.rb', line 348 def mark_dirty self.dirty = true end |
.method_missing(method_name, *args) ⇒ Object
224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 |
# File 'lib/active_hash/base.rb', line 224 def method_missing(method_name, *args) return super unless respond_to? method_name config = configuration_for_custom_finder(method_name) attribute_pairs = config[:fields].zip(args) matches = all.select { |base| attribute_pairs.all? { |field, value| base.send(field).to_s == value.to_s } } if config[:all?] matches else result = matches.first if config[:bang?] result || raise(RecordNotFound, "Couldn\'t find #{name} with #{attribute_pairs.collect { |pair| "#{pair[0]} = #{pair[1]}" }.join(', ')}") else result end end end |
.next_id ⇒ Object
86 87 88 89 90 91 92 93 |
# File 'lib/active_hash/base.rb', line 86 def next_id max_record = all.max { |a, b| a.id <=> b.id } if max_record.nil? 1 elsif max_record.id.is_a?(Numeric) max_record.id.succ end end |
.pluralize_table_names ⇒ Object
49 50 51 |
# File 'lib/active_hash/base.rb', line 49 def pluralize_table_names true end |
.primary_key ⇒ Object
31 32 33 |
# File 'lib/active_hash/base.rb', line 31 def primary_key "id" end |
.record_index ⇒ Object
95 96 97 |
# File 'lib/active_hash/base.rb', line 95 def record_index @record_index ||= {} end |
.reload ⇒ Object
340 341 342 343 344 |
# File 'lib/active_hash/base.rb', line 340 def reload reset_record_index self.data = _data mark_clean end |
.reset_record_index ⇒ Object
101 102 103 |
# File 'lib/active_hash/base.rb', line 101 def reset_record_index record_index.clear end |
.respond_to?(method_name, include_private = false) ⇒ Boolean
214 215 216 217 218 219 220 221 222 |
# File 'lib/active_hash/base.rb', line 214 def respond_to?(method_name, include_private=false) super || begin config = configuration_for_custom_finder(method_name) config && config[:fields].all? do |field| field_names.include?(field.to_sym) || field.to_sym == :id end end end |
.the_meta_class ⇒ Object
39 40 41 42 43 |
# File 'lib/active_hash/base.rb', line 39 def class << self self end end |
.transaction ⇒ Object
153 154 155 156 157 158 |
# File 'lib/active_hash/base.rb', line 153 def transaction yield rescue LocalJumpError => err raise err rescue ActiveRecord::Rollback end |
.validate_field(field_name) ⇒ Object
206 207 208 209 210 |
# File 'lib/active_hash/base.rb', line 206 def validate_field(field_name) if [:attributes].include?(field_name.to_sym) raise ReservedFieldError.new("#{field_name} is a reserved field in ActiveHash. Please use another name.") end end |
.validate_unique_id(record) ⇒ Object
113 114 115 |
# File 'lib/active_hash/base.rb', line 113 def validate_unique_id(record) raise IdError.new("Duplicate Id found for record #{record.attributes}") if record_index.has_key?(record.id.to_s) end |
.where(options) ⇒ Object
142 143 144 145 146 147 |
# File 'lib/active_hash/base.rb', line 142 def where() return @records if .nil? (@records || []).select do |record| .all? { |col, match| record[col] == match } end end |
Instance Method Details
#[](key) ⇒ Object
384 385 386 |
# File 'lib/active_hash/base.rb', line 384 def [](key) attributes[key] end |
#[]=(key, val) ⇒ Object
388 389 390 |
# File 'lib/active_hash/base.rb', line 388 def []=(key, val) attributes[key] = val end |
#cache_key ⇒ Object
428 429 430 431 432 433 434 435 436 437 |
# File 'lib/active_hash/base.rb', line 428 def cache_key case when new_record? "#{self.class.model_name.cache_key}/new" when = self[:updated_at] "#{self.class.model_name.cache_key}/#{id}-#{.to_s(:number)}" else "#{self.class.model_name.cache_key}/#{id}" end end |
#destroyed? ⇒ Boolean
406 407 408 |
# File 'lib/active_hash/base.rb', line 406 def destroyed? false end |
#eql?(other) ⇒ Boolean Also known as: ==
418 419 420 |
# File 'lib/active_hash/base.rb', line 418 def eql?(other) other.instance_of?(self.class) and not id.nil? and (id == other.id) end |
#errors ⇒ Object
439 440 441 442 443 444 445 446 447 448 449 450 451 |
# File 'lib/active_hash/base.rb', line 439 def errors obj = Object.new def obj.[](key) [] end def obj.() [] end obj end |
#hash ⇒ Object
424 425 426 |
# File 'lib/active_hash/base.rb', line 424 def hash id.hash end |
#id ⇒ Object Also known as: quoted_id
392 393 394 |
# File 'lib/active_hash/base.rb', line 392 def id attributes[:id] ? attributes[:id] : nil end |
#id=(id) ⇒ Object
396 397 398 |
# File 'lib/active_hash/base.rb', line 396 def id=(id) attributes[:id] = id end |
#marked_for_destruction? ⇒ Boolean
466 467 468 |
# File 'lib/active_hash/base.rb', line 466 def marked_for_destruction? false end |
#new_record? ⇒ Boolean
402 403 404 |
# File 'lib/active_hash/base.rb', line 402 def new_record? !self.class.all.include?(self) end |
#persisted? ⇒ Boolean
410 411 412 |
# File 'lib/active_hash/base.rb', line 410 def persisted? self.class.all.map(&:id).include?(id) end |
#readonly? ⇒ Boolean
414 415 416 |
# File 'lib/active_hash/base.rb', line 414 def readonly? true end |
#save(*args) ⇒ Object Also known as: save!
453 454 455 456 457 458 |
# File 'lib/active_hash/base.rb', line 453 def save(*args) unless self.class.exists?(self) self.class.insert(self) end true end |
#to_param ⇒ Object
24 25 26 |
# File 'lib/active_hash/base.rb', line 24 def to_param id.present? ? id.to_s : nil end |
#valid? ⇒ Boolean
462 463 464 |
# File 'lib/active_hash/base.rb', line 462 def valid? true end |