Class: ActiveRecord::AssociationRelation

Inherits:
Relation show all
Defined in:
activerecord/lib/active_record/association_relation.rb

Constant Summary

Constants inherited from Relation

Relation::CLAUSE_METHODS, Relation::INVALID_METHODS_FOR_DELETE_ALL, Relation::MULTI_VALUE_METHODS, Relation::SINGLE_VALUE_METHODS, Relation::VALUE_METHODS

Constants included from FinderMethods

FinderMethods::ONE_AS_ONE

Constants included from QueryMethods

QueryMethods::FROZEN_EMPTY_ARRAY, QueryMethods::FROZEN_EMPTY_HASH, QueryMethods::VALID_UNSCOPING_VALUES

Constants included from Batches

Batches::ORDER_IGNORE_MESSAGE

Instance Attribute Summary

Attributes inherited from Relation

#_deprecated_scope_source, #klass, #loaded, #predicate_builder, #skip_preloading_value, #table

Instance Method Summary collapse

Methods inherited from Relation

#_exec_scope, #alias_tracker, #any?, #arel_attribute, #bind_attribute, #blank?, #cache_key, #cache_version, #create_or_find_by, #create_or_find_by!, #delete_all, #delete_by, #destroy_all, #destroy_by, #eager_loading?, #empty?, #empty_scope?, #encode_with, #explain, #find_or_create_by, #find_or_create_by!, #find_or_initialize_by, #first_or_create, #first_or_create!, #first_or_initialize, #has_limit_or_offset?, #initialize_copy, #inspect, #joined_includes_values, #load, #many?, #none?, #one?, #preload_associations, #pretty_print, #records, #reload, #reset, #scope_for_create, #scoping, #size, #to_ary, #to_sql, #touch_all, #update, #update_all, #update_counters, #values, #where_values_hash

Methods included from FinderMethods

#exists?, #fifth, #fifth!, #find, #find_by, #find_by!, #first, #first!, #forty_two, #forty_two!, #fourth, #fourth!, #last, #last!, #raise_record_not_found_exception!, #second, #second!, #second_to_last, #second_to_last!, #take, #take!, #third, #third!, #third_to_last, #third_to_last!

Methods included from Calculations

#average, #calculate, #count, #ids, #maximum, #minimum, #pick, #pluck, #sum

Methods included from SpawnMethods

#except, #merge, #merge!, #only, #spawn

Methods included from QueryMethods

#_select!, #annotate, #annotate!, #arel, #construct_join_dependency, #create_with, #create_with!, #distinct, #distinct!, #eager_load, #eager_load!, #extending, #extending!, #extract_associated, #from, #from!, #group, #group!, #having, #having!, #includes, #includes!, #joins, #joins!, #left_outer_joins, #left_outer_joins!, #limit, #limit!, #lock, #lock!, #none, #none!, #offset, #offset!, #optimizer_hints, #optimizer_hints!, #or, #or!, #order, #order!, #preload, #preload!, #readonly, #readonly!, #references, #references!, #reorder, #reorder!, #reselect, #reselect!, #reverse_order, #reverse_order!, #rewhere, #select, #skip_preloading!, #skip_query_cache!, #unscope, #unscope!, #where, #where!

Methods included from ActiveSupport::Concern

#append_features, #class_methods, extended, #included

Methods included from Batches

#find_each, #find_in_batches, #in_batches

Methods included from Explain

#collecting_queries_for_explain, #exec_explain

Methods included from Enumerable

#as_json, #compact_blank, #exclude?, #excluding, #including, #index_by, #index_with, #many?, #pluck, #sum, #without

Constructor Details

#initialize(klass, association) ⇒ AssociationRelation

Returns a new instance of AssociationRelation.



5
6
7
8
 
# File 'activerecord/lib/active_record/association_relation.rb', line 5

def initialize(klass, association, **)
  super(klass)
  @association = association
end

Instance Method Details

#==(other) ⇒ Object 



14
15
16
 
# File 'activerecord/lib/active_record/association_relation.rb', line 14

def ==(other)
  other == records
end

#build(attributes = nil, &block) ⇒ Object Also known as: new 



18
19
20
21
22
23
 
# File 'activerecord/lib/active_record/association_relation.rb', line 18

def build(attributes = nil, &block)
  block = _deprecated_scope_block("new", &block)
  @association.scoping(self) do
    @association.build(attributes, &block)
  end
end

#create(attributes = nil, &block) ⇒ Object 



26
27
28
29
30
31
 
# File 'activerecord/lib/active_record/association_relation.rb', line 26

def create(attributes = nil, &block)
  block = _deprecated_scope_block("create", &block)
  @association.scoping(self) do
    @association.create(attributes, &block)
  end
end

#create!(attributes = nil, &block) ⇒ Object 



33
34
35
36
37
38
 
# File 'activerecord/lib/active_record/association_relation.rb', line 33

def create!(attributes = nil, &block)
  block = _deprecated_scope_block("create!", &block)
  @association.scoping(self) do
    @association.create!(attributes, &block)
  end
end

#proxy_association ⇒ Object 



10
11
12
 
# File 'activerecord/lib/active_record/association_relation.rb', line 10

def proxy_association
  @association
end