假設我們有兩個 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 也沒有再依存其他東西了，嘿。

這裡的雲指的是這張圖，其中一個圈大概是一個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 (二)

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

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

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

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

從 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，不過這其實不是最重要的地方，最厲害的地方是，它參數 :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 的架構，有幾篇文章可以看看：

• The Path to Rails 3: Introduction (算是最簡單的一篇，可以看看)
• Rails 3 Beta is Out — A Retrospective
• Rails 3: The Great Decoupling
• Rails Edge Architecture
• Rails and Merb Merge: The Anniversary (Part 1 of 6)
• Rails and Merb Merge: Performance (Part 2 of 6)
• Rails and Merb Merge: Plugin API (Part 3 of 6)
• Rails and Merb Merge: Rails Core (Part 4 of 6)
• Rails and Merb Merge: ORM Agnosticism (Part 5 of 6)
• Rails and Merb Merge: Rack (Part 6 of 6)

最後，如果你還想找更多，英文的懶人包有：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

首先是安裝：

sudo gem install sketches

然後編輯你的 ~/.irbrc 檔案，加上：

require ’sketches’
Sketches.config :editor => ‘mate’

接著在 irb 裡面就可以：

sketch 就會打開你的編輯器，存檔之後就可以使用。
sketches 會列出曾經編輯過的記錄
name_sketch 可以命名這些記錄
save_sketch 則可以存成檔案

不過有個缺點是 local variable 區域變數是讀不到的，不過我想最常用的方式是打開編輯器寫一些類別跟函式定義 :)

如果你還是不知道這是怎麼回事，可以看看 RubyPulse 的示範。

突然想到，上課用來 live demo 似乎非常適合 :p

Ruby Tuesday 今年的第一場聚會，由 godfat 和我帶來 EventMachine 和 Distributed Ruby&Background-Processing in Rails 兩場演講。

EventMachine 是一套使用 Reactor pattern 的 event-driven I/O 函式庫，你可以在許多 Ruby networking 工具發現它的蹤跡，像是 Thin、starling、amqp、cramp 等

我的部份則是將上次在中研院的題目 Distributed Ruby and Rails 中的 Distributed Ruby 和 Background-Processing in Rails 這兩個準備比較完整的部分拿出來分享。

時間: 2010/2/9（週二）晚上七點到九點。

地點: 台北市 果子咖啡

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

• Distributed Ruby
  • DRb
  • Rinda
  • Starfish
  • MapReduce
  • MagLev VM
• Distributed Message Queues
  • Starling
  • AMQP/RabbitMQ
  • Stomp/ActiveMQ
  • beanstalkd
• Background-processing in Rails
  • script/runner
  • rake
  • cron
  • daemon
  • run_later plugin
  • spawn plugin
• Message Queues for Rails
  • ar_mailer
  • BackgroundDRb
  • workling
  • delayed_job
  • resque
• SOA for Rails
  • What’s SOA
  • Why SOA
  • Considerations
  • The tool set
• Distributed Filesystem
• Distributed database

訂出這麼大的 Agenda 範圍，自己也嚇了一跳，簡直就是差點準備不完。像是 RabbitMQ、MagLev VM、XMPP、MapReduce、SOA 等我還希望可以準備些實際的程式範例。本來預定一個小時的演講，最後也膨脹到快兩個小時才講的完。

Anyway，這是最後的投影片了，相信你也可以獲得這個領域的大局觀。之後有機會我會繼續分享更多實作經驗。

  task :blah do
    puts ENV['foo']
  end

但是，最近看到新的 API 使用中括號的用法 (也不新了，從 0.8.2 開始支援)，覺得挺有趣的：

  desc "passing 1 parameter to rake task"
  task :blah1, [:a] do |t,args|
    puts args.inspect
  end
   

執行 rake blah1[9] 會輸出 {:a=>"9"}，注意到傳進來的變數值是字串。

  desc "passing 2 parameters to rake task"
  task :blah2, [:a, :b] do |t,args|
    puts args.inspect
  end

 

執行 rake blah2[foo,bar] 會輸出 {:a=>"foo", :b=>"bar"}

如果要有預設值，可以這樣做：

  desc "passing parameters with default values to rake task"
  task :blah3, [:a, :b] do |t,args|
    args.with_defaults(:a => 'foobar', :b => 1)
    puts args.inspect
  end    

此時執行 rake blah3 則是輸出 {:a=>"foobar", :b=>1}

對了，好奇 t 是什麼? 那是 Rake::Task 物件。

DEFAULTS: &DEFAULTS
  email: no-reply@harmonyapp.com
  email_signature: |
    Regards,
    The Harmony Team

development:
  domain: harmonyapp.local
  <<: *DEFAULTS

test:
  domain: harmonyapp.com
  <<: *DEFAULTS

production:
  domain: harmonyapp.com
  <<: *DEFAULTS

然後將以下這個 Module 檔放到 lib 目錄下 (或是 config/initializers 下也可以)：

# /lib/harmony.rb
module Harmony
  # Allows accessing config variables from harmony.yml like so:
  # Harmony[:domain] => harmonyapp.com
  def self.[](key)
    unless @config
      raw_config = File.read(RAILS_ROOT + "/config/harmony.yml")
      @config = YAML.load(raw_config)[RAILS_ENV].symbolize_keys
    end
    @config[key]
  end

  def self.[]=(key, value)
    @config[key.to_sym] = value
  end
end

如此便可以讀到 Harmony[:domain] 了，依據不同 Rails 環境。

它提供了 key-value stores 標準共通的使用介面，讓你可以用相同的程式，但是可以輕易轉換底層實際使用的儲存庫，包括：

• Basic File Store
• BerkeleyDB
• CouchDB
• DataMapper
• File store for xattr
• In-memory store
• Memcache store
• Redis
• S3
• SDBM
• Tokyo
• Xattrs in a file system

它的用法其實跟 Hash API 差不多，非常容易使用。我認為最實際的用途是用在撰寫快取程式了。

因為不同環境可以輕易切換 store 的這個好處，我在 local 的 development 環境中，可以使用 In-memory store 或 File Store (前者重開 server 快取資料就會消失，後者則會留著)，不需要多裝東西就可以寫快取。更重要的是，團隊中其他人也不需要費心設定 (叫每個人都去裝 Memcached 也太辛苦了)。而在 production 正式環境中，則可以輕易設定成使用 Memcached。

我自己也用了 Moneta 介面寫了一個小程式 Headcache，提供了 get_and_set 功能：

data = Handcache.get_and_set("data-123", :expires_in => 60 ) do
                "cached-foobar"
            end

如果快取存在，就回傳快取資料；如果不存在，就執行 code block，並將最後的運算值回傳並快取起來。

如果是在 View 中搭配 partial 使用也非常簡單：

<%= Handcache.get_and_set( dom_id(@post), :expires_in => 60 ) do
               render :partial => "post"
           end %>

設定的方法則可以是：

# config/environments/development.rb
begin
  # for developer has tokyo cabinet
  Handcache = Moneta::Tyrant.new( :host => 'localhost', :port => 1978 )
rescue
  # for developer has not tokyo cabinet
  Handcache = Moneta::BasicFile.new( :path => "tmp" )
end

關於快取這件事情的學問，可以參考我之前的 Memcached 文章：一是如何清除過期的快取資料(expire)，二是注意快取 Key 的命名。