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;