Update to Rails 5.1.4

Author: AndorChen

book.adoc

@@ -2,8 +2,8 @@
 :slug: railsguides
 :translator: 安道/chinakr
 :translator-email: [email protected]
-:revnumber: 5.1.3.p1
-:revdate: 2017-08-08T20:00:00+08:00
+:revnumber: 5.1.4.p1
+:revdate: 2017-12-28T20:00:00+08:00
 :lang: zh-CN
 :description: Rails 全方位解读。
 :keywords: rails, guide, guides, 指南
@@ -36,7 +36,7 @@
 :epub-cover-image: rails-guides-cover.jpg
 :cover-page-title: 封面
 :ebook-theme: rails_guides
-:rails-version: 5.1.3
+:rails-version: 5.1.4
 
 ifeval::["{ebook-format}" != "html"]
 include::manuscript/foreword.adoc[]

manuscript/association_basics.adoc

@@ -888,6 +888,7 @@ a.first_name == b.writer.first_name # => true
 * `build_association(attributes = {})`
 * `create_association(attributes = {})`
 * `create_association!(attributes = {})`
+* `reload_association`
 
 这五个方法中的 `association` 要替换成传给 `belongs_to` 方法的第一个参数。对下述声明来说：
 
@@ -907,6 +908,7 @@ author=
 build_author
 create_author
 create_author!
+reload_author
 ----
 
 [NOTE]
@@ -924,11 +926,11 @@ create_author!
 @author = @book.author
 ----
 
-如果关联的对象之前已经取回，会返回缓存版本。如果不想使用缓存版本（强制读取数据库）在父对象上调用 `+#reload+` 方法。
+如果关联的对象之前已经取回，会返回缓存版本。如果不想使用缓存版本（强制读取数据库）在父对象上调用 `+#reload_association+` 方法。
 
 [source,ruby]
 ----
-@author = @book.reload.author
+@author = @book.reload_author
 ----
 
 [[methods-added-by-belongs-to-association-associate]]
@@ -1065,13 +1067,10 @@ end
 [[options-for-belongs-to-dependent]]
 ====== `:dependent`
 
-`:dependent` 选项控制属主销毁后怎么处理关联的对象：
+`:dependent` 选项可以设为以下几个值：
 
-* `:destroy`：也销毁关联的对象
-* `:delete_all`：直接从数据库中删除关联的对象（不执行回调）
-* `:nullify`：把外键设为 `NULL`（不执行回调）
-* `:restrict_with_exception`：如果有关联的记录，抛出异常
-* `:restrict_with_error`：如果有关联的对象，为属主添加一个错误
+* `:destroy`：销毁对象时，在关联的对象上调用 `destroy` 方法
+* `:delete`：销毁对象时，关联的所有对象直接从数据库中删除，不在关联的对象上调用 `destroy` 方法
 
 [WARNING]
 ====
@@ -1283,6 +1282,7 @@ end
 * `build_association(attributes = {})`
 * `create_association(attributes = {})`
 * `create_association!(attributes = {})`
+* `reload_association`
 
 这五个方法中的 `association` 要替换成传给 `has_one` 方法的第一个参数。对如下的声明来说：
 
@@ -1302,6 +1302,7 @@ account=
 build_account
 create_account
 create_account!
+reload_account
 ----
 
 [NOTE]
@@ -1319,11 +1320,11 @@ create_account!
 @account = @supplier.account
 ----
 
-如果关联的对象之前已经取回，会返回缓存版本。如果不想使用缓存版本，而是强制重新从数据库中读取，在父对象上调用 `#reload` 方法。
+如果关联的对象之前已经取回，会返回缓存版本。如果不想使用缓存版本，而是强制重新从数据库中读取，在父对象上调用 `#reload_association` 方法。
 
 [source,ruby]
 ----
-@account = @supplier.reload.account
+@account = @supplier.reload_account
 ----
 
 [[methods-added-by-has-one-association-associate]]
