更多資訊請參閱 rubyonrails.org:

Ruby on Rails 5.0 發行說明

Rails 5.0 的重點

  • Action Cable
  • Rails API
  • Active Record 屬性 API
  • 測試執行器
  • 完全使用 rails CLI 而非 Rake
  • Sprockets 3
  • Turbolinks 5
  • 需要 Ruby 2.2.2+

這些發行說明僅涵蓋主要變更。若要了解各種錯誤修正和變更，請參閱變更日誌或查看 GitHub 上主要 Rails 儲存庫中的提交清單。

1 升級至 Rails 5.0

如果您要升級現有的應用程式，最好先做好良好的測試覆蓋率。您也應該先升級到 Rails 4.2（如果您還沒升級），並確保您的應用程式在嘗試更新到 Rails 5.0 之前仍能如預期般運作。升級時需要注意的事項清單可在升級 Ruby on Rails 指南中找到。

2 主要功能

2.1 Action Cable

Action Cable 是 Rails 5 中的一個新框架。它將 WebSockets 與您其餘的 Rails 應用程式無縫整合。

Action Cable 允許以與其餘 Rails 應用程式相同的風格和形式用 Ruby 編寫即時功能，同時仍保持高效能和可擴充性。它是一個完整的堆疊產品，同時提供客戶端 JavaScript 框架和伺服器端 Ruby 框架。您可以存取使用 Active Record 或您選擇的 ORM 編寫的完整網域模型。

請參閱 Action Cable 概述指南以取得更多資訊。

2.2 API 應用程式

現在可以使用 Rails 來建立精簡的僅 API 應用程式。這對於建立和服務類似於 X 或 GitHub API 的 API 很有用，這些 API 可以用於服務公開的，以及客製化應用程式。

您可以使用以下方式產生新的 api Rails 應用程式

$ rails new my_api --api

這將執行三項主要操作

  • 設定您的應用程式以使用比平常更有限的中介軟體集啟動。具體來說，它預設不會包含任何主要用於瀏覽器應用程式的中介軟體（例如 Cookie 支援）。
  • 使 ApplicationController 從 ActionController::API 而不是 ActionController::Base 繼承。與中介軟體一樣，這將省略任何主要由瀏覽器應用程式使用的 Action Controller 模組的功能。
  • 設定產生器以在您產生新資源時跳過產生視圖、助手和資源。

該應用程式提供了 API 的基礎，然後可以根據應用程式的需求設定為導入功能。

請參閱 將 Rails 用於僅 API 應用程式 指南以取得更多資訊。

2.3 Active Record 屬性 API

在模型上定義具有類型的屬性。如果需要，它將覆蓋現有屬性的類型。這允許控制值在指派給模型時如何與 SQL 相互轉換。它還會變更傳遞給 ActiveRecord::Base.where 的值的行為，這讓您可以在 Active Record 中使用我們的網域物件，而不必依賴實作細節或猴子修補。

您可以使用這個實現的一些目標

  • 可以覆蓋 Active Record 偵測到的類型。
  • 也可以提供預設值。
  • 屬性不需要資料庫欄位支援。
# db/schema.rb
create_table :store_listings, force: true do |t|
  t.decimal :price_in_cents
  t.string :my_string, default: "original default"
end

# app/models/store_listing.rb
class StoreListing < ActiveRecord::Base
end

store_listing = StoreListing.new(price_in_cents: '10.1')

# before
store_listing.price_in_cents # => BigDecimal.new(10.1)
StoreListing.new.my_string # => "original default"

class StoreListing < ActiveRecord::Base
  attribute :price_in_cents, :integer # custom type
  attribute :my_string, :string, default: "new default" # default value
  attribute :my_default_proc, :datetime, default: -> { Time.now } # default value
  attribute :field_without_db_column, :integer, array: true
end

# after
store_listing.price_in_cents # => 10
StoreListing.new.my_string # => "new default"
StoreListing.new.my_default_proc # => 2015-05-30 11:04:48 -0600
model = StoreListing.new(field_without_db_column: ["1", "2", "3"])
model.attributes # => {field_without_db_column: [1, 2, 3]}

建立自訂類型

