Mapeie DTOs para modelos de domínio

Na prática, seu aplicativo tem duas formas de dados: o DTO bruto da API e o modelo de domínio limpo que o seu código espera.

Um DTO, ou objeto de transferência de dados, reproduz exatamente o JSON, mesmo quando os nomes dos campos são confusos ou pouco práticos.

Se todo o aplicativo usar DTOs, uma pequena alteração na API se espalhará por toda parte. Um modelo de domínio protege você disso.

O modelo de domínio é moldado para o seu código: nomes claros, nenhum valor nulo desnecessário e exatamente os campos de que a interface precisa.

Escreva uma pequena função de mapeamento que transforme um DTO em um modelo de domínio, tudo em um único local organizado e testável.

O mapeamento é o lugar ideal para aplicar valores padrão, para que campos JSON ausentes ou nulos nunca façam o restante do aplicativo falhar.

Para uma resposta em lista, chame map na coleção para converter todos os DTOs em itens de domínio de uma só vez.

O repositório busca os DTOs e depois os mapeia para modelos de domínio, para que os chamadores vejam apenas o tipo limpo.

Mantenha as classes DTO internas à camada de dados. Nada fora do repositório deve importá-las.

Agora a API pode renomear um campo, e você corrige apenas o mapeador, enquanto o modelo de domínio e a interface do usuário permanecem estáveis.

Esta é a fronteira em ação: um DTO entra, o mapeador é executado e um modelo de domínio limpo sai.

Os DTOs reproduzem o JSON bruto e permanecem na camada de dados, enquanto uma função de mapeamento os transforma em modelos de domínio limpos usados pelo restante do aplicativo.