Class: ActiveHash::Base

Inherits:
Object
  • Object
show all
Extended by:
ActiveModel::Naming
Includes:
ActiveModel::Conversion
Defined in:
lib/active_hash/base.rb

Direct Known Subclasses

ActiveFile::Base

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

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

#attributesObject (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(options={})
  if options.has_key?(:conditions)
    where(options[: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_classObject

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

.countObject



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

.dataObject



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)
    the_meta_class.instance_eval do
      unless singleton_methods.include?(method_name)
        define_method(method_name) do |*args|
          options = args.extract_options!
          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)
    the_meta_class.instance_eval do
      define_method(method_name) do |*args|
        options = args.extract_options!
        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_allObject



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

Returns:

  • (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, options = {})
  validate_field(field_name)
  field_names << field_name

  define_getter_method(field_name, options[: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_namesObject



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)
  options = args.extract_options!
  args.each do |field|
    field(field, options)
  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

Returns:

  • (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

Returns:

  • (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_cleanObject



354
355
356
# File 'lib/active_hash/base.rb', line 354

def mark_clean
  self.dirty = false
end

.mark_dirtyObject



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_idObject



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_namesObject



49
50
51
# File 'lib/active_hash/base.rb', line 49

def pluralize_table_names
  true
end

.primary_keyObject



31
32
33
# File 'lib/active_hash/base.rb', line 31

def primary_key
  "id"
end

.record_indexObject



95
96
97
# File 'lib/active_hash/base.rb', line 95

def record_index
  @record_index ||= {}
end

.reloadObject



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_indexObject



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

Returns:

  • (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_classObject



39
40
41
42
43
# File 'lib/active_hash/base.rb', line 39

def the_meta_class
  class << self
    self
  end
end

.transactionObject



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

Raises:



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(options)
  return @records if options.nil?
  (@records || []).select do |record|
    options.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_keyObject



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 timestamp = self[:updated_at]
      "#{self.class.model_name.cache_key}/#{id}-#{timestamp.to_s(:number)}"
    else
      "#{self.class.model_name.cache_key}/#{id}"
  end
end

#destroyed?Boolean

Returns:

  • (Boolean)


406
407
408
# File 'lib/active_hash/base.rb', line 406

def destroyed?
  false
end

#eql?(other) ⇒ Boolean Also known as: ==

Returns:

  • (Boolean)


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

#errorsObject



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.full_messages()
    []
  end

  obj
end

#hashObject



424
425
426
# File 'lib/active_hash/base.rb', line 424

def hash
  id.hash
end

#idObject 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

Returns:

  • (Boolean)


466
467
468
# File 'lib/active_hash/base.rb', line 466

def marked_for_destruction?
  false
end

#new_record?Boolean

Returns:

  • (Boolean)


402
403
404
# File 'lib/active_hash/base.rb', line 402

def new_record?
  !self.class.all.include?(self)
end

#persisted?Boolean

Returns:

  • (Boolean)


410
411
412
# File 'lib/active_hash/base.rb', line 410

def persisted?
  self.class.all.map(&:id).include?(id)
end

#readonly?Boolean

Returns:

  • (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_paramObject



24
25
26
# File 'lib/active_hash/base.rb', line 24

def to_param
  id.present? ? id.to_s : nil
end

#valid?Boolean

Returns:

  • (Boolean)


462
463
464
# File 'lib/active_hash/base.rb', line 462

def valid?
  true
end