只要自訂類型響應值類型上定義的方法，您就可以定義自己的自訂類型。方法 deserialize 或 cast 將在您的類型物件上呼叫，並使用來自資料庫或控制器的原始輸入。這在進行自訂轉換時很有用，例如貨幣資料。

查詢

當呼叫 ActiveRecord::Base.where 時，它將使用模型類別定義的類型將值轉換為 SQL，並呼叫類型物件上的 serialize。

這讓物件能夠指定在執行 SQL 查詢時如何轉換值。

變更追蹤

屬性的類型允許變更執行變更追蹤的方式。

請參閱其文件以取得詳細說明。

2.4 測試執行器

已引入新的測試執行器，以增強從 Rails 執行測試的功能。若要使用此測試執行器，只需輸入 bin/rails test。

測試執行器的靈感來自 RSpec、minitest-reporters、maxitest 和其他。它包含以下一些值得注意的改進

  • 使用測試的行號執行單個測試。
  • 透過精確指出測試的行號來執行多個測試。
  • 改進的失敗訊息，也增加了重新執行失敗測試的便利性。
  • 使用 -f 選項快速失敗，在發生失敗時立即停止測試，而不是等待套件完成。
  • 使用 -d 選項將測試輸出延遲到完整測試執行結束。
  • 使用 -b 選項完成異常回溯追蹤輸出。
  • 與 minitest 整合以允許選項，例如 -s 用於測試種子資料，-n 用於按名稱執行特定測試，-v 用於更好的詳細輸出等等。
  • 彩色測試輸出。

3 Railties

請參閱 變更日誌 以取得詳細變更。

3.1 移除

  • 已移除偵錯工具支援，請改用 byebug。Ruby 2.2 不支援 debugger。( commit )

  • 已移除已棄用的 test:all 和 test:all:db 工作。( commit )

  • 已移除已棄用的 Rails::Rack::LogTailer。( commit )

  • 已移除已棄用的 RAILS_CACHE 常數。( commit )

  • 已移除已棄用的 serve_static_assets 設定。( commit )

  • 已移除文件工作 doc:app、doc:rails 和 doc:guides。( commit )

  • 已從預設堆疊中移除 Rack::ContentLength 中介軟體。( Commit )

3.2 棄用

  • 已棄用 config.static_cache_control，改用 config.public_file_server.headers。( Pull Request )

  • 已棄用 config.serve_static_files，改用 config.public_file_server.enabled。( Pull Request )

  • 已棄用 rails 工作命名空間中的工作，改用 app 命名空間。（例如，rails:update 和 rails:template 工作已重新命名為 app:update 和 app:template。）( Pull Request )

3.3 重要變更

  • 已新增 Rails 測試執行器 bin/rails test。( Pull Request )

  • 新產生的應用程式和外掛程式會在 Markdown 中取得 README.md。( commit, Pull Request )

  • 已新增 bin/rails restart 工作，以透過觸摸 tmp/restart.txt 來重新啟動您的 Rails 應用程式。( Pull Request )

  • 已新增 bin/rails initializers 工作，以依 Rails 叫用的順序印出所有已定義的初始化程式。( Pull Request )

  • 已新增 bin/rails dev:cache 以在開發模式中啟用或停用快取。( Pull Request )

  • 已新增 bin/update 指令碼以自動更新開發環境。( Pull Request )

  • 透過 bin/rails 代理 Rake 任務。（Pull Request, Pull Request）

  • 新的應用程式會在 Linux 和 macOS 上啟用事件驅動檔案系統監控器產生。可透過傳遞 --skip-listen 給產生器來選擇停用此功能。（commit, commit）

  • 產生應用程式時，可選擇使用環境變數 RAILS_LOG_TO_STDOUT 在生產環境記錄到 STDOUT。（Pull Request）

  • 為新應用程式啟用包含 IncludeSubdomains 標頭的 HSTS。（Pull Request）

  • 應用程式產生器會寫入新的檔案 config/spring.rb，告知 Spring 監看額外的常用檔案。（commit）

  • 新增 --skip-action-mailer 選項，可在產生新應用程式時跳過 Action Mailer。（Pull Request）

  • 移除 tmp/sessions 目錄以及相關的清除 Rake 任務。（Pull Request）

  • 將 scaffold 產生器產生的 _form.html.erb 修改為使用區域變數。（Pull Request）

  • 在生產環境中停用類別的自動載入。（commit）

