aboutsummaryrefslogtreecommitdiffstats
path: root/activerecord/lib/active_record/relation.rb
diff options
context:
space:
mode:
authorJon Leighton <j@jonathanleighton.com>2012-08-01 21:42:38 +0100
committerJon Leighton <j@jonathanleighton.com>2012-08-01 21:59:46 +0100
commit437851ea02983e7f039de1a09a69ee32f7681134 (patch)
treeec7e9b6941d39b515875f3dbd91232e004f15717 /activerecord/lib/active_record/relation.rb
parent4efebdedf8d8b8e2be711fafb560daddb15e48ad (diff)
downloadrails-437851ea02983e7f039de1a09a69ee32f7681134.tar.gz
rails-437851ea02983e7f039de1a09a69ee32f7681134.tar.bz2
rails-437851ea02983e7f039de1a09a69ee32f7681134.zip
Add `Relation#load`
This method explicitly loads the records and then returns `self`. Rather than deciding between "do I want an array or a relation?", most people are actually asking themselves "do I want to eager load or lazy load?" Therefore, this method provides a way to explicitly eager-load without having to switch from a `Relation` to an array. Example: @posts = Post.where(published: true).load
Diffstat (limited to 'activerecord/lib/active_record/relation.rb')
-rw-r--r--activerecord/lib/active_record/relation.rb14
1 files changed, 12 insertions, 2 deletions
diff --git a/activerecord/lib/active_record/relation.rb b/activerecord/lib/active_record/relation.rb
index 3821c6122a..a8170dc489 100644
--- a/activerecord/lib/active_record/relation.rb
+++ b/activerecord/lib/active_record/relation.rb
@@ -466,11 +466,21 @@ module ActiveRecord
where(primary_key => id_or_array).delete_all
end
+ # Causes the records to be loaded from the database if they have not
+ # been loaded already. You can use this if for some reason you need
+ # to explicitly load some records before actually using them. The
+ # return value is the relation itself, not the records.
+ #
+ # Post.where(published: true).load # => #<ActiveRecord::Relation>
+ def load
+ to_a # force reload
+ self
+ end
+
# Forces reloading of relation.
def reload
reset
- to_a # force reload
- self
+ load
end
def reset