Class: ActiveRecord::DynamicFinderMatch

Inherits:
Object
  • Object
show all
Defined in:
activerecord/lib/active_record/dynamic_finder_match.rb

Overview

Active Record Dynamic Finder Match

Refer to ActiveRecord::Base documentation for Dynamic attribute-based finders for detailed info

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(finder, instantiator, bang, attribute_names) ⇒ DynamicFinderMatch


35
36
37
38
39
40
# File 'activerecord/lib/active_record/dynamic_finder_match.rb', line 35

def initialize(finder, instantiator, bang, attribute_names)
  @finder          = finder
  @instantiator    = instantiator
  @bang            = bang
  @attribute_names = attribute_names
end

Instance Attribute Details

#attribute_namesObject (readonly)

Returns the value of attribute attribute_names


42
43
44
# File 'activerecord/lib/active_record/dynamic_finder_match.rb', line 42

def attribute_names
  @attribute_names
end

#finderObject (readonly)

Returns the value of attribute finder


42
43
44
# File 'activerecord/lib/active_record/dynamic_finder_match.rb', line 42

def finder
  @finder
end

#instantiatorObject (readonly)

Returns the value of attribute instantiator


42
43
44
# File 'activerecord/lib/active_record/dynamic_finder_match.rb', line 42

def instantiator
  @instantiator
end

Class Method Details

.match(method) ⇒ Object


8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
# File 'activerecord/lib/active_record/dynamic_finder_match.rb', line 8

def self.match(method)
  finder       = :first
  bang         = false
  instantiator = nil

  case method.to_s
  when /^find_(all_|last_)?by_([_a-zA-Z]\w*)$/
    finder = :last if $1 == 'last_'
    finder = :all if $1 == 'all_'
    names = $2
  when /^find_by_([_a-zA-Z]\w*)\!$/
    bang = true
    names = $1
  when /^find_or_create_by_([_a-zA-Z]\w*)\!$/
    bang = true
    instantiator = :create
    names = $1
  when /^find_or_(initialize|create)_by_([_a-zA-Z]\w*)$/
    instantiator = $1 == 'initialize' ? :new : :create
    names = $2
  else
    return nil
  end

  new(finder, instantiator, bang, names.split('_and_'))
end

Instance Method Details

#bang?Boolean


56
57
58
# File 'activerecord/lib/active_record/dynamic_finder_match.rb', line 56

def bang?
  @bang
end

#creator?Boolean


52
53
54
# File 'activerecord/lib/active_record/dynamic_finder_match.rb', line 52

def creator?
  @finder == :first && @instantiator == :create
end

#finder?Boolean


44
45
46
# File 'activerecord/lib/active_record/dynamic_finder_match.rb', line 44

def finder?
  @finder && !@instantiator
end

#instantiator?Boolean


48
49
50
# File 'activerecord/lib/active_record/dynamic_finder_match.rb', line 48

def instantiator?
  @finder == :first && @instantiator
end

#save_methodObject


64
65
66
# File 'activerecord/lib/active_record/dynamic_finder_match.rb', line 64

def save_method
  bang? ? :save! : :save
end

#save_record?Boolean


60
61
62
# File 'activerecord/lib/active_record/dynamic_finder_match.rb', line 60

def save_record?
  @instantiator == :create
end