Type:
Class

Association proxies in Active Record are middlemen between the object that holds the association, known as the @owner, and the actual associated object, known as the @target. The kind of association any proxy is about is available in @reflection. That's an instance of the class ActiveRecord::Reflection::AssociationReflection.

For example, given

1
2
3
4
5
class Blog < ActiveRecord::Base
  has_many :posts
end
 
blog = Blog.first

the association proxy in blog.posts has the object in blog as @owner, the collection of its posts as @target, and the @reflection object represents a :has_many macro.

This class delegates unknown methods to @target via method_missing.

The @target object is not loaded until needed. For example,

1
blog.posts.count

is computed directly through SQL and does not trigger by itself the instantiation of the actual post records.

scope
  • References/Ruby on Rails/Rails/Classes/ActiveRecord/ActiveRecord::Associations/ActiveRecord::Associations::CollectionProxy

scope() Instance Public methods Returns a Relation object for the

2025-01-10 15:47:30
append
  • References/Ruby on Rails/Rails/Classes/ActiveRecord/ActiveRecord::Associations/ActiveRecord::Associations::CollectionProxy

append(*records) Instance Public methods Alias for:

2025-01-10 15:47:30
find
  • References/Ruby on Rails/Rails/Classes/ActiveRecord/ActiveRecord::Associations/ActiveRecord::Associations::CollectionProxy

find(*args, &block) Instance Public methods Finds an object in the collection

2025-01-10 15:47:30
replace
  • References/Ruby on Rails/Rails/Classes/ActiveRecord/ActiveRecord::Associations/ActiveRecord::Associations::CollectionProxy

replace(other_array) Instance Public methods Replaces this collection with

2025-01-10 15:47:30
first
  • References/Ruby on Rails/Rails/Classes/ActiveRecord/ActiveRecord::Associations/ActiveRecord::Associations::CollectionProxy

first(*args) Instance Public methods Returns the first record, or the first

2025-01-10 15:47:30
new
  • References/Ruby on Rails/Rails/Classes/ActiveRecord/ActiveRecord::Associations/ActiveRecord::Associations::CollectionProxy

new(attributes = {}, &block) Instance Public methods Alias for:

2025-01-10 15:47:30
fourth
  • References/Ruby on Rails/Rails/Classes/ActiveRecord/ActiveRecord::Associations/ActiveRecord::Associations::CollectionProxy

fourth(*args) Instance Public methods Same as first except returns

2025-01-10 15:47:30
build
  • References/Ruby on Rails/Rails/Classes/ActiveRecord/ActiveRecord::Associations/ActiveRecord::Associations::CollectionProxy

build(attributes = {}, &block) Instance Public methods Returns a new object

2025-01-10 15:47:30
third
  • References/Ruby on Rails/Rails/Classes/ActiveRecord/ActiveRecord::Associations/ActiveRecord::Associations::CollectionProxy

third(*args) Instance Public methods Same as first except returns

2025-01-10 15:47:30
==
  • References/Ruby on Rails/Rails/Classes/ActiveRecord/ActiveRecord::Associations/ActiveRecord::Associations::CollectionProxy

==(other) Instance Public methods Equivalent to Array#==. Returns

2025-01-10 15:47:30