4 Action Pack

請參閱 Changelog 以了解詳細變更。

4.1 移除

  • 移除 ActionDispatch::Request::Utils.deep_munge。（commit）

  • 移除 ActionController::HideActions。（Pull Request）

  • 移除 respond_to 和 respond_with 佔位方法，此功能已提取到 responders gem 中。（commit）

  • 移除已棄用的斷言檔案。（commit）

  • 移除 URL helper 中已棄用的字串鍵用法。（commit）

  • 移除 *_path helper 中已棄用的 only_path 選項。（commit）

  • 移除已棄用的 NamedRouteCollection#helpers。（commit）

  • 移除已棄用定義不包含 # 的 :to 選項路由的支援。（commit）

  • 移除已棄用的 ActionDispatch::Response#to_ary。（commit）

  • 移除已棄用的 ActionDispatch::Request#deep_munge。（commit）

  • 移除已棄用的 ActionDispatch::Http::Parameters#symbolized_path_parameters。（commit）

  • 移除控制器測試中已棄用的 use_route 選項。（commit）

  • 移除 assigns 和 assert_template。這兩個方法都已提取到 rails-controller-testing gem 中。（Pull Request）

4.2 棄用

  • 棄用所有 *_filter 回呼，改用 *_action 回呼。（Pull Request）

  • 棄用 *_via_redirect 整合測試方法。在請求呼叫後手動使用 follow_redirect! 以達到相同行為。（Pull Request）

  • 棄用 AbstractController#skip_action_callback，改用個別的 skip_callback 方法。（Pull Request）

  • 棄用 render 方法的 :nothing 選項。（Pull Request）

  • 棄用將第一個參數作為 Hash 傳遞以及 head 方法的預設狀態碼。（Pull Request）

  • 棄用使用字串或符號作為 middleware 類別名稱。改用類別名稱。（commit）

  • 棄用透過常數 (例如 Mime::HTML) 存取 MIME 類型。改為使用帶有符號的下標運算符 (例如 Mime[:html])。（Pull Request）

  • 棄用 redirect_to :back，改用 redirect_back，它接受一個必要的 fallback_location 引數，從而消除 RedirectBackError 的可能性。（Pull Request）

  • ActionDispatch::IntegrationTest 和 ActionController::TestCase 棄用位置引數，改用關鍵字引數。（Pull Request）

  • 棄用 :controller 和 :action 路徑參數。（Pull Request）

  • 棄用控制器實例上的 env 方法。（commit）

  • ActionDispatch::ParamsParser 已棄用，並已從 middleware 堆疊中移除。要配置參數解析器，請使用 ActionDispatch::Request.parameter_parsers=。（commit, commit）