@@ -1606,6 +1607,7 @@ end
 * `collection.build(attributes = {}, ...)`
 * `collection.create(attributes = {})`
 * `collection.create!(attributes = {})`
+* `collection.reload`
 
 这些个方法中的 `collection` 要替换成传给 `has_many` 方法的第一个参数。`collection_singular` 要替换成第一个参数的单数形式。对如下的声明来说：
 
@@ -1636,12 +1638,13 @@ books.exists?(...)
 books.build(attributes = {}, ...)
 books.create(attributes = {})
 books.create!(attributes = {})
+books.reload
 ----
 
 [[methods-added-by-has-many-collection]]
 ====== `collection`
 
-`collection` 方法返回一个数组，包含所有关联的对象。如果没有关联的对象，则返回空数组。
+`collection` 方法返回一个 `Relation` 对象，包含所有关联的对象。如果没有关联的对象，则返回一个空 `Relation` 对象。
 
 [source,ruby]
 ----
@@ -1795,10 +1798,20 @@ WARNING: 如果设为 `dependent: :destroy`，对象会被删除，这与 `depen
 ----
 
 [[methods-added-by-has-many-collection-create-bang-attributes]]
-##### `collection.create!(attributes = {})`
+====== `collection.create!(attributes = {})`
 
 作用与 `collection.create` 相同，但如果记录无效，会抛出 `ActiveRecord::RecordInvalid` 异常。
 
+[[methods-added-by-has-many-collection-reload]]
+====== `collection.reload`
+
+`collection.reload` 强制从数据库中读取，返回一个 `Relation` 对象，包含所有关联的对象。如果没有关联的对象，返回一个空 `Relation` 对象。
+
+[source,ruby]
+----
+@books = @author.books.reload
+----
+
 [[options-for-has-many]]
 ===== `has_many` 方法的选项
 
@@ -2182,6 +2195,7 @@ person.articles << article unless person.articles.include?(article)
 * `collection.build(attributes = {})`
 * `collection.create(attributes = {})`
 * `collection.create!(attributes = {})`
+* `collection.reload`
 
 这些个方法中的 `collection` 要替换成传给 `has_and_belongs_to_many` 方法的第一个参数。`collection_singular` 要替换成第一个参数的单数形式。对如下的声明来说：
 
@@ -2212,6 +2226,7 @@ assemblies.exists?(...)
 assemblies.build(attributes = {}, ...)
 assemblies.create(attributes = {})
 assemblies.create!(attributes = {})
+assemblies.reload
 ----
 
 [[additional-column-methods]]
@@ -2224,7 +2239,7 @@ WARNING: 在 `has_and_belongs_to_many` 关联的联结表中使用其他字段
 [[methods-added-by-has-and-belongs-to-many-collection]]
 ====== `collection`
 
-`collection` 方法返回一个数组，包含所有关联的对象。如果没有关联的对象，则返回空数组。
+`collection` 方法返回一个 `Relation` 对象，包含所有关联的对象。如果没有关联的对象，则返回一个空 `Relation` 对象。
 
 [source,ruby]
 ----
@@ -2360,6 +2375,16 @@ NOTE: 这个方法是 `collection.concat` 和 `collection.push` 的别名。
 
 作用和 `collection.create` 相同，但如果记录无效，会抛出 `ActiveRecord::RecordInvalid` 异常。
 
+[[methods-added-by-has-and-belongs-to-many-collection-reload]]
+====== `collection.reload`
+
+`collection.reload` 方法强制从数据库中读取，返回一个 `Relation` 对象，包含所有关联的对象。如果没有关联的对象，返回一个空 `Relation` 对象。
+
+[source,ruby]
+----
+@assemblies = @part.assemblies.reload
+----
+
 [[options-for-has-and-belongs-to-many]]
 ===== `has_and_belongs_to_many` 方法的选项