AutoMapper(上)，AutoMapper(

AutoMapper(上)，AutoMapper(

返回總目錄

映射前後操作

偶爾有時候，在映射發生之前或之後，你可能需要執行一些自定義的邏輯。這可能是很少見的事情，因為在AutoMapper之外處理這些事情是更明顯的。你可以創建一個映射前後的全局操作：

Mapper.CreateMap<Source, Dest>()
    .BeforeMap((src, dest) => src.Value = src.Value + 10)
    .AfterMap((src, dest) => dest.Name = "John");

或者在映射期間，創建映射前後的回調函數：

int i = 10;
Mapper.Map<Source, Dest>(src, opt => {
    opt.BeforeMap((src, dest) => src.Value = src.Value + i);
    opt.AfterMap((src, dest) => dest.Name = HttpContext.Current.Identity.Name);
});

當你需要將上下文信息注入映射前後的行為中時，後者的配置很有用。

條件映射

在屬性映射之前，AutoMapper允許將必須滿足的條件添加到屬性上。

這個用在下面這種情況，比如有兩個類，分別是Aliens（外星人）和Person（人）類，都有一個Age屬性，我們都知道我們人類的年齡都是非負數，所以我們這裡用unsigned int(無符號整數)類型。但是，目前人類科技水平有限，還沒有研究出是否有外星人存在，就更無法確定其年齡屬性了，所以我們這裡假設外星人的年齡可以為負數（如果你反駁我你也沒依據啊，暫且就這樣吧），那麼就定義其為int類型，如果我們要將外星人映射到人類上，其實就是uint到int之間的映射：

namespace FrontAutoMapper
{
    class Program
    {
        static void Main(string[] args)
        {
//創建映射，映射條件是源類型的Age屬性在區間(0,149)范圍內
            Mapper.CreateMap<Aliens, Person>().ForMember(dest => dest.Age, opt => opt.Condition(src => src.Age > 0 && src.Age < 149));

            var p1 = Mapper.Map<Person>(new Aliens() { Age = -1 });//不符合映射條件
              var p2 = Mapper.Map<Person>(new Aliens() { Age = 0 });//不符合映射條件
              var p3 = Mapper.Map<Person>(new Aliens() { Age = 1 });//符合映射條件
              var p4 = Mapper.Map<Person>(new Aliens() { Age = 148 });//符合映射條件
              var p5 = Mapper.Map<Person>(new Aliens() { Age = 149 });//不符合映射條件
              Console.WriteLine(p1.Age);//映射不成功，返回Person.Age默認值22
            Console.WriteLine(p2.Age);//映射不成功，返回Person.Age默認值22
            Console.WriteLine(p3.Age);//映射成功，返回新值1
            Console.WriteLine(p4.Age);//映射成功，返回新值148
            Console.WriteLine(p5.Age);//映射不成功，返回新值22
            Console.Read();
        }
    }
    public class Person
    {
        public Person()
        {
            Age = 22;
        }
        public uint Age { set; get; }//Person的Age屬性默認值是22
    }

    public class Aliens
    {
        public Aliens()
        {
            Age = -23;
        }
        public int Age { get; set; }//Aliens的Age屬性默認值是-23
    }
}

這個例子是將年齡Age在區間(0,149)范圍內的外星人映射成人，執行結果如下，和預測結果一致。

//初始化配置文件 Mapper.Initialize(cfg => { cfg.CreateMap<Aliens, Person>(); cfg.AddProfile<AliensPersonProfile>();//添加一個配置文件 });

映射配置是靜態的，此後不應該改變了。

Profile實例

可用來組織AutoMapper配置

namespace ConditionalMapping
{
    public class AliensPersonProfile : Profile
    {
        protected override void Configure()
        {
            //放一些CreateMap(...)等映射配置操作

        }
    }
}

自定義一個繼承了Profile類的類，然後重寫Configure方法，在該方法中放一些映射的配置。

像下面這樣初始化自定義的配置文件：

//初始化配置文件
Mapper.Initialize(cfg =>
{
    cfg.AddProfile<AliensPersonProfile>();//添加一個配置文件
});

命名慣例

可以設置源和目標的命名慣例。

//初始化配置文件
Mapper.Initialize(cfg =>
{
    cfg.SourceMemberNamingConvention=new LowerUnderscoreNamingConvention();
    cfg.DestinationMemberNamingConvention=new PascalCaseNamingConvention();
});

也可以在配置文件中的Configure方法中設置：

protected override void Configure()
{
    SourceMemberNamingConvention = new LowerUnderscoreNamingConvention();
    DestinationMemberNamingConvention = new PascalCaseNamingConvention();
}

小試牛刀：

在Aliens類中添加如下代碼：

public string MyName { set; get; }

在Person類中添加如下代碼：

public string my_name { get; set; }

結果如下，和預測結果一致：

注意一定要在CreateMap方法之前，配置替換字符，否則沒有效果。這也符合邏輯，只有先添加替換條件，才能按條件映射嘛。

cfg.ReplaceMemberName("Ä", "A");
cfg.ReplaceMemberName("í", "i");
cfg.ReplaceMemberName("Tool", "Car");
cfg.AddProfile<AliensPersonProfile>();

小試牛刀：

在Aliens類中添加如下代碼：

public int Ävíator { get; set; }
public string ToolName { get; set; }

在Person類中添加如下代碼：

public int Aviator { get; set; }
public string CarName { get; set; }

結果如下，和預測結果一致：

public string PGender { get; set; }

在Person類中添加如下代碼：

public string Gender { get; set; }

可見，源類型中有一個前綴為“P”的字段PGender，要想成功映射為Person，就必須識別出前綴“P”，所以在Mapper的配置中添加代碼（注意，添加到CreateMap方法之前，否則無效）：

cfg.RecognizePrefixes("P");

結果如下，和預測結果一致：

cfg.ClearPrefixes();

全局屬性/字段過濾

默認情況下，AutoMapper映射每一個公共的屬性/字段。你可以使用屬性/字段過濾器過濾出不需要映射的屬性/字段：

//不映射任何字段
cfg.ShouldMapField = fi => false;
//只映射getter是private的屬性
cfg.ShouldMapProperty = pi => pi.GetMethod != null && pi.GetMethod.IsPrivate;
cfg.AddProfile<AliensPersonProfile>();

小試牛刀：

分別給Aliens和Person類添加下面這段代碼：

private string code;
public string Code
{
    private get { return code; }
    set { code = value; }
}

Main方法中添加代碼：

var p10 = Mapper.Map<Person>(new Aliens() { Age = 44,Code = "111"});
Console.WriteLine(string.Format("Person.Age={0},Person.code={1}",p10.Age,p10.code));//22,111

結果和預測一樣：

Mapper.Initialize(cfg => { // 映射具有public或internal的getter的屬性 cfg.ShouldMapProperty = p => p.GetMethod.IsPublic || p.GetMethod.IsAssembly; cfg.CreateMap<Source, Destination>(); });