4.3 重要變更

  • 新增 ActionController::Renderer 以在控制器動作之外呈現任意樣板。（Pull Request）

  • 在 ActionController::TestCase 和 ActionDispatch::Integration HTTP 請求方法中遷移到關鍵字引數語法。（Pull Request）

  • 將 http_cache_forever 新增到 Action Controller，因此我們可以快取永遠不會過期的回應。（Pull Request）

  • 提供更友善的方式存取請求變體。（Pull Request）

  • 對於沒有對應樣板的動作，呈現 head :no_content 而不是引發錯誤。（Pull Request）

  • 新增覆寫控制器預設表單建構器的功能。（Pull Request）

  • 新增僅限 API 應用程式的支援。新增 ActionController::API 作為此類應用程式的 ActionController::Base 的替代方案。（Pull Request）

  • 使 ActionController::Parameters 不再繼承自 HashWithIndifferentAccess。（Pull Request）

  • 透過使其更易於嘗試且更易於停用，從而更輕鬆地選擇加入 config.force_ssl 和 config.ssl_options。（Pull Request）

  • 新增將任意標頭返回給 ActionDispatch::Static 的功能。（Pull Request）

  • 將 protect_from_forgery prepend 預設值變更為 false。（commit）

  • ActionController::TestCase 將在 Rails 5.1 中移動到其自己的 gem。請改用 ActionDispatch::IntegrationTest。（commit）

  • Rails 預設產生弱 ETags。（Pull Request）

  • 沒有明確 render 呼叫且沒有對應樣板的控制器動作，將會隱式呈現 head :no_content，而不是引發錯誤。（Pull Request 1, 2）

  • 新增每個表單 CSRF 令牌的選項。（Pull Request）

  • 在整合測試中新增請求編碼和回應解析。（Pull Request）

  • 新增 ActionController#helpers 以在控制器層級存取視圖上下文。（Pull Request）

  • 丟棄的快閃訊息會在儲存到會話之前移除。（Pull Request）

  • 新增將記錄集合傳遞給 fresh_when 和 stale? 的支援。（Pull Request）

  • ActionController::Live 成為 ActiveSupport::Concern。這表示它不能只是包含在其他模組中，而無需使用 ActiveSupport::Concern 來擴展它們，否則 ActionController::Live 將不會在生產環境中生效。有些人可能正在使用另一個模組來包含一些特殊的 Warden/Devise 身份驗證失敗處理程式碼，因為 middleware 無法捕獲由產生的執行緒拋出的 :warden，這是使用 ActionController::Live 的情況。（此問題中的更多詳細資訊）

  • 引入 Response#strong_etag= 和 #weak_etag= 以及 fresh_when 和 stale? 的類似選項。（Pull Request）

5 Action View

請參閱 Changelog 以了解詳細變更。

5.1 移除

  • 移除已棄用的 AbstractController::Base::parent_prefixes。（commit）

  • 移除 ActionView::Helpers::RecordTagHelper，此功能已提取到 record_tag_helper gem 中。（Pull Request）

  • 移除 translate helper 的 :rescue_format 選項，因為 I18n 不再支援它。（Pull Request）

5.2 重要變更

  • 將預設樣板處理程式從 ERB 變更為 Raw。（commit）

  • 集合呈現可以快取並一次獲取多個 partial。（Pull Request, commit）

  • 將萬用字元匹配新增到明確的依賴項。（Pull Request）

  • 使 disable_with 成為提交標籤的預設行為。在提交時停用按鈕，以防止重複提交。（Pull Request）

  • partial 樣板名稱不再需要是有效的 Ruby 識別符。（commit）

  • 現在，datetime_tag helper 會產生類型為 datetime-local 的輸入標籤。（Pull Request）

  • 允許在使用 render partial: helper 呈現時使用區塊。（Pull Request）

6 Action Mailer

請參閱 Changelog 以了解詳細變更。

6.1 移除

  • 移除電子郵件視圖中已棄用的 *_path helpers。（commit）

  • 移除已棄用的 deliver 和 deliver! 方法。（commit）

6.2 重要變更

  • 現在，樣板查找會遵守預設地區設定和 I18n 回退。（commit）

  • 將 _mailer 後綴新增到透過產生器建立的 mailer，遵循在控制器和 job 中使用的相同命名慣例。（Pull Request）

  • 新增 assert_enqueued_emails 和 assert_no_enqueued_emails。（Pull Request）

  • 新增 config.action_mailer.deliver_later_queue_name 配置，以設定 mailer 佇列名稱。（Pull Request）

  • 新增 Action Mailer 視圖中對片段快取的支援。新增新的配置選項 config.action_mailer.perform_caching，以決定您的樣板是否應執行快取。（Pull Request）

7 Active Record

請參閱 Changelog 以了解詳細變更。

