如果 attribute 是一个属性方法，则返回 true，否则返回 false。

class Person
  include ActiveModel::Validations

  attr_accessor :name
end

User.attribute_method?(:name) # => true
User.attribute_method?(:age)  # => false

清除所有验证器和验证。

请注意，这将清除用于验证模型的所有内容，包括 validates_with 和 validate 方法。它会清除通过调用 validates_with 创建的验证器，以及通过调用 validate 设置的回调。

class Person
  include ActiveModel::Validations

  validates_with MyValidator
  validates_with OtherValidator, on: :create
  validates_with StrictValidator, strict: true
  validate :cannot_be_robot

  def cannot_be_robot
    errors.add(:base, 'A person cannot be a robot') if person_is_robot
  end
end

Person.validators
# => [
#      #<MyValidator:0x007fbff403e808 @options={}>,
#      #<OtherValidator:0x007fbff403d930 @options={on: :create}>,
#      #<StrictValidator:0x007fbff3204a30 @options={strict:true}>
#    ]

如果有人运行 Person.clear_validators! 然后检查此类拥有哪些验证器，您将获得

Person.validators # => []

此外，通过 validate :cannot_be_robot 设置的回调也将被删除，因此

Person._validate_callbacks.empty?  # => true

向类添加验证方法或块。当重写 validate 实例方法变得过于繁琐，并且您正在寻找更具描述性的验证声明时，这会很有用。

这可以通过指向方法的符号来完成

class Comment
  include ActiveModel::Validations

  validate :must_be_friends

  def must_be_friends
    errors.add(:base, 'Must be friends to leave a comment') unless commenter.friend_of?(commentee)
  end
end

使用块，该块与要验证的当前记录一起传递

class Comment
  include ActiveModel::Validations

  validate do |comment|
    comment.must_be_friends
  end

  def must_be_friends
    errors.add(:base, 'Must be friends to leave a comment') unless commenter.friend_of?(commentee)
  end
end

或者使用块，其中 self 指向要验证的当前记录

class Comment
  include ActiveModel::Validations

  validate do
    errors.add(:base, 'Must be friends to leave a comment') unless commenter.friend_of?(commentee)
  end
end

请注意，验证方法的返回值无关紧要。无法中断验证回调链。

选项¶ ↑

• :on - 指定此验证处于活动状态的上下文。默认情况下，在所有验证上下文中运行 nil。您可以传递一个符号或一个符号数组。（例如，on: :create 或 on: :custom_validation_context 或 on: [:create, :custom_validation_context]）

• :except_on - 指定此验证不处于活动状态的上下文。默认情况下，在所有验证上下文中运行 nil。您可以传递一个符号或一个符号数组。（例如，except: :create 或 except_on: :custom_validation_context 或 except_on: [:create, :custom_validation_context]）

• :if - 指定一个方法、proc 或字符串来调用以确定验证是否应该发生（例如，if: :allow_validation，或 if: Proc.new { |user| user.signup_step > 2 }）。该方法、proc 或字符串应返回或计算为 true 或 false 值。

• :unless - 指定一个方法、proc 或字符串来调用以确定验证是否不应该发生（例如，unless: :skip_validation，或 unless: Proc.new { |user| user.signup_step <= 2 }）。该方法、proc 或字符串应返回或计算为 true 或 false 值。

注意：对同一方法多次调用 validate 会覆盖先前的定义。

此方法是所有默认验证器以及以“Validator”结尾的任何自定义验证器类的快捷方式。请注意，Rails 默认验证器可以在特定类中被覆盖，通过创建自定义验证器类来代替，例如 PresenceValidator。

使用默认 Rails 验证器的示例

validates :username, absence: true
validates :terms, acceptance: true
validates :password, confirmation: true
validates :username, exclusion: { in: %w(admin superuser) }
validates :email, format: { with: /\A([^@\s]+)@((?:[-a-z0-9]+\.)+[a-z]{2,})\z/i, on: :create }
validates :age, inclusion: { in: 0..9 }
validates :first_name, length: { maximum: 30 }
validates :age, numericality: true
validates :username, presence: true

