Automapper實現自動映射

出於安全考慮，在后台與前台進行數據傳輸時，往往不會直接傳輸實體模型，而是使用Dto（Data transfer object 數據傳輸對象），這樣在后台往前台傳遞數據時可以省略不必要的信息，只保留必要的信息，大大增強數據安全性。

下面給出兩個相互對應的關系模型User、UserDto

public class User
{
    private const int NameMaxLength = 20;

    private const int PassWordMaxLength = 16;

    [Key]
    public long Id { get; }


    [MaxLength(NameMaxLength)]
    public string Name { get; set; }

    [MaxLength(PassWordMaxLength)]
    [DataType(DataType.Password)]
    public string PassWord { get; set; }
}

public class UserDto
{
    private const int NameMaxLength = 20;

    private const int PassWordMaxLength = 16;

    [MaxLength(NameMaxLength)]
    public string Name { get; set; }

    [MaxLength(PassWordMaxLength)]
    public string PassWord { get; set; }
}

這里將 Id 定義為自增長主鍵，在注冊頁面，這個 Id 應不可見，這個時候使用Dto的好處就體現出來了，這個時候，在存入數據庫時會涉及到 UserDto 往 User 的類型轉換，按照之前的經驗，肯定可以按照下面這樣來寫：

user.Name=userDto.Name;
user.PassWord=UserDto.PassWord;

這樣的轉換固然可以，但是如果一個 User 對象足夠復雜，有十幾個甚至二十幾個屬性，這個時候這種寫法就會顯得十分笨拙。

這個時候我們就可以借助AutoMapper來幫助我們完成 UserDto 到 User 的轉換了。

首先安裝Nuget包

在 Tools - Nuget Package Manage - Package Manage Console 輸入

Install-Package AutoMapper 

安裝相應的Nuget包。

根據 Github 上給出的幫助文檔來看，有兩種方法可以創建映射，一種是靜態的 Initalize 一種是動態創建。

下面使用兩種不同的方法來進行單元測試

    public void Using_Initlalize_Test()
    {
        UserDto dto = new UserDto
        {
            Name = "Niko",
            PassWord = "1234",
        };
        Mapper.Initialize(ctx => ctx.CreateMap<UserDto, User>());
        User user = Mapper.Map<UserDto, User>(dto);
        user.Name.ShouldBe("Niko");
        user.PassWord.ShouldBe("1234");
        user.Id.ToString().ShouldBe("0");
    }

    public  void Using_MapperConfiguration_Test()
    {
        var config = new MapperConfiguration(ctx => ctx.CreateMap<UserDto, User>());
        var mapper = config.CreateMapper();
       // var mapper = new Mapper(config);
        UserDto dto = new UserDto
        {
            Name = "Niko",
            PassWord = "1234",
        };
        User user = mapper.Map<User>(dto);
        //User user = Mapper.Map<User>(dto);
        user.Name.ShouldBe("Niko");
        user.PassWord.ShouldBe("1234");
        user.Id.ToString().ShouldBe("0");
    }

這里使用到 Shouldly 斷言框架，具體用法參考官方文檔。

寫完規則之后 通常會調用 AssertConfigurationIsValid 方法，檢查規則是否完整

        Mapper.AssertConfigurationIsValid();

兩種方法，單元測試均通過。這樣的話，借助 Automapper 處理復雜的對象映射，將大大簡化我們的代碼量。

為了更加便捷地使用 AutoMappper ,對AutoMapper進行擴展

 public static class AutoMapperExtension
{
    /// <summary>
    /// 對象到對象
    /// </summary>
    /// <typeparam name="T"></typeparam>
    /// <param name="obj"></param>
    /// <returns></returns>

    public static T MapTo<T>(this object obj)
    {
        if (obj == null) return default(T);
        Mapper.Initialize(ctx=>ctx.CreateMap(obj.GetType(),typeof(T)));
        return Mapper.Map<T>(obj);
    }

    /// <summary>
    /// 集合到集合
    /// </summary>
    /// <typeparam name="T"></typeparam>
    /// <param name="obj"></param>
    /// <returns></returns>

    public static List<T> MapTo<T>(this IEnumerable obj )
    {
        if (obj == null) throw new ArgumentNullException();
        Mapper.Initialize(ctx => ctx.CreateMap ( obj.GetType(), typeof(T))) ;
        return Mapper.Map<List<T>>(obj);
    }
}

使用上面的方法進行單元測試：

    public void testme()
    {
        UserDto dto = new UserDto
        {
            Name = "Niko",
            PassWord = "1234",
        };
        User user=dto.MapTo<User>();
        user.Name.ShouldBe("Niko");
        user.PassWord.ShouldBe("1234");
        user.Id.ToString().ShouldBe("0");
    }

測試通過，對比以上封裝前后的方法，發現封裝后代碼量更加簡潔，使用起來更加方便。