UAMapper.MapUtils 1.0.0

DataAnnotationsMapper Um utilitário de mapeamento de objetos (object-to-object) simples, leve e de configuração zero para .NET.

Este pacote fornece métodos de extensão (.MapTo<T>()) que usam reflection para copiar propriedades entre dois objetos baseando-se em nome e tipo.

Seu principal diferencial é o suporte nativo ao atributo [MaxLength] de System.ComponentModel.DataAnnotations. Ao mapear uma string para uma propriedade de destino que possui este atributo, o valor será automaticamente truncado para o comprimento máximo permitido, evitando exceções de banco de dados ou validação.

Principais Características Leve e Rápido: Sem dependências extras além do System.ComponentModel.DataAnnotations.

Configuração Zero: Apenas instale e use. Nenhuma configuração de profiles ou mapas é necessária.

Consciente de [MaxLength]: Trunca strings automaticamente para respeitar o [MaxLength] da propriedade de destino.

Suporte a Nullable: Lida corretamente com mapeamento entre tipos anuláveis e não anuláveis (ex: int? para int).

Métodos de Extensão: Integração limpa e fluente com seu código (origem.MapTo<Destino>()).

Instalação Package Manager Console

PowerShell

Install-Package SeuPacote.DataAnnotationsMapper .NET CLI

Bash

dotnet add package SeuPacote.DataAnnotationsMapper (Substitua SeuPacote.DataAnnotationsMapper pelo PackageId real que você escolheu)

Como Usar Suponha que você tenha um DTO (Data Transfer Object) vindo de uma requisição e uma Entidade que irá para o banco de dados.

1. Definição das Classes Objeto de Origem (DTO):

C#

// Objeto de origem, ex: um DTO de API public class CreateUserInput { public string Username { get; set; } public string Comment { get; set; } public int? Age { get; set; } } Objeto de Destino (Entidade): Note o atributo [MaxLength] na propriedade Comment.

C#

using System.ComponentModel.DataAnnotations;

// Objeto de destino, ex: uma entidade do EF Core public class UserEntity { public string Username { get; set; }

[MaxLength(50)] // <-- O mapper vai respeitar isso!
public string Comment { get; set; }

public int Age { get; set; }

// Propriedade extra que não existe na origem (será ignorada)
public DateTime CreatedAt { get; set; } = DateTime.UtcNow;

} 2. Mapeando um Objeto (MapTo) Importe o namespace para habilitar os métodos de extensão e chame MapTo<T>().

C#

// Importe o namespace do seu pacote using App.Shared.Utils; // (Ou o namespace que você definiu)

// 1. O DTO de origem com dados var userInput = new CreateUserInput { Username = "bira.dev", Age = 30, Comment = "Este é um comentário muito, muito, muito longo que definitivamente vai exceder o limite de 50 caracteres." };

// 2. Mapear! var userEntity = userInput.MapTo<UserEntity>();

// 3. O Resultado // userEntity.Username == "bira.dev" // userEntity.Age == 30 // userEntity.Comment == "Este é um comentário muito, muito, muito longo que d" (Truncado em 50 chars) // userEntity.CreatedAt == (data/hora atual, pois não foi mapeado) 3. Mapeando uma Lista (MapListTo) Você também pode mapear coleções de objetos de forma fluente.

C#

// 1. Lista de origem var dtoList = new List<CreateUserInput> { new CreateUserInput { Username = "usuario1", Comment = "Comentário curto." }, new CreateUserInput { Username = "usuario2", Comment = "Outro comentário muito, muito, muito longo que também será truncado." } };

// 2. Mapear a lista! var entityList = dtoList.MapListTo<UserEntity>();

// entityList agora é um IEnumerable<UserEntity> com os dados mapeados. Como Funciona (Detalhes) O MapTo usa System.Reflection para iterar sobre as propriedades públicas do objeto de origem. Para cada propriedade, ele procura no objeto de destino por uma propriedade pública que atenda a dois critérios:

Ter o mesmo nome (case-sensitive).

Ter o mesmo tipo (ou o tipo base, no caso de Nullable<T>).

Se uma propriedade correspondente for encontrada e for "escrevível" (set), seu valor é copiado.

Licença Este projeto está licenciado sob a licença MIT.