validates 方法的强大之处在于，它可以在一次调用中为给定的属性使用自定义验证器和默认验证器。

class EmailValidator < ActiveModel::EachValidator
  def validate_each(record, attribute, value)
    record.errors.add attribute, (options[:message] || "is not an email") unless
      /\A([^@\s]+)@((?:[-a-z0-9]+\.)+[a-z]{2,})\z/i.match?(value)
  end
end

class Person
  include ActiveModel::Validations
  attr_accessor :name, :email

  validates :name, presence: true, length: { maximum: 100 }
  validates :email, presence: true, email: true
end

Validator 类也可以存在于被验证的类中，允许根据需要包含自定义验证器模块。

class Film
  include ActiveModel::Validations

  class TitleValidator < ActiveModel::EachValidator
    def validate_each(record, attribute, value)
      record.errors.add attribute, "must start with 'the'" unless /\Athe/i.match?(value)
    end
  end

  validates :name, title: true
end

此外，验证器类可以存在于另一个命名空间中，并且仍然可以在任何类中使用。

validates :name, :'film/title' => true

验证器哈希还可以处理正则表达式、范围、数组和字符串的快捷方式。

validates :email, format: /@/
validates :role, inclusion: %w(admin contributor)
validates :password, length: 6..20

当使用快捷方式时，范围和数组会作为 options[:in] 传递给验证器的初始化程序，而其他类型（包括正则表达式和字符串）则作为 options[:with] 传递。

还可以使用一组选项来配合验证器

• :on - 指定此验证处于活动状态的上下文。默认情况下，在所有验证上下文中运行 nil。您可以传递一个符号或一个符号数组。（例如，on: :create 或 on: :custom_validation_context 或 on: [:create, :custom_validation_context]）

• :except_on - 指定此验证不处于活动状态的上下文。默认情况下，在所有验证上下文中运行 nil。您可以传递一个符号或一个符号数组。（例如，except: :create 或 except_on: :custom_validation_context 或 except_on: [:create, :custom_validation_context]）

• :if - 指定一个方法、proc 或字符串来调用以确定验证是否应该发生（例如，if: :allow_validation，或 if: Proc.new { |user| user.signup_step > 2 }）。该方法、proc 或字符串应返回或计算为 true 或 false 值。

• :unless - 指定一个方法、proc 或字符串来调用以确定验证是否不应该发生（例如，unless: :skip_validation，或 unless: Proc.new { |user| user.signup_step <= 2 }）。该方法、proc 或字符串应返回或计算为 true 或 false 值。

• :allow_nil - 如果属性为 nil，则跳过验证。

• :allow_blank - 如果属性为空，则跳过验证。

• :strict - 如果将 :strict 选项设置为 true，则将引发 ActiveModel::StrictValidationFailed，而不是添加错误。:strict 选项也可以设置为任何其他异常。

示例

validates :password, presence: true, confirmation: true, if: :password_required?
validates :token, length: { is: 24 }, strict: TokenLengthException

最后，选项 :if、:unless、:on、:allow_blank、:allow_nil、:strict 和 :message 可以作为哈希值传递给特定的验证器

validates :password, presence: { if: :password_required?, message: 'is forgotten.' }, confirmation: true

此方法用于定义不能由最终用户纠正且被视为异常的验证。因此，使用感叹号定义的每个验证器或将 :strict 选项设置为 true 的验证器，在验证失败时将始终引发 ActiveModel::StrictValidationFailed，而不是添加错误。有关验证本身的更多信息，请参阅 validates。

class Person
  include ActiveModel::Validations

  attr_accessor :name
  validates! :name, presence: true
end

person = Person.new
person.name = ''
person.valid?
# => ActiveModel::StrictValidationFailed: Name can't be blank

针对块验证每个属性。

