ActiveSupport::Concern 是 Rails3 做 Modularity 的一個重要的小工具。他的任務是讓管理 modules 之間的 dependencies 變得容易。

假設我們有兩個 Modules 有依存關係,module Bar 依存於 module Foo,然後有一個宿主 Host 類別希望 include Bar 的功能,我們可以這樣寫:


module Foo
   # self.included 這個函式會在 Foo 被 include 時執行
    def self.included(base)
        base.send(:do_host_something) # 對宿主做某些操作,例如增強功能等等
    end
end

module Bar
    def self.included(base)
        base.send(:do_host_something)
    end
end

class Host
  include Foo, Bar
end

這有個討厭的缺點就是,我們必須在宿主中同時 include Foo 跟 Bar,也就是要把所有依存的 modules 都 include 進來。這很糟糕啊,為什麼我們需要在 Host 裡面知道這些 modules 的依存關係呢 :/

我們希望能夠將 modules 的依存關係寫在 module 中,而宿主 Host 就只要使用就好了。所以我們試著改寫成:


module Bar
  include Foo # 因為 Bar 依存於 Foo,所以我們在這裡 include 它

  def self.included(base)
    base.send(:do_host_something)
  end

end

class Host
  include Bar # 只要 include Bar 就好,不需要知道 Bar 還依存哪些 modules
end

這樣乍看之下好像沒問題,但是卻有個嚴重的問題導致無法執行,因為 Foo 變成是由 Bar 所 include,所以對 Foo 的 self.included 來說,他的參數 base 變成了 Bar 了,所以他就沒辦法存取到宿主 Host 的任何函式及變數,do_host_something 時就會失敗。

Okay,ActiveSupport::Concern 就是來幫助解決這個難題,我們希望宿主可以不需要知道 modules 之間的 dependencies 關係。dependencies 關係寫在 module 裡面就好了。


require 'active_support/concern'

module Foo
    extend ActiveSupport::Concern
    included do
        self.send(:do_host_something)
    end
end

module Bar
    extend ActiveSupport::Concern
    include Foo # 因為 Bar 依存於 Foo,所以我們在這裡 include 它

    included do
        self.send(:do_host_something)
    end
end

class Host
  include Bar # 只要 include Bar 就好,不需要知道 Bar 還依存哪些 modules
end


如此就搞定了。One more thing,如果你有定義 module ClassMethods 和 module InstanceMethods 在裡面的話,它也會自動幫你載入到宿主裡面去,就不用自己寫 send(:include, InstanceMethods) 跟 send(:extend, ClassMethods) 了。用法舉例:



module Foo
    extend ActiveSupport::Concern
    included do
        self.send(:do_host_something)
    end

   module ClassMethods
      def bite
        # do something
      end
   end

   module InstanceMethods
      def poke
         # do something
      end
   end
end


想知道 ActiveSupport::Concern 到底怎麼實作的話,請看 /activesupport/lib/active_support/concern.rb,只有 29 行,而且 ActiveSupport::Concern 也沒有再依存其他東西了,嘿。

這次很難得臨時邀請到即將前往日本慶應大學 W3C 擔任研究員的 Kenny 來跟我們分享語意網(Semantic Web)的現況、概論與鍵連資料(Linked Data)雲,所以臨時將 #9 我的 Rails Performance & Security 講題移到 Ruby Tuesday #10。

這裡的雲指的是這張圖,其中一個圈大概是一個RDF資料庫,連結就是跨domain的RDF的連結,這個架構可以把全部的資料庫們視為一個資料庫查詢,所以我們把這整個RDF Web稱為一個雲。

語意網的技術包括有RDF+SPARQL(RDF版的SQL)+RDFa+OWL+RIF,因為時間有限,講者會跟我們分享其中的概念總論,參考資料是講者老闆(Tim Berners-Lee,WWW 發明人) 在TED 2009的演講。當然,也會分享 RDFa on Rails 實作。

報名 #9 請前往: http://registrano.com/events/ruby-tuesday-9,時間是 2010/3/9 (二)

報名 #10 請前往: http://registrano.com/events/ruby-tuesday-10,時間是 2010/3/23 (二)

Update(2010/2/28): Ruby Tuesday #9 講題更換及 #10 開催

Ruby Tuesday 聚會辦到第九次啦,這一次很難得由 Josh Moore 帶來 JRuby on the Google App Engine,終於找到人來講 JRuby 了,我特別好奇 JRuby 跟我們一般用的 MRI 到底用起來有什麼差別的地方。

另一場演講則是由我帶來 Rails Best Performance and Security Practices,這個題目從我在準備 Rails Best Practices 就肖想了,當時的重點著重在程式怎樣寫的容易擴充跟維護,所以有一些效能跟安全性的最佳實務只好忍痛割愛。這次趁與 OSSF 合作,就來準備這個題目。

時間: 2010/3/9(週二)晚上七點到九點半。

地點: 台北市 果子咖啡

報名網頁: http://registrano.com/events/ruby-tuesday-9

疑?怎麼今年的 OSDC.TW 大會沒有任何 Ruby 場次? 這是因為今年我們 Ruby Taiwan 社群決定與 OSDC.TW 並行獨立出來一整天的 Ruby 議程啦,詳細內容及報名請前往 RubyConf Taiwan 網頁。

台灣的 Ruby 社群很小,但是我們的眼界跟志向不低。這是我們第一次舉辦國際性的 Ruby 程式語言研討會,講者群中包含了來自美國、日本以及大陸的朋友,相信可以帶給我們不同的視野及經驗。一天的議程安排地非常緊湊(也許明年可以來辦兩天了),真是非常興奮又期待。

身為活動主辦人,我要特別感謝 OSDC.TW 與我們分享了會場、EvenDesign 贊助了專業的網頁設計,以及 Handlino 贊助了網域名稱費用和提供 Registrano 報名網站。如果貴單位有意願贊助這項活動,歡迎與我們聯繫(2010@rubyconf.tw)。

又要開課啦,由 中央研究院 資訊創新研究中心自由軟體鑄造場主辦的自由軟體技術分享工作坊—Ruby On Rails由淺入深課程。這是兩整天共 12hr 的上機實作課程,名額有限、完全免費。

活動名稱:自由軟體技術分享工作坊—Ruby On Rails由淺入深
活動時間:2010.02.27(六)/ 2010.02.28(日)
活動講者:ihower
報名首頁:http://whoswho.openfoundry.org/workshop.html
活動地點:台北市復興北路99號2樓 (恆逸教育訓練中心)

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 RailsUsing Bundler in Real Life 示範 Bundle 的用法

新的 Routes

由於全面導入 Rack 的關係,現在的 Route 其實也是一個 Rack middleware,實作上就是 rack-mount。新的 Route 第一眼看到就是 API 的改變了,可以參考這篇 Revamped 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_withDefault RESTful RenderingThree 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 ResourcesRails 3.0 Beta: 36 Links and Resources To Get You GoingRails 3 Reading MaterialOn the way to Rails 3 – a link list

Next Page »