1

私はRubyにかなり慣れていないので、これらすべてのクラスとメソッドの間の接続を確認できません。各メソッドが正確に何をするのか、少し説明していただけますか。

module Naming
# Returns an ActiveModel::Name object for module. It can be
# used to retrieve all kinds of naming-related information.
def model_name
  @_model_name ||= begin
    namespace = self.parents.detect do |n|
      n.respond_to?(:use_relative_model_naming?) && n.use_relativve_model_naming?
    end
    ActiveModel::Name.new(self, namespace)
  end
end

# Returns the plural class name of a record or class. Examples:
#
#   ActiveModel::Naming.plural(post)             # => "posts"
#   ActiveModel::Naming.plural(Highrise::Person) # => "highrise_people"
def self.plural(record_or_class)
  model_name_from_record_or_class(record_or_class).plural
end

# Returns the singular class name of a record or class. Examples:
#
#   ActiveModel::Naming.singular(post)             # => "post"
#   ActiveModel::Naming.singular(Highrise::Person) # => "highrise_person"
def self.singular(record_or_class)
  model_name_from_record_or_class(record_or_class).singular
end

# Identifies whether the class name of a record or class is uncountable. Examples:
#
#   ActiveModel::Naming.uncountable?(Sheep) # => true
#   ActiveModel::Naming.uncountable?(Post) => false
def self.uncountable?(record_or_class)
  plural(record_or_class) == singular(record_or_class)
end

# Returns string to use while generating route names. It differs for
# namespaced models regarding whether it's inside isolated engine.
#
# For isolated engine:
# ActiveModel::Naming.route_key(Blog::Post) #=> post
#
# For shared engine:
# ActiveModel::Naming.route_key(Blog::Post) #=> blog_post
def self.singular_route_key(record_or_class)
  model_name_from_record_or_class(record_or_class).singular_route_key
end

# Returns string to use while generating route names. It differs for
# namespaced models regarding whether it's inside isolated engine.
#
# For isolated engine:
# ActiveModel::Naming.route_key(Blog::Post) #=> posts
#
# For shared engine:
# ActiveModel::Naming.route_key(Blog::Post) #=> blog_posts
#
# The route key also considers if the noun is uncountable and, in
# such cases, automatically appends _index.
def self.route_key(record_or_class)
  model_name_from_record_or_class(record_or_class).route_key
end

# Returns string to use for params names. It differs for
# namespaced models regarding whether it's inside isolated engine.
#
# For isolated engine:
# ActiveModel::Naming.param_key(Blog::Post) #=> post
#
# For shared engine:
# ActiveModel::Naming.param_key(Blog::Post) #=> blog_post
def self.param_key(record_or_class)
  model_name_from_record_or_class(record_or_class).param_key
end

private
  def self.model_name_from_record_or_class(record_or_class)
    (record_or_class.is_a?(Class) ? record_or_class :     convert_to_model(record_or_class).class).model_name
  end

  def self.convert_to_model(object)
    object.respond_to?(:to_model) ? object.to_model : object
  end
end

end

各メソッドにコメントがあることは知っていますが、それでも基本的なメタを理解できません。

4

1 に答える 1

1

このモジュールはActiveModelの一部であり、命名規則を確実にするのに役立ちます。

このすべての目標は、単一のオブジェクトから推測するのに役立つ標準インターフェースを提供することです。

  • ファイルがアプリ構造内にある場合(これはrenderコントローラーの背後にある魔法であり、たとえば、ビューがどこにあるべきかをコントローラー名から推測します)
  • このリソースにつながる標準のRESTルート
  • paramsハッシュのどのキーがform_for特定のオブジェクトのヘルパーを生成するか
  • 等々...

このモジュールは、命名規則に依存する独立したロジックビットによって広く使用されているため、これ以上説明することは困難です。

于 2013-02-28T20:08:52.140 に答える