Skip to main content
1 de 3
Ricardo Pontual
  • 23,2mil
  • 2
  • 33
  • 64

Cláusula de guarda é uma cláusula quer permite validar uma variável, normalmente um input, e garantir que ela tem um valor que seja possível utilizar no código.

Não é uma validação de negócio, como por exemplo se uma data é posterior a data atual, é por exemplo:

  • Se um valor não é nulo;
  • Se um valor de um número identificador não é zero;
  • Se uma string não está nula ou vazia;
  • Se uma injeção de dependência foi corretamente injetada

Alguns exemplos apenas, mas o objeto é fazer a salvaguarda do método/função/módulo de que os valores tem o mínimo para poder seguir com a execução do código.

Imagine por exemplo esse código:

public void Calcular(AlgumaClasse obj, int valor)
{
   var x = obl.Total / valor;
}

O que vai acontecer se o obj estiver nulo, ou valor for igual a zero? Vai dar de referência nula e/ou divisão por zero.

Um guard clause aqui podeira ser assim:

public void Calcular(AlgumaClasse obj, int valor)
{
   if (obj == null)
   {
       throw new ArgumentNullException("obj não pode ser nulo");
   }

   if (valor == 0)
   {
       throw new ArgumentInvalidException("valor não pode ser zero");
   }

   var x = obj.Total / valor;
}

Portanto o código teria uma salvaguarda com valores mal informados, lembrando que é só um exemplo da estrutura de como guardar o código, que pode ser implementado de diversas maneiras.

Ricardo Pontual
  • 23,2mil
  • 2
  • 33
  • 64