модуль ActiveModel::API

Включенные модули:: ActiveModel::AttributeAssignment, ActiveModel::Validations, ActiveModel::Conversion

API Active Model

Включает необходимый интерфейс для взаимодействия объекта с Action Pack и Action View, используя различные модули Active Model. Он включает интроспекцию имени модели, преобразования, переводы и валидации. Помимо этого, он позволяет инициализировать объект с хэш-таблицей атрибутов, практически так же, как и Active Record.

Минимальная реализация может быть такой:

class Person
  include ActiveModel::API
  attr_accessor :name, :age
end

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

Обратите внимание, что по умолчанию ActiveModel::API реализует persisted? для возврата false, что является наиболее распространённым случаем. Вы можете переопределить его в своём классе для моделирования другого сценария:

class Person
  include ActiveModel::API
  attr_accessor :id, :name

  def persisted?
    self.id.present?
  end
end

person = Person.new(id: 1, name: 'bob')
person.persisted? # => true

Также, если по какой-то причине вам нужно выполнить код при инициализации ( ::new ), убедитесь, что вы вызываете super , если хотите, чтобы произошло инициализирование хэш-таблицы атрибутов.

class Person
  include ActiveModel::API
  attr_accessor :id, :name, :omg

  def initialize(attributes={})
    super
    @omg ||= true
  end
end

person = Person.new(id: 1, name: 'bob')
person.omg # => true

Для получения более подробной информации об других доступных функциях, пожалуйста, обратитесь к конкретным модулям, включённым в ActiveModel::API (см. ниже).

Публичные методы класса

new(attributes = {}) Показать исходный код

# File activemodel/lib/active_model/api.rb, line 80
def initialize(attributes = {})
  assign_attributes(attributes) if attributes

  super()
end

Инициализирует новую модель с заданными params.

class Person
  include ActiveModel::API
  attr_accessor :name, :age
end

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

Вызывает метод суперкласса

Публичные методы экземпляра

persisted?() Показать исходный код

# File activemodel/lib/active_model/api.rb, line 95
def persisted?
  false
end

Указывает, является ли модель сохранённой. По умолчанию false.

class Person
  include ActiveModel::API
  attr_accessor :id, :name
end

person = Person.new(id: 1, name: 'bob')
person.persisted? # => false