Français | 한국어 | 日本語 | Português | Deutsch | 中文 | Español | Русский | Bosanski | Nederlands | العربية | Български | Italiano

Model Validation

Sequel::Model provides a set of validation methods by default. The available standard validations are:

• acceptance_of
• confirmation_of
• format_of
• length_of
• numericality_of
• presence_of
• uniqueness_of

Validations can be specified in two ways within a class.

class User < Sequel::Model

  validates_confirmation_of :password
  validates_length_of :login, :minimum => 5
  
  # or
  
  validates do
    confirmation_of :password
    length_of :login, :minimum => 5
  end
end

By default, Sequel::Model will raise an error on validation failures. The class accessor :raise_on_save_failure can be set to false to avoid raising errors on validation failure. If raise_on_save_failure is false, the #save method will return false on failures

An important distinction between Sequel::Model and ActiveRecord is the #save! method. In Sequel::Model, #save! will update the record without validation. This is significantly different from ActiveRecord, which will run validations and raise an error on failure.

If validation fails, errors can be accessed on the object with the #errors method.

User.raise_on_save_faliure = false
u = User.new(:login => 3)

u.save
=> false
u.errors.on(:login)
=> 'is too short'

By default, Sequel will also not allow unexpected data into a column. If the table schema prevents a column from containing a nil value, it can not be set to nil. Sequel attempts to typecast entered values to match their column type. This can be disabled by setting the class attr_accesor raise_on_typecast_failure to false.

a => Address.new(:user_id => 1, :city => 'A City')
a.user_id = nil
Sequel::Error::InvalidValue: nil/NULL is not allowed for the user_id column
Address.raise_on_typecast_failure = false
a.user_id = nil
=> nil

A full set of documentation for model validations can be found in the Merb::Sequel documentation

Previous | Home | Next