Module: ActiveModel::Validations

Extended by:
ActiveSupport::Concern
Includes:
ActiveSupport::Callbacks
Included in:
ActiveRecord::Validations, ActiveResource::Validations
Defined in:
activemodel/lib/active_model/validations.rb,
activemodel/lib/active_model/validations/with.rb,
activemodel/lib/active_model/validations/format.rb,
activemodel/lib/active_model/validations/length.rb,
activemodel/lib/active_model/validations/presence.rb,
activemodel/lib/active_model/validations/exclusion.rb,
activemodel/lib/active_model/validations/validates.rb,
activemodel/lib/active_model/validations/inclusion.rb,
activemodel/lib/active_model/validations/callbacks.rb,
activemodel/lib/active_model/validations/acceptance.rb,
activemodel/lib/active_model/validations/confirmation.rb,
activemodel/lib/active_model/validations/numericality.rb

Overview

Active Model Numericality Validator

Defined Under Namespace

Modules: Callbacks, ClassMethods, HelperMethods Classes: AcceptanceValidator, ConfirmationValidator, ExclusionValidator, FormatValidator, InclusionValidator, LengthValidator, NumericalityValidator, PresenceValidator

Instance Method Summary (collapse)

Methods included from ActiveSupport::Concern

append_features, extended, included

Methods included from ActiveSupport::Callbacks

#callback, #run_callbacks

Instance Method Details

- (Object) errors

Returns the Errors object that holds all information about attribute error messages.



169
170
171
# File 'activemodel/lib/active_model/validations.rb', line 169

def errors
  @errors ||= Errors.new(self)
end

- (Boolean) invalid?(context = nil)

Performs the opposite of valid?. Returns true if errors were added, false otherwise.

Returns:

  • (Boolean)


186
187
188
# File 'activemodel/lib/active_model/validations.rb', line 186

def invalid?(context = nil)
  !valid?(context)
end

- (Boolean) valid?(context = nil)

Runs all the specified validations and returns true if no errors were added otherwise false. Context can optionally be supplied to define which callbacks to test against (the context is defined on the validations using :on).

Returns:

  • (Boolean)


176
177
178
179
180
181
182
# File 'activemodel/lib/active_model/validations.rb', line 176

def valid?(context = nil)
  current_context, self.validation_context = validation_context, context
  errors.clear
  run_validations!
ensure
  self.validation_context = current_context
end

- (Object) validates_with(*args, &block)

Passes the record off to the class or classes specified and allows them to add errors based on more complex conditions.

class Person
  include ActiveModel::Validations

  validates :instance_validations

  def instance_validations
    validates_with MyValidator
  end
end

Please consult the class method documentation for more information on creating your own validator.

You may also pass it multiple classes, like so:

class Person
  include ActiveModel::Validations

  validates :instance_validations, :on => :create

  def instance_validations
    validates_with MyValidator, MyOtherValidator
  end
end

Standard configuration options (:on, :if and :unless), which are available on the class version of validates_with, should instead be placed on the validates method as these are applied and tested in the callback

If you pass any additional configuration options, they will be passed to the class and available as options, please refer to the class version of this method for more information



123
124
125
126
127
128
129
# File 'activemodel/lib/active_model/validations/with.rb', line 123

def validates_with(*args, &block)
  options = args.extract_options!
  args.each do |klass|
    validator = klass.new(options, &block)
    validator.validate(self)
  end
end