Tratando Valores Nulos no Thymeleaf Sem Erros de Parsing
Resposta Rápida
Ao trabalhar com valores null no Thymeleaf, é recomendado usar o operador Elvis:
<!-- O operador Elvis ajuda a lidar corretamente com null -->
<span th:text="${value} ?: 'Texto Padrão'"></span>Se a variável value for null, o texto "Texto Padrão" aparecerá na página. Para renderização condicional, use th:if/th:unless:
<!-- Se o valor existir, exiba-o. -->
<span th:if="${value}" th:text="${value}"></span>
<!-- Se o valor for nulo, mostre o texto padrão. -->
<span th:unless="${value}" th:text="'Texto Padrão'"></span>Essas técnicas permitirão gerenciar eficazmente valores null em templates Thymeleaf.
Usando o Operador Seguro para Null no Thymeleaf
Para acessar de forma segura propriedades de um objeto que pode ser null, use o operador seguro para null (?):
<!-- Verifique se o objeto que estamos referenciando existe? -->
<span th:text="${user?.name}"></span>Quando user for null, uma NullPointerException não será lançada. No entanto, lembre-se da necessidade do SpringStandardDialect. Sem o suporte do Dialeto Spring MVC, você precisará configurá-lo manualmente:
// Defina o dialeto a ser usado pelo Thymeleaf
templateEngine.setDialect(new SpringStandardDialect());Usando Métodos Auxiliares para Definir Valores Padrão
Para facilitar o manuseio de valores null, utilize o método embutido do Thymeleaf ${#objects.nullSafe(obj, default)}:
<!-- Se o usuário não estiver definido, considere-o um convidado. -->
<span th:text="${#objects.nullSafe(user, 'Convidado')}"></span>Se user for null, a página exibirá "Convidado". Esta ferramenta é útil para lidar com valores de preenchimento.
Visualização
Imagine o Thymeleaf como um circuito elétrico, onde as variáveis são lâmpadas:
| Status da Variável | Reação do Thymeleaf | Visualização |
|---|---|---|
| Valor Existe | Circuito fechado (💡 ligado) | 🌟 |
Valor é null |
Circuito aberto (💡 desligado) | 🌑 |
Ao encontrar um valor null, o Thymeleaf se comporta como se houvesse uma quebra no circuito:
Thymeleaf: 🧐 "Há dados para exibir?"
Variável: 🔌---[null]---💡 "Sem conexão, a lâmpada está desligada!"A solução para este problema é fornecer um valor padrão, que garante que o circuito esteja fechado:
<!-- Prepare-se antecipadamente para uma possível falta de valor -->
<div th:text="${variable != null ? variable : 'Texto Padrão'}">Valor Substituto</div>Agora, mesmo na ausência de um valor (`null`), nosso circuito controla a situação:
Variável: 🔌---[Valor Substituto:💬]---💡 "Usando o substituto, o cenário é bem-sucedido!"Considerando Valores Nulos em Formulários e Entrada do Usuário
Para trabalhar com formulários e entrada do usuário, onde null pode levar a erros, use uma combinação de th:value e th:attr:
<!-- Nome? Elemento opcional, mas se ausente, solicite a entrada. -->
<input type="text" th:value="${user?.name}" th:attr="placeholder=${user?.name ?: 'Digite seu nome'}" />Esta ação ajuda a prevenir erros ao processar formulários com objetos cujas propriedades podem ser null.
Escrevendo Código Seguro para Nulos
Apesar da conveniência que o Thymeleaf oferece ao lidar com valores null, evite verificações frequentes de null em templates. É aconselhável projetar a lógica da aplicação de forma que as chances de null ocorrerem sejam minimizadas.
Exemplos Práticos de Tratamento de Nulos
Aqui estão alguns exemplos comuns de como tratar nulos no Thymeleaf:
- Perfis de Usuário: Informações são exibidas apenas quando disponíveis.
- Listas de Produtos: Quando não há preço ou descrição, valores padrão são mostrados.
- Envio de Formulário: Campos são preenchidos com dados salvos ou um valor padrão é usado.
Não se esqueça de acompanhar atualizações na documentação do Thymeleaf, pois você encontrará muitas dicas úteis lá.