instance method `references`

Ruby on Rails 4.0.13

Since v4.0.13

Available in: v4.0.13 v4.1.16 v4.2.9 v5.2.8.1 v6.0.6 v6.1.7.10 v7.0.10 v7.1.6 v7.2.3 v8.0.4 v8.1.2

Compare with:

references(*args)

Used to indicate that an association is referenced by an SQL string, and should therefore be JOINed in any query rather than loaded separately.

User.includes(:posts).where("posts.name = 'foo'")
# => Doesn't JOIN the posts table, resulting in an error.

User.includes(:posts).where("posts.name = 'foo'").references(:posts)
# => Query now knows the string references posts, so adds a JOIN

Parameters

args rest

Source

# File activerecord/lib/active_record/relation/query_methods.rb, line 166
    def references(*args)
      check_if_method_has_arguments!("references", args)
      spawn.references!(*args)
    end

Defined in activerecord/lib/active_record/relation/query_methods.rb line 166 · View on GitHub · Improve this page · Find usages on GitHub

Defined in ActiveRecord::QueryMethods

Signature

Parameters