7.1 移除

  • 移除允許將巢狀陣列作為查詢值傳遞的已棄用行為。（Pull Request）

  • 移除已棄用的 ActiveRecord::Tasks::DatabaseTasks#load_schema。此方法已由 ActiveRecord::Tasks::DatabaseTasks#load_schema_for 取代。（commit）

  • 移除已棄用的 serialized_attributes。（commit）

  • 移除 has_many :through 上已棄用的自動計數器快取。（commit）

  • 移除已棄用的 sanitize_sql_hash_for_conditions。（commit）

  • 移除已棄用的 Reflection#source_macro。（commit）

  • 移除已棄用的 symbolized_base_class 和 symbolized_sti_name。（commit）

  • 移除已棄用的 ActiveRecord::Base.disable_implicit_join_references=。（commit）

  • 移除了使用字串存取器存取連線規格的已棄用方法。（commit）

  • 移除了預先載入實例相關聯的關聯的已棄用支援。（commit）

  • 移除了對具有獨佔下限的 PostgreSQL 範圍的已棄用支援。（commit）

  • 移除使用快取 Arel 修改關聯時的棄用警告。現在會改為拋出 ImmutableRelation 錯誤。（commit）

  • 從核心中移除了 ActiveRecord::Serialization::XmlSerializer。此功能已提取到 activemodel-serializers-xml gem。（Pull Request）

  • 從核心中移除了對舊版 mysql 資料庫介面卡的支援。大多數使用者應該可以使用 mysql2。當我們找到維護者時，它將被轉換為單獨的 gem。（Pull Request 1、Pull Request 2）

  • 移除了對 protected_attributes gem 的支援。（commit）

  • 移除了對低於 9.1 版本的 PostgreSQL 的支援。（Pull Request）

  • 移除了對 activerecord-deprecated_finders gem 的支援。（commit）

  • 移除了 ActiveRecord::ConnectionAdapters::Column::TRUE_VALUES 常數。（commit）

7.2 棄用

  • 已棄用在查詢中將類別作為值傳遞。使用者應改為傳遞字串。（Pull Request）

  • 已棄用回傳 false 作為停止 Active Record 回呼鏈的方式。建議的方式是使用 throw(:abort)。（Pull Request）

  • 已棄用 ActiveRecord::Base.errors_in_transactional_callbacks=。（commit）

  • 已棄用 Relation#uniq，請改用 Relation#distinct。（commit）

  • 已棄用 PostgreSQL 的 :point 類型，建議使用新的類型，它將會回傳 Point 物件而不是 Array。（Pull Request）

  • 已棄用透過傳遞真值參數給關聯方法來強制關聯重新載入。（Pull Request）

  • 已棄用關聯 restrict_dependent_destroy 錯誤的鍵，建議使用新的鍵名稱。（Pull Request）

  • 同步 #tables 的行為。（Pull Request）

  • 已棄用 SchemaCache#tables、SchemaCache#table_exists? 和 SchemaCache#clear_table_cache!，建議改用它們新的資料來源對應方法。（Pull Request）

  • 已棄用 SQLite3 和 MySQL 介面卡上的 connection.tables。（Pull Request）

  • 已棄用將引數傳遞給 #tables - 某些介面卡 (mysql2, sqlite3) 的 #tables 方法會同時回傳表格和檢視表，而其他介面卡 (postgresql) 只會回傳表格。為了使它們的行為一致，未來 #tables 將只回傳表格。（Pull Request）

  • 已棄用 table_exists? - #table_exists? 方法會檢查表格和檢視表。為了使其行為與 #tables 一致，未來 #table_exists? 將僅檢查表格。（Pull Request）

  • 已棄用傳送 offset 引數給 find_nth。請改用關聯上的 offset 方法。（Pull Request）

  • 已棄用 DatabaseStatements 中的 {insert|update|delete}_sql。請改用 {insert|update|delete} 公有方法。（Pull Request）

  • 已棄用 use_transactional_fixtures，建議使用 use_transactional_tests 以更清楚表達其意圖。（Pull Request）

  • 已棄用將欄位傳遞給 ActiveRecord::Connection#quote。（commit）

  • 在 find_in_batches 中新增了 end 選項，與 start 參數搭配使用，以指定停止批次處理的位置。（Pull Request）

