ihower { blogging }

Rails3 Beta 發佈: 重點導覽

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 可以看到完整說明。

Sketches: 在 irb 中使用文字編輯器

Sketches 是個很有趣的工具，它讓你可以在 irb 中打開你最愛的文字編輯器直接編輯，然後無需重開 irb 環境就可以使用。

首先是安裝：

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 2010 首場

Update(2010/2/10): 這場的投影片和 Distributed Ruby and Rails 那場一樣 :)

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（週二）晚上七點到九點。

地點: 台北市果子咖啡

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

Distributed Ruby and Rails

應中研院OSSF工作坊邀請，這次很有野心的挑戰這個題目，試圖涵蓋 Ruby 生態圈中，有關分散式 Ruby 程式設計和 Ruby on Rails 架構的相關內容：

Distributed Ruby and Rails

View more documents from Wen-Tien Chang.

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

使用 logrotate 定期整理 Rails Log 檔案

(2017/5) linux 日志定时轮询流程详解這篇解釋的更清楚

不像 Apache 預設已經設定好了，會定期整理成 access.log.1, access.log.2.gz, access.log.3.gz 等，如果你沒特別處理，Rails 底下的 log 檔案可是越長越肥。

這個系統工具是 logrotate，它的設定檔在 /etc/logrotate.conf，設定的方式還真是簡單 (參考自 Rotating Rails Log Files)：


# Rotate Rails application logs
/path/to/your/rails/current/log/*.log {
  daily
  dateext
  missingok
  rotate 65535
  compress
  delaycompress
  notifempty
  copytruncate
}

其中 daily 表示每天整理，也可以改成 weekly 或 monthly
dateext 表示檔案補上 rotate 的日期
missingok 表示如果找不到 log 檔也沒關係
rotate 7 表示保留65535份
compress 表示壓縮起來，預設用 gzip。不過如果硬碟空間多，不壓也沒關係。
delaycompress 表示延後壓縮直到下一次 rotate
notifempty 表示如果 log 檔是空的，就不 rotate
copytruncate 先複製 log 檔的內容後，在清空的作法，因為有些程式一定 log 在本來的檔名，例如 rails。另一種方法是 create。

設定好之後，可以等明天，或是執行 /usr/sbin/logrotate -f /etc/logrotate.conf 看看。

傳參數到 Rake 中

傳統作法是用 rake blah foo=1 這樣的指令，於是就可以透過環境變數拿到：


  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 物件。