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アプリケーションのリポジトリをローカルにチェックアウトしたものがあり、それを使ってアプリケーションを生成したい場合は、--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など多くの作業が行われました。
- あらゆるオブジェクトでのI18n:
ActiveModel::TranslationやActiveModel::Validationsを含むあらゆるオブジェクトにI18nの振る舞いを追加できます。訳文のerrors.messagesフォールバック機能もあります。
- 属性にデフォルトの訳文を与えられます。
- フォームのsubmitタグが、オブジェクトのステータスに応じて自動的に正しいステータス（CreateまたはUpdate）を取れるようになったことで、正しい訳文も取れるようになりました。
- I18n化されたラベルに属性名を渡すだけで使えるようになりました。
詳しくは「Rails 3 I18n changes」を参照してください。
主要なRailsフレームワークの分離作業に伴って、Railtiesも大規模にオーバーホールされ、フレームワーク/エンジン/プラグインをできるだけ楽に拡張できる形で連結しました。
- アプリケーションごとに独自の名前空間が与えられます。アプリケーションはたとえば
アプリ名.bootで始まり、他のアプリケーションとのやりとりが今よりもずっと簡単になります。
-
Rails.root/app以下に置かれるものはすべて読み込みパスに追加されるようになりました。これにより、たとえばapp/observers/user_observer.rbを作るだけで、設定変更なしでRailsが読み込んでくれます。
- Rails 3.0では
Rails.configオブジェクトが提供されます。これは、Railsの膨大な設定オプションをすべて集約する中央リポジトリを提供します。
アプリケーション生成時に、test-unit/Active Record/Prototype.js/Gitのインストールをスキップするフラグも渡せるようになりました。また、--devフラグも新たに追加されたことで、Railsを指すGemfileをチェックアウト状態でアプリをセットアップできるようになりました（これはrailsバイナリへのパスで決定されます）。詳しくはrails --helpを参照してください。
Rails 3.0のRailtiesジェネレータでは、基本的に以下のようなさまざまな注意点があります。
- ジェネレータが完全に書き直されたことで後方互換性が失われた
- RailsテンプレートAPIとジェネレータAPIがマージされた: 利用上は従来と同じです
- ジェネレータは特殊なパスからの読み込みを行わなくなった: 今後はRubyの読み込みパスのみを探索しますので、
rails generate fooを呼び出すとgenerators/foo_generatorを探索します。
- 新しいジェネレータではフックが提供される: あらゆるテンプレートエンジン/ORM/テストフレームワークを簡単にフックインできます
- 新しいジェネレータでは、
Rails.root/lib/templatesにテンプレートのコピーを置くことでテンプレートをオーバーライドできる
-
Rails::Generators::TestCaseも提供される: これを用いて独自のジェネレータを作成・テストできます
また、Railtiesジェネレータで生成されるビューについてもいくつかオーバーホールが行われました。
- ビューで
pタグの代わりにdivタグが使われるようになった
- scaffoldジェネレータで、editビューとnewビューの重複コードの代わりに
_formパーシャルを使うようになった
- scaffoldフォームで
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で新しく追加されました。これはルーティングの明快な実装を新たに提供します。
- ルーターが大々的に書き直されてクリーンアップされたことで、RailsのルーターがRails DSLを持つ
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リリースで削除される予定です。
以下が非推奨化されました。
- 非RESTアプリケーションですべてのルーティングをキャッチする
/: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など）は、この変更の影響を受けないため、従来同様<%が必要です。
- HTML出力を
h(string)呼び出しでエスケープする必要はもうありません。h(string)はデフォルトであらゆるビューテンプレートで有効になります。エスケープを解除した（unescaped）文字列が欲しい場合はraw(string)を呼び出します。
- ヘルパーがデフォルトでHTML5を出力するようになりました。
- フォームラベルヘルパーが、単一の値を元にI18nの複数の値を取り出せるようになりました。つまり、
f.label :nameとすると:nameの訳文を取り出します。
- I18nのselectラベルは、今後
:en.support.selectではなく:en.helpers.selectと記述すべきです。
- ERBテンプレート内の式展開でHTML出力末尾のCR文字を除去するために置かれていたマイナス記号は、今後不要です。
- Action Viewに
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 => Boolean
Rails 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ブランチでは他にも多数の修正が行われました。
- SQLite2のサポートが終了し、SQLite3がサポート対象になった
- MySQLのカラム順をサポート
- PostgreSQLアダプタの
TIME ZONEサポートが修正され、誤った値が挿入されないようになった
- PostgreSQLテーブル名で複数のスキーマをサポート
- PostgreSQLでXMLデータ型カラムをサポート
-
table_nameがキャッシュされるようになった
- Oracleアダプタで多くの作業が行われ、バグも多数修正された
以下の非推奨化も行われました。
- Active Recordクラスの
named_scopeが非推奨化され、シンプルなscopeにリネームされた
-
scopeメソッドでは、従来の:conditions => {}ではなく今後リレーションメソッドを使うべき（例: scope :since, lambda {|time| where("created_at > ?", time) }）
-
save(false)が非推奨化され、今後はsave(:validate => false)に
- Active RecordのI18nエラーメッセージは
: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オブジェクトをシームレスに利用できるようになりました。
- Active Modelで使えるバリデーションを追加
- observer用フックを追加
- HTTPプロキシのサポート
- ダイジェスト認証のサポートを追加
- モデルの命名をActive Modelに移動
- Active Resource属性をHashWithIndifferentAccessに変更
- findスコープと同等なエイリアス
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互換になるようにする）
- JSONフォーマットのエラーをサポート
-
loadが数値の配列でも使えるようになった
- リモートリソースの410レスポンスを、リソースが削除されたと認識するようになった
- Active Resource接続にSSLオプションを設定する機能を追加
- コネクションのタイムアウト設定が
Net::HTTPのopen_timeoutにも効くようになった
以下は非推奨化されました。
-
save(false)が非推奨化され、今後はsave(:validate => false)に
- Ruby 1.9.2:
URI.parseと.decodeが非推奨化され、今後はライブラリで使われなくなった
Active Supportの必要な機能だけを利用できるよう、多くの作業が行われました。これにより、Active Supportライブラリの一部の機能だけを使うために全体をrequireする必要がなくなりました。これにより、Railsのさまざまなコアコンポーネントがスリム化できるようになります。
Active Supportの主な変更点は以下のとおりです。
- ライブラリをクリーンアップし、不要なメソッドを徹底的に削除しました。
- Active SupportでTZInfoやMemcache ClientやBuilderのベンダリングバージョンの提供が終了しました。今後これらはすべて依存ライブラリに含まれ、
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でデシリアライズできるようになった
- XmlMini用のSaxベースのパーサーを追加（LibXMLとNokogiriを利用）
-
Object#presenceを追加（#present?の場合はオブジェクトを、それ以外の場合はnilを返す）
-
String#exclude?コア拡張を追加（#include?と逆の結果を返す）
-
DateTime属性を持つモデルでto_yamlが正しく動作するために、to_iをActiveSupportのDateTimeに追加
-
Enumerable#exclude?を追加（if !x.include?という書き方を避けるためEnumerable#include?と逆の結果を返す）
- RailsのXSS（クロスサイトスクリプティング）のエスケープがデフォルトでオンになった
-
ActiveSupport::HashWithIndifferentAccessのdeepマージをサポート
-
Enumerable#sumがあらゆるenumerableで動作するようになった（:sizeに応答しない場合でも利用可能）
- 長さゼロのdurationを
inspectすると空文字列ではなく'0 seconds'が返るようになった
-
elementとcollectionをModelNameに追加
-
String#to_timeやString#to_datetimeで分数形式の秒を扱うようになった
- beforeコールバックやafterコールバックで
: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_char-
String#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#daemonize-
Object#remove_subclasses_of、Object#extend_with_included_modules_from、Object#extended_by
Class#remove_class-
Regexp#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に置かれるようになった
- 新しいAPIを用いて3とおりの方法（
attachments、headers、mail）でメールを送信できるようになった
- Action Mailerが
attachments.inlineメソッドを用いてインライン添付ファイルをネイティブでサポートするようになった
- Action Mailerのメール送信メソッドが
Mail::Messageオブジェクトを返すようになり、deliverメッセージを送信することで自分自身を送信できるようになった
- 配信メソッドがすべてMail gemに抽象化された
-
mail配信メソッドが、有効なメールヘッダーのハッシュ（それらの値ペアを含む）を受け取れるようになった
-
mail配信メソッドがAction Controllerのrespond_toと似た振る舞いになり、テンプレートを明示的または暗黙的にレンダリングできるようになった（Action Mailerはメールを必要に応じてマルチパートメールにする）
-
mailのブロック内でformat.mime_type呼び出しにprocを1つ渡すことで、特定の種類のテキストを明示的にレンダリングしたり、レイアウトや別のテンプレートを追加したりできるようになった。そのproc内のrender呼び出しはAbstract Controllerのもので、同じオプションをサポートする。
- メーラーの単体テスト項目が機能テストに移動した
- Action Mailerがヘッダーフィールドや本文（body）の自動エンコーディングをMail gemに委譲した
- Action Mailerがメールの本文やヘッダーを自動エンコードするようになった
以下は非推奨化されました。
-
: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
🖋 GitHubで編集を提案する
/
📕 英語で読む
Railsガイドは GitHub の yasslab/railsguides.jp で管理・公開されております。本ガイドを読んで気になる文章や間違ったコードを見かけたら、気軽に Pull Request を出して頂けると嬉しいです。Pull Request の送り方については GitHub の README をご参照ください。
原著における間違いを見つけたら『Rails のドキュメントに貢献する』を参考にしながらぜひ Rails コミュニティに貢献してみてください 🛠💨✨
本ガイドの品質向上に向けて、皆さまのご協力が得られれば嬉しいです。
Railsガイド運営チーム (@RailsGuidesJP)
Railsガイドは下記の協賛企業から継続的な支援を受けています。支援・協賛にご興味あれば協賛プランからお問い合わせいただけると嬉しいです。
- Star
-
-
