модуль 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