Module: ActiveRecord::SpawnMethods

Included in:
Relation
Defined in:
activerecord/lib/active_record/relation/spawn_methods.rb

Constant Summary collapse

VALID_FIND_OPTIONS =
[ :conditions, :include, :joins, :limit, :offset, :extend,
:order, :select, :readonly, :group, :having, :from, :lock ]

Instance Method Summary collapse

Instance Method Details

#apply_finder_options(options) ⇒ Object


119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
# File 'activerecord/lib/active_record/relation/spawn_methods.rb', line 119

def apply_finder_options(options)
  relation = clone
  return relation unless options

  options.assert_valid_keys(VALID_FIND_OPTIONS)
  finders = options.dup
  finders.delete_if { |key, value| value.nil? && key != :limit }

  ([:joins, :select, :group, :order, :having, :limit, :offset, :from, :lock, :readonly] & finders.keys).each do |finder|
    relation = relation.send(finder, finders[finder])
  end

  relation = relation.where(finders[:conditions]) if options.has_key?(:conditions)
  relation = relation.includes(finders[:include]) if options.has_key?(:include)
  relation = relation.extending(finders[:extend]) if options.has_key?(:extend)

  relation
end

#except(*skips) ⇒ Object

Removes from the query the condition(s) specified in skips.

Example:

Post.order('id asc').except(:order)                  # discards the order condition
Post.where('id > 10').order('id asc').except(:where) # discards the where condition but keeps the order

73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
# File 'activerecord/lib/active_record/relation/spawn_methods.rb', line 73

def except(*skips)
  result = self.class.new(@klass, table)
  result.default_scoped = default_scoped

  ((Relation::ASSOCIATION_METHODS + Relation::MULTI_VALUE_METHODS) - skips).each do |method|
    result.send(:"#{method}_values=", send(:"#{method}_values"))
  end

  (Relation::SINGLE_VALUE_METHODS - skips).each do |method|
    result.send(:"#{method}_value=", send(:"#{method}_value"))
  end

  # Apply scope extension modules
  result.send(:apply_modules, extensions)

  result
end

#merge(r) ⇒ Object


5
6
7
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
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
# File 'activerecord/lib/active_record/relation/spawn_methods.rb', line 5

def merge(r)
  return self unless r
  return to_a & r if r.is_a?(Array)

  merged_relation = clone

  r = r.with_default_scope if r.default_scoped? && r.klass != klass

  Relation::ASSOCIATION_METHODS.each do |method|
    value = r.send(:"#{method}_values")

    unless value.empty?
      if method == :includes
        merged_relation = merged_relation.includes(value)
      else
        merged_relation.send(:"#{method}_values=", value)
      end
    end
  end

  (Relation::MULTI_VALUE_METHODS - [:joins, :where]).each do |method|
    value = r.send(:"#{method}_values")
    merged_relation.send(:"#{method}_values=", merged_relation.send(:"#{method}_values") + value) if value.present?
  end

  merged_relation.joins_values += r.joins_values

  merged_wheres = @where_values + r.where_values

  unless @where_values.empty?
    # Remove duplicates, last one wins.
    seen = Hash.new { |h,table| h[table] = {} }
    merged_wheres = merged_wheres.reverse.reject { |w|
      nuke = false
      if w.respond_to?(:operator) && w.operator == :==
        name              = w.left.name
        table             = w.left.relation.name
        nuke              = seen[table][name]
        seen[table][name] = true
      end
      nuke
    }.reverse
  end

  merged_relation.where_values = merged_wheres

  (Relation::SINGLE_VALUE_METHODS - [:lock, :create_with]).each do |method|
    value = r.send(:"#{method}_value")
    merged_relation.send(:"#{method}_value=", value) unless value.nil?
  end

  merged_relation.lock_value = r.lock_value unless merged_relation.lock_value

  merged_relation = merged_relation.create_with(r.create_with_value) unless r.create_with_value.empty?

  # Apply scope extension modules
  merged_relation.send :apply_modules, r.extensions

  merged_relation
end

#only(*onlies) ⇒ Object

Removes any condition from the query other than the one(s) specified in onlies.

Example:

Post.order('id asc').only(:where)         # discards the order condition
Post.order('id asc').only(:where, :order) # uses the specified order

98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
# File 'activerecord/lib/active_record/relation/spawn_methods.rb', line 98

def only(*onlies)
  result = self.class.new(@klass, table)
  result.default_scoped = default_scoped

  ((Relation::ASSOCIATION_METHODS + Relation::MULTI_VALUE_METHODS) & onlies).each do |method|
    result.send(:"#{method}_values=", send(:"#{method}_values"))
  end

  (Relation::SINGLE_VALUE_METHODS & onlies).each do |method|
    result.send(:"#{method}_value=", send(:"#{method}_value"))
  end

  # Apply scope extension modules
  result.send(:apply_modules, extensions)

  result
end