class Person
  include ActiveModel::Validations

  attr_accessor :first_name, :last_name

  validates_each :first_name, :last_name, allow_blank: true do |record, attr, value|
    record.errors.add attr, "starts with z." if value.start_with?("z")
  end
end

选项¶ ↑

• :on - 指定此验证处于活动状态的上下文。默认情况下，在所有验证上下文中运行 nil。您可以传递一个符号或一个符号数组。（例如，on: :create 或 on: :custom_validation_context 或 on: [:create, :custom_validation_context]）

• :except_on - 指定此验证不处于活动状态的上下文。默认情况下，在所有验证上下文中运行 nil。您可以传递一个符号或一个符号数组。（例如，except: :create 或 except_on: :custom_validation_context 或 except_on: [:create, :custom_validation_context]）

• :allow_nil - 如果属性为 nil，则跳过验证。

• :allow_blank - 如果属性为空，则跳过验证。

• :if - 指定一个方法、proc 或字符串来调用以确定验证是否应该发生（例如，if: :allow_validation，或 if: Proc.new { |user| user.signup_step > 2 }）。该方法、proc 或字符串应返回或计算为 true 或 false 值。

• :unless - 指定一个方法、proc 或字符串来调用以确定验证是否不应该发生（例如，unless: :skip_validation，或 unless: Proc.new { |user| user.signup_step <= 2 }）。该方法、proc 或字符串应返回或计算为 true 或 false 值。

将记录传递给指定的类或类，并允许它们基于更复杂的条件添加错误。

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

您也可以传递多个类，如下所示

class Person
  include ActiveModel::Validations
  validates_with MyValidator, MyOtherValidator, on: :create
end

validates_with 没有默认错误消息。您必须在验证器类中手动将错误添加到记录的错误集合中。

要实现 validate 方法，您必须定义一个 record 参数，该参数是被验证的记录。

配置选项

• :on - 指定此验证处于活动状态的上下文。默认情况下，在所有验证上下文中运行 nil。您可以传递一个符号或一个符号数组。（例如，on: :create 或 on: :custom_validation_context 或 on: [:create, :custom_validation_context]）

• :if - 指定一个方法、proc 或字符串来调用以确定验证是否应该发生（例如，if: :allow_validation，或 if: Proc.new { |user| user.signup_step > 2 }）。该方法、proc 或字符串应返回或计算为 true 或 false 值。

• :unless - 指定一个方法、proc 或字符串来调用以确定验证是否不应该发生（例如，unless: :skip_validation，或 unless: Proc.new { |user| user.signup_step <= 2 }）。该方法、proc 或字符串应返回或计算为 true 或 false 值。

• :strict - 指定验证是否应严格。有关更多信息，请参阅 ActiveModel::Validations#validates!。

如果您传递任何其他配置选项，它们将被传递给类，并可作为 options 访问

class Person
  include ActiveModel::Validations
  validates_with MyValidator, my_custom_key: 'my custom value'
end

class MyValidator < ActiveModel::Validator
  def validate(record)
    options[:my_custom_key] # => "my custom value"
  end
end

使用 validates_with 方法列出用于验证模型的所有验证器。

class Person
  include ActiveModel::Validations

  validates_with MyValidator
  validates_with OtherValidator, on: :create
  validates_with StrictValidator, strict: true
end

Person.validators
# => [
#      #<MyValidator:0x007fbff403e808 @options={}>,
#      #<OtherValidator:0x007fbff403d930 @options={on: :create}>,
#      #<StrictValidator:0x007fbff3204a30 @options={strict:true}>
#    ]

列出用于验证特定属性的所有验证器。

class Person
  include ActiveModel::Validations

  attr_accessor :name, :age

  validates_presence_of :name
  validates_inclusion_of :age, in: 0..99
end

Person.validators_on(:name)
# => [
#       #<ActiveModel::Validations::PresenceValidator:0x007fe604914e60 @attributes=[:name], @options={}>,
#    ]