Module: Mongoid::Validatable

Extended by:
ActiveSupport::Concern
Included in:
Composable
Defined in:
lib/mongoid/validatable.rb,
lib/mongoid/validatable/format.rb,
lib/mongoid/validatable/length.rb,
lib/mongoid/validatable/macros.rb,
lib/mongoid/validatable/presence.rb,
lib/mongoid/validatable/queryable.rb,
lib/mongoid/validatable/associated.rb,
lib/mongoid/validatable/uniqueness.rb,
lib/mongoid/validatable/localizable.rb,
lib/mongoid/validatable/numericality.rb more...

Overview

This module provides additional validations that ActiveModel does not provide: validates_associated and validates_uniqueness_of.

Defined Under Namespace

Modules: ClassMethods, Localizable, Macros, Queryable Classes: AssociatedValidator, FormatValidator, LengthValidator, NumericalityValidator, PresenceValidator, UniquenessValidator

Instance Method Summary collapse

Instance Method Details

#begin_validate ⇒ Object

Begin the associated validation.

Examples:

Begin validation.

document.begin_validate
[View source]

30
31
32
 
# File 'lib/mongoid/validatable.rb', line 30

def begin_validate
  Threaded.begin_validate(self)
end

#exit_validate ⇒ Object

Exit the associated validation.

Examples:

Exit validation.

document.exit_validate
[View source]

38
39
40
 
# File 'lib/mongoid/validatable.rb', line 38

def exit_validate
  Threaded.exit_validate(self)
end

#performing_validations?(options = {}) ⇒ true | false

Given the provided options, are we performing validations?

Examples:

Are we performing validations?

document.performing_validations?(validate: true)

Parameters:

  • options (Hash) (defaults to: {}) —

    The options to check.

Options Hash (options):

  • :validate (true | false) —

    Whether or not to validate.

Returns:

  • (true | false) —

    If we are validating.

[View source]

60
61
62
 
# File 'lib/mongoid/validatable.rb', line 60

def performing_validations?(options = {})
  options[:validate].nil? ? true : options[:validate]
end

#read_attribute_for_validation(attr) ⇒ Object

Overrides the default ActiveModel behavior since we need to handle validations of associations slightly different than just calling the getter.

Examples:

Read the value.

person.read_attribute_for_validation(:addresses)

Parameters:

  • attr (Symbol) —

    The name of the field or association.

Returns:

  • (Object) —

    The value of the field or the association.

[View source]

74
75
76
77
78
79
80
81
82
83
84
85
86
 
# File 'lib/mongoid/validatable.rb', line 74

def read_attribute_for_validation(attr)
  attribute = database_field_name(attr)
  if relations.key?(attribute)
    begin_validate
    relation = without_autobuild { send(attr) }
    exit_validate
    relation.try(:in_memory) || relation
  elsif fields[attribute].try(:localized?)
    attributes[attribute]
  else
    send(attr)
  end
end

#valid?(context = nil) ⇒ true | false

Determine if the document is valid.

Examples:

Is the document valid?

person.valid?

Is the document valid in a context?

person.valid?(:create)

Parameters:

  • context (Symbol) (defaults to: nil) —

    The optional validation context.

Returns:

  • (true | false) —

    True if valid, false if not.

[View source]

99
100
101
 
# File 'lib/mongoid/validatable.rb', line 99

def valid?(context = nil)
  super context ? context : (new_record? ? :create : :update)
end

#validated? ⇒ true | false

Used to prevent infinite loops in associated validations.

Examples:

Is the document validated?

document.validated?

Returns:

  • (true | false) —

    Has the document already been validated?

[View source]

109
110
111
 
# File 'lib/mongoid/validatable.rb', line 109

def validated?
  Threaded.validated?(self)
end

#validating ⇒ Object

Perform a validation within the associated block.

[View source]

43
44
45
46
47
48
 
# File 'lib/mongoid/validatable.rb', line 43

def validating
  begin_validate
  yield
ensure
  exit_validate
end

#validating_with_query? ⇒ true | false

Are we currently performing a validation that has a query?

Examples:

Are we validating with a query?

document.validating_with_query?

Returns:

  • (true | false) —

    If we are validating with a query.

[View source]

119
120
121
 
# File 'lib/mongoid/validatable.rb', line 119

def validating_with_query?
  self.class.validating_with_query?
end