Active Model – Rails 的模型接口

Active Model 提供了一套已知的接口，供模型类使用。例如，它们允许 Action Pack 帮助程序与非 Active Record 模型交互。Active Model 还帮助构建自定义 ORM，以便在 Rails 框架之外使用。

您可以在 Active Model 基础指南中了解更多关于 Active Model 的信息。

在 Rails 3.0 之前，如果插件或 gem 开发者想要让一个对象与 Action Pack 帮助程序交互，就需要要么从 Rails 中复制代码块，要么对整个帮助程序进行猴子补丁，以使它们能够处理不完全符合 Active Record 接口的对象。这会导致代码重复，并且在升级时会造成脆弱的应用程序。Active Model 通过定义一个显式 API 来解决这个问题。您可以在 ActiveModel::Lint::Tests 中了解更多关于 API 的信息。

Active Model 提供了一个默认模块，该模块实现了与 Action Pack 集成的基本 API：ActiveModel::API.

class Person
  include ActiveModel::API

  attr_accessor :name, :age
  validates_presence_of :name
end

person = Person.new(name: 'bob', age: '18')
person.name   # => 'bob'
person.age    # => '18'
person.valid? # => true

它包括模型名称内省、转换、翻译和验证，从而产生一个适合与 Action Pack 一起使用的类。有关更多示例，请参阅 ActiveModel::API。

Active Model 还提供以下功能，以便开箱即用地获得类似 ORM 的行为

为对象添加属性魔法

class Person
  include ActiveModel::AttributeMethods

  attribute_method_prefix 'clear_'
  define_attribute_methods :name, :age

  attr_accessor :name, :age

  def clear_attribute(attr)
    send("#{attr}=", nil)
  end
end

person = Person.new
person.clear_name
person.clear_age

了解更多

特定操作的回调

class Person
  extend ActiveModel::Callbacks
  define_model_callbacks :create

  def create
    run_callbacks :create do
      # Your create action methods here
    end
  end
end

这将生成 before_create、around_create 和 after_create 类方法，这些方法将包装您的 create 方法。

了解更多

跟踪值变化

class Person
  include ActiveModel::Dirty

  define_attribute_methods :name

  def name
    @name
  end

  def name=(val)
    name_will_change! unless val == @name
    @name = val
  end

  def save
    # do persistence work
    changes_applied
  end
end

person = Person.new
person.name             # => nil
person.changed?         # => false
person.name = 'bob'
person.changed?         # => true
person.changed          # => ['name']
person.changes          # => { 'name' => [nil, 'bob'] }
person.save
person.name = 'robert'
person.save
person.previous_changes # => {'name' => ['bob, 'robert']}

了解更多

为对象添加 errors 接口

公开错误消息使对象能够与 Action Pack 帮助程序无缝交互。

class Person

  def initialize
    @errors = ActiveModel::Errors.new(self)
  end

  attr_accessor :name
  attr_reader   :errors

  def validate!
    errors.add(:name, "cannot be nil") if name.nil?
  end

  def self.human_attribute_name(attr, options = {})
    "Name"
  end
end

person = Person.new
person.name = nil
person.validate!
person.errors.full_messages
# => ["Name cannot be nil"]

了解更多

模型名称内省

class NamedPerson
  extend ActiveModel::Naming
end

NamedPerson.model_name.name   # => "NamedPerson"
NamedPerson.model_name.human  # => "Named person"

了解更多

使对象可序列化

ActiveModel::Serialization 为您的对象提供了提供 to_json 序列化的标准接口。

class SerialPerson
  include ActiveModel::Serialization

  attr_accessor :name

  def attributes
    {'name' => name}
  end
end

s = SerialPerson.new
s.serializable_hash   # => {"name"=>nil}

class SerialPerson
  include ActiveModel::Serializers::JSON
end

s = SerialPerson.new
s.to_json             # => "{\"name\":null}"

了解更多

国际化 (i18n) 支持

class Person
  extend ActiveModel::Translation
end

Person.human_attribute_name('my_attribute')
# => "My attribute"

了解更多

验证支持

class Person
  include ActiveModel::Validations

  attr_accessor :first_name, :last_name

  validates_each :first_name, :last_name do |record, attr, value|
    record.errors.add attr, "starts with z." if value.start_with?("z")
  end
end

person = Person.new
person.first_name = 'zoolander'
person.valid?  # => false

了解更多

自定义验证器

class HasNameValidator < ActiveModel::Validator
  def validate(record)
    record.errors.add(:name, "must exist") if record.name.blank?
  end
end

class ValidatorPerson
  include ActiveModel::Validations
  validates_with HasNameValidator
  attr_accessor :name
end

p = ValidatorPerson.new
p.valid?                  # =>  false
p.errors.full_messages    # => ["Name must exist"]
p.name = "Bob"
p.valid?                  # =>  true

了解更多