Rails 3.0は、晩ご飯も作れば洗濯物も畳んでくれる、夢のような製品です。Rails 3.0なしで今までどうやって暮らしていけたのか、不思議で仕方がなくなるでしょう。Rails 3.0は、これまでのRailsバージョンの中でかつてない高みに到達しました。
冗談はともかく、Rails 3.0は実によい仕上がりとなりました。Merbチームが我らがRailsチームに参加したことでもたらされた素晴らしいアイデアがすべて込められています。Merbチームはフレームワークの謎に満ちた内部をスリムかつ高速化し、素敵なAPIを多数もたらしてくれました。Merb 1.xをご存じの方であれば、Rails 3.0にその成果が多数盛り込まれていることがおわかりいただけるはずです。Rails 2.xをご存じの方もきっとRails 3.0を好きになっていただけるでしょう。
多くの機能や改良APIを搭載したRails 3.0は、内部がきれいになったかどうかに関心のない方も夢中になるでしょう。Railsアプリケーション開発者にとって、かつてないほど素晴らしい時期が到来しました。その中からいくつかご紹介します。
そして何よりも、今回私たちは旧APIを非推奨化する際にできるかぎり適切なwarningを表示することを心がけました。つまり、Rails 3に移行するために、既存のアプリケーションの古いコードを今すぐ最新のベストプラクティスにすべて書き換えなくてもよいということです。
これらのリリースノートでは主要なアップグレードを取り扱いますが、細かなバグ修正や変更点については記載しませんのでご注意ください。Rails 3.0は、250人を超える人々による4,000件近いコミットを含みます。すべての変更点をチェックしたい方は、GitHub上のメインRailsリポジトリでコミットリストをご覧ください。
Rails 3のインストール方法は次のとおりです。
# セットアップで必要な場合はsudoを使います $ gem install rails
既存のアプリケーションをアップグレードするのであれば、その前に質のよいテストカバレッジを用意するのはよい考えです。アプリケーションがRails 2.3.5までアップグレードされていない場合は先にそれを完了し、アプリケーションが正常に動作することを十分確認してからRails 3にアップデートしてください。終わったら、以下の変更点にご注意ください。
Rails 3.0ではRuby 1.8.7以上が必須です。これより前のバージョンのRubyのサポートは公式に廃止されたため、速やかにRubyをアップグレードすべきです。Rails 3.0はRuby 1.9.2とも互換性があります。
Ruby 1.8.7のp248とp249には、Railsクラッシュの原因となるマーシャリングのバグがあります。なおRuby Enterprise Editionでは1.8.7-2010.02のリリースでこの問題が修正されました。現行のRuby 1.9のうち、Ruby 1.9.1はRails 3.0でセグメンテーションフォールト（segfault）で完全にダウンするため利用できません。Railsをスムーズに動かすため、Rails 3でRuby 1.9.xを使いたい場合は1.9.2をお使いください。
Rails 3では、同一プロセス内で複数のRailsアプリケーション実行をサポートするための基礎の一環として、「アプリケーションオブジェクト」という概念が導入されました。1つのアプリケーションオブジェクトには、そのアプリケーション固有の設定がすべて保持されます。しかも、この設定は従来のRailsのconfig/environment.rbと極めて似通っています。
今後、各Railsアプリケーションはそれに対応するアプリケーションオブジェクトを持たなければなりません。このアプリケーションオブジェクトはconfig/application.rbで定義されます。既存のアプリケーションをRails 3にアップグレードする場合、このconfig/application.rbを追加して、config/environment.rb内の設定を適宜そこに移動しなければなりません。
従来スクリプトの置き場に使われていたscriptディレクトリは、新しいscript/railsに置き換えられます。script/railsは直接実行するものではありませんが、Railsアプリケーションのルートディレクトリで呼び出されたことをrailsコマンドが検知して、代わりにスクリプトを実行します。望ましい用法は以下のとおりです。
$ rails console # script/consoleではない $ rails g scaffold post title:string # script/generate scaffold post title:stringではない
rails --helpを実行すればすべてのオプションを表示できます。
従来のconfig.gemを用いる方式は廃止され、bundlerとGemfileを用いる方式に置き換えられました。後述のgemに移行するを参照してください。
アップグレードプロセスを支援するために、Rails Upgradeというプラグインが自動化の一部として作成されました。
このプラグインをインストールしてrake rails:upgrade:checkを実行すれば、アプリ内でアップデートの必要な箇所をチェックできます（アップグレード方法の情報へのリンクも表示されます）。このプラグインは、config.gem呼び出しに基づいてGemfileを生成するタスクや、現在のルーティングから新しいルーティングファイルを生成するタスクも提供します。以下を実行すればプラグインを取得できます。
$ ruby script/plugin install git://github.com/rails/rails_upgrade.git
動作例については「Rails Upgradeプラグインが公式化された （英語）」で参照できます。
Rails Upgradeツール以外にも、支援が必要な場合はIRCやGoogleグループのrubyonrails-talkに自分と同じ問題に遭遇した人がおそらくいるでしょう。ぜひアップグレード作業をブログ記事にして、他の人々も知見を得られるようにしましょう。
# 'rails'というRubyGemがインストールされている必要があります。 $ rails new myapp $ cd myapp
今後のRailsでは、アプリケーションのルートディレクトリに置かれるGemfileを使って、アプリケーションの起動に必要なgemを指定するようになりました。このGemfileはBundlerというgemによって処理され、依存関係のある必要なgemをすべてインストールします。依存するgemをそのアプリケーションの中にだけインストールして、OS環境にある既存のgemに影響を与えないようにすることもできます。
詳細情報: Bundlerホームページ
BundlerとGemfileのおかげで、専用のbundleコマンド一発でRailsアプリケーションのgemを簡単に安定させることができます。Gitリポジトリから直接bundleしたい場合は--edgeフラグを追加します。
$ rails new myapp --edge
Railsアプリケーションのリポジトリをローカルにチェックアウトしたものがあり、それを使ってアプリケーションを生成したい場合は、--devフラグを追加します。
$ ruby /path/to/rails/bin/rails new myapp --dev
Railsのアーキテクチャで6つの大きな変更点が発生しました。
Railtiesが更新され、Railsフレームワーク全体で一貫したプラグインAPIを提供するようになるとともに、ジェネレータやRailsバインディングが完全に書き直されました。これによって、開発者がジェネレータやアプリケーションフレームワークのあらゆる重要なステージに統一的かつ定義済みの方法でフックをかけられるようになりました。
MerbとRailsの主要なマージ作業の１つが、Railsのコアコンポーネントの密結合を切り離すことでした。この作業が完了したことで、Railsのあらゆるコアコンポーネントが同一のAPIを使うようになりました。これらのAPIはプラグイン開発に利用できます。つまり、作成したプラグインやコアコンポーネントを置き換える（DataMapperやSequelなど）際に、Railsコアコンポーネントからアクセスできるあらゆる機能にアクセスして自由自在に拡張できるようになったということです。
詳しくは「The Great Decoupling」を参照してください。
密結合したコアコンポーネントの切り離し作業の一環として、Active Recordへの結合をAction Packから切り出しました。この作業が完了したことで、新しいORMプラグインではActive Modelインターフェイスを実装するだけでAction Packとシームレスに協調動作できるようになりました。
詳しくは「Make Any Ruby Object Feel Like ActiveRecord」を参照してください。
密結合したコアコンポーネントの切り離し作業として、基底スーパークラスを1つ作成しました。このクラスは、ビューのレンダリングなどを扱うHTTPの記法から分離されています。このAbstractControllerクラスを作成したことで、ActionControllerやActionMailerが極めてシンプルになり、これらのライブラリすべてから共通部分が切り出されてAbstract Controllerに移動しました。
詳しくは「Rails Edge Architecture」を参照してください。
Arel（Active Relationとも呼ばれます）がActive Recordの下に配置され、Railsで必須のコンポーネントになりました。Arelは、Active Recordを簡潔にするSQL抽象化を提供し、Active Recordのリレーション機能を支えます。
詳しくは「Why I wrote Arel」を参照してください。
Action Mailerは最初期からモンキーパッチやプリパーサーだらけで、配信エージェントや受信エージェントまであり、さらにソースツリーでTMailをベンダリングしているというありさまでした。Rails 3では、メールに関連するあらゆる機能をMail gemで抽象化しました。こちらでもコードの重複が著しく解消され、Action Mailerとメールパーサーの間に定義可能な境界を作成しやすくなりました。
詳しくは「New Action Mailer API in Rails 3」を参照してください。
Railsツリーのドキュメントが更新されてAPI変更がすべて反映されました。さらに、Rails EdgeガイドにもRails 3.0の変更点を順次反映中です。ただし、guides.rubyonrails.orgの本ガイドについては、安定版Railsのドキュメントのみを含みます（執筆時点では3.0がリリースされるまで2.3.5となります）。
詳しくは「Rails Documentation Projects」を参照してください。
Rails 3では国際化（I18n）のサポートに関して、速度改善が著しい最新のI18n gemなど多くの作業が行われました。
ActiveModel::TranslationやActiveModel::Validationsを含むあらゆるオブジェクトにI18nの振る舞いを追加できます。訳文のerrors.messagesフォールバック機能もあります。詳しくは「Rails 3 I18n changes」を参照してください。
主要なRailsフレームワークの分離作業に伴って、Railtiesも大規模にオーバーホールされ、フレームワーク/エンジン/プラグインをできるだけ楽に拡張できる形で連結しました。
アプリ名.bootで始まり、他のアプリケーションとのやりとりが今よりもずっと簡単になります。Rails.root/app以下に置かれるものはすべて読み込みパスに追加されるようになりました。これにより、たとえばapp/observers/user_observer.rbを作るだけで、設定変更なしでRailsが読み込んでくれます。Rails.configオブジェクトが提供されます。これは、Railsの膨大な設定オプションをすべて集約する中央リポジトリを提供します。アプリケーション生成時に、test-unit/Active Record/Prototype.js/Gitのインストールをスキップするフラグも渡せるようになりました。また、--devフラグも新たに追加されたことで、Railsを指すGemfileをチェックアウト状態でアプリをセットアップできるようになりました（これはrailsバイナリへのパスで決定されます）。詳しくはrails --helpを参照してください。
Rails 3.0のRailtiesジェネレータでは、基本的に以下のようなさまざまな注意点があります。
rails generate fooを呼び出すとgenerators/foo_generatorを探索します。Rails.root/lib/templatesにテンプレートのコピーを置くことでテンプレートをオーバーライドできるRails::Generators::TestCaseも提供される: これを用いて独自のジェネレータを作成・テストできますまた、Railtiesジェネレータで生成されるビューについてもいくつかオーバーホールが行われました。
pタグの代わりにdivタグが使われるようになった_formパーシャルを使うようになったf.submitが使われるようになった: これは、渡されるオブジェクトのステートに応じて「Create ModelName」または「Update ModelName」を返します最後に、rakeタスクもいくつかの点が拡張されました。
rake db:forwardが追加された: マイグレーションを個別またはグループにまとめてロールフォワードできますrake routes CONTROLLER=xが追加された: コントローラを1つ指定してルーティングを表示できます。Railtiesで以下が非推奨化されました。
RAILS_ROOTが非推奨化: 今後はRails.rootを使いますRAILS_ENVが非推奨化: 今後はRails.envを使いますRAILS_DEFAULT_LOGGERが非推奨化: Rails.loggerを使いますPLUGIN/rails/tasksとPLUGIN/tasksは今後どのタスクでも読み込まれなくなったので、今後はPLUGIN/lib/tasksを使わなければなりません。
詳しくは以下を参照してください。
Action Packは内部と外部ともに大きく変更されました。
Action Controllerから一般性の高い部分をAbstract Controllerに切り出して再利用可能なモジュールとし、テンプレートやパーシャルのレンダリング、ヘルパー、訳文、ログ出力など「リクエスト-レスポンス」サイクルのあらゆる要素をどのライブラリからでも利用できるようにしました。この抽象化によって、ActionMailer::BaseはAbstractControllerを継承してRails DSLをMail gemでラップするだけで済むようになりました。
Abstract Controllerを導入したことで、Action Controllerのコードをクリーンアップするよい機会となり、コードをシンプルにする部分が抽象化されました。
ただし、Abstract Controllerはユーザー（開発者）が直接使うAPIではない点にご注意ください。日々のRails開発でAbstract Controllerを使うことはありません。
詳しくは「Rails Edge Architecture」を参照してください。
application_controller.rbにprotect_from_forgeryがデフォルトで含まれるようになりました。cookie_verifier_secretは非推奨化され、今後はRails.application.config.cookie_secretで代入されます。また、これはconfig/initializers/cookie_verification_secret.rbという独自のファイルに移動しました。session_storeはActionController::Base.sessionで設定されるようになり、Rails.application.config.session_storeに移動しました。デフォルトはconfig/initializers/session_store.rbで設定されます。cookies.secureを用いて、暗号化された値をcookie.secure[:key] => valueでcookieに設定できます。cookies.permanentを用いて、恒久的な値をcookie.permanent[:key] => valueでcookieハッシュに設定できます。署名済みの値が検証に失敗すると例外がraiseされます。respond_toブロック内のformat呼び出しに、:notice => 'This is a flash message'や:alert => 'Something went wrong'を渡せるようになりました。flash[]ハッシュの動作は従来と同じです。respond_withメソッドがコントローラに追加されます。これを用いて、込み入ったformatブロックをシンプルに書けます。ActionController::Responderが追加されました。これを用いて、レスポンスを柔軟に生成できます。以下が非推奨化されました。
filter_parameter_loggingが非推奨化されました。今後はconfig.filter_parameters << :passwordをお使いください。詳しくは以下を参照してください。
Action DispatchはRails 3.0で新しく追加されました。これはルーティングの明快な実装を新たに提供します。
rack_mountとなりました。これは単独のソフトウェアです。各アプリケーションで定義されるルーティングは、以下のようにApplicationモジュール内で名前空間化されるようになりました。
# 従来 ActionController::Routing::Routes.draw do |map| map.resources :posts end # 今後はこのように書く AppName::Application.routes do resources :posts end
matchメソッドがルーターに追加され、マッチしたルーティングに任意のRackアプリケーションも渡せるようになりました。
constraintsメソッドがルーターに追加され、定義済みの制約を用いてルーターを保護できるようになりました。
scopeメソッドがルーターに追加され、以下のようにさまざまな言語（ロケール）やアクションへのルーティングを名前空間化できるようになりました。
scope 'es' do resources :projects, :path_names => { :edit => 'cambiar' }, :path => 'proyecto' end # /es/proyecto/1/cambiarでeditアクションにアクセスできる
rootメソッドがルーターに追加され、これでmatch '/', :to => pathをショートカットできるようになりました。
マッチにセグメントをオプションとして渡せるようになりました。たとえばmatch "/:controller(/:action(/:id))(.:format)"の場合、丸かっこで囲まれた各セグメントがオプションになります。
ルーティングをブロックで表現できるようになりました。controller :home { match '/:action' }のように呼び出せます。
mapコマンドの旧来の書式は、後方互換性レイヤがあることで引き続き使えます。ただし、後方互換性レイヤは3.1リリースで削除される予定です。
以下が非推奨化されました。
/:controller/:action/:idはコメントアウトされるようになりました。:path_prefixルーティングは存在しなくなりました。また、:name_prefixに渡された値の末尾に自動的に"_"が追加されるようになりました。詳しくは以下を参照してください。
Action Viewヘルパーで大規模な書き直しが行われ、Unobtrusive JavaScript（UJS）フックが実装され、旧来のインラインAJAXコマンドが削除されました。これによって、RailsでヘルパーでUJSフックを実装するときに任意のUJS準拠ドライバを利用できるようになりました。
具体的には、旧来のremote_<メソッド名>ヘルパーはRailsコアからすべて削除され、Prototype Legacy Helperに移動しました。今後UJSフックをHTML側で取得するには、以下のように:remote => trueを渡します。
form_for @post, :remote => true
上のコードから以下のHTMLが生成されます。
<form action="http://host.com" id="create-post" method="post" data-remote="true">
form_forやdiv_forなどの、ブロック内のコンテンツを挿入するヘルパーが、以下のように<%=を使うようになりました。
<%= form_for @post do |f| %> ... <% end %>
今後これと同様の自作ヘルパーは、手動で出力バッファにappendするのではなく、文字列を返すことが期待されます。
それ以外のヘルパー（cacheやcontent_forなど）は、この変更の影響を受けないため、従来同様<%が必要です。
h(string)呼び出しでエスケープする必要はもうありません。h(string)はデフォルトであらゆるビューテンプレートで有効になります。エスケープを解除した（unescaped）文字列が欲しい場合はraw(string)を呼び出します。f.label :nameとすると:nameの訳文を取り出します。:en.support.selectではなく:en.helpers.selectと記述すべきです。grouped_collection_selectヘルパーが追加されました。content_for?が追加されました。これはレンダリング前のビューにコンテンツが存在するかどうかをチェックします。:value => nilをフォームヘルパーに渡すと、デフォルト値を使わずにフィールドのvalue属性をnilに設定できます。:id => nilをフォームヘルパーに渡すと、フィールドがid属性なしでレンダリングされます。image_tagに:alt => nilを渡すと、imgタグがalt属性なしでレンダリングされます。Rails 3.0で新たにActive Modelが導入されました。Active Modelは任意のORMライブラリを抽象化するレイヤを提供し、Active Modelインターフェイスを実装してRailsとやり取りするのに用います。
コアコンポーネント分離作業の１つは、Active Recordへの結合をAction Packからすべて切り出すことでした。この作業が完了したことで、新しいORMプラグインはすべて、Active Modelインターフェイスを実装するだけでAction Packとシームレスにやりとりできるようになりました。
詳しくはMake Any Ruby Object Feel Like ActiveRecordを参照してください。
バリデーションがActive RecordからActive Modelに移動し、Rail 3のさまざまなORMライブラリで使えるバリデーションのインターフェイスを提供するようになりました。
validates :attribute, options_hashショートカットメソッドができました。これによって、あらゆるクラスメソッドのバリデーションに用いるオプションを渡せるようになり、1つのバリデーションメソッドに複数のオプションを渡せるようになりました。
validatesメソッドのオプションは以下のとおりです。
:acceptance => Boolean:confirmation => Boolean:exclusion => { :in => Enumerable }:inclusion => { :in => Enumerable }:format => { :with => Regexp, :on => :create }:length => { :maximum => Fixnum }:numericality => Boolean:presence => Boolean:uniqueness => BooleanRails 2.3スタイルのバリデーションメソッドはRails 3.0でも引き続きサポートされます。この新しいバリデーションメソッドの設計はモデルに新たなバリデーションを追加するためのものであり、既存APIを置き換えるものではありません。
バリデータオブジェクトを1つ渡すこともできます。バリデータオブジェクトは、Active Modelを利用するオブジェクト間で再利用できます。
class TitleValidator < ActiveModel::EachValidator Titles = ['Mr.', 'Mrs.', 'Dr.'] def validate_each(record, attribute, value) unless Titles.include?(value) record.errors[attribute] << 'must be a valid title' end end end
class Person include ActiveModel::Validations attr_accessor :title validates :title, :presence => true, :title => true end # Active Recordで用いる場合 class Person < ActiveRecord::Base validates :title, :presence => true, :title => true end
以下のようなintrospectionもサポートします。
User.validators User.validators_on(:login)
詳しくは以下を参照してください。
Rails 3.0ではActive Recordについて集中的な作業が行われました。Active Modelへの抽象化、Arelによるクエリインターフェイスの全面的な更新、バリデーションの更新を含む多くの拡張や修正が行われました。Rail 2.x APIはすべて互換性レイヤを介して利用可能になっており、この互換性レイヤは3.1までサポートされます。
Active Recordのコアメソッド群が、Arelを用いて自身のリレーションを返すようになりました。Rails 2.3.xの既存のAPIは引き続きサポートされ、Rails 3.1までは非推奨化されず、Rails 3.2までは削除されません。ただし新しいAPIでは、以下の新しいメソッド群が提供され、どのメソッドも互いにチェーン可能なリレーションを返します。
where: 何を返すかという条件をリレーションに提供します。select: モデルのどの属性をデータベースから返したいかを選択します。group: 提供された属性のリレーションをグループ化します。having: リレーションのグループ化を制約する式（GROUP BY制約）を提供します。joins: リレーションを別のテーブルに結合（join）します。clause: リレーションのjoinを制約する式（JOIN制約）を提供します。includes: プリロードされた他のリレーションをインクルードします。order: 提供された式に基づいてリレーションの並び順（order）を指定します。limit: リレーションのレコード数を、指定の上限値に制限します（limit）。lock: テーブルから返されたレコードをロックします。readonly: データのコピーをリードオンリーにしたものを返します。from: リレーションシップを複数のテーブルのどれから選択するかを指定します。scope（旧named_scope）: リレーションを返し、他のリレーションメソッドと互いにチェーンできるようにします。with_scopeとwith_exclusive_scopeもリレーションを返すようになったことでチェーン可能になりました。default_scopeもリレーションで使えるようになりました。詳しくは以下を参照してください。
:destroyed?がActive Recordオブジェクトに追加されました。:inverse_ofActive Record関連付け（association）に追加され、読み込み済みの関連付けのインスタンスを、データベースにアクセスせずに取れるようになりました。Active Recordブランチでは他にも多数の修正が行われました。
TIME ZONEサポートが修正され、誤った値が挿入されないようになったtable_nameがキャッシュされるようになった以下の非推奨化も行われました。
named_scopeが非推奨化され、シンプルなscopeにリネームされたscopeメソッドでは、従来の:conditions => {}ではなく今後リレーションメソッドを使うべき（例: scope :since, lambda {|time| where("created_at > ?", time) }）save(false)が非推奨化され、今後はsave(:validate => false)に:en.activerecord.errors.templateから今後:en.errors.templateに変更すべきmodel.errors.onが非推奨化され、今後はmodel.errors[]にvalidates_presence_of => validatesは今後:presence => trueにActiveRecord::Base.colorize_loggingとconfig.active_record.colorize_loggingが非推奨化され、今後はそれぞれRails::LogSubscriber.colorize_loggingやconfig.colorize_loggingに数か月前にActive Recordのedge版にState Machineが実装されていましたが、Rails 3.0リリースからは削除されました。
Active ResourceもActive Modelに切り出されたことで、Action PackでActive Resourceオブジェクトをシームレスに利用できるようになりました。
first、last、allを追加find_everyで何も返されなかった場合にResourceNotFoundを返さないようになったsave!を追加（オブジェクトがvalid?でなければResourceInvalidをraiseする）update_attributeとupdate_attributesをActive Resourceモデルに追加exists?を追加SchemaDefinitionをSchemaにリネーム、define_schemaをschemaにリネームcontent-typeではなくActive Resourcesのformatを用いるようになったinstance_evalを用いるようになったActiveResource::ConnectionError#to_sを修正（@responseが#codeや#messageに応答しない場合にRuby 1.9互換になるようにする）loadが数値の配列でも使えるようになったNet::HTTP open_timeoutにも効くようになった以下は非推奨化されました。
save(false)が非推奨化され、今後はsave(:validate => false)にURI.parseと.decodeが非推奨化され、今後はライブラリで使われなくなったActive Supportの必要な機能だけを利用できるよう、多くの作業が行われました。これにより、Active Supportライブラリの一部の機能だけを使うために全体をrequireする必要がなくなりました。これにより、Railsのさまざまなコアコンポーネントがスリム化できるようになります。
Active Supportの主な変更点は以下のとおりです。
bundle installコマンドでインストールされます。ActiveSupport::SafeBufferに安全なバッファが実装されたArray.uniq_byとArray.uniq_by!を追加Array#randを削除し、Ruby 1.9からArray#sampleをバックポートしたTimeZone.seconds_to_utc_offsetが誤った値を返すバグを修正したActiveSupport::Notificationsミドルウェアを追加ActiveSupport.use_standard_json_time_formatのデフォルトがtrueになったActiveSupport.escape_html_entities_in_jsonのデフォルトがfalseになったInteger#multiple_of?がゼロを引数として受け取れるようになり、レシーバーがゼロでない場合にfalseを返すようになったstring.charsがstring.mb_charsにリネームされたActiveSupport::OrderedHashがYAMLでデシリアライズできるようになったObject#presenceを追加（#present?の場合はオブジェクトを、それ以外の場合はnilを返す）String#exclude?コア拡張を追加（#include?と逆の結果を返す）DateTime属性を持つモデルでto_yamlが正しく動作するために、to_iをActiveSupportのDateTimeに追加Enumerable#exclude?を追加（if !x.include?という書き方を避けるためEnumerable#include?と逆の結果を返す）ActiveSupport::HashWithIndifferentAccessのdeepマージをサポートEnumerable#sumがあらゆるenumerableで動作するようになった（:sizeに応答しない場合でも利用可能）inspectすると空文字列ではなく'0 seconds'が返るようになったelementとcollectionをModelNameに追加String#to_timeやString#to_datetimeで分数形式の秒を扱うようになった:beforeや:afterの両方に応答するaroundフィルタオブジェクトのコールバックを新たにサポートしたActiveSupport::OrderedHash#to_aメソッドが返す配列セットがソート済みになった（Ruby 1.9のHash#to_aと一致）MissingSourceFileは定数として存在するがLoadErrorと等価になったClass#class_attributeを追加（値を継承可能でサブクラスから上書きできるクラスレベルの属性を宣言できる）ActiveRecord::AssociationsのDeprecatedCallbacksがついに削除されたObject#metaclassがKernel#singleton_classになりRubyと一致するようになった以下のメソッドはRuby 1.8.7と1.9で利用できるようになったため削除されました。
Integer#even?とInteger#odd?
String#each_charString#start_with?とString#end_with?（三人称のエイリアスは保持）String#bytesizeObject#tapSymbol#to_procObject#instance_variable_defined?Enumerable#none?REXMLのセキュリティパッチは、初期パッチレベルのRuby 1.8.7で必要なため引き続きActive Supportに置かれています。適用が必要かどうかはActive Supportで認識されます。
以下のメソッドはフレームワークで今後使われないため削除されました。
Kernel#daemonizeObject#remove_subclasses_of、Object#extend_with_included_modules_from、Object#extended_by
Class#remove_classRegexp#number_of_captures、Regexp.unoptionalize、Regexp.optionalize、Regexp#number_of_captures
Action Mailerで、メールライブラリとしてTMailに代えて新たにMailに置き換えられた新しいAPIが提供されました。Action Mailer自身はほぼ完全に書き換えられ、多くのコードに手が入れられました。その結果Action MailerはAbstract Controllerをシンプルに継承するようになり、Rails DSLでMail gemをラップするようになりました。これにより、Action Mailer内の他のライブラリとのコード量や重複が著しく削減されました。
app/mailersに置かれるようになったattachments、headers、mail）でメールを送信できるようになったattachments.inlineメソッドを用いてインライン添付ファイルをネイティブでサポートするようになったMail::Messageオブジェクトを返すようになり、deliverメッセージを送信することで自分自身を送信できるようになったmail配信メソッドが、有効なメールヘッダーのハッシュ（それらの値ペアを含む）を受け取れるようになったmail配信メソッドがAction Controllerのrespond_toと似た振る舞いになり、テンプレートを明示的または暗黙的にレンダリングできるようになった（Action Mailerはメールを必要に応じてマルチパートメールにする）mailのブロック内でformat.mime_type呼び出しにprocを1つ渡すことで、特定の種類のテキストを明示的にレンダリングしたり、レイアウトや別のテンプレートを追加したりできるようになった。そのproc内のrender呼び出しはAbstract Controllerのもので、同じオプションをサポートする。以下は非推奨化されました。
:charset、:content_type、:mime_version、:implicit_parts_orderはすべて非推奨化され、今後はActionMailer.default :key => value方式の宣言になったcreate_method_nameやdeliver_method_nameが非推奨化された: 今後は単にmethod_nameを呼ぶこと（Mail::Messageオブジェクトが1つ返る）ActionMailer.deliver(message)が非推奨化された: 今後は単にmessage.deliverを呼ぶことtemplate_rootが非推奨化された: 今後はmail生成ブロック内のformat.mime_typeメソッドからのproc内でrender呼び出しにオプションを渡すことbodyメソッド（body {:ivar => value}）が非推奨化された: 今後はインスタンス変数をメソッド内で直接宣言するだけでビューで利用できるようになるapp/modelsに配置することが非推奨化された: 今後はapp/mailersを使うこと詳しくは以下を参照してください。
Rails3を頑丈かつ安定したフレームワークにするために多大な時間を費やしてくださった多くの開発者については、Railsコントリビューターの完全なリストを参照してください。これらの方々全員に敬意を表明いたします。
Rails 3.0リリースノート編集担当: Mikel Lindsaar
Railsガイドは GitHub の yasslab/railsguides.jp で管理・公開されております。本ガイドを読んで気になる文章や間違ったコードを見かけたら、気軽に Pull Request を出して頂けると嬉しいです。Pull Request の送り方については GitHub の README をご参照ください。
原著における間違いを見つけたら『Rails のドキュメントに貢献する』を参考にしながらぜひ Rails コミュニティに貢献してみてください 🛠💨✨
本ガイドの品質向上に向けて、皆さまのご協力が得られれば嬉しいです。
Railsガイド運営チーム (@RailsGuidesJP)
Railsガイドは下記の協賛企業から継続的な支援を受けています。支援・協賛にご興味あれば協賛プランからお問い合わせいただけると嬉しいです。
