class ActiveModel::Validator

Проверяющий Active Model

Простой базовый класс, который можно использовать вместе с ActiveModel::Validations::ClassMethods#validates_with

class Person
  include ActiveModel::Validations
  validates_with MyValidator
end

class MyValidator < ActiveModel::Validator
  def validate(record)
    if some_complex_logic
      record.errors.add(:base, "This record is invalid")
    end
  end

  private
    def some_complex_logic
      # ...
    end
end

Любой класс, унаследованный от ActiveModel::Validator, должен реализовать метод под названием validate, который принимает record.

class Person
  include ActiveModel::Validations
  validates_with MyValidator
end

class MyValidator < ActiveModel::Validator
  def validate(record)
    record # => The person instance being validated
    options # => Any non-standard options passed to validates_with
  end
end

Чтобы вызвать ошибку проверки, необходимо добавить в ошибки record напрямую из сообщения валидатора.

class MyValidator < ActiveModel::Validator
  def validate(record)
    record.errors.add :base, "This is some custom error message"
    record.errors.add :first_name, "This is some complex validation"
    # etc...
  end
end

Чтобы добавить поведение в метод initialize, используйте следующий синтаксис:

class MyValidator < ActiveModel::Validator
  def initialize(options)
    super
    @my_custom_field = options[:field_name] || :first_name
  end
end

Обратите внимание, что валидатор инициализируется только один раз для всего жизненного цикла приложения, а не при каждой проверке.

Самый простой способ добавить пользовательских валидаторов для проверки отдельных атрибутов — использовать удобный метод ActiveModel::EachValidator.

class TitleValidator < ActiveModel::EachValidator
  def validate_each(record, attribute, value)
    record.errors.add attribute, 'must be Mr., Mrs., or Dr.' unless %w(Mr. Mrs. Dr.).include?(value)
  end
end

Теперь это можно использовать в сочетании с методом validates (подробнее см. в ActiveModel::Validations::ClassMethods.validates).

class Person
  include ActiveModel::Validations
  attr_accessor :title

  validates :title, presence: true, title: true
end

Полезно получить доступ к классу, использующему этот валидатор, при наличии предварительных условий, таких как attr_accessor. Этот класс доступен через options[:class] в конструкторе. Для настройки валидатора переопределите конструктор.

class MyValidator < ActiveModel::Validator
  def initialize(options={})
    super
    options[:class].send :attr_accessor, :custom_attribute
  end
end