跳至内容 跳至搜索

Active Model Naming ↑

为您的对象创建一个 model_name 方法。

要实现，只需在您的对象中扩展 ActiveModel::Naming

class BookCover
  extend ActiveModel::Naming
end

BookCover.model_name.name   # => "BookCover"
BookCover.model_name.human  # => "Book cover"

BookCover.model_name.i18n_key              # => :book_cover
BookModule::BookCover.model_name.i18n_key  # => :"book_module/book_cover"

在对象中提供 ActiveModel::Naming 提供的功能，才能通过 Active Model Lint 测试。因此，需要扩展下面提供的方法，或者自行实现。

方法
M
P
R
S
U

类公共方法

param_key(record_or_class)

返回用于参数名称的字符串。它对于名称空间内的模型有所不同，具体取决于它是否在隔离的引擎内部。

# For isolated engine:
ActiveModel::Naming.param_key(Blog::Post) # => "post"

# For shared engine:
ActiveModel::Naming.param_key(Blog::Post) # => "blog_post"

Source: show | on GitHub

# File activemodel/lib/active_model/naming.rb, line 337
def self.param_key(record_or_class)
  model_name_from_record_or_class(record_or_class).param_key
end

plural(record_or_class)

返回记录或类的复数类名。

ActiveModel::Naming.plural(post)             # => "posts"
ActiveModel::Naming.plural(Highrise::Person) # => "highrise_people"

Source: show | on GitHub

# File activemodel/lib/active_model/naming.rb, line 282
def self.plural(record_or_class)
  model_name_from_record_or_class(record_or_class).plural
end

route_key(record_or_class)

返回用于生成路由名称的字符串。它对于名称空间内的模型有所不同，具体取决于它是否在隔离的引擎内部。

# For isolated engine:
ActiveModel::Naming.route_key(Blog::Post) # => "posts"

# For shared engine:
ActiveModel::Naming.route_key(Blog::Post) # => "blog_posts"

路由键还会考虑名词是否是不可数名词，在这种情况下，会自动追加 _index。

Source: show | on GitHub

# File activemodel/lib/active_model/naming.rb, line 325
def self.route_key(record_or_class)
  model_name_from_record_or_class(record_or_class).route_key
end

singular(record_or_class)

返回记录或类的单数类名。

ActiveModel::Naming.singular(post)             # => "post"
ActiveModel::Naming.singular(Highrise::Person) # => "highrise_person"

Source: show | on GitHub

# File activemodel/lib/active_model/naming.rb, line 290
def self.singular(record_or_class)
  model_name_from_record_or_class(record_or_class).singular
end

singular_route_key(record_or_class)

返回用于生成路由名称的字符串。它对于名称空间内的模型有所不同，具体取决于它是否在隔离的引擎内部。

# For isolated engine:
ActiveModel::Naming.singular_route_key(Blog::Post) # => "post"

# For shared engine:
ActiveModel::Naming.singular_route_key(Blog::Post) # => "blog_post"

Source: show | on GitHub

# File activemodel/lib/active_model/naming.rb, line 310
def self.singular_route_key(record_or_class)
  model_name_from_record_or_class(record_or_class).singular_route_key
end

uncountable?(record_or_class)

识别记录或类的类名是否不可数。

ActiveModel::Naming.uncountable?(Sheep) # => true
ActiveModel::Naming.uncountable?(Post)  # => false

Source: show | on GitHub

# File activemodel/lib/active_model/naming.rb, line 298
def self.uncountable?(record_or_class)
  model_name_from_record_or_class(record_or_class).uncountable?
end

实例公共方法

model_name()

返回一个 ActiveModel::Name 对象用于模块。它可用于检索所有命名相关的（参见 ActiveModel::Name 以获取更多信息）。

class Person
  extend ActiveModel::Naming
end

Person.model_name.name     # => "Person"
Person.model_name.class    # => ActiveModel::Name
Person.model_name.singular # => "person"
Person.model_name.plural   # => "people"

Source: show | on GitHub

# File activemodel/lib/active_model/naming.rb, line 269
def model_name
  @_model_name ||= begin
    namespace = module_parents.detect do |n|
      n.respond_to?(:use_relative_model_naming?) && n.use_relative_model_naming?
    end
    ActiveModel::Name.new(self, namespace)
  end
end