Permalink
Browse files

Update AR reload doc for the case of manually set primary key attribu…

…te [ci skip]
  • Loading branch information...
1 parent 7dfbe58 commit 7f1e8759c301101f79327a7473fce4e66c4a2ecb @makaroni4 makaroni4 committed Oct 2, 2013
Showing with 11 additions and 2 deletions.
  1. +11 −2 activerecord/lib/active_record/persistence.rb
@@ -335,8 +335,17 @@ def toggle!(attribute)
# Reloads the record from the database.
#
- # This method modifies the receiver in-place. Attributes are updated, and
- # caches busted, in particular the associations cache.
+ # This method finds record by its primary key (which could be assigned manually) and
+ # modifies the receiver in-place:
+ #
+ # account = Account.new
+ # # => #<Account id: nil, email: nil>
+ # account.id = 1
+ # account.reload
+ # # Account Load (1.2ms) SELECT "accounts".* FROM "accounts" WHERE "accounts"."id" = $1 LIMIT 1 [["id", 1]]
+ # # => #<Account id: 1, email: 'account@example.com'>
+ #
+ # Attributes are updated, and caches busted, in particular the associations cache.
#
# If the record no longer exists in the database <tt>ActiveRecord::RecordNotFound</tt>
# is raised. Otherwise, in addition to the in-place modification the method

0 comments on commit 7f1e875

Please sign in to comment.