在Asp.net (core)中使用AutoMapper（1）why & how

1. why

考虑以下类：

namespace AutoMapperTest
{    public class Author
    {
        public string Name { get; set; }
    }    public class Book
    {
        public string Title { get; set; }        public Author Author { get; set; }
    }    public class BookViewModel
    {
        public string Title { get; set; }        public string Author { get; set; }
    }
}

如果想得到一个理想中的BookViewModel, 不借助任何类的帮助，我们可能会这样写：

BookViewModel model = new BookViewModel
{
    Title = book.Title,
    Author = book.Author.Name
}

嗯，看起来还好...
但如果BookViewModel类有20个字段呢？40个？写这样的代码可以直接写吐。不能忍。这时候有请AutoMapper上场。

2. how

• 安装
  

  从NuGet添加Automapper包

  
  或者install-package automapper

• 基本使用

Mapper.Initialize(cfg => cfg.CreateMap<Book, BookViewModel>());//或者//var config = new MapperConfiguration(cfg => cfg.CreateMap<Book, BookViewModel>());//config.CreateMapper();

然后就可以使用Mapper了：

Book book = new Book { Author = new Author { Name = "Angeladaddy" }, Title = "Java两周从入门到放弃" };var model = Mapper.Map<BookViewModel>(book);

此时运行程序不会报错，但是mapper结果不正确：

image.png

原因大家都能看到，mapper并不能自动识别不符合concention约定的字段定义，Author属性是个对象，我们必须告诉mapper该怎么样映射这个对象。

//修改map定义，将Book.Author.Name 映射到 BookViewModel的Author
 Mapper.Initialize(                cfg => cfg.CreateMap<Book, BookViewModel>()
                    .ForMember(dest => dest.Author, 
                    opts => opts.MapFrom(src => src.Author.Name))
                );

image.png

that's all, 有关automapper知道这么多就基本能用了。需要注意的一点是，mapper定义必须越早越好。

2.1 在asp.net 中使用Automapper

其实我们使用automapper最常见的场景应该是在web开发中，由于前端模型定义和后端往往不一致，为了建立两者间的映射，我们不得不手动映射。有了automapper，这一切都方便了很多。
建立一个asp.net core 的api项目作为演示：

红框为添加或改动的内容

• Models中，我们定义最常见的用户模型，方便起见，我们不引入数据库。

    public class User
    {
        [Key]        public int Id { get; set; }        public string Name { get; set; }        public string Email { get; set; }        public string Password { get; set; }        public DateTime CreatedOn { get; set; } = DateTime.UtcNow;
    }    public class UserViewModel
    {
        [Required]        public string Name { get; set; }
        [Required, DataType(DataType.EmailAddress)]        public string Email { get; set; }
        [Required, DataType(DataType.Password)]        public string Password { get; set; }
        [Required, DataType(DataType.Password), Compare("Password")]        public string ConfirmPassword { get; set; }
        [Required]        public bool AgreedToTerms { get; set; }
    }

前端传进来的模型中多了ConfirmPassword 字段和AgreedToTerms 字段，这些字段我们不希望存入数据库，所以我们要建立UserViewModelUser（数据库类）的映射。
用Automapper我们的映射应该是这个样子：

var config = new AutoMapper.MapperConfiguration(cfg =>{
    cfg.CreateMap<UserViewModel, User>();
});var mapper = config.CreateMapper();

但是这段代码我们应该放在那里呢？这是一个web应用，我们的映射定义应该放在尽可能早的地方。那放在Startup.cs文件中的ConfigureServices方法中最合适不过：

 public void ConfigureServices(IServiceCollection services)
{            var config = new AutoMapper.MapperConfiguration(cfg =>
            {
                cfg.CreateMap<UserViewModel, User>();
            });            var mapper = config.CreateMapper();
            services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2);
}

但如果我们的映射类较多，这里就会显得很臃肿。而且这个map我想在所有地方可用，那最好是定一个service进行注入。
比较好的做法是建立一个profile，统一放置。新建AutoMapperProfileConfiguration.cs文件，在其中定义所有映射：

    public class AutoMapperProfileConfiguration : Profile
    {
         public AutoMapperProfileConfiguration() : this("MyProfile") { }

        protected AutoMapperProfileConfiguration(string profileName):base(profileName)
        {
            CreateMap<UserViewModel, User>();
        }
    }

然后在Startup中进行实例化并注册单例：

        public void ConfigureServices(IServiceCollection services)
        {            var config = new AutoMapper.MapperConfiguration(cfg => {
                cfg.AddProfile(new AutoMapperProfileConfiguration());
            });            var mapper = config.CreateMapper();
            services.AddSingleton(mapper);
            services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2);
        }

一切就绪，我们新建UsersController测试：

    [Route("api/[controller]")]
    [ApiController]    public class UsersController : ControllerBase
    {        private readonly IMapper _mapper;        public UsersController(IMapper mapper)
        {
            _mapper = mapper;
        }
        [HttpPost]        public JsonResult Index(UserViewModel uservm)
        {
            var user = _mapper.Map<User>(uservm);            return new JsonResult(user) ;
        }

    }

automapper正确进行了映射，去除了多余字段

作者：Angeladaddy
链接：https://www.jianshu.com/p/3394f84130d6