Module: Mongoid::Validatable::Macros

Extended by:
ActiveSupport::Concern
Defined in:
lib/mongoid/validatable/macros.rb

Overview

Mixin module included in Mongoid::Document which adds various validation macro methods, such as validates_presence_of and validates_uniqueness_of.

Instance Method Summary collapse

Instance Method Details

#validates_associated(*args) ⇒ Object

Validates whether or not an association is valid or not. Will correctly handle has one and has many associations.

Examples:


class Person
  include Mongoid::Document
  embeds_one :name
  embeds_many :addresses

  validates_associated :name, :addresses
end

Parameters:

  • *args (Object...) —

    The arguments to pass to the validator.



25
26
27
 
# File 'lib/mongoid/validatable/macros.rb', line 25

def validates_associated(*args)
  validates_with(AssociatedValidator, _merge_attributes(args))
end

#validates_format_of(*args) ⇒ Object

Validates the format of a field.

Examples:

class Person
  include Mongoid::Document
  field :title

  validates_format_of :title, with: /\A[a-z0-9 \-_]*\z/i
end

Parameters:

  • *args (Object...) —

    The names of the field(s) to validate.



57
58
59
 
# File 'lib/mongoid/validatable/macros.rb', line 57

def validates_format_of(*args)
  validates_with(FormatValidator, _merge_attributes(args))
end

#validates_length_of(*args) ⇒ Object

Validates the length of a field.

Examples:

class Person
  include Mongoid::Document
  field :title

  validates_length_of :title, minimum: 100
end

Parameters:

  • *args (Object...) —

    The names of the field(s) to validate.



72
73
74
 
# File 'lib/mongoid/validatable/macros.rb', line 72

def validates_length_of(*args)
  validates_with(LengthValidator, _merge_attributes(args))
end

#validates_numericality_of(*args) ⇒ Object

Validates whether or not a field contains a numeric value.

Examples:

class Person
  include Mongoid::Document
  field :cost

  validates_numericality_of :cost
end

Parameters:

  • *args (Object...) —

    The names of the field(s) to validate.



102
103
104
 
# File 'lib/mongoid/validatable/macros.rb', line 102

def validates_numericality_of(*args)
  validates_with(NumericalityValidator, _merge_attributes(args))
end

#validates_presence_of(*args) ⇒ Object

Validates whether or not a field is present - meaning nil or empty.

Examples:

class Person
  include Mongoid::Document
  field :title

  validates_presence_of :title
end

Parameters:

  • *args (Object...) —

    The names of the field(s) to validate.



87
88
89
 
# File 'lib/mongoid/validatable/macros.rb', line 87

def validates_presence_of(*args)
  validates_with(PresenceValidator, _merge_attributes(args))
end

#validates_uniqueness_of(*args) ⇒ Object

Validates whether or not a field is unique against the documents in the database.

Examples:


class Person
  include Mongoid::Document
  field :title

  validates_uniqueness_of :title
end

Parameters:

  • *args (Object...) —

    The arguments to pass to the validator.



42
43
44
 
# File 'lib/mongoid/validatable/macros.rb', line 42

def validates_uniqueness_of(*args)
  validates_with(UniquenessValidator, _merge_attributes(args))
end