Ruby on Rails 4.2 發布記 · Ruby on Rails 指南

# Ruby on Rails 4.2 發布記 Rails 4.2 精華摘要： * Active Job * 異步郵件 * Adequate Record * Web 終端 * 外鍵支持本篇僅記錄主要的變化。要了解關于已修復的 Bug、特性變更等，請參考 [Rails GitHub 主頁](https://github.com/rails/rails)上各個 Gem 的 CHANGELOG 或是 [Rails 的提交歷史](https://github.com/rails/rails/commits/master)。 ### Chapters 1. [升級至 Rails 4.2](#%E5%8D%87%E7%BA%A7%E8%87%B3-rails-4.2) 2. [重要新特性](#%E9%87%8D%E8%A6%81%E6%96%B0%E7%89%B9%E6%80%A7) * [Active Job](#active-job) * [異步郵件](#%E5%BC%82%E6%AD%A5%E9%82%AE%E4%BB%B6) * [Adequate Record](#adequate-record) * [Web 終端](#web-%E7%BB%88%E7%AB%AF) * [外鍵支持](#%E5%A4%96%E9%94%AE%E6%94%AF%E6%8C%81) 3. [Rails 4.2 向下不兼容的部份](#rails-4.2-%E5%90%91%E4%B8%8B%E4%B8%8D%E5%85%BC%E5%AE%B9%E7%9A%84%E9%83%A8%E4%BB%BD) * [`render` 字串參數](#render-%E5%AD%97%E4%B8%B2%E5%8F%82%E6%95%B0) * [`respond_with` / class-level `respond_to`](#respond_with-/-class-level-respond_to) * [`rails server` 的缺省主機（host）變更](#rails-server-%E7%9A%84%E7%BC%BA%E7%9C%81%E4%B8%BB%E6%9C%BA%EF%BC%88host%EF%BC%89%E5%8F%98%E6%9B%B4) * [HTML Sanitizer](#html-sanitizer) * [`assert_select`](#assert_select) 4. [Railties](#railties) * [移除](#railties-%E7%A7%BB%E9%99%A4) * [棄用](#railties-%E5%BC%83%E7%94%A8) * [值得一提的變化](#railties-%E5%80%BC%E5%BE%97%E4%B8%80%E6%8F%90%E7%9A%84%E5%8F%98%E5%8C%96) 5. [Action Pack](#action-pack) * [移除](#action-pack-%E7%A7%BB%E9%99%A4) * [棄用](#action-pack-%E5%BC%83%E7%94%A8) * [值得一提的變化](#action-pack-%E5%80%BC%E5%BE%97%E4%B8%80%E6%8F%90%E7%9A%84%E5%8F%98%E5%8C%96) 6. [Action View](#action-view) * [棄用](#action-view-%E5%BC%83%E7%94%A8) * [值得一提的變化](#action-view-%E5%80%BC%E5%BE%97%E4%B8%80%E6%8F%90%E7%9A%84%E5%8F%98%E5%8C%96) 7. [Action Mailer](#action-mailer) * [棄用](#action-mailer-%E5%BC%83%E7%94%A8) * [值得一提的變化](#action-mailer-%E5%80%BC%E5%BE%97%E4%B8%80%E6%8F%90%E7%9A%84%E5%8F%98%E5%8C%96) 8. [Active Record](#active-record) * [移除](#active-record-%E7%A7%BB%E9%99%A4) * [棄用](#active-record-%E5%BC%83%E7%94%A8) * [值得一提的變化](#active-record-%E5%80%BC%E5%BE%97%E4%B8%80%E6%8F%90%E7%9A%84%E5%8F%98%E5%8C%96) 9. [Active Model](#active-model) * [移除](#active-model-%E7%A7%BB%E9%99%A4) * [棄用](#active-model-%E5%BC%83%E7%94%A8) * [值得一提的變化](#active-model-%E5%80%BC%E5%BE%97%E4%B8%80%E6%8F%90%E7%9A%84%E5%8F%98%E5%8C%96) 10. [Active Support](#active-support) * [移除](#%E7%A7%BB%E9%99%A4) * [棄用](#%E5%BC%83%E7%94%A8) * [值得一提的變化](#%E5%80%BC%E5%BE%97%E4%B8%80%E6%8F%90%E7%9A%84%E5%8F%98%E5%8C%96) 11. [致謝](#%E8%87%B4%E8%B0%A2) ### 1 升級至 Rails 4.2 如果您正試著升級現有的應用，應用最好要有足夠的測試。第一步先升級至 4.1，確保應用仍正常工作，接著再升上 4.2。升級需要注意的事項在 [Ruby on Rails 升級指南](upgrading_ruby_on_rails.html#upgrading-from-rails-4-1-to-rails-4-2)可以找到。 ### 2 重要新特性 #### 2.1 Active Job Active Job 是 Rails 4.2 新搭載的框架。是隊列系統（Queuing systems）的統一接口，用來連接像是 [Resque](https://github.com/resque/resque)、[Delayed Job](https://github.com/collectiveidea/delayed_job)、[Sidekiq](https://github.com/mperham/sidekiq) 等隊列系統。采用 Active Job API 撰寫的任務程序（Background jobs），便可在任何支持的隊列系統上運行而無需對代碼進行任何修改。Active Job 缺省會即時執行任務。任務通常需要傳入 Active Record 對象作為參數。Active Job 將傳入的對象作為 URI（統一資源標識符），而不是直接對對象進行 marshal。新增的 GlobalID 函式庫，給對象生成統一資源標識符，并使用該標識符來查找對象。現在因為內部使用了 Global ID，任務只要傳入 Active Record 對象即可。譬如，`trashable` 是一個 Active Record 對象，則下面這個任務無需做任何序列化，便可正常完成任務： ``` class TrashableCleanupJob < ActiveJob::Base def perform(trashable, depth) trashable.cleanup(depth) end end ``` 參考 [Active Job 基礎](active_job_basics.html)指南來進一步了解。 #### 2.2 異步郵件構造于 Active Job 之上，Action Mailer 新增了 `#deliver_later` 方法，通過隊列來發送郵件，若開啟了隊列的異步特性，便不會拖慢控制器或模型的運行（缺省隊列是即時執行任務）。想直接發送信件仍可以使用 `deliver_now`。 #### 2.3 Adequate Record Adequate Record 是對 Active Record `find` 和 `find_by` 方法以及其它的關聯查詢方法所進行的一系列重構，查詢速度最高提升到了兩倍之多。工作原理是在執行 Active Record 調用時，把 SQL 查詢語句緩存起來。有了查詢語句的緩存之后，同樣的 SQL 查詢就無需再次把調用轉換成 SQL 語句。更多細節請參考 [Aaron Patterson 的博文](http://tenderlovemaking.com/2014/02/19/adequaterecord-pro-like-activerecord.html)。 Adequate Record 已經合并到 Rails 里，所以不需要特別啟用這個特性。多數的 `find` 和 `find_by` 調用和關聯查詢會自動使用 Adequate Record，比如： ``` Post.find(1) # First call generates and cache the prepared statement Post.find(2) # Subsequent calls reuse the cached prepared statement Post.find_by_title('first post') Post.find_by_title('second post') post.comments post.comments(true) ``` 有一點特別要說明的是，如上例所示，緩存的語句不會緩存傳入的數值，只是緩存語句的模版而已。下列場景則不會使用緩存： * 當 model 有缺省作用域時 * 當 model 使用了單表繼承時 * 當 `find` 查詢一組 ID 時： ``` # not cached Post.find(1, 2, 3) Post.find([1,2]) ``` * 以 SQL 片段執行 `find_by`： ``` Post.find_by('published_at < ?', 2.weeks.ago) ``` #### 2.4 Web 終端用 Rails 4.2 新產生的應用程序，缺省搭載了 [Web 終端](https://github.com/rails/web-console)。Web 終端給錯誤頁面添加了一個互動式 Ruby 終端，并提供視圖幫助方法 `console`，以及一些控制器幫助方法。錯誤頁面的互動式的終端，讓你可以在異常發生的地方執行代碼。插入 `console` 視圖幫助方法到任何頁面，便可以在頁面的上下文里，在頁面渲染結束后啟動一個互動式的終端。最后，可以執行 `rails console` 來啟動一個 VT100 終端。若需要建立或修改測試資料，可以直接從瀏覽器里執行。 #### 2.5 外鍵支持遷移 DSL 現在支持新增、移除外鍵，外鍵也會導出到 `schema.rb`。目前只有 `mysql`、`mysql2` 以及 `postgresql` 的適配器支持外鍵。 ``` # add a foreign key to `articles.author_id` referencing `authors.id` add_foreign_key :articles, :authors # add a foreign key to `articles.author_id` referencing `users.lng_id` add_foreign_key :articles, :users, column: :author_id, primary_key: "lng_id" # remove the foreign key on `accounts.branch_id` remove_foreign_key :accounts, :branches # remove the foreign key on `accounts.owner_id` remove_foreign_key :accounts, column: :owner_id ``` 完整說明請參考 API 文檔：[add_foreign_key](http://api.rubyonrails.org/v4.2.0/classes/ActiveRecord/ConnectionAdapters/SchemaStatements.html#method-i-add_foreign_key) 和 [remove_foreign_key](http://api.rubyonrails.org/v4.2.0/classes/ActiveRecord/ConnectionAdapters/SchemaStatements.html#method-i-remove_foreign_key)。 ### 3 Rails 4.2 向下不兼容的部份前版棄用的特性已全數移除。請參考文后下列各 Rails 部件來了解 Rails 4.2 新棄用的特性有那些。以下是升級至 Rails 4.2 所需要立即采取的行動。 #### 3.1 `render` 字串參數 4.2 以前在 Controller action 調用 `render "foo/bar"` 時，效果等同于：`render file: "foo/bar"`；Rails 4.2 則改為 `render template: "foo/bar"`。如需 `render` 文件，請將代碼改為 `render file: "foo/bar"`。 #### 3.2 `respond_with` / class-level `respond_to` `respond_with` 以及對應的**類別層級** `respond_to` 被移到了 `responders` gem。要使用這個特性，把 `gem 'responders', '~> 2.0'` 加入到 Gemfile： ``` # app/controllers/users_controller.rb class UsersController < ApplicationController respond_to :html, :json def show @user = User.find(params[:id]) respond_with @user end end ``` 而實例層級的 `respond_to` 則不受影響： ``` # app/controllers/users_controller.rb class UsersController < ApplicationController def show @user = User.find(params[:id]) respond_to do |format| format.html format.json { render json: @user } end end end ``` #### 3.3 `rails server` 的缺省主機（host）變更由于 [Rack 的一項修正](https://github.com/rack/rack/commit/28b014484a8ac0bbb388e7eaeeef159598ec64fc)，`rails server` 現在缺省會監聽 `localhost` 而不是 `0.0.0.0`。[http://127.0.0.1:3000](http://127.0.0.1:3000) 和 [http://localhost:3000](http://localhost:3000) 仍可以像先前一般使用。但這項變更禁止了從其它機器訪問 Rails 服務器（譬如開發環境位于虛擬環境里，而想要從宿主機器上訪問），則需要用 `rails server -b 0.0.0.0` 來啟動，才能像先前一樣使用。若是使用了 `0.0.0.0`，記得要把防火墻設置好，改成只有信任的機器才可以存取你的開發服務器。 #### 3.4 HTML Sanitizer HTML sanitizer 換成一個新的、更加安全的實現，基于 Loofah 和 Nokogiri。新的 Sanitizer 更安全，而 sanitization 更加強大與靈活。有了新的 sanitization 算法之后，某些 pathological 輸入的輸出會和之前不太一樣。若真的需要使用舊的 sanitizer，可以把 `rails-deprecated_sanitizer` 加到 Gemfile，便會用舊的 sanitizer 取代掉新的。而因為這是自己選擇性加入的 gem，所以并不會拋出棄用警告。 Rails 4.2 仍會維護 `rails-deprecated_sanitizer`，但 Rails 5.0 之后便不會再進行維護。參考[這篇文章](http://blog.plataformatec.com.br/2014/07/the-new-html-sanitizer-in-rails-4-2/)來了解更多關于新的 sanitizer 的變更內容細節。 #### 3.5 `assert_select` `assert_select` 測試方法現在用 Nokogiri 改寫了。不再支援某些先前可用的選擇器。若應用程式使用了以下的選擇器，則會需要進行更新： * 屬性選擇器的數值需要用雙引號包起來。 ``` a[href=/] => a[href="/"] a[href$=/] => a[href$="/"] ``` * 含有錯誤嵌套的 HTML 所建出來的 DOM 可能會不一樣譬如： ``` # content: <div><i><p></i></div> # before: assert_select('div > i') # => true assert_select('div > p') # => false assert_select('i > p') # => true # now: assert_select('div > i') # => true assert_select('div > p') # => true assert_select('i > p') # => false ``` * 之前要比較含有 HTML entities 的元素要寫未經轉譯的 HTML，現在寫轉譯后的即可 ``` # content: <p>AT&T</p> # before: assert_select('p', 'AT&T') # => true assert_select('p', 'AT&T') # => false # now: assert_select('p', 'AT&T') # => true assert_select('p', 'AT&T') # => false ``` ### 4 Railties 請參考 [CHANGELOG](https://github.com/rails/rails/blob/4-2-stable/railties/CHANGELOG.md) 來了解更多細節。 #### 4.1 移除 * `--skip-action-view` 選項從 app generator 移除。 ([Pull Request](https://github.com/rails/rails/pull/17042)) * 移除 `rails application` 命令。 ([Pull Request](https://github.com/rails/rails/pull/11616)) #### 4.2 棄用 * 生產環境新增 `config.log_level` 設置。 ([Pull Request](https://github.com/rails/rails/pull/16622)) * 棄用 `rake test:all`，請改用 `rake test` 來執行 `test` 目錄下的所有測試。 ([Pull Request](https://github.com/rails/rails/pull/17348)) * 棄用 `rake test:all:db`，請改用 `rake test:db`。 ([Pull Request](https://github.com/rails/rails/pull/17348)) * 棄用 `Rails::Rack::LogTailer`，沒有替代方案。 ([Commit](https://github.com/rails/rails/commit/84a13e019e93efaa8994b3f8303d635a7702dbce)) #### 4.3 值得一提的變化 * `web-console` 導入為應用內建的 Gem。 ([Pull Request](https://github.com/rails/rails/pull/11667)) * Model 用來產生關聯的 generator 添加 `required` 選項。 ([Pull Request](https://github.com/rails/rails/pull/16062)) * 導入 `after_bundle` 回調到 Rails 模版。 ([Pull Request](https://github.com/rails/rails/pull/16359)) * 導入 `x` 命名空間，可用來自訂設置選項： ``` # config/environments/production.rb config.x.payment_processing.schedule = :daily config.x.payment_processing.retries = 3 config.x.super_debugger = true ``` 這些選項都可以從設置對象里獲取： ``` Rails.configuration.x.payment_processing.schedule # => :daily Rails.configuration.x.payment_processing.retries # => 3 Rails.configuration.x.super_debugger # => true ``` ([Commit](https://github.com/rails/rails/commit/611849772dd66c2e4d005dcfe153f7ce79a8a7db)) * 導入 `Rails::Application.config_for`，用來給當前的環境載入設置 ``` # config/exception_notification.yml: production: url: http://127.0.0.1:8080 namespace: my_app_production development: url: http://localhost:3001 namespace: my_app_development # config/production.rb Rails.application.configure do config.middleware.use ExceptionNotifier, config_for(:exception_notification) end ``` ([Pull Request](https://github.com/rails/rails/pull/16129)) * 產生器新增 `--skip-turbolinks` 選項，可在新建應用時拿掉 turbolink。 ([Commit](https://github.com/rails/rails/commit/bf17c8a531bc8059d50ad731398002a3e7162a7d)) * 導入 `bin/setup` 腳本來啟動（bootstrapping）應用。 ([Pull Request](https://github.com/rails/rails/pull/15189)) * `config.assets.digest` 在開發模式的缺省值改為 `true`。 ([Pull Request](https://github.com/rails/rails/pull/15155)) * 導入給 `rake notes` 注冊新擴充功能的 API。 ([Pull Request](https://github.com/rails/rails/pull/14379)) * 導入 `Rails.gem_version` 作為返回 `Gem::Version.new(Rails.version)` 的便捷方法。 ([Pull Request](https://github.com/rails/rails/pull/14101)) ### 5 Action Pack 請參考 [CHANGELOG](https://github.com/rails/rails/blob/4-2-stable/actionpack/CHANGELOG.md) 來了解更多細節。 #### 5.1 移除 * 將 `respond_with` 以及類別層級的 `respond_to` 從 Rails 移除，移到 `responders` gem（版本 2.0）。要繼續使用這個特性，請在 Gemfile 添加：`gem 'responders', '~> 2.0'`。([Pull Request](https://github.com/rails/rails/pull/16526)) * 移除棄用的 `AbstractController::Helpers::ClassMethods::MissingHelperError`，改用 `AbstractController::Helpers::MissingHelperError` 取代。 ([Commit](https://github.com/rails/rails/commit/a1ddde15ae0d612ff2973de9cf768ed701b594e8)) #### 5.2 棄用 * 棄用 `*_path` 幫助方法的 `only_path` 選項。 ([Commit](https://github.com/rails/rails/commit/aa1fadd48fb40dd9396a383696134a259aa59db9)) * 棄用 `assert_tag`、`assert_no_tag`、`find_tag` 以及 `find_all_tag`，請改用 `assert_select`。 ([Commit](https://github.com/rails/rails-dom-testing/commit/b12850bc5ff23ba4b599bf2770874dd4f11bf750)) * 棄用路由的 `:to` 選項里，`:to` 可以指向符號或不含井號的字串這兩個功能。 ``` get '/posts', to: MyRackApp => (No change necessary) get '/posts', to: 'post#index' => (No change necessary) get '/posts', to: 'posts' => get '/posts', controller: :posts get '/posts', to: :index => get '/posts', action: :index ``` ([Commit](https://github.com/rails/rails/commit/cc26b6b7bccf0eea2e2c1a9ebdcc9d30ca7390d9)) * 棄用 URL 幫助方法不再支持使用字串作為鍵： ``` # bad root_path('controller' => 'posts', 'action' => 'index') # good root_path(controller: 'posts', action: 'index') ``` ([Pull Request](https://github.com/rails/rails/pull/17743)) #### 5.3 值得一提的變化 * `*_filter` 方法已經從文件中移除，已經不鼓勵使用。偏好使用 `*_action` 方法： ``` after_filter => after_action append_after_filter => append_after_action append_around_filter => append_around_action append_before_filter => append_before_action around_filter => around_action before_filter => before_action prepend_after_filter => prepend_after_action prepend_around_filter => prepend_around_action prepend_before_filter => prepend_before_action skip_after_filter => skip_after_action skip_around_filter => skip_around_action skip_before_filter => skip_before_action skip_filter => skip_action_callback ``` 若應用程式依賴這些 `*_filter` 方法，應該使用 `*_action` 方法替換。因為 `*_filter` 方法最終會從 Rails 里拿掉。 (Commit [1](https://github.com/rails/rails/commit/6c5f43bab8206747a8591435b2aa0ff7051ad3de), [2](https://github.com/rails/rails/commit/489a8f2a44dc9cea09154ee1ee2557d1f037c7d4)) * `render nothing: true` 或算繪 `nil` 不再加入一個空白到響應主體。 ([Pull Request](https://github.com/rails/rails/pull/14883)) * Rails 現在會自動把模版的 digest 加入到 ETag。 ([Pull Request](https://github.com/rails/rails/pull/16527)) * 傳入 URL 輔助方法的片段現在會自動 Escaped。 ([Commit](https://github.com/rails/rails/commit/5460591f0226a9d248b7b4f89186bd5553e7768f)) * 導入 `always_permitted_parameters` 選項，用來設置全局允許賦值的參數。缺省值是 `['controller', 'action']`。 ([Pull Request](https://github.com/rails/rails/pull/15933)) * 從 [RFC 4791](https://tools.ietf.org/html/rfc4791) 新增 HTTP 方法 `MKCALENDAR`。 ([Pull Request](https://github.com/rails/rails/pull/15121)) * `*_fragment.action_controller` 通知消息的 Payload 現在會帶有控制器和動作名稱。 ([Pull Request](https://github.com/rails/rails/pull/14137)) * 改善路由錯誤頁面，搜索路由支持模糊搜尋。 ([Pull Request](https://github.com/rails/rails/pull/14619)) * 新增關掉記錄 CSRF 失敗的選項。 ([Pull Request](https://github.com/rails/rails/pull/14280)) * 當使用 Rails 服務器來提供靜態資源時，若客戶端支持 gzip，則會自動傳送預先產生好的 gzip 靜態資源。Asset Pipeline 缺省會給所有可壓縮的靜態資源產生 `.gz` 文件。傳送 gzip 可將所需傳輸的數據量降到最小，并加速靜態資源請求的存取。當然若要在 Rails 生產環境提供靜態資源，最好還是使用 [CDN](http://guides.rubyonrails.org/asset_pipeline.html#cdns)。([Pull Request](https://github.com/rails/rails/pull/16466)) * 在整合測試里調用 `process` 幫助方法時，路徑開始需要有 `/`。以前可以忽略開頭的 `/`，但這是實作所產生的副產品，而不是有意新增的特性，譬如： ``` test "list all posts" do get "/posts" assert_response :success end ``` ### 6 Action View 請參考 [CHANGELOG](https://github.com/rails/rails/blob/4-2-stable/actionview/CHANGELOG.md) 來了解更多細節。 #### 6.1 棄用 * 棄用 `AbstractController::Base.parent_prefixes`。想修改尋找視圖的位置，請覆蓋 `AbstractController::Base.local_prefixes`。 ([Pull Request](https://github.com/rails/rails/pull/15026)) * 棄用 `ActionView::Digestor#digest(name, format, finder, options = {})`，現在參數改用 Hash 傳入。 ([Pull Request](https://github.com/rails/rails/pull/14243)) #### 6.2 值得一提的變化 * `render "foo/bar"` 現在等同 `render template: "foo/bar"` 而不是 `render file: "foo/bar"`。([Pull Request](https://github.com/rails/rails/pull/16888)) * 隱藏欄位的表單輔助方法不再產生含有行內樣式表的 `<div>` 元素。 ([Pull Request](https://github.com/rails/rails/pull/14738)) * 導入一個特別的 `#{partial_name}_iteration` 局部變量，給在 collection 里渲染的部分視圖（Partial）使用。這個變量可以通過 `#index`、`#size`、`first?` 以及 `last?` 等方法來獲得目前迭代的狀態。([Pull Request](https://github.com/rails/rails/pull/7698)) * Placeholder I18n 遵循和 `label` I18n 一樣的慣例。 ([Pull Request](https://github.com/rails/rails/pull/16438)) ### 7 Action Mailer 請參考 [CHANGELOG](https://github.com/rails/rails/blob/4-2-stable/actionmailer/CHANGELOG.md) 來了解更多細節。 #### 7.1 棄用 * Mailer 棄用所有 `*_path` 的幫助方法。請全面改用 `*_url`。 ([Pull Request](https://github.com/rails/rails/pull/15840)) * 棄用 `deliver` 與 `deliver!`，請改用 `deliver_now` 或 `deliver_now!`。 ([Pull Request](https://github.com/rails/rails/pull/16582)) #### 7.2 值得一提的變化 * `link_to` 和 `url_for` 在模版里缺省產生絕對路徑，不再需要傳入 `only_path: false`。 ([Commit](https://github.com/rails/rails/commit/9685080a7677abfa5d288a81c3e078368c6bb67c)) * 導入 `deliver_later` 方法，將郵件加到應用的隊列里，用來異步發送郵件。 ([Pull Request](https://github.com/rails/rails/pull/16485)) * 新增 `show_previews` 選項，用來在開發環境之外啟用郵件預覽特性。 ([Pull Request](https://github.com/rails/rails/pull/15970)) ### 8 Active Record 請參考 [CHANGELOG](https://github.com/rails/rails/blob/4-2-stable/activerecord/CHANGELOG.md) 來了解更多細節。 #### 8.1 移除 * 移除 `cache_attributes` 以及其它相關的方法，所有的屬性現在都會緩存了。 ([Pull Request](https://github.com/rails/rails/pull/15429)) * 移除已棄用的方法 `ActiveRecord::Base.quoted_locking_column`. ([Pull Request](https://github.com/rails/rails/pull/15612)) * 移除已棄用的方法 `ActiveRecord::Migrator.proper_table_name`。請改用 `ActiveRecord::Migration` 的實例方法：`proper_table_name`。 ([Pull Request](https://github.com/rails/rails/pull/15512)) * 移除了未使用的 `:timestamp` 類型。把所有 `timestamp` 類型都改為 `:datetime` 的別名。修正在 `ActiveRecord` 之外，欄位類型不一致的問題，譬如 XML 序列化。 ([Pull Request](https://github.com/rails/rails/pull/15184)) #### 8.2 棄用 * 棄用 `after_commit` 和 `after_rollback` 會吃掉錯誤的行為。 ([Pull Request](https://github.com/rails/rails/pull/16537)) * 棄用對 `has_many :through` 自動偵測 counter cache 的支持。要自己對 `has_many` 和 `belongs_to` 關聯，給 `through` 的記錄手動設置。 ([Pull Request](https://github.com/rails/rails/pull/15754)) * 棄用 `.find` 或 `.exists?` 可傳入 Active Record 對象。請先對對象調用 `#id`。 (Commit [1](https://github.com/rails/rails/commit/d92ae6ccca3bcfd73546d612efaea011270bd270), [2](https://github.com/rails/rails/commit/d35f0033c7dec2b8d8b52058fb8db495d49596f7)) * 棄用僅支持一半的 PostgreSQL 范圍數值（不包含起始值）。目前我們把 PostgreSQL 的范圍對應到 Ruby 的范圍。但由于 Ruby 的范圍不支持不包含起始值，所以無法完全轉換。目前的解決方法是將起始數遞增，這是不對的，已經棄用了。關于不知如何遞增的子類型（比如沒有定義 `#succ`）會對不包含起始值的拋出 `ArgumentError`。 ([Commit](https://github.com/rails/rails/commit/91949e48cf41af9f3e4ffba3e5eecf9b0a08bfc3)) * 棄用無連接調用 `DatabaseTasks.load_schema`。請改用 `DatabaseTasks.load_schema_current` 來取代。 ([Commit](https://github.com/rails/rails/commit/f15cef67f75e4b52fd45655d7c6ab6b35623c608)) * 棄用 `sanitize_sql_hash_for_conditions`，沒有替代方案。使用 `Relation` 來進行查詢或更新是推薦的做法。 ([Commit](https://github.com/rails/rails/commit/d5902c9e)) * 棄用 `add_timestamps` 和 `t.timestamps` 可不用傳入 `:null` 選項的行為。Rails 5 將把缺省 `null: true` 改為 `null: false`。 ([Pull Request](https://github.com/rails/rails/pull/16481)) * 棄用 `Reflection#source_macro`，沒有替代方案。Active Record 不再需要這個方法了。 ([Pull Request](https://github.com/rails/rails/pull/16373)) * 棄用 `serialized_attributes`，沒有替代方案。 ([Pull Request](https://github.com/rails/rails/pull/15704)) * 棄用了當欄位不存在時，還會從 `column_for_attribute` 返回 `nil` 的情況。 Rails 5.0 將會返回 Null Object。 ([Pull Request](https://github.com/rails/rails/pull/15878)) * 棄用了 `serialized_attributes`，沒有替代方案。 ([Pull Request](https://github.com/rails/rails/pull/15704)) * 棄用依賴實例狀態（有定義接受參數的作用域）的關聯可以使用 `.joins`、`.preload` 以及 `.eager_load` 的行為 ([Commit](https://github.com/rails/rails/commit/ed56e596a0467390011bc9d56d462539776adac1)) #### 8.3 值得一提的變化 * `SchemaDumper` 對 `create_table` 使用 `force: :cascade`。這樣就可以重載加入外鍵的綱要文件。 * 單數關聯增加 `:required` 選項，用來定義關聯的存在性驗證。 ([Pull Request](https://github.com/rails/rails/pull/16056)) * `ActiveRecord::Dirty` 現在會偵測可變數值的變化。序列化過的屬性只在有變更時才會保存。修復了像是 PostgreSQL 不會偵測到字串或 JSON 欄位改變的問題。 (Pull Requests [1](https://github.com/rails/rails/pull/15674), [2](https://github.com/rails/rails/pull/15786), [3](https://github.com/rails/rails/pull/15788)) * 導入 `bin/rake db:purge` 任務，用來清空當前環境的數據庫。 ([Commit](https://github.com/rails/rails/commit/e2f232aba15937a4b9d14bd91e0392c6d55be58d)) * 導入 `ActiveRecord::Base#validate!`，若記錄不合法時會拋出 `RecordInvalid`。 ([Pull Request](https://github.com/rails/rails/pull/8639)) * 引入 `#validate` 作為 `#valid?` 的別名。 ([Pull Request](https://github.com/rails/rails/pull/14456)) * `#touch` 現在可一次對多屬性操作。 ([Pull Request](https://github.com/rails/rails/pull/14423)) * PostgreSQL 適配器現在支持 PostgreSQL 9.4+ 的 `jsonb` 數據類型。 ([Pull Request](https://github.com/rails/rails/pull/16220)) * 新增 PostgreSQL 適配器的 `citext` 支持。 ([Pull Request](https://github.com/rails/rails/pull/12523)) * PostgreSQL 與 SQLite 適配器不再默認限制字串只能 255 字符。 ([Pull Request](https://github.com/rails/rails/pull/14579)) * 新增 PostgreSQL 適配器的使用自建的范圍類型支持。 ([Commit](https://github.com/rails/rails/commit/4cb47167e747e8f9dc12b0ddaf82bdb68c03e032)) * `sqlite3:///some/path` 現在可以解析系統的絕對路徑 `/some/path`。相對路徑請使用 `sqlite3:some/path`。(先前是 `sqlite3:///some/path` 會解析成 `some/path`。這個行為已在 Rails 4.1 被棄用了。 Rails 4.1.) ([Pull Request](https://github.com/rails/rails/pull/14569)) * 新增 MySQL 5.6 以上版本的 fractional seconds 支持。 (Pull Request [1](https://github.com/rails/rails/pull/8240), [2](https://github.com/rails/rails/pull/14359)) * 新增 `ActiveRecord::Base` 對象的 `#pretty_print` 方法。 ([Pull Request](https://github.com/rails/rails/pull/15172)) * `ActiveRecord::Base#reload` 現在的行為同 `m = Model.find(m.id)`，代表不再給自定的 `select` 保存額外的屬性。 ([Pull Request](https://github.com/rails/rails/pull/15866)) * `ActiveRecord::Base#reflections` 現在返回的 hash 的鍵是字串類型，而不是符號。 ([Pull Request](https://github.com/rails/rails/pull/17718)) * 遷移的 `references` 方法支持 `type` 選項，用來指定外鍵的類型，比如 `:uuid`。 ([Pull Request](https://github.com/rails/rails/pull/16231)) ### 9 Active Model 請參考 [CHANGELOG](https://github.com/rails/rails/blob/4-2-stable/activemodel/CHANGELOG.md) 來了解更多細節。 #### 9.1 移除 * 移除了 `Validator#setup`，沒有替代方案。 ([Pull Request](https://github.com/rails/rails/pull/15617)) #### 9.2 棄用 * 棄用 `reset_#{attribute}`，請改用 `restore_#{attribute}`。 ([Pull Request](https://github.com/rails/rails/pull/16180)) * 棄用 `ActiveModel::Dirty#reset_changes`，請改用 `#clear_changes_information`。 ([Pull Request](https://github.com/rails/rails/pull/16180)) #### 9.3 值得一提的變化 * 引入 `#validate` 作為 `#valid?` 的別名。 ([Pull Request](https://github.com/rails/rails/pull/14456)) * `ActiveModel::Dirty` 導入 `restore_attributes` 方法，用來回復已修改的屬性到先前的數值。 (Pull Request [1](https://github.com/rails/rails/pull/14861), [2](https://github.com/rails/rails/pull/16180)) * `has_secure_password` 現在缺省允許空密碼（只含空白的密碼也算空密碼）。 ([Pull Request](https://github.com/rails/rails/pull/16412)) * 驗證啟用時，`has_secure_password` 現在會檢查密碼是否少于 72 個字符。 ([Pull Request](https://github.com/rails/rails/pull/15708)) ### 10 Active Support 請參考 [CHANGELOG](https://github.com/rails/rails/blob/4-2-stable/activesupport/CHANGELOG.md) 來了解更多細節。 #### 10.1 移除 * 移除棄用的 `Numeric#ago`、`Numeric#until`、`Numeric#since` 以及 `Numeric#from_now`. ([Commit](https://github.com/rails/rails/commit/f1eddea1e3f6faf93581c43651348f48b2b7d8bb)) * 移除棄用 `ActiveSupport::Callbacks` 基于字串的終止符。 ([Pull Request](https://github.com/rails/rails/pull/15100)) #### 10.2 棄用 * 棄用 `Kernel#silence_stderr`、`Kernel#capture` 以及 `Kernel#quietly` 方法，沒有替代方案。([Pull Request](https://github.com/rails/rails/pull/13392)) * 棄用 `Class#superclass_delegating_accessor`，請改用 `Class#class_attribute`。 ([Pull Request](https://github.com/rails/rails/pull/14271)) * 棄用 `ActiveSupport::SafeBuffer#prepend!` 請改用 `ActiveSupport::SafeBuffer#prepend`（兩者功能相同）。 ([Pull Request](https://github.com/rails/rails/pull/14529)) #### 10.3 值得一提的變化 * 導入新的設置選項： `active_support.test_order`，用來指定測試執行的順序，預設是 `:sorted`，在 Rails 5.0 將會改成 `:random`。([Commit](https://github.com/rails/rails/commit/53e877f7d9291b2bf0b8c425f9e32ef35829f35b)) * `Object#try` 和 `Object#try!` 方法現在不需要消息接收者也可以使用。 ([Commit](https://github.com/rails/rails/commit/5e51bdda59c9ba8e5faf86294e3e431bd45f1830), [Pull Request](https://github.com/rails/rails/pull/17361)) * `travel_to` 測試輔助方法現在會把 `usec` 部分截斷為 0。 ([Commit](https://github.com/rails/rails/commit/9f6e82ee4783e491c20f5244a613fdeb4024beb5)) * 導入 `Object#itself` 作為 identity 函數（返回自身的函數）。(Commit [1](https://github.com/rails/rails/commit/702ad710b57bef45b081ebf42e6fa70820fdd810) 和 [2](https://github.com/rails/rails/commit/64d91122222c11ad3918cc8e2e3ebc4b0a03448a)) * `Object#with_options` 方法現在不需要消息接收者也可以使用。 ([Pull Request](https://github.com/rails/rails/pull/16339)) * 導入 `String#truncate_words` 方法，可指定要單詞截斷至幾個單詞。 ([Pull Request](https://github.com/rails/rails/pull/16190)) * 新增 `Hash#transform_values` 與 `Hash#transform_values!` 方法，來簡化 Hash 值需要更新、但鍵保留不變這樣的常見模式。 ([Pull Request](https://github.com/rails/rails/pull/15819)) * `humanize` 現在會去掉前面的底線。 ([Commit](https://github.com/rails/rails/commit/daaa21bc7d20f2e4ff451637423a25ff2d5e75c7)) * 導入 `Concern#class_methods` 來取代 `module ClassMethods` 以及 `Kernel#concern`，來避免使用 `module Foo; extend ActiveSupport::Concern; end` 這樣的樣板。 ([Commit](https://github.com/rails/rails/commit/b16c36e688970df2f96f793a759365b248b582ad)) * 新增一篇[指南](constant_autoloading_and_reloading.html)，關于常量的載入與重載。 ### 11 致謝許多人花費寶貴的時間貢獻至 Rails 項目，使 Rails 成為更穩定、更強韌的網絡框架，參考[完整的 Rails 貢獻者清單](http://contributors.rubyonrails.org/)，感謝所有的貢獻者！ ### 反饋歡迎幫忙改善指南質量。如發現任何錯誤，歡迎修正。開始貢獻前，可先行閱讀[貢獻指南：文檔](http://edgeguides.rubyonrails.org/contributing_to_ruby_on_rails.html#contributing-to-the-rails-documentation)。翻譯如有錯誤，深感抱歉，歡迎 [Fork](https://github.com/ruby-china/guides/fork) 修正，或至此處[回報](https://github.com/ruby-china/guides/issues/new)。文章可能有未完成或過時的內容。請先檢查 [Edge Guides](http://edgeguides.rubyonrails.org) 來確定問題在 master 是否已經修掉了。再上 master 補上缺少的文件。內容參考 [Ruby on Rails 指南準則](ruby_on_rails_guides_guidelines.html)來了解行文風格。最后，任何關于 Ruby on Rails 文檔的討論，歡迎到 [rubyonrails-docs 郵件群組](http://groups.google.com/group/rubyonrails-docs)。