класс 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
Для добавления поведения в метод инициализации используйте следующую сигнатуру:
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].attr_accessor :custom_attribute
end
end
Атрибуты
Открытые методы класса
# File activemodel/lib/active_model/validator.rb, line 103
def self.kind
@kind ||= name.split("::").last.underscore.chomp("_validator").to_sym unless anonymous?
end Возвращает тип валидатора.
PresenceValidator.kind # => :presence AcceptanceValidator.kind # => :acceptance
# File activemodel/lib/active_model/validator.rb, line 108
def initialize(options = {})
@options = options.except(:class).freeze
end Принимает опции, которые будут доступны через options.
Открытые методы экземпляра
# File activemodel/lib/active_model/validator.rb, line 116 def kind self.class.kind end
Возвращает тип этого валидатора.
PresenceValidator.new(attributes: [:username]).kind # => :presence AcceptanceValidator.new(attributes: [:terms]).kind # => :acceptance
# File activemodel/lib/active_model/validator.rb, line 122 def validate(record) raise NotImplementedError, "Subclasses must implement a validate(record) method." end
Переопределите этот метод в подклассах с логикой валидации, добавляя ошибки в массив errors записи при необходимости.
© 2004–2019 David Heinemeier Hansson
Licensed under the MIT License.