модуль ActiveModel::Validations

# File activemodel/lib/active_model/validations.rb, line 299
def errors
  @errors ||= Errors.new(self)
end

Возвращает объект Errors, содержащий всю информацию об ошибках атрибутов.

class Person
  include ActiveModel::Validations

  attr_accessor :name
  validates_presence_of :name
end

person = Person.new
person.valid? # => false
person.errors # => #<ActiveModel::Errors:0x007fe603816640 @messages={name:["can't be blank"]}>

# File activemodel/lib/active_model/validations.rb, line 371
def invalid?(context = nil)
  !valid?(context)
end

Выполняет обратное действие valid?. Возвращает true, если ошибки были добавлены, false, в противном случае.

class Person
  include ActiveModel::Validations

  attr_accessor :name
  validates_presence_of :name
end

person = Person.new
person.name = ''
person.invalid? # => true
person.name = 'david'
person.invalid? # => false

Контекст может быть необязательно передан для определения, против каких коллбеков проводить проверку (контекст определяется для валидаций с использованием :on).

class Person
  include ActiveModel::Validations

  attr_accessor :name
  validates_presence_of :name, on: :new
end

person = Person.new
person.invalid?       # => false
person.invalid?(:new) # => true

# File activemodel/lib/active_model/validations.rb, line 332
def valid?(context = nil)
  current_context, self.validation_context = validation_context, context
  errors.clear
  run_validations!
ensure
  self.validation_context = current_context
end

Выполняет все указанные валидации и возвращает true, если ошибки не были добавлены, иначе false.

class Person
  include ActiveModel::Validations

  attr_accessor :name
  validates_presence_of :name
end

person = Person.new
person.name = ''
person.valid? # => false
person.name = 'david'
person.valid? # => true

Контекст может быть необязательно передан для определения, против каких коллбеков проводить проверку (контекст определяется для валидаций с использованием :on).

class Person
  include ActiveModel::Validations

  attr_accessor :name
  validates_presence_of :name, on: :new
end

person = Person.new
person.valid?       # => true
person.valid?(:new) # => false

# File activemodel/lib/active_model/validations.rb, line 380
def validate!(context = nil)
  valid?(context) || raise_validation_error
end

Выполняет все валидации в указанном контексте. Возвращает true, если ошибки не найдены, в противном случае генерирует исключение ValidationError.

Валидации Validations без опции :on будут выполняться независимо от контекста. Валидации Validations с опцией :on будут выполняться только в указанном контексте.

# File activemodel/lib/active_model/validations/with.rb, line 135
def validates_with(*args, &block)
  options = args.extract_options!
  options[:class] = self.class

  args.each do |klass|
    validator = klass.new(options, &block)
    validator.validate(self)
  end
end

Передает запись указанному классу или классам и позволяет им добавлять ошибки на основе более сложных условий.

class Person
  include ActiveModel::Validations

  validate :instance_validations

  def instance_validations
    validates_with MyValidator
  end
end

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

Вы также можете передать несколько классов, например:

class Person
  include ActiveModel::Validations

  validate :instance_validations, on: :create

  def instance_validations
    validates_with MyValidator, MyOtherValidator
  end
end

Стандартные параметры конфигурации (:on, :if и :unless), доступные в версии метода класса validates_with, должны вместо этого быть размещены в методе validates, так как они применяются и проверяются в коллбеке.

Если вы передаете дополнительные параметры конфигурации, они будут переданы классу и доступны как options, для получения дополнительной информации обратитесь к версии метода класса.