Ruby on Rails 2.3 リリースノート

1 アプリケーションアーキテクチャ

Railsアプリケーションのアーキテクチャには2つの主要な変更があります：Rackモジュラーウェブサーバーインターフェースの完全な統合と、Rails Engineへのサポートの再開です。

RailsはCGIの過去から脱却し、Rackをすべてで使用するようになりました。これにより、内部の変更が非常に多く必要とされました（ただし、CGIを使用している場合は心配しないでください。Railsはプロキシインターフェースを介してCGIをサポートしています）。それにもかかわらず、これはRailsの内部における大きな変更です。2.3にアップグレードした後は、ローカル環境と本番環境でテストする必要があります。テストする項目は以下の通りです：

セッション
クッキー
ファイルのアップロード
JSON/XML API

以下は、Rackに関連する変更の概要です：

script/serverはRackを使用するように切り替えられました。これにより、任意のRack互換サーバーをサポートします。script/serverは、rackupの設定ファイルが存在する場合にもそれを使用します。デフォルトでは、config.ruファイルを探しますが、-cスイッチでこれをオーバーライドできます。
FCGIハンドラはRackを介して処理されます。
ActionController::Dispatcherは独自のデフォルトミドルウェアスタックを維持します。ミドルウェアは挿入、並べ替え、削除ができます。スタックは起動時にチェーンにコンパイルされます。ミドルウェアスタックはenvironment.rbで設定できます。
rake middlewareタスクが追加され、ミドルウェアスタックを検査できます。ミドルウェアスタックの順序をデバッグするのに便利です。
統合テストランナーは、ミドルウェアとアプリケーションスタック全体を実行するように変更されました。これにより、統合テストはRackミドルウェアのテストに最適です。
ActionController::CGIHandlerは、Rackに対応した古いCGIオブジェクトを受け取り、環境情報を変換するための後方互換のCGIラッパーです。
CgiRequestおよびCgiResponseは削除されました。
セッションストアは遅延ロードされるようになりました。リクエスト中にセッションオブジェクトにアクセスしない場合、セッションデータをロードしません（クッキーの解析、メモリキャッシュからのデータの読み込み、Active Recordオブジェクトの検索など）。
クッキーの値を設定するためにテストでCGI::Cookie.newを使用する必要はもはやありません。request.cookies["foo"]にString値を割り当てると、期待どおりにクッキーが設定されます。
CGI::Session::CookieStoreはActionController::Session::CookieStoreに置き換えられました。
CGI::Session::MemCacheStoreはActionController::Session::MemCacheStoreに置き換えられました。
CGI::Session::ActiveRecordStoreはActiveRecord::SessionStoreに置き換えられました。
ActionController::Base.session_store = :active_record_storeを使用してセッションストアを変更することは引き続き可能です。
デフォルトのセッションオプションは、ActionController::Base.session = { :key => "..." }で設定します。ただし、:session_domainオプションは:domainに名前が変更されました。
通常リクエスト全体をラップしていたミューテックスは、ミドルウェアでラップされるようになりました（ActionController::Lock）。
ActionController::AbstractRequestおよびActionController::Requestが統合されました。新しいActionController::RequestはRack::Requestを継承しています。これはテストリクエストでのresponse.headers['type']へのアクセスに影響します。代わりにresponse.content_typeを使用してください。
ActiveRecord::QueryCacheミドルウェアは、ActiveRecordがロードされている場合、自動的にミドルウェアスタックに挿入されます。このミドルウェアは、リクエストごとのActive Recordクエリキャッシュを設定およびフラッシュします。
RailsのルーターとコントローラークラスはRackの仕様に従います。SomeController.call(env)のようにコントローラーを直接呼び出すことができます。ルーターはルーティングパラメータをrack.routing_argsに格納します。
ActionController::RequestはRack::Requestを継承します。
config.action_controller.session = { :session_key => 'foo', ...の代わりにconfig.action_controller.session = { :key => 'foo', ...を使用してください。
ParamsParserミドルウェアを使用すると、XML、JSON、またはYAMLリクエストを事前処理して、その後の任意のRack::Requestオブジェクトで通常通り読み取ることができます。

1.2 Rails Engineへの再度のサポート

アップグレードがないバージョンがいくつかあった後、Rails 2.3ではRails Engine（他のアプリケーションに埋め込むことができるRailsアプリケーション）のいくつかの新機能が提供されます。まず、エンジン内のルーティングファイルは、routes.rbファイルと同様に自動的にロードおよびリロードされるようになりました（これは他のプラグインのルーティングファイルにも適用されます）。また、プラグインにappフォルダーがある場合、app/[models|controllers|helpers]が自動的にRailsのロードパスに追加されます。エンジンはまた、ビューパスを追加することもサポートしており、Action MailerおよびAction Viewはエンジンや他のプラグインのビューを使用します。

2 ドキュメンテーション

Ruby on Railsガイドプロジェクトは、Rails 2.3向けにいくつかの追加ガイドを公開しています。さらに、別のサイトでは、Edge Railsのガイドの最新版が保持されています。その他のドキュメンテーションの取り組みには、Rails wikiの再開と、Rails Bookの早期計画が含まれます。

詳細はこちら：Railsドキュメンテーションプロジェクト

3 Ruby 1.9.1のサポート

Rails 2.3は、Ruby 1.8または現在リリースされているRuby 1.9.1で実行している場合、自身のテストをすべてパスするはずです。ただし、1.9.1に移行すると、データアダプタ、プラグイン、およびその他のコードがRuby 1.9.1とRailsコアの互換性を持つかどうかを確認する必要があります。

4 Active Record

Active Recordには、Rails 2.3で多くの新機能とバグ修正があります。ハイライトには、ネストした属性、ネストしたトランザクション、動的およびデフォルトのスコープ、およびバッチ処理が含まれます。

4.1 ネストした属性

Active Recordは、指定した場合にネストしたモデルの属性を直接更新できるようになりました。

class Book < ActiveRecord::Base
  has_one :author
  has_many :pages

  accepts_nested_attributes_for :author, :pages
end

ネストした属性を有効にすると、レコードと関連する子レコードの自動（およびアトミックな）保存、子レコードに対するバリデーション、およびネストしたフォームのサポートが可能になります（後述）。

また、ネストした属性を使用して追加される新しいレコードに対して要件を指定することもできます。これは、:reject_ifオプションを使用して行います。

accepts_nested_attributes_for :author,
  :reject_if => proc { |attributes| attributes['name'].blank? }

主な貢献者：Eloy Duran
詳細はこちら：Nested Model Forms

4.2 ネストしたトランザクション

Active Recordは、要望の多かったネストしたトランザクションをサポートするようになりました。以下のようなコードを書くことができます。

User.transaction do
  User.create(:username => 'Admin')
  User.transaction(:requires_new => true) do
    User.create(:username => 'Regular')
    raise ActiveRecord::Rollback
  end
end

User.find(:all)  # => Adminのみが返されます

ネストしたトランザクションを使用すると、内部のトランザクションをロールバックすることなく、外部のトランザクションの状態に影響を与えることができます。トランザクションをネストする場合は、明示的にrequires_newオプションを追加する必要があります。そうしないと、ネストしたトランザクションは単に親トランザクションの一部となります（Rails 2.2では現在のようになります）。内部では、ネストしたトランザクションはセーブポイントを使用しているため、真のネストしたトランザクションを持たないデータベースでもサポートされます。また、テスト中のトランザクションフィクスチャとの互換性を確保するために、これらのトランザクションがうまく機能するようにするためのいくつかのマジックもあります。

主な貢献者：Jonathan VineyおよびHongli Lai

4.3 動的スコープ

Railsの動的ファインダ（find_by_color_and_flavorのようなメソッドを動的に作成できる）や名前付きスコープ（currently_activeのような再利用可能なクエリ条件をフレンドリーな名前にカプセル化できる）については既に知っていると思います。さらに、動的スコープメソッドを使用することもできます。アイデアは、フィルタリングとメソッドチェーンの両方を可能にする構文を組み合わせることです。例えば：

Order.scoped_by_customer_id(12)
Order.scoped_by_customer_id(12).find(:all,
  :conditions => "status = 'open'")
Order.scoped_by_customer_id(12).scoped_by_status("open")

動的スコープを使用するためには、特に定義する必要はありません。ただ動作するだけです。

主な貢献者：Yaroslav Markin
詳細はこちら：What's New in Edge Rails: Dynamic Scope Methods

4.4 デフォルトスコープ

Rails 2.3では、名前付きスコープやモデル内のすべての名前付きスコープまたは検索メソッドに適用される「デフォルトスコープ」という概念が導入されます。例えば、default_scope :order => 'name ASC'と書くと、そのモデルからレコードを取得するたびに名前でソートされた状態で取得されます（オプションを上書きしない限り）。

主な貢献者：Paweł Kondzior
詳細はこちら：What's New in Edge Rails: Default Scoping

4.5 バッチ処理

find_in_batchesを使用することで、Active Recordモデルから大量のレコードをメモリに対して少ない圧力で処理することができます。

Customer.find_in_batches(:conditions => {:active => true}) do |customer_group|
  customer_group.each { |customer| customer.update_account_balance! }
end

find_in_batchesにはほとんどのfindオプションを渡すことができます。ただし、レコードの返される順序を指定することはできません（常にプライマリキーの昇順で返されます。プライマリキーは整数である必要があります）、またlimitオプションを使用することもできません。代わりに、各バッチで返されるレコード数を設定するためにbatch_sizeオプションを使用します。デフォルトでは、バッチごとに1000レコードが返されます。

新しいfind_eachメソッドは、個々のレコードを返すfind_in_batchesのラッパーを提供します。デフォルトでは、バッチで検索が行われます（デフォルトでは1000レコード）。

Customer.find_each do |customer|
  customer.update_account_balance!
end

このメソッドはバッチ処理にのみ使用するようにしてください。少数のレコード（1000未満）の場合は、通常の検索メソッドを使用して独自のループを作成してください。

追加情報（この時点では便利なメソッドは単に each と呼ばれていました）：
- Rails 2.3: バッチ検索
- Edge Railsの新機能：バッチ検索

4.6 コールバックの複数条件

Active Recordのコールバックを使用する際に、同じコールバックに :if と :unless オプションを組み合わせ、複数の条件を配列として指定することができます。

before_save :update_credit_rating, :if => :active,
  :unless => [:admin, :cash_only]

主な貢献者：L. Caviola

4.7 havingを使用した検索

Railsには、グループ化された検索のレコードをフィルタリングするための :having オプションがあります（has_many および has_and_belongs_to_many の関連付けでも使用できます）。SQLの経験が豊富な方にはおなじみのように、これによりグループ化された結果に基づいてフィルタリングすることができます。

developers = Developer.find(:all, :group => "salary",
  :having => "sum(salary) > 10000", :select => "salary")

主な貢献者：Emilio Tagua

4.8 MySQL接続の再接続

MySQLは、接続に再接続フラグをサポートしています。これがtrueに設定されている場合、クライアントは接続が失われた場合にサーバーに再接続を試みます。Railsアプリケーションからこの動作を得るために、database.yml のMySQL接続に reconnect = true を設定することができます。デフォルトは false なので、既存のアプリケーションの動作は変わりません。

主な貢献者：Dov Murik
追加情報：
- 自動再接続の制御
- MySQL auto-reconnect revisited

4.9 その他のActive Recordの変更

has_and_belongs_to_many のプリロード時に生成されるSQLから余分な AS が削除され、一部のデータベースでの動作が改善されました。
ActiveRecord::Base#new_record? は、既存のレコードに遭遇した場合に nil ではなく false を返すようになりました。
一部の has_many :through 関連付けでテーブル名をクォートする際のバグが修正されました。
updated_at タイムスタンプに特定のタイムスタンプを指定することができるようになりました：cust = Customer.create(:name => "ABC Industries", :updated_at => 1.day.ago)
失敗した find_by_attribute! の呼び出しに関するエラーメッセージが改善されました。
Active Recordの to_xml サポートは、:camelize オプションの追加により、少し柔軟性が向上しました。
before_update または before_create からのコールバックのキャンセルに関するバグが修正されました。
JDBCを介したデータベースのテストのためのRakeタスクが追加されました。
validates_length_of は、:in または :within オプションでカスタムエラーメッセージを使用します（指定されている場合）。
スコープ付きの選択に対するカウントが正しく機能するようになりました。したがって、Account.scoped(:select => "DISTINCT credit_limit").count のようなことができます。
ActiveRecord::Base#invalid? は、ActiveRecord::Base#valid? の反対として機能するようになりました。

5 Action Controller

このリリースでは、Action Controllerはレンダリングに関する重要な変更、ルーティングの改善など、いくつかの重要な変更を行っています。

5.1 統一されたレンダリング

ActionController::Base#render は、レンダリングする内容を判断する際によりスマートになりました。今では、レンダリングしたい内容を指定するだけで、正しい結果が得られるようになりました。古いバージョンのRailsでは、レンダリングに明示的な情報を提供する必要がありました。

render :file => '/tmp/random_file.erb'
render :template => 'other_controller/action'
render :action => 'show'

Rails 2.3では、レンダリングしたい内容を単に指定することができます。

render '/tmp/random_file.erb'
render 'other_controller/action'
render 'show'
render :show

Railsは、レンダリングする内容に先頭のスラッシュ、埋め込まれたスラッシュ、スラッシュが含まれていないかどうかに基づいて、ファイル、テンプレート、アクションのいずれかを選択します。アクションをレンダリングする際には、文字列の代わりにシンボルを使用することもできます。その他のレンダリングスタイル（:inline、:text、:update、:nothing、:json、:xml、:js）は引き続き明示的なオプションが必要です。

5.2 Application Controllerの名前変更

application.rb の特殊な命名にいつも悩まされていた人の一人であれば、喜ぶことができます！Rails 2.3では、application.rb が application_controller.rb に再構成されました。さらに、rake rails:update:application_controller という新しいrakeタスクが追加され、これを使用すると自動的に変更することができます。このタスクは通常の rake rails:update プロセスの一部として実行されます。

追加情報：
- Application.rbの終焉
- Edge Railsの新機能：Application.rbの二重性はもはや存在しない

5.3 HTTPダイジェスト認証のサポート

Railsには、HTTPダイジェスト認証の組み込みサポートがあります。これを使用するには、ユーザーのパスワードを返すブロックを指定して authenticate_or_request_with_http_digest を呼び出します（パスワードはハッシュ化され、送信された認証情報と比較されます）。

class PostsController < ApplicationController
  Users = {"dhh" => "secret"}
  before_filter :authenticate

  def secret
    render :text => "Password Required!"
  end

  private
  def authenticate
    realm = "Application"
    authenticate_or_request_with_http_digest(realm) do |name|
      Users[name]
    end
  end
end

主な貢献者：Gregg Kellogg
詳細情報：Edge Railsの新機能：HTTPダイジェスト認証

5.4 より効率的なルーティング

Rails 2.3では、いくつかの重要なルーティングの変更があります。formatted_ルートヘルパーはなくなり、代わりにオプションとして:formatを渡すようになりました。これにより、任意のリソースのルート生成プロセスが50%削減され、メモリの節約（大規模なアプリケーションでは最大で100MB）が可能です。コードがformatted_ヘルパーを使用している場合、当面は動作しますが、この動作は非推奨となっており、新しい標準を使用してこれらのルートを書き直すとアプリケーションがより効率的になります。もう1つの大きな変更は、Railsがroutes.rbだけでなく複数のルーティングファイルをサポートするようになったことです。いつでもRouteSet#add_configuration_fileを使用して追加のルートを読み込むことができますが、現在読み込まれているルートはクリアされません。この変更はエンジンに最も有用ですが、ルートをバッチで読み込む必要がある任意のアプリケーションで使用することができます。

主な貢献者：Aaron Batalion

5.5 Rackベースの遅延読み込みセッション

Action Controllerのセッションストレージの基盤がRackレベルに押し下げられるという大きな変更がありました。これにはコード上でのかなりの作業が必要でしたが、Railsアプリケーションには完全に透過的です（さらに、古いCGIセッションハンドラに関するいくつかの問題が解決されました）。ただし、1つだけ重要な理由があります。非RailsのRackアプリケーションは、Railsアプリケーションと同じセッションストレージハンドラ（および同じセッション）にアクセスできるようになりました。さらに、セッションは現在のフレームワークの読み込みの改善に合わせて遅延読み込みされるようになりました。つまり、明示的にセッションを無効にする必要はもはやありません。参照しなければ読み込まれません。

5.6 MIMEタイプの処理の変更

RailsのMIMEタイプの処理にはいくつかの変更があります。まず、MIME::Typeは今や=~演算子を実装しており、シノニムを持つタイプの存在を確認する必要がある場合に非常にクリーンになりました。

if content_type && Mime::JS =~ content_type
  # 何かクールなことをする
end

Mime::JS =~ "text/javascript"        => true
Mime::JS =~ "application/javascript" => true

もう1つの変更は、フレームワークがさまざまな場所でJavaScriptをチェックする際にMime::JSを使用するようになり、これによりこれらの代替をきれいに処理できるようになりました。

主な貢献者：Seth Fitzsimmons

5.7 `respond_to`の最適化

Rails 2.3では、Rails-Merbチームの合併の最初の成果の一部として、respond_toメソッドの最適化が行われています。respond_toは、リクエストのMIMEタイプに基づいてコントローラが結果を異なる形式でフォーマットするために多くのRailsアプリケーションで頻繁に使用されるメソッドです。method_missingの呼び出しを削除し、プロファイリングと微調整を行った結果、3つのフォーマット間を切り替える単純なrespond_toで秒あたりのリクエスト数が8%向上しています。最高の部分は、この高速化を利用するためにアプリケーションのコードを一切変更する必要がないことです。

5.8 キャッシュのパフォーマンスの向上

Railsは、リモートキャッシュストアからの読み取りをリクエストごとにローカルキャッシュとして保持することで、不要な読み取りを削減し、サイトのパフォーマンスを向上させるようになりました。この作業はもともとMemCacheStoreに限定されていましたが、必要なメソッドを実装するリモートストアならどのストアでも利用できます。

主な貢献者：Nahum Wild

5.9 ローカライズされたビュー

Railsは、設定したロケールに応じてローカライズされたビューを提供することができます。たとえば、Postsコントローラにshowアクションがある場合、デフォルトではapp/views/posts/show.html.erbがレンダリングされます。しかし、I18n.locale = :daと設定すると、app/views/posts/show.da.html.erbがレンダリングされます。ローカライズされたテンプレートが存在しない場合は、未装飾のバージョンが使用されます。Railsには、現在のRailsプロジェクトで利用可能な翻訳の配列を返すI18n#available_localesとI18n::SimpleBackend#available_localesも含まれています。

さらに、同じ方法を使用してパブリックディレクトリ内のレスキューファイルをローカライズすることもできます。たとえば、public/500.da.htmlやpublic/404.en.htmlなどが機能します。

5.10 パーシャルスコープのための翻訳

翻訳APIの変更により、パーシャル内でキーの翻訳を書く際により簡単で繰り返しの少ない方法が提供されます。people/index.html.erbテンプレートからtranslate(".foo")を呼び出すと、実際にはI18n.translate("people.index.foo")が呼び出されます。キーの前にピリオドを付けない場合、APIはスコープされません（以前と同様）。

5.11 その他のアクションコントローラの変更

ETagの処理が少し改善されました。Railsは、レスポンスに本文がない場合やsend_fileでファイルを送信する場合には、ETagヘッダーを送信しないようになりました。
RailsはIPスプーフィングのチェックを行うことができますが、携帯電話とのトラフィックが多いサイトでは、プロキシが正しく設定されていないことが多いため、これが迷惑になることがあります。その場合は、ActionController::Base.ip_spoofing_check = falseと設定することで、チェックを無効にすることができます。
ActionController::Dispatcherは、独自のミドルウェアスタックを実装するようになりました。これは、rake middlewareを実行することで確認することができます。
Cookieセッションには、サーバーサイドストアとのAPI互換性を持つ永続的なセッション識別子が追加されました。
send_fileとsend_dataの:typeオプションには、今やシンボルを使用することができます。例えば、send_file("fabulous.png", :type => :png)のように使用します。
map.resourcesの:onlyオプションと:exceptオプションは、ネストされたリソースには継承されなくなりました。
バンドルされているmemcachedクライアントは、バージョン1.6.4.99に更新されました。
expires_in、stale?、fresh_whenメソッドは、プロキシキャッシュとの互換性を確保するために、:publicオプションを受け入れるようになりました。
:requirementsオプションは、追加のRESTfulメンバールートでも正しく機能するようになりました。
シャロールートは、名前空間を正しく尊重するようになりました。
polymorphic_urlは、不規則な複数形の名前を持つオブジェクトを扱う際に、より良いパフォーマンスを発揮します。

6 アクションビュー

Rails 2.3のアクションビューでは、ネストされたモデルフォーム、renderの改善、柔軟な日付選択ヘルパーのプロンプトなど、さまざまな改善が行われています。

6.1 ネストされたオブジェクトフォーム

親モデルが子オブジェクトのネストされた属性を受け入れる場合（Active Recordのセクションで説明されているように）、form_forとfield_forを使用してネストされたフォームを作成することができます。これらのフォームは任意の深さでネストすることができ、冗長なコードなしで複雑なオブジェクトの階層を単一のビューで編集することができます。例えば、次のモデルがある場合：

class Customer < ActiveRecord::Base
  has_many :orders

  accepts_nested_attributes_for :orders, :allow_destroy => true
end

Rails 2.3では、次のようなビューを作成することができます：

<% form_for @customer do |customer_form| %>
  <div>
    <%= customer_form.label :name, 'Customer Name:' %>
    <%= customer_form.text_field :name %>
  </div>

  <!-- ここでは、customer_formビルダーインスタンスに対してfields_forを呼び出しています。
  ブロックはordersコレクションの各メンバーごとに呼び出されます。 -->
  <% customer_form.fields_for :orders do |order_form| %>
    <p>
      <div>
        <%= order_form.label :number, 'Order Number:' %>
        <%= order_form.text_field :number %>
      </div>

  <!-- モデルのallow_destroyオプションにより、子レコードの削除が可能になります。 -->
      <% unless order_form.object.new_record? %>
        <div>
          <%= order_form.label :_delete, 'Remove:' %>
          <%= order_form.check_box :_delete %>
        </div>
      <% end %>
    </p>
  <% end %>

  <%= customer_form.submit %>
<% end %>

主な貢献者：Eloy Duran
詳細情報：

6.2 パーシャルのスマートなレンダリング

renderメソッドは、年々賢くなってきており、今ではさらに賢くなりました。オブジェクトやコレクションと適切なパーシャルがある場合、命名が一致している場合、オブジェクトを単純にレンダリングするだけで動作するようになりました。例えば、Rails 2.3では、次のようなrender呼び出しはビューで動作します（適切な命名がされている場合）：

# render :partial => 'articles/_article',
# :object => @article
render @article

# render :partial => 'articles/_article',
# :collection => @articles
render @articles

詳細情報：What's New in Edge Rails: render Stops Being High-Maintenance

6.3 日付選択ヘルパーのプロンプト

Rails 2.3では、日付選択ヘルパー（date_select、time_select、datetime_select）に対して、コレクション選択ヘルパーと同様にカスタムプロンプトを指定することができます。プロンプト文字列または各コンポーネントの個別のプロンプト文字列のハッシュを指定することができます。また、カスタムの一般的なプロンプトを使用するには、:promptをtrueに設定することもできます。

select_datetime(DateTime.now, :prompt => true)

select_datetime(DateTime.now, :prompt => "Choose date and time")

select_datetime(DateTime.now, :prompt =>
  {:day => 'Choose day', :month => 'Choose month',
   :year => 'Choose year', :hour => 'Choose hour',
   :minute => 'Choose minute'})

主な貢献者：Sam Oliver

6.4 AssetTagのタイムスタンプキャッシュ

Railsでは、静的なアセットパスにタイムスタンプを追加して「キャッシュバスター」として使用することが一般的です。これにより、サーバー上で変更した画像やスタイルシートなどの古いコピーがユーザーのブラウザキャッシュから提供されないようになります。Action Viewのcache_asset_timestamps設定オプションを使用して、この動作を変更することができます。キャッシュを有効にすると、Railsはアセットを最初に提供する際にタイムスタンプを計算し、その値を保存します。これにより、静的アセットを提供するための（高価な）ファイルシステム呼び出しの回数が減りますが、サーバーが実行中の間にアセットを変更しても、クライアントに変更が反映されないことになります。

6.5 オブジェクトとしてのアセットホスト

エッジRailsでは、アセットホストを特定の呼び出しに応答するオブジェクトとして宣言することができるため、アセットホストはより柔軟になります。これにより、アセットホスティングに必要な複雑なロジックを実装することができます。

詳細はこちら：asset-hosting-with-minimum-ssl

6.6 grouped_options_for_selectヘルパーメソッド

Action Viewにはすでにセレクトコントロールの生成を支援するためのヘルパーがいくつかありますが、これに加えてgrouped_options_for_selectがあります。これは、文字列の配列またはハッシュを受け取り、optgroupタグで囲まれたoptionタグの文字列に変換します。例えば：

grouped_options_for_select([["Hats", ["Baseball Cap","Cowboy Hat"]]],
  "Cowboy Hat", "Choose a product...")

は以下を返します：

<option value="">Choose a product...</option>
<optgroup label="Hats">
  <option value="Baseball Cap">Baseball Cap</option>
  <option selected="selected" value="Cowboy Hat">Cowboy Hat</option>
</optgroup>

6.7 フォームセレクトヘルパーの無効なオプションタグ

フォームセレクトヘルパー（selectやoptions_for_selectなど）は、結果のタグで無効にする値を単一の値または値の配列として受け入れる:disabledオプションをサポートしています。

select(:post, :category, Post::CATEGORIES, :disabled => 'private')

は以下を返します：

<select name="post[category]">
<option>story</option>
<option>joke</option>
<option>poem</option>
<option disabled="disabled">private</option>
</select>

また、無効にするオプションを実行時に決定するために、無名関数を使用することもできます。

options_from_collection_for_select(@product.sizes, :name, :id, :disabled => lambda{|size| size.out_of_stock?})

主な貢献者：Tekin Suleyman
詳細はこちら：New in rails 2.3 - disabled option tags and lambdas for selecting and disabling options from collections

6.8 テンプレートの読み込みに関する注意事項

Rails 2.3では、特定の環境でキャッシュされたテンプレートを有効または無効にする機能が追加されました。キャッシュされたテンプレートは、レンダリング時に新しいテンプレートファイルをチェックしないため、スピードが向上しますが、サーバーを再起動せずにテンプレートを「オンザフライ」で置き換えることはできません。

ほとんどの場合、テンプレートキャッシュを本番環境で有効にしたい場合は、production.rbファイルで設定を行うことができます。

config.action_view.cache_template_loading = true

この行は、新しいRails 2.3アプリケーションではデフォルトで生成されます。古いバージョンのRailsからアップグレードした場合、Railsは本番環境とテストではテンプレートをキャッシュし、開発環境ではキャッシュしません。

6.9 その他のAction Viewの変更

CSRF保護のためのトークン生成が簡素化されました。Railsは、セッションIDをいじるのではなく、ActiveSupport::SecureRandomによって生成されたシンプルなランダム文字列を使用します。
auto_linkは、生成されたメールリンクに対してtargetやclassなどのオプションを正しく適用します。
autolinkヘルパーは、少し整理されてわかりやすくなりました。
current_page?は、URLに複数のクエリパラメータがある場合でも正しく動作します。

7 Active Support

Active Supportにはいくつかの興味深い変更があります。その中には、Object#tryの導入も含まれています。

7.1 Object#try

多くの人々が、オブジェクト上で操作を試みるためにtry()を使用するという考え方を採用しています。ビューでは、<%= @person.try(:name) %>のようなコードを書くことで、nilチェックを回避することができます。それがRailsに組み込まれました。Railsでは、プライベートメソッドに対してはNoMethodErrorを発生させ、オブジェクトがnilの場合は常にnilを返します。

詳細はこちら：try()

7.2 Object#tapのバックポート

Object#tapは、Ruby 1.9と1.8.7に追加されたもので、Railsには以前からあるreturningメソッドと似ています。ブロックに対してyieldし、yieldされたオブジェクトを返します。Railsは、この機能を古いバージョンのRubyでも利用できるようにするためのコードを含んでいます。

7.3 XMLmini用のパーサーの交換可能性

Active SupportのXMLパースのサポートは、異なるパーサーを交換できるようになりました。デフォルトでは、標準のREXML実装が使用されますが、適切なgemがインストールされている場合は、簡単に高速なLibXMLやNokogiriの実装を指定することができます。

XmlMini.backend = 'LibXML'

主な貢献者：Bart ten Brinke
主な貢献者：Aaron Patterson

7.4 TimeWithZoneのための小数秒

TimeとTimeWithZoneクラスには、XMLに適した文字列で時間を返すためのxmlschemaメソッドがあります。Rails 2.3以降、TimeWithZoneは、Timeと同じように、返される文字列の小数秒部分の桁数を指定するための引数をサポートしています。

Time.zone.now.xmlschema(6) # => "2009-01-16T13:00:06.13653Z"

主な寄稿者：Nicholas Dainty

7.5 JSONキーの引用

「json.org」サイトの仕様を調べると、JSON構造のすべてのキーは文字列でなければならず、ダブルクォートで引用する必要があることがわかります。Rails 2.3以降、数値キーでも正しく処理されます。

7.6 その他のActive Supportの変更

Enumerable#none?を使用して、要素が提供されたブロックと一致しないことを確認できます。
Active Supportのデリゲートを使用している場合、新しい:allow_nilオプションを使用すると、対象オブジェクトがnilの場合に例外を発生させずにnilを返すことができます。
ActiveSupport::OrderedHash：each_keyとeach_valueを実装しました。
ActiveSupport::MessageEncryptorは、信頼できない場所（クッキーなど）に格納するための情報を暗号化する簡単な方法を提供します。
Active Supportのfrom_xmlはもはやXmlSimpleに依存しません。代わりに、Railsには必要な機能だけを備えた独自のXmlMini実装が含まれています。これにより、Railsは持ち運んでいたXmlSimpleのバンドルコピーを廃止することができます。
プライベートメソッドをメモ化すると、結果もプライベートになります。
String#parameterizeはオプションのセパレータを受け入れます："Quick Brown Fox".parameterize('_') => "quick_brown_fox"。
number_to_phoneは7桁の電話番号も受け入れます。
ActiveSupport::Json.decodeは\u0000スタイルのエスケープシーケンスを処理します。

8 Railties

上記でカバーされているRackの変更に加えて、Railties（Rails自体のコアコード）には、Rails Metal、アプリケーションテンプレート、および静かなバックトレースなど、多くの重要な変更があります。

8.1 Rails Metal

Rails Metalは、Railsアプリケーション内の超高速エンドポイントを提供する新しいメカニズムです。MetalクラスはルーティングとAction Controllerをバイパスして、生のスピードを提供します（もちろん、Action Controllerのすべての機能を犠牲にしています）。これは、Railsを公開されたミドルウェアスタックを持つRackアプリケーションにするための最近の基盤作業をすべて活用しています。Metalエンドポイントは、アプリケーションまたはプラグインからロードできます。

詳細情報：

8.2 アプリケーションテンプレート

Rails 2.3には、Jeremy McAnallyのrgアプリケーションジェネレータが組み込まれています。これは、Railsにテンプレートベースのアプリケーション生成が組み込まれたことを意味します。すべてのアプリケーションに含めるプラグインのセットなど、一度テンプレートを設定し、railsコマンドを実行するたびに繰り返し使用することができます。また、既存のアプリケーションにテンプレートを適用するためのrakeタスクもあります：

$ rake rails:template LOCATION=~/template.rb

これにより、テンプレートからの変更がプロジェクトが既に含んでいるコードの上に重ねられます。

主な寄稿者：Jeremy McAnally
詳細情報：Rails templates

8.3 静かなバックトレース

thoughtbotのQuiet Backtraceプラグインを活用し、Test::Unitのバックトレースから行を選択的に削除できるようにするRails 2.3では、ActiveSupport::BacktraceCleanerとRails::BacktraceCleanerがコアに実装されています。これにより、フィルタ（バックトレースの行に基づいた正規表現による置換を実行する）とサイレンサ（バックトレースの行を完全に削除する）の両方をサポートしています。Railsは新しいアプリケーションで最も一般的なノイズを取り除くために自動的にサイレンサを追加し、独自の追加を保持するconfig/backtrace_silencers.rbファイルを作成します。この機能により、バックトレース内の任意のgemからのよりきれいな出力も可能になります。

8.4 開発モードでの起動時間の短縮と遅延読み込み/自動読み込み

Railsの一部（およびその依存関係）が必要な時にのみメモリに読み込まれるようにするための作業が行われました。コアフレームワークであるActive Support、Active Record、Action Controller、Action Mailer、およびAction Viewは、各クラスを遅延読み込みするためにautoloadを使用しています。この作業により、メモリの使用量を抑え、全体的なRailsのパフォーマンスを向上させることが期待されます。

また、新しいpreload_frameworksオプションを使用して、コアライブラリを起動時に自動読み込みするかどうかを指定することもできます。これは、Railsを一度にすべて読み込む必要がある場合があるため、デフォルトではfalseに設定されています- PassengerとJRubyは、Railsのすべてを一度に読み込む必要があります。

8.5 rake gemタスクの書き直し

さまざまなrake gemタスクの内部が大幅に改訂され、さまざまなケースでシステムがより効果的に機能するようになりました。gemシステムは、開発時とランタイムの依存関係の違いを認識し、より堅牢な展開システムを持ち、ジェムのステータスをクエリする際により良い情報を提供し、ゼロから構築する際の「鶏と卵」の依存関係の問題に対してもより耐性があります。JRubyでのgemコマンドの使用や、既にベンダリングされているジェムの外部コピーを持ち込もうとする依存関係に対する修正もあります。 * 主な寄稿者：David Dollar

8.6 その他のRailtiesの変更

CIサーバーを更新してRailsをビルドするための手順が更新および拡張されました。
内部のRailsテストはTest::Unit::TestCaseからActiveSupport::TestCaseに切り替えられ、RailsコアではテストにMochaが必要です。
デフォルトのenvironment.rbファイルが整理されました。
dbconsoleスクリプトでは、すべての数字のパスワードをクラッシュせずに使用できるようになりました。
Rails.rootは現在Pathnameオブジェクトを返すため、File.joinを使用する既存のコードを直接使用できます。
デフォルトでは、すべてのRailsアプリケーションで/ publicのCGIおよびFCGIディスパッチに関連するさまざまなファイルが生成されなくなりました（railsコマンドを実行するときに--with-dispatchersを追加するか、後でrake rails:update:generate_dispatchersで追加できます）。
RailsガイドはAsciiDocからTextileマークアップに変換されました。
スキャフォールドされたビューとコントローラーが少し整理されました。
script/serverは、特定のパスからRailsアプリケーションをマウントするための--path引数を受け入れるようになりました。
設定されたジェムが不足している場合、ジェムのrakeタスクは環境の多くの部分をスキップします。これにより、rake gems:installが実行できなかったジェムが不足している場合の多くの「鶏と卵」の問題が解決されます。
ジェムは1回だけ展開されます。これにより、ファイルに読み取り専用のアクセス許可があるジェム（たとえば、hoe）に関する問題が修正されます。

非推奨

このリリースでは、いくつかの古いコードが非推奨となっています。

インスペクタ、リーパー、およびスポーナースクリプトに依存するような方法で展開する（かなりまれな）Rails開発者の場合、これらのスクリプトはもはやRailsのコアに含まれていません。必要な場合は、irs_process_scriptsプラグインを使用してコピーを取得できます。
render_componentはRails 2.3では「存在しない」になります。必要な場合は、render_componentプラグインをインストールできます。
Railsコンポーネントのサポートは削除されました。
統合テストに基づいたパフォーマンスを確認するためにscript/performance/requestを実行するように慣れていた場合、新しいトリックを学ぶ必要があります。このスクリプトはもはやRailsのコアから削除されました。同じ機能を取得するためにインストールできる新しいrequest_profilerプラグインがあります。
ActionController::Base#session_enabled?は非推奨となりました。セッションは遅延読み込みされるためです。
protect_from_forgeryの:digestおよび:secretオプションは非推奨となり、効果がありません。
一部の統合テストヘルパーが削除されました。response.headers["Status"]およびheaders["Status"]はもはや何も返さなくなりました。Rackは返されたヘッダーに「Status」を許可しません。ただし、statusおよびstatus_messageヘルパーは引き続き使用できます。response.headers["cookie"]およびheaders["cookie"]はもはやCGIクッキーを返しません。生のクッキーヘッダーを確認するにはheaders["Set-Cookie"]を調べるか、クライアントに送信されたクッキーのハッシュを取得するためにcookiesヘルパーを使用できます。
formatted_polymorphic_urlは非推奨です。代わりにpolymorphic_urlを使用して:formatを指定します。
ActionController::Response#set_cookieの:http_onlyオプションは、:httponlyに名前が変更されました。
to_sentenceの:connectorおよび:skip_last_commaオプションは、:words_connector、:two_words_connector、および:last_word_connectorオプションに置き換えられました。
空のfile_fieldコントロールでマルチパートフォームを投稿すると、以前のRailsのマルチパートパーサーとの違いにより、空の文字列ではなくnilが送信されるようになりました。

クレジット

リリースノートはMike Gunderloyによって編集されました。このRails 2.3のリリースノートのバージョンは、Rails 2.3のRC2に基づいて編集されました。

フィードバック

このガイドの品質向上にご協力ください。

タイポや事実の誤りを見つけた場合は、ぜひ貢献してください。開始するには、ドキュメントへの貢献セクションを読んでください。

不完全なコンテンツや最新でない情報も見つかるかもしれません。メインのドキュメントに不足しているドキュメントを追加してください。修正済みかどうかは、まずEdge Guidesを確認してください。スタイルと規約については、Ruby on Rails Guides Guidelinesを確認してください。

修正すべき点を見つけたが、自分で修正できない場合は、問題を報告してください。

そして最後に、Ruby on Railsのドキュメントに関するあらゆる議論は、公式のRuby on Railsフォーラムで大歓迎です。

Ruby on Rails 2.3 リリースノート

Chapters

フィードバック