7.3 重要變更

  • 在建立表格時，為 references 新增了 foreign_key 選項。（commit）

  • 新的屬性 API。（commit）

  • 在 enum 定義中新增了 :_prefix/:_suffix 選項。（Pull Request、Pull Request）

  • 為 ActiveRecord::Relation 新增了 #cache_key。（Pull Request）

  • 將 timestamps 的預設 null 值變更為 false。（commit）

  • 新增 ActiveRecord::SecureToken，以便使用 SecureRandom 封裝模型中屬性的唯一令牌產生。（Pull Request）

  • 為 drop_table 新增了 :if_exists 選項。（Pull Request）

  • 新增 ActiveRecord::Base#accessed_fields，可用於快速發現從模型讀取了哪些欄位，當您只想從資料庫選取所需的資料時。（commit）

  • 在 ActiveRecord::Relation 上新增了 #or 方法，允許使用 OR 運算子來組合 WHERE 或 HAVING 子句。（commit）

  • 新增 ActiveRecord::Base.suppress，以防止接收者在給定的區塊期間被儲存。（Pull Request）

  • 如果關聯不存在，belongs_to 現在預設會觸發驗證錯誤。您可以使用 optional: true 在每個關聯的基礎上關閉此功能。同時棄用 belongs_to 的 required 選項，建議改用 optional。（Pull Request）

  • 新增 config.active_record.dump_schemas 以配置 db:structure:dump 的行為。（Pull Request）

  • 新增 config.active_record.warn_on_records_fetched_greater_than 選項。（Pull Request）

  • 在 MySQL 中新增原生 JSON 資料類型支援。（Pull Request）

  • 新增在 PostgreSQL 中並行刪除索引的支援。（Pull Request）

  • 在連線介面卡上新增了 #views 和 #view_exists? 方法。（Pull Request）

  • 新增 ActiveRecord::Base.ignored_columns，使某些欄位在 Active Record 中不可見。（Pull Request）

  • 新增 connection.data_sources 和 connection.data_source_exists?。這些方法決定了哪些關聯可用於支援 Active Record 模型（通常是表格和檢視表）。（Pull Request）

  • 允許 fixture 檔案在 YAML 檔案本身中設定模型類別。（Pull Request）

  • 新增在產生資料庫遷移時，預設使用 uuid 作為主鍵的功能。（Pull Request）

  • 新增 ActiveRecord::Relation#left_joins 和 ActiveRecord::Relation#left_outer_joins。（Pull Request）

  • 新增 after_{create,update,delete}_commit 回呼。（Pull Request）

  • 版本化呈現給遷移類別的 API，以便我們可以在不破壞現有遷移的情況下變更參數預設值，或強制它們通過棄用週期重寫。（Pull Request）

  • ApplicationRecord 是所有應用程式模型的新超類別，類似於子類化 ApplicationController 而不是 ActionController::Base 的應用程式控制器。這為應用程式提供了一個設定應用程式範圍模型行為的單一位置。（Pull Request）

  • 新增 ActiveRecord #second_to_last 和 #third_to_last 方法。（Pull Request）

  • 新增使用儲存在 PostgreSQL 和 MySQL 資料庫元資料中的註解來註解資料庫物件（表格、欄位、索引）的功能。（Pull Request）

  • 為 mysql2 介面卡新增準備陳述式支援，適用於 mysql2 0.4.4+，先前僅在已棄用的舊版 mysql 介面卡上支援。若要啟用，請在 config/database.yml 中設定 prepared_statements: true。（Pull Request）

  • 新增在關聯物件上呼叫 ActiveRecord::Relation#update 的功能，這將對關聯中的所有物件執行驗證回呼。（Pull Request）

  • 為 save 方法新增了 :touch 選項，以便可以儲存記錄而無需更新時間戳記。（Pull Request）

  • 為 PostgreSQL 新增運算式索引和運算子類別支援。（commit）

  • 新增 :index_errors 選項，以將索引新增到巢狀屬性的錯誤中。（Pull Request）

  • 新增對雙向刪除依賴項的支援。（Pull Request）

  • 在交易測試中新增對 after_commit 回呼的支援。（Pull Request）

  • 新增 foreign_key_exists? 方法，以查看表格上是否存在外鍵。（Pull Request）

  • 為 touch 方法新增了 :time 選項，以使用與目前時間不同的時間來觸碰記錄。（Pull Request）

  • 變更交易回呼以不吞噬錯誤。在此變更之前，除非您使用（新棄用的）raise_in_transactional_callbacks = true 選項，否則在交易回呼中引發的任何錯誤都會被救援並印在記錄中。

    現在這些錯誤不再被救援，而是直接冒泡，與其他回呼的行為一致。（commit）

