Automapper

Description

Permet le mapping d'un objet de type A vers un objet de type B.
AutoMapper utilise des convention de mapping afin de réduire le paramétrage:

• Propriétés de même nom
• Flattening
• Ignore les références null

Liens

• Getting Started
• Static and Instance API
• AutoMapper.Collection bibliothèque externe pour géré les collections
• Map 1 object to list of objects

Setup and configuration

var config = new MapperConfiguration(cfg => { // configure mapping from Source to Dest cfg.CreateMap<Source, Dest>(); // load the configuration from AppProfile cfg.AddProfile<AppProfile>(); // load the configuration from all classes who inherits from Profile in the current assembly cfg.AddProfiles(typeof(ContainerConfig).Assembly); }); IMapper mapper = config.CreateMapper(); IMapper mapper = new Mapper(config);

• Configuration

Profile

AProfile.cs

internal sealed class AProfile : Profile { public AProfile() { this.CreateAToBMapping(); this.CreateBToAMapping(); } private void CreateAToBMapping() { this.CreateMap<A, B>() .ForMember(dest => dest.B1, opt => opt.MapFrom(src => src.A1)); } private void CreateBToAMapping() { this.CreateMap<B, A>() .ForMember(dest => dest.A1, opt => opt.MapFrom(src => src.B1)); .ForAllOtherMembers(opt => opt.Ignore()); // ignore all other members } }

Dependency Injection

Add the nuget package AutoMapper.Extensions.Microsoft.DependencyInjection

Startup.cs

public void ConfigureServices(IServiceCollection services) { // add as parameter one type for each assembly services.AddAutoMapper(typeof(ProfileTypeFromAssembly1), typeof(ProfileTypeFromAssembly2));

Exemple

var config = new MapperConfiguration(cfg => { cfg.CreateMap<A, B>() .ForMember(dst => dst.Q2, opts => opts.MapFrom(src => src.P2)); // map A.P2 → B.Q2 .ReverseMap(); // map B → A }); IMapper mapper = config.CreateMapper(); C c = new C() { P1 = 3 }; A a = new A() { P1 = 1, C1 = c }; B b = mapper.Map<B>(a); // b.P1 = 1, b.Q2 = 2, b.C1P1 = 3 class A { public int P1 { get; set; } public int P2 { get; set; } public C C1 { get; set; } } class B { public int P1 { get; set; } // mapping par convention avec A.P1 public int Q2 { get; set; } // mapping par configuration avec A.P2 public int C1P1 { get; set; } // mapping par flattening avec A.C1.P1 } class C { public int P1 { get; set; } }

• Flattening

If the mapping has not been configured, you will get an AutoMapper.AutoMapperMappingException

List and polymorphism

// avec une liste List<B> listB = Mapper.Map<List<A>, List<B>>(listA); // polymorphism cfg.CreateMap<Parent1, Parent2>() .Include<Child1, Child2>(); // IncludeAllDerived(); to include all the derived classes // without the include, the resulting list contains only Parent2 objects (no Child2 objects) cfg.CreateMap<Child1, Child2>(); var lp1 = new List<Parent1> { new Parent1 { P1 = 1}, new Child1 { P1 = 2, P2 = 22 } }; var lp2 = mapper.Map<List<Parent2>>(lp1); // Parent2, Child2 class Parent1 { public int P1 { get; set; } } class Child1 : Parent1 { public int P2 { get; set; } } class Parent2 { public int P1 { get; set; } } class Child2 : Parent2 { public int P2 { get; set; } }

• Mapping Inheritance

Pass parameter to the mapping

var config = new MapperConfiguration(cfg => { cfg.CreateMap<A, B>() .ForMember(dest => dest.P1, opt => opt.MapFrom((src, dest, destMember, resContext) => src.P1 + (int)resContext.Items["+"])); }); IMapper mapper = config.CreateMapper(); var a = new A { P1 = 1 }; var b = mapper.Map<B>(a, opt => opt.Items["+"] = 9);

Map 1 object to multiple objects

class Group { public int Id { get; set; } public ICollection<int> UserIds { get; } = new List<int>(); } class User { public int Id { get; set; } public int GroupId { get; set; } }

Flatten to ValueType

var config = new MapperConfiguration(cfg => { cfg.CreateMap<(Group group, int userId), User>() .IncludeMembers(s => s.group) // call the mapping Group → User .ForMember(dest => dest.Id, opt => opt.MapFrom(src => src.userId)); cfg.CreateMap<Group, User>() .ForMember(dest => dest.GroupId, opt => opt.MapFrom(src => src.Id)) .ForMember(dest => dest.Id, opt => opt.Ignore()); }); IMapper mapper = config.CreateMapper(); var group = new Group { Id = 9, UserIds = {1, 2, 3} }; IEnumerable<(int groupId, int userId)> groupAndUserList = group.UserIds.Select(x => ValueTuple.Create(group.Id, x)); var users = mapper.Map<IEnumerable<User>>(groupAndUserList).ToList();

Flatten with a ITypeConverter

var config = new MapperConfiguration(cfg => { cfg.CreateMap<int, User>() .ForMember(dest => dest.Id, opt => opt.MapFrom(src => src)); cfg.CreateMap<Group, User>() .ForMember(dest => dest.GroupId, opt => opt.MapFrom(src => src.Id)) .ForMember(dest => dest.Id, opt => opt.Ignore()); cfg.CreateMap<Group, IEnumerable<User>>() .ConvertUsing<GroupToUsersConverter>(); }); IMapper mapper = config.CreateMapper(); var group = new Group { Id = 9, UserIds = { 1, 2, 3 } }; var users = mapper.Map<IEnumerable<User>>(group).ToList(); // use a converter to flatten a Group class GroupToUsersConverter : ITypeConverter<Group, IEnumerable<User>> { public IEnumerable<User> Convert( Group source, IEnumerable<User> destination, ResolutionContext context) { foreach (var userId in source.UserIds) { var user = context.Mapper.Map<User>(userId); context.Mapper.Map(source, user); yield return user; } } }

MOQ

var mapperMock = new Mock<IMapper>(); mapperMock.Setup(x => x.Map<ItemDto>(It.IsAny<Item>())) .Returns(new ItemDto());

Unit tests

var configuration = new MapperConfiguration(cfg => cfg.AddProfile<ItemProfile>()); configuration.AssertConfigurationIsValid(); var mapper = configuration.CreateMapper(); var item = new Item { /* ... */ }; var itemDto = mapper.Map<ItemDto>(item); var mappedItem = mapper.Map<Item>(itemDto); Assert.Equal(item.Property1, mappedItem.Property1);

Installation

NuGet → AutoMapper

ASP.NET Core

NuGet → AutoMapper.Extensions.Microsoft.DependencyInjection

Startup.cs

public void ConfigureServices(IServiceCollection services) { services.AddAutoMapper();

MyController.cs

private readonly IMapper _mapper; public MyController(IMapper mapper) { _mapper = mapper; B b = _mapper.Map<A, B>(a);

Configuration dans Profile