Validação do documento

Definir uma regra de validação

Use a macro validates para criar uma regra de validação e, em seguida, inclua o assistente de validação e as especificações necessárias para a regra.

O código abaixo demonstra como usar o assistente de validação presence para exigir que as instâncias Person contenham um valor para o campo name:

class Person
  include Mongoid::Document
  
  field :name, type: String
  validates :name, presence: true
end

Você pode aprender sobre outros auxiliares de validação úteis na seção Validações comuns deste guia.

Regra de comparação

Você pode usar o assistente comparison para validar um documento com base no valor de um campo especificado.

O assistente comparison oferece suporte às seguintes opções:

• greater_than: O valor deve ser maior que o valor fornecido.

• greater_than_or_equal_to: O valor deve ser maior ou igual ao valor fornecido.

• equal_to: O valor deve ser igual ao valor fornecido.

• less_than: O valor deve ser menor que o valor fornecido.

• less_than_or_equal_to: O valor deve ser menor ou igual ao valor fornecido.

• other_than: O valor deve ser diferente do valor fornecido.

Este exemplo define as seguintes regras de validação de comparação no modelo Order :

• delivery_date: deve ser posterior (maior que) ao valor de order_date

• quantity: Deve ser menor que 5

class Order
  include Mongoid::Document
  
  field :order_date, type: DateTime
  field :delivery_date, type: DateTime
  field :quantity, type: Integer
  validates :delivery_date, comparison: { greater_than: :order_date }
  validates :quantity, comparison: { less_than: 5 }
end

Regra de Formatação

Você pode usar o assistente format para validar um documento com base no fato de um valor de campo corresponder a uma expressão regular. Use a opção with para especificar a expressão regular.

Este exemplo define uma regra de validação de formato no modelo User para garantir que o campo username contenha apenas letras:

class User
  include Mongoid::Document
  
  field :username, type: String
  validates :username, format: { with: /\A[a-zA-Z]+\z/ }
end

validates_format_of :username, with: /\A[a-zA-Z]+\z/

Regra de inclusão ou exclusão

Você pode usar os auxiliares inclusion e exclusion para validar um documento com base no fato de um valor de campo estar em uma lista de valores especificada. Utilize a opção in para especificar a lista de valores.

Este exemplo define uma regra de validação de inclusão no modelo Order para garantir que o valor de campo shipping seja um dos valores aceitos:

class Order
  include Mongoid::Document
  
  field :shipping, type: String
  validates :shipping, inclusion: { in: %w(standard priority overnight) }
end

Regra de presença ou ausência

Você pode usar os auxiliares presence e absence para validar um documento com base na presença ou ausência de um valor de campo (vazio).

Este exemplo define uma regra de validação de ausência no modelo Order para garantir que o valor do campo delivery_date seja nil ou uma string vazia:

class Order
  include Mongoid::Document
  
  field :delivery_date, type: String
  validates :delivery_date, absence: true
end

validates_presence_of :delivery_date

Regra de singularidade

Você pode usar o assistente uniqueness para validar um documento com base no fato de um valor de campo ser exclusivo de outros valores na coleção. Você pode usar a opção scope para especificar um ou mais nomes de campo que o Mongoid usa para limitar a verificação de exclusividade.

Este exemplo define uma regra de validação de exclusividade no modelo Person para garantir que o valor de campo first_name seja exclusivo em documentos que têm o mesmo valor de last_name:

class Person
  include Mongoid::Document
  
  field :first_name, type: String
  field :last_name, type: String
  validates :first_name, uniqueness: { scope: :last_name }
end

validates_uniqueness_of :first_name

validates_uniqueness_of :name, conditions: -> { where(:age.gte => 10) }

Validar associações

Você pode utilizar o assistente validates_associated para validar quaisquer associações que seu modelo tenha. Quando você inclui essa regra de validação, o Mongoid valida quaisquer documentos de associação sempre que você tentar salvar uma instância. Para saber mais sobre associações, consulte o guia Associações do.

Este exemplo define uma regra de validação de associação no modelo Author para executar as regras de validação para as instâncias Book incorporadas:

class Author
  include Mongoid::Document
  
  embeds_many :books
  validates_associated :books
end

Regras de validação personalizadas

Você pode utilizar os ajudantes do validates_each e validates_with para criar validadores personalizados. Para saber mais sobre esses auxiliares e ver exemplos, consulte as referências validates_each e validates_with na documentação do Active Record.

Para saber mais sobre validadores personalizados,consulte Executando validações personalizadas na documentação do Active Record.

Validação do trigger

Você pode executar validações manualmente utilizando o método valid?. Esse método retorna true se o objeto passar na validação e false caso contrário:

class Person
  include Mongoid::Document
  
  field :name, type: String
  field :age, type: Integer
  validates :age, comparison: { greater_than_or_equal_to: 0 }
end
# Returns true
Person.new(name: "Berta Odom", age: 4).valid?
# Returns false
Person.new(name: "Cody Peng", age: -5).valid?

O Mongoid se comporta de forma diferente do Active Record ao executar valid? em dados persistentes. O valid? do Active Record executa todas as validações, mas o valid? do Mongoid executa validações somente em documentos que estão na memória para otimizar o desempenho.