8 Active Model

有關詳細變更，請參閱 變更日誌。

8.1 移除

8.2 棄用

  • 已棄用回傳 false 作為停止 Active Model 和 ActiveModel::Validations 回呼鏈的方式。建議的方式是使用 throw(:abort)。（Pull Request）

  • 已棄用具有不一致行為的 ActiveModel::Errors#get、ActiveModel::Errors#set 和 ActiveModel::Errors#[]= 方法。（Pull Request）

  • 已棄用 validates_length_of 的 :tokenizer 選項，建議使用純 Ruby。（Pull Request）

  • 已棄用 ActiveModel::Errors#add_on_empty 和 ActiveModel::Errors#add_on_blank，沒有替代方案。（Pull Request）

8.3 重要變更

  • 新增 ActiveModel::Errors#details，以確定哪個驗證器失敗。（Pull Request）

  • 將 ActiveRecord::AttributeAssignment 提取到 ActiveModel::AttributeAssignment，允許將其用作任何物件的可包含模組。（Pull Request）

  • 新增 ActiveModel::Dirty#[attr_name]_previously_changed? 和 ActiveModel::Dirty#[attr_name]_previous_change，以改進模型儲存後對記錄的變更的存取。（Pull Request）

  • 一次驗證多個情境下 valid? 和 invalid? 的結果。（Pull Request）

  • 變更 validates_acceptance_of，除了 1 之外，也接受 true 作為預設值。（Pull Request）

9 Active Job

請參考變更日誌以了解詳細變更。

9.1 重要變更

  • ActiveJob::Base.deserialize 委派給 job 類別。這允許 jobs 在序列化時附加任意元數據，並在執行時讀回這些元數據。（Pull Request）

  • 新增在每個 job 基礎上設定 queue adapter 的能力，而不會互相影響。（Pull Request）

  • 預設情況下，產生的 job 現在繼承自 app/jobs/application_job.rb。（Pull Request）

  • 允許 DelayedJob、Sidekiq、qu、que 和 queue_classic 將 job id 回報給 ActiveJob::Base 作為 provider_job_id。（Pull Request、Pull Request、commit）

  • 實作一個簡單的 AsyncJob 處理器和相關的 AsyncAdapter，將 jobs 排隊到 concurrent-ruby 線程池。（Pull Request）

  • 將預設 adapter 從 inline 變更為 async。這是一個更好的預設，因為測試將不會錯誤地依賴同步發生的行為。（commit）

10 Active Support

請參考變更日誌以了解詳細變更。

10.1 移除

  • 移除已棄用的 ActiveSupport::JSON::Encoding::CircularReferenceError。（commit）

  • 移除已棄用的方法 ActiveSupport::JSON::Encoding.encode_big_decimal_as_string= 和 ActiveSupport::JSON::Encoding.encode_big_decimal_as_string。（commit）

  • 移除已棄用的 ActiveSupport::SafeBuffer#prepend。（commit）

  • 從 Kernel 移除已棄用的方法。silence_stderr、silence_stream、capture 和 quietly。（commit）

  • 移除已棄用的 active_support/core_ext/big_decimal/yaml_conversions 檔案。（commit）

  • 移除已棄用的方法 ActiveSupport::Cache::Store.instrument 和 ActiveSupport::Cache::Store.instrument=。（commit）

  • 移除已棄用的 Class#superclass_delegating_accessor。改用 Class#class_attribute。（Pull Request）

  • 移除已棄用的 ThreadSafe::Cache。改用 Concurrent::Map。（Pull Request）

  • 移除 Object#itself，因為它已在 Ruby 2.2 中實作。（Pull Request）

