Como tornar a resposta de Spring Boot mais eficiente ao usar ResponseEntity com Map

Ao trabalhar com ResponseEntity em Spring Boot, especialmente ao montar respostas com Map, uma dúvida comum é se há uma abordagem mais eficiente que criar e preencher um HashMap manualmente.

No exemplo padrão, fazemos algo assim:

@GetMapping("/api/payments/reservation/{idReservation}")
public ResponseEntity<Map<String, Object>> obtenerPagoReal(@PathVariable("idReservation") int idReservation) {
    Payment pay = dao_interface.findByIdReserva(idReservation). Map<String, Object> response = new HashMap<>(). response.put("payment", pay). // outros atributos
    return ResponseEntity.ok(response). }

Existem alternativas que podem ajudar a otimizar essa construção, como o uso de Collections.singletonMap() ou até mesmo criar classes de DTO específicas para a resposta. Esses métodos reduzem a complexidade e podem melhorar a legibilidade e desempenho.

Para casos simples, usar Collections.singletonMap() é uma boa prática, mas limita a quantidade de chaves. Caso precise de múltiplos atributos, uma abordagem com DTO é mais limpa e segura. O valor aparece melhor quando operação, produto e engenharia olham para o mesmo risco. Por isso, o recorte precisa considerar manutenção, validação e caminho de volta.

Qual a experiência de vocês nesse aspecto? Preferem montar o Map manualmente ou já migraram para classes específicas de resposta? Por isso, o recorte precisa considerar manutenção, validação e caminho de volta. Esse contexto ajuda a separar ganho real de novidade difícil de sustentar. A decisão fica mais saudável quando o time consegue medir o impacto depois. Sem esse critério, a solução pode parecer simples no começo e cara no suporte.