aboutsummaryrefslogtreecommitdiffstats
path: root/activerecord/lib/active_record/relation/query_methods.rb
diff options
context:
space:
mode:
authorMaurizio De Santis <desantis.maurizio@gmail.com>2013-02-07 23:01:19 +0100
committerMaurizio De Santis <desantis.maurizio@gmail.com>2013-02-07 23:01:19 +0100
commit7c663f507f5b4f1f443949c92dbc375d42dbd6b8 (patch)
tree715d5c40b75f338162cb7926de917cb3e1567a8f /activerecord/lib/active_record/relation/query_methods.rb
parentcf5e0f490cf9f9c82b322263dc768176edbdc27f (diff)
downloadrails-7c663f507f5b4f1f443949c92dbc375d42dbd6b8.tar.gz
rails-7c663f507f5b4f1f443949c92dbc375d42dbd6b8.tar.bz2
rails-7c663f507f5b4f1f443949c92dbc375d42dbd6b8.zip
Add example for ActiveRecord::Base.joins using a string as argument
Diffstat (limited to 'activerecord/lib/active_record/relation/query_methods.rb')
-rw-r--r--activerecord/lib/active_record/relation/query_methods.rb5
1 files changed, 5 insertions, 0 deletions
diff --git a/activerecord/lib/active_record/relation/query_methods.rb b/activerecord/lib/active_record/relation/query_methods.rb
index 4e4e58b319..63836bf375 100644
--- a/activerecord/lib/active_record/relation/query_methods.rb
+++ b/activerecord/lib/active_record/relation/query_methods.rb
@@ -305,6 +305,11 @@ module ActiveRecord
#
# User.joins(:posts)
# => SELECT "users".* FROM "users" INNER JOIN "posts" ON "posts"."user_id" = "users"."id"
+ #
+ # You can use strings in order to customize your joins:
+ #
+ # User.joins("LEFT JOIN bookmarks ON bookmarks.bookmarkable_type = 'Post' AND bookmarks.user_id = users.id")
+ # => SELECT "users".* FROM "users" LEFT JOIN bookmarks ON bookmarks.bookmarkable_type = 'Post' AND bookmarks.user_id = users.id
def joins(*args)
args.compact.blank? ? self : spawn.joins!(*args.flatten)
end