Skip to main content
3 de 3
removeu 1 caractere do conteúdo
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 objetivo é 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.

Veja 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.

Podem ser usadas expressões para fazer a validação. Em C# podemos ter:

var total = obj == null ? 0 : obj.Total;
var total = obj?.Total;  // só exemplo, total sera null, vai falhar em seguida
var div = valor == 0 ? 1 : valor;
Ricardo Pontual
  • 23,2mil
  • 2
  • 33
  • 64