Update(2010/2/22): The Rails 3 Upgrade Handbook 可以買來看。
從 Merb 和 Rails 決定合併開始,過了一年多的努力終於發佈 Beta 版啦。Rails3 最重要的人物就是總架構師 Yehuda Katz 了,整個把 Rails core 翻了好幾翻,徹底改頭換面。
Why? 我是這麼想的,DHH 一開始開發 Rails 的時候,Ruby 社群還不像現在這麼發達,所以很多事情必須自己造(連 prototype 都是為了 Rails 而造的),為了達到非常容易設定跟快速開發的理想,得包山包海什麼功能都要做,再加上有限的資源,造成了 Rails core 其實綁得很緊,基本上就是一整包給你。要修改擴充它,常常就必須 monkeypatch 一下。另一方面,對怎樣的 Ruby 程式是好程式,一開始也沒有這麼多人想清楚,例如 Rails core 充滿了 alias_method_chain,這件事情現在也被認為是比較不好的寫法。
Rails3 的時代不同了,Ruby 社群起來了。我們有標準的 Rack 介面、我們有不同的ORM甚至是 NoSQL 的儲存庫、我們有不同 JS Libary、我們有不同測試方式 RSpec、我們也有許多現成不需要自己造的新函式庫。Rails3 基本上就是這麼一個接近改掉重寫的版本,但是以重構的方式達成了這個兼容並蓄的目標:將 API 重新釐清、徹底模組化、低耦合度元件、大幅提昇效能等。具體來說,有幾個成果:
使用 Ruby 1.8.7 或 Ruby 1.9.2
1.9 的時代終於要來臨了 :) 可以複習一下我去年演講的投影片。
Dependencies 管理
本來的 config.gem 換成新的 Bundler 來管理所有用到的函式庫,使用新的 Gemfiles 格式,本來的 config.gem sucks 問題多功能有限。現在,我們真的做到可以完全不依靠系統 gems。可以參考這篇 Bundle me some Rails 和 Using Bundler in Real Life 示範 Bundle 的用法
新的 Routes
由於全面導入 Rack 的關係,現在的 Route 其實也是一個 Rack middleware,實作上就是 rack-mount。新的 Route 第一眼看到就是 API 的改變了,可以參考這篇 Revamped Routes in Rails 3 和 The Lowdown on Routes in Rails 3,不過這其實不是最重要的地方,最厲害的地方是,它參數 :to 接的端點其實是 rack 端點,而 main#home 是 MainController.action(:home) 的簡寫( 是的!! Rails3 中每個 Controller actions 全都是一個標準的 Rack app!! 超酷!!),可以看看 Yehuda 的實作說明。既然是 Rack 端點,我們就可以給它接其他 Rack app,例如 Sinatra,這一篇就示範了怎麼接 Rails 3 Routing with Rack,真是超級簡單啊。我們可以預期,會有更多有趣的 Rack middlewares 可以與 Rails 結合。
另外,我們也可以直接在 Routes 層直接辦到 redirect 和 render template,可以看看 Yehuda 的實作說明:Generic Actions in Rails 3,基本上就是簡單的 Rack middleware。
新的 Active Model
為了達到與不同 ORM 銜接的目標,Rails3 的 ActiveModel 將本來的 ActiveRecord 的個別功能抽出來成為 Module,例如 callbacks, validations, serialization, observing, dirty tracking 等。任何 Class 只要符合 ActiveModel 定義的幾個 API,再加上 include 你需要的 Module,就可以與 Rails3 接在一起了。請參閱 ActiveModel: Make Any Ruby Object Feel Like ActiveRecord。
其中 Validation 有新的 API,請參閱 validates :rails_3, :awesome => true
ActiveRecord
那 ActiveRecord 本身呢? 引入了 ARel 這套 SQL 產生工具(why Arel?),大幅採用 “method chain” 的串接用法,讓每個操作都變成了 scope。
ActiveRecord 因此也有了新的 API: Active Record Query Interface 3.0
ActionController
Responder 帶來了 respond_with,可以簡化 controller 的寫法,用法參考 Cleaner RESTful Controllers w/ respond_with、Default RESTful Rendering 和 Three reasons to love ActionController::Responder 這幾篇。這工具非常有趣,我之前甚至寫了一個 plugin respond_methods 來讓 Rails 2.x 支援這個功能。
另外,新的 Render 實作可以讓你輕易擴展,這一篇 Render Options in Rails 3 示範了怎麼做出你自己的 render :pdf。
ActionView
幾個大的改變:
1. 採用 Erubis 實作
2. 預設 XSS protection 打開,再也不用忘記加上 h 逸出了。請參考 SafeBuffers and Rails 3.0 有更多細節
3. 將所有 JavaScript helpers 改成 unobtrusive。你會發現 Rails3 的 public/javascripts 多了一個 rails.js,這就是一個 JS driver,預設是接 prototype.js,要換成 jQuery 非常簡單,只要用 jQuery 版本的 rails.js 就可以了。因此本來的一些 Ajax Helper 就被移除了,有需要的話可以在 prototype_legacy_helper plugin 找回來。
4. Helpers 預設輸出格式是 HTML 5。
說到 HTML5,我另外推薦這份閱讀材料 Dive into HTML5 以及 HTML 5 Demos and Examples。
ActionMailer
首先底層換成 Mail 這套工具了,可以參考這篇介紹。接著,受益於 Controller 的重構成果,新的 ActionMailer 終於和 Controller 繼承自同一個 AbstractController,讓 ActionMailer 的功能增加不少,也大大的 DRY 了。
新的 API 請參考 New ActionMailer API in Rails 3.0
最後它的位置改放在 app/mailers 了,放在 app/models 下實在讓人搞混啊。
ActiveSupport
之前的 ActiveSupport 有個討厭的地方是,如果你只想要用到其中的幾個功能,很不容易搞懂到底要 require 哪些東西,最後只好通通載入以求保險。新的 Rails3 把這件事情弄清楚了,你可以只載入你要的部分。
Rails Application object
為了讓一個 Process 可以跑多個 Rails app,Rails3 使用了一個 Rails Application 物件來表示一整個 Application 的所有設定,因此本來的 config/environment.rb 的功能,幾乎都搬到 config/application.rb 了。另外,Rack 的標準 config.ru 檔案也被加到了根目錄,因此要特別注意到你的 Application 名稱,這會是跟其他 Application 互動時使用的名稱,預設是目錄的名字。
新的 Rails Module
幾個常數被拿掉了,RAILS_ROOT 要改用 Rails.root、RAILS_ENV 要改用 Rails.env、RAILS_DEFAULT_LOGGER 要改用 Rails.logger 等,詳細請參閱這篇 The Rails Module (in Rails 3)。改成物件的好處是,我們就不需要做字串操作這種事情了。
新的 rails 指令
本來的 script/* 指令全部拿掉了,都改成用 rails。例如 script/console 變成 rails console (可以簡寫成 rails c)、script/generate 變成 rails generate (可以簡寫成 rails g)、script/server 變成 rails server(可以簡寫成 rails s)。使用 rails –help 可以看到完整說明。
推薦閱讀
Rails3 的閱讀資料非常多,官方的 Rails 3.0: Release Notes 是必讀。如果你從升級的方向切入,可以使用官方的升級 Plugin rails-upgrade is now an official plugin,它可以幫助你 1. 檢查需要升級的地方 2. 產生 Gemfile 3. 產生新的 routes.rb。請搭配這篇 The Path to Rails 3: Approaching the upgrade 服用。不過,嗯,現在還是不要在 Production 環境上升級比較好,畢竟很多 Plugin 還沒跟上來哩 (可以看看 Is Your Plugin Ready For Rails 3? 和 Rails Wiki 有整理哪些 Plugins OK 了)。
如果是從重新開始會容易得多,可以看 The Path to Rails 3: Greenfielding new apps with the Rails 3 beta 這篇。十分建議你有空的話,現在就可以開始玩玩看了。
如果想多了解 Rails 的架構,有幾篇文章可以看看:
最後,如果你還想找更多,英文的懶人包有:Rails 3 Resources、Rails 3.0 Beta: 36 Links and Resources To Get You Going、Rails 3 Reading Material、On the way to Rails 3 – a link list