跳至内容 跳至搜索

Active Model EachValidator

EachValidator 是一个验证器,它会遍历选项哈希中给定的属性,调用 validate_each 方法,并将记录、属性和值传递进去。

所有 Active Model 的验证都建立在这个验证器之上。

方法
C
N
V

Attributes

[R] attributes

类公共方法

new(options)

返回一个新的验证器实例。所有选项都可以通过 options 读取器访问,但是 :attributes 选项将被移除,并可以通过 attributes 读取器访问。

# File activemodel/lib/active_model/validator.rb, line 140
def initialize(options)
  @attributes = Array(options.delete(:attributes))
  raise ArgumentError, ":attributes cannot be blank" if @attributes.empty?
  super
  check_validity!
end

实例公共方法

check_validity!()

初始化程序调用的钩子方法,允许验证提供的参数是否有效。例如,当提供无效选项时,可以抛出 ArgumentError

# File activemodel/lib/active_model/validator.rb, line 168
def check_validity!
end

validate(record)

对提供的记录执行验证。默认情况下,这将调用 validate_each 来确定有效性,因此子类应该用验证逻辑重写 validate_each

# File activemodel/lib/active_model/validator.rb, line 150
def validate(record)
  attributes.each do |attribute|
    value = record.read_attribute_for_validation(attribute)
    next if (value.nil? && options[:allow_nil]) || (value.blank? && options[:allow_blank])
    value = prepare_value_for_validation(value, record, attribute)
    validate_each(record, attribute, value)
  end
end

validate_each(record, attribute, value)

在子类中重写此方法以实现验证逻辑,并在必要时将错误添加到记录的 errors 数组中。

# File activemodel/lib/active_model/validator.rb, line 161
def validate_each(record, attribute, value)
  raise NotImplementedError, "Subclasses must implement a validate_each(record, attribute, value) method"
end