2007年12月24日月曜日

Action Pack: Record identification

InfoQの記事 Ruby on Rails 2.0が公式リリースをもとに、Rails2.0の新機能を順に確認しつつ、知らない機能があれば詳しく調べてしまおうというもくろみの3つ目、Action PackのRecord identification。

InfoQの説明だけ見てると、なんのこっちゃという感じだが、サンプルを見てみるとなんとなくイメージはついてくる。
# person is a Person object, which by convention will
# be mapped to person_url for lookup
redirect_to(person)
link_to(person.name, person)
form_for(person)
URL生成系の各種メソッドが、引数としてモデルオブジェクトを取ることができるようになった、ということらしい。正直、あんまり使ったことないから便利さはよくわからないんだけど、新機能らしい。…さすがにこれだけで終わるわけにはいかないので、それぞれのメソッドを簡単に調べてみる。まずはredirect_toから。

・gems\actionpack-2.0.2\lib\action_controller\base.rb
module ActionController #:nodoc:
class Base
class << self
def redirect_to(options = {}, response_status = {}) #:doc:

if options.is_a?(Hash) && options[:status]
status = options.delete(:status)
elsif response_status[:status]
status = response_status[:status]
else
status = 302
end

case options
when %r{^\w+://.*}
raise DoubleRenderError if performed?
logger.info("Redirected to #{options}") if logger && logger.info?
response.redirect(options, interpret_status(status))
response.redirected_to = options
@performed_redirect = true

when String
redirect_to(request.protocol + request.host_with_port
+ options, :status=>status)

when :back
request.env["HTTP_REFERER"] ? redirect_to(request.env["HTTP_REFERER"],
:status=>status) : raise(RedirectBackError)

when Hash
redirect_to(url_for(options), :status=>status)
response.redirected_to = options

else
redirect_to(url_for(options), :status=>status)
end
end
モデルオブジェクトが渡された際に実行されるのは、一番下のelse~のところだろうか。ここだけじゃよくわからないので、さらにurl_forを追ってみる。
module ActionController #:nodoc:
class Base
class << self
def url_for(options = nil) #:doc:
case options || {}
when String
options
when Hash
@url.rewrite(rewrite_options(options))
else
polymorphic_url(options)
end
end
モデルオブジェクトが渡されて来た場合には、polymorphic_urlが呼び出されるようだ。
・gems\actionpack-2.0.2\lib\action_controller\polymorphic_routes.rb
module ActionController
module PolymorphicRoutes
def polymorphic_url(record_or_hash_or_array, options = {})
record = extract_record(record_or_hash_or_array)

namespace = extract_namespace(record_or_hash_or_array)

args = case record_or_hash_or_array
when Hash; [ record_or_hash_or_array ]
when Array; record_or_hash_or_array.dup
else [ record_or_hash_or_array ]
end

inflection =
case
when options[:action] == "new"
args.pop
:singular
when record.respond_to?(:new_record?) && record.new_record?
args.pop
:plural
else
:singular
end

named_route = build_named_route_call(record_or_hash_or_array,
namespace, inflection, options)
send!(named_route, *args)
end
モデルの情報を色々展開して、最後はbuild_named_route_callを呼び出し。
def build_named_route_call(records, namespace, inflection, options = {})
records = Array.new([extract_record(records)]) unless records.is_a?(Array)
base_segment = "#{RecordIdentifier.send!("#{inflection}_class_name", records.pop)}_"

method_root = records.reverse.inject(base_segment) do |string, name|
segment = "#{RecordIdentifier.send!("singular_class_name", name)}_"
segment << string
end

action_prefix(options) + namespace + method_root + routing_type(options)
end
結局、RecordIdentifierを使ってurl生成のための情報をひっぱってきて、組み立てて返している。やっとタイトルにつながった。

・gems\actionpack-2.0.2\lib\action_controller\record_identifier.rb
module ActionController
module RecordIdentifier
extend self
def plural_class_name(record_or_class)
singular_class_name(record_or_class).pluralize
end

def singular_class_name(record_or_class)
class_from_record_or_class(record_or_class).name.underscore.tr('/', '_')
end
このルートで使われているのが確認できるのはこれくらいだろうか。
link_toもform_forも、入り口が違うだけで最終的には同じルートを通っていた。細かい点でわからないところはいくつかあるが、機能の確認としてはここまでで終わっておく。

関連リンク:
Rails2.0リリース
Rails2.0のscaffoldは前とだいぶ違うらしい
Migration
Rails2.0でブックマークアプリ
Rails2.0の変更点
Action Pack: Resources
Action Pack: Multiview

0 件のコメント: