第十二章：从凡间代码到仙道程序（C#数据映射）

—— 从凡间代码到仙道程序的蜕变之旅。

🏮 一、何谓"映射之道"？

在软件开发中，"映射（Mapping）"如同修仙界的"灵气转化"——将数据从一种形态转换为另一种形态，使其适配不同的场景。无论是对象转换、数据持久化还是API数据传输，映射无处不在。

C# 提供了多种映射方式：

• 手动赋值（苦修之法）

• AutoMapper（法器辅助）

• LINQ投影（神通点化）

• 反射动态映射（变幻莫测）

📜 二、灵脉初开（基础类型映射）

凡间数据如何转化为仙道数据？

int age = 30;  // 凡寿三十  
double height = 175.5;  // 凡躯七尺  

// 🌀 映射为仙道数据  
var immortalAge = age;  // 自动转化  
var immortalHeight = (float)height;  // 显式压缩（小心灵气逸散！）  
string daoName = "玄天";  // 道号生成  

📊 数据映射对照表（精度控制很重要！）

💡 修炼心得：基础映射如引气入体，需注意类型安全，避免"走火入魔（数据溢出）"！

🏯 三、夺舍大法（对象映射）

凡人之躯如何夺舍为仙体？

// 🏡 凡人  
public class Mortal {  
    public string Name { get; set; }  
    public int Age { get; set; }  
}  

// 🏔 仙人  
public class Immortal {  
    public string DaoName { get; set; }  // 道号  
    public int CultivationYears { get; set; }  // 修炼年数  
}  

⚡ 使用 AutoMapper 自动夺舍

var config = new MapperConfiguration(cfg =>  
    cfg.CreateMap<Mortal, Immortal>()  
       .ForMember(dest => dest.DaoName, opt => opt.MapFrom(src => src.Name))  
       .ForMember(dest => dest.CultivationYears, opt => opt.MapFrom(src => src.Age))  
);  

var immortal = mapper.Map<Immortal>(mortal);  // 夺舍完成！  

📈 夺舍成功率（不同映射方式对比）

💡 修炼心得：AutoMapper 是上乘法器，但需小心配置，否则可能"元神错位（属性映射错误）"！

🌌 四、点化众生（集合映射）

如何让整个村落飞升？

List<Mortal> village = new List<Mortal> {  
    new Mortal { Name = "李四", Age = 25 },  
    new Mortal { Name = "王五", Age = 40 }  
};  

// 🌀 LINQ 点化之术  
var immortals = village  
    .Select(m => new Immortal {  
        DaoName = m.Name,  
        CultivationYears = m.Age  
    }).ToList();  

// 或者使用 AutoMapper 批量夺舍  
var immortals2 = mapper.Map<List<Immortal>>(village);  

📊 集合映射性能对比（单位：毫秒）

💡 修炼心得：小规模数据可用LINQ，大规模数据建议手动优化，避免"灵气枯竭（性能问题）"！

🚀 五、跨界飞升（跨层映射）

如何让数据在不同层级（DB → DTO → Domain）间无损传递？

// 🗃️ 数据库实体  
public class UserEntity {  
    public Guid Id { get; set; }  
    public string UserName { get; set; }  
}  

// 📡 DTO（传输层）  
public class UserDto {  
    public string DisplayName { get; set; }  
}  

// 🏛️ 领域模型  
public class UserDomain {  
    public string Account { get; set; }  
}  

// ⚡ 配置三层映射  
cfg.CreateMap<UserEntity, UserDomain>()  
   .ForMember(dest => dest.Account, opt => opt.MapFrom(src => src.UserName));  

cfg.CreateMap<UserDomain, UserDto>()  
   .ForMember(dest => dest.DisplayName, opt => opt.MapFrom(src => src.Account));  

🌐 跨层映射关系图

[数据库实体]  
   │  
   ↓ AutoMapper  
[领域模型]  
   │  
   ↓ AutoMapper  
[DTO]  

💡 修炼心得：跨层映射如飞升渡劫，需确保每层转换无信息丢失！

🎯 六、大道至简

• 基础映射 → 引气入体（根基要稳）

• 对象映射 → 夺舍重生（精准控制）

• 集合映射 → 点化众生（批量处理）

• 跨层映射 → 飞升渡劫（保持数据一致性）

🚀 你是哪种修士？

• 苦修派（手动映射）

• 法器派（AutoMapper）

• 神通派（LINQ+反射）

欢迎在评论区留下你的修炼心得！👇

微信公众号：【.NET修仙日记】