Active Record Validations 6 Performing Custom Validations 执行个性化校验

version Rails 4.1

6. 执行个性化校验

当内建的校验辅助方法不能满足你的需求时, 你能够写你自己更喜欢的校验类或者校验方法.

 

6.1 Custom Validators 个性化校验

个性化校验是类(class), 该类继承ActiveModel::Validator. 这些类必须实现一个validate方法, 它会带入一个record作为一个参数, 然后对这个record执行校验. 个性化校验是通过使用 validates_with 方法来被调用的.

class MyValidator < ActiveModel::Validator

  def validate(record)

    unless record.name.starts_with? 'X'

      record.errors[:name] << 'Need a name starting with X please!'

    end

  end

end

 

class Person

  include ActiveModel::Validations

  validates_with MyValidator

end

对于校验各个属性增加个性化校验最简单的方式是用ActiveModel::EachValidator的规则. 在这个例子中, 个性化校验类必须实现一个validate_each方法, 该方法有三个参数: record, attribute和value, 和实例相对应, 被校验的属性和属性的值都存在于被传入方法的实例中.

class EmailValidator < ActiveModel::EachValidator

  def validate_each(record, attribute, value)

    unless value =~ /\A([^@\s]+)@((?:[-a-z0-9]+\.)+[a-z]{2,})\z/i

      record.errors[attribute] << (options[:message] || "is not an email")

    end

  end

end

 

class Person < ActiveRecord::Base

  validates :email, presence: true, email: true

end

正如在例子中显示的, 你同样结合标准的校验和你自己个性化的校验.

 

6.2 Custom Methods 个性化方法

你也能够创建方法来校验你模型的状态以及给errors集合增加信息, 当他们是无效的时候. 然后你必须要注册这些方法, 通过使用validate类的方法, 传入标志, 即校验方法名.

 

对于每一个方法你能够传入多于一个的标志, 各自的校验将会在同一个指令中运行, 正如他们被注册时那般.

class Invoice < ActiveRecord::Base

  validate :expiration_date_cannot_be_in_the_past,

    :discount_cannot_be_greater_than_total_value

 

  def expiration_date_cannot_be_in_the_past

    if expiration_date.present? && expiration_date < Date.today

      errors.add(:expiration_date, "can't be in the past")

    end

  end

 

  def discount_cannot_be_greater_than_total_value

    if discount > total_value

      errors.add(:discount, "can't be greater than total value")

    end

  end

end

默认情况下,  类似的校验在你每次调用valid?时, 将会运行. 同样也能控制, 当去运行这些个性化校验时, 通过给校验的方法后增加一个 :on 选项, 赋值 :create 或者 :update. 

class Invoice < ActiveRecord::Base

  validate :active_customer, on: :create

 

  def active_customer

    errors.add(:customer_id, "is not active") unless customer.active?

  end

end

 

original url: http://guides.rubyonrails.org/active_record_validations.html#performing-custom-validations