Update - 14th February 2016:
Looking in my blog stats, this continues to be one of my most popular articles, so it is most definitely worth an update. As of v4.2.0 Automapper has been updated to remove the static implementation. I've not had chance to play with the new version yet but I would imagine this version will now work with any IoC container you wish to use it with.
The main “Mapper” class of the AutoMapper framework is a static class which does make the initial testing and usage really easy but quickly causes problems if you’re using an Inversion of Control framework such as a Castle Windsor. Also being static it is far harder to abstract the AutoMapper framework out of any unit tests using mocking frame such as MOQ. As a final point for all these reasons using AutoMapper directly could cause problems in the future if it was decided to switch to another mapping framework.
The following code handles all of the above concerns / issues by wrapping the AutoMapper static instance up into a single bespoke mapping class. At a first glance this would appear to be a step backwards as it requires each object to object mapping to be defined as a method in the interface and implementing class. However for very little overhead or extra coding this comes with a benefit of abstracting the “how” of the mapping from the calling code. It would be easy to add another mapping framework into the Mapper class below and then update individual methods to use that new mapping framework. It also helps prevent any premature optimisations as the code can be deployed with new methods using mappings that provide the maximum automation and minimal manual configuration. If performance issues then arise during testing or live usage, individual methods/mappings can be tackled to provide better performance – which for maximum throughput if the situation required it could result in the mapping framework(s) being by-passed completely and all initialisation of the target class performed directly within the mapping method.
using am = Automapper;
public interface IMapper
CustomerEntity MapCustomer(CreateCustomerMsg msg);
CustomerEntity MapCustomer(UpdateCustomerMsg msg);
public class Mapper : IMapper
// All creation code in the static constructoram.Mapper.CreateMap<CreateCustomerMsg, CustomerEntity>();