10.2 棄用

  • 棄用 MissingSourceFile，改用 LoadError。（commit）

  • 棄用 alias_method_chain，改用 Ruby 2.0 中引入的 Module#prepend。（Pull Request）

  • 棄用 ActiveSupport::Concurrency::Latch，改用 concurrent-ruby 中的 Concurrent::CountDownLatch。（Pull Request）

  • 棄用 number_to_human_size 的 :prefix 選項，沒有替代方案。（Pull Request）

  • 棄用 Module#qualified_const_，改用內建的 Module#const_ 方法。（Pull Request）

  • 棄用將字串傳遞給定義回呼。（Pull Request）

  • 棄用 ActiveSupport::Cache::Store#namespaced_key、ActiveSupport::Cache::MemCachedStore#escape_key 和 ActiveSupport::Cache::FileStore#key_file_path。改用 normalize_key。（Pull Request、commit）

  • 棄用 ActiveSupport::Cache::LocaleCache#set_cache_value，改用 write_cache_value。（Pull Request）

  • 棄用將參數傳遞給 assert_nothing_raised。（Pull Request）

  • 棄用 Module.local_constants，改用 Module.constants(false)。（Pull Request）

10.3 重要變更

  • 新增 #verified 和 #valid_message? 方法到 ActiveSupport::MessageVerifier。（Pull Request）

  • 變更停止回呼鏈的方式。從現在開始，停止回呼鏈的首選方法是明確地 throw(:abort)。（Pull Request）

  • 新的配置選項 config.active_support.halt_callback_chains_on_return_false，用於指定 ActiveRecord、ActiveModel 和 ActiveModel::Validations 回呼鏈是否可以透過在「before」回呼中返回 false 來停止。（Pull Request）

  • 將預設測試順序從 :sorted 變更為 :random。（commit）

  • 新增 #on_weekend?、#on_weekday?、#next_weekday、#prev_weekday 方法到 Date、Time 和 DateTime。（Pull Request、Pull Request）

  • 為 Date、Time 和 DateTime 的 #next_week 和 #prev_week 新增 same_time 選項。（Pull Request）

  • 為 Date、Time 和 DateTime 新增 #prev_day 和 #next_day 對應於 #yesterday 和 #tomorrow 的方法。（Pull Request）

  • 新增 SecureRandom.base58 用於產生隨機 base58 字串。（commit）

  • 新增 file_fixture 到 ActiveSupport::TestCase。它提供了一種簡單的機制來存取測試案例中的範例檔案。（Pull Request）

  • 在 Enumerable 和 Array 上新增 #without，以返回不包含指定元素的可列舉物件副本。（Pull Request）

  • 新增 ActiveSupport::ArrayInquirer 和 Array#inquiry。（Pull Request）

  • 新增 ActiveSupport::TimeZone#strptime，允許解析時間，就像來自給定的時區一樣。（commit）

  • 新增 Integer#positive? 和 Integer#negative? 查詢方法，與 Integer#zero? 類似。（commit）

  • 為 ActiveSupport::OrderedOptions 的 get 方法新增 bang 版本，如果值為 .blank?，則會引發 KeyError。（Pull Request）

  • 新增 Time.days_in_year 以返回給定年份的天數，如果沒有提供參數，則返回當前年份的天數。（commit）

  • 新增一個事件驅動的檔案監視器，以非同步方式偵測應用程式原始碼、路由、地區設定等的變更。（Pull Request）

  • 新增 thread_m/cattr_accessor/reader/writer 方法套件，用於宣告每個線程存在的類別和模組變數。（Pull Request）

  • 新增 Array#second_to_last 和 Array#third_to_last 方法。（Pull Request）

  • 發布 ActiveSupport::Executor 和 ActiveSupport::Reloader API，允許組件和函式庫管理並參與應用程式程式碼的執行和應用程式重新載入程序。（Pull Request）

  • ActiveSupport::Duration 現在支援 ISO8601 格式化和解析。（Pull Request）

  • 當啟用 parse_json_times 時，ActiveSupport::JSON.decode 現在支援解析 ISO8601 本地時間。（Pull Request）

  • ActiveSupport::JSON.decode 現在為日期字串返回 Date 物件。（Pull Request）

  • 新增 TaggedLogging 的功能，允許多次實例化記錄器，以便它們彼此不共享標籤。（Pull Request）

11 鳴謝

請參閱Rails 的完整貢獻者列表，了解許多花費大量時間讓 Rails 成為穩定且健全的框架的人們。向他們所有人致敬。

回到頂端