aboutsummaryrefslogtreecommitdiffstats
path: root/activerecord/lib/active_record/persistence.rb
diff options
context:
space:
mode:
authorAnatoli Makarevich <makaroni4@gmail.com>2013-10-02 08:14:58 +0400
committerAnatoli Makarevich <makaroni4@gmail.com>2013-10-02 08:14:58 +0400
commit7f1e8759c301101f79327a7473fce4e66c4a2ecb (patch)
treee1d7e9ae128b1d134fb7e894a77d069c16d69e3d /activerecord/lib/active_record/persistence.rb
parent7dfbe58c70ec6acc9cee842fc8f18ec1ac57b66d (diff)
downloadrails-7f1e8759c301101f79327a7473fce4e66c4a2ecb.tar.gz
rails-7f1e8759c301101f79327a7473fce4e66c4a2ecb.tar.bz2
rails-7f1e8759c301101f79327a7473fce4e66c4a2ecb.zip
Update AR reload doc for the case of manually set primary key attribute [ci skip]
Diffstat (limited to 'activerecord/lib/active_record/persistence.rb')
-rw-r--r--activerecord/lib/active_record/persistence.rb13
1 files changed, 11 insertions, 2 deletions
diff --git a/activerecord/lib/active_record/persistence.rb b/activerecord/lib/active_record/persistence.rb
index bdd00ee259..21eabd69f2 100644
--- a/activerecord/lib/active_record/persistence.rb
+++ b/activerecord/lib/active_record/persistence.rb
@@ -335,8 +335,17 @@ module ActiveRecord
# 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