Module: ActiveRecord::Validations

Extended by:
ActiveSupport::Concern
Includes:
ActiveModel::Validations
Included in:
Base
Defined in:
activerecord/lib/active_record/validations.rb,
activerecord/lib/active_record/validations/presence.rb,
activerecord/lib/active_record/validations/uniqueness.rb,
activerecord/lib/active_record/validations/associated.rb

Overview

Active Record Validations

Active Record includes the majority of its validations from ActiveModel::Validations all of which accept the :on argument to define the context where the validations are active. Active Record will always supply either the context of :create or :update dependent on whether the model is a new_record?.

Defined Under Namespace

Modules: ClassMethods Classes: AssociatedValidator, PresenceValidator, UniquenessValidator

Instance Method Summary collapse

Methods included from ActiveSupport::Concern

append_features, extended, included

Methods included from ActiveModel::Validations

#errors, #initialize_dup, #invalid?, #validates_with

Instance Method Details

#save(options = {}) ⇒ Object

The validation process on save can be skipped by passing validate: false. The regular Base#save method is replaced with this when the validations module is mixed in, which it is by default.



50
51
52
# File 'activerecord/lib/active_record/validations.rb', line 50

def save(options={})
  perform_validations(options) ? super : false
end

#save!(options = {}) ⇒ Object

Attempts to save the record just like Base#save but will raise a RecordInvalid exception instead of returning false if the record is not valid.



56
57
58
# File 'activerecord/lib/active_record/validations.rb', line 56

def save!(options={})
  perform_validations(options) ? super : raise(RecordInvalid.new(self))
end

#valid?(context = nil) ⇒ Boolean

Runs all the validations within the specified context. Returns true if no errors are found, false otherwise.

If the argument is false (default is nil), the context is set to :create if new_record? is true, and to :update if it is not.

Validations with no :on option will run no matter the context. Validations with some :on option will only run in the specified context.

Returns:

  • (Boolean)


68
69
70
71
72
# File 'activerecord/lib/active_record/validations.rb', line 68

def valid?(context = nil)
  context ||= (new_record? ? :create : :update)
  output = super(context)
  errors.empty? && output
end