第二篇：Entity Framework CodeFirst & Model 映射

    前一篇 第一篇：Entity Framework 简介 我有讲到，ORM 最关键的 Mapping，也提到了最早实现Mapping的技术，就是 特性 + 反射，那Entity Framework 实现Mapping 又是怎样的呢？ EntityFramework 实现Mapping 有两种方式。

    1. 数据注解（DataAnnotations）

    2. Fluent API

一. 数据注解，这种方式，就是在实体和属性加上一些EntityFramework 定义好的一些特性，然后EntityFramework，在具体操作数据库时进行反射。跟我们上篇提到 特性+反射 一样的方案。因此今天不会在这篇讲 DataAnnotations 。会贴一点实例代码。

比较要注意的是，实现 DataAnnotations ，要引用 System.ComponentModel.DataAnnotations 命名空间。

实例代码如下，特殊说明一下，EntityFramework 支持 .Net 可为空表达法，如 int?,DateTime? 。下面代码 最后修改时间 LastModifiedDateTime 就是这样。

 

 

using System;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace EntityFrameworkSample.Models
{
    [Table("Sample_Order")] //标示为 表名
    //[Table("Sample_Order", Schema = "dbo")] //标示为 表名 ，表的拥有者
    public class OrderModel
    {
        [Key]//标示为 主键
        [DatabaseGenerated(DatabaseGeneratedOption.Identity)] // 标示为 自动增量
        public Guid OrderGuid { get; set; }
        [Required] //标示为 必填
        [MaxLength(30)] //标示为 字符串长度最大30
        public string OrderNo { get; set; }
        [Required] //标示为 必填
        [MaxLength(20)] //标示为 字符串长度最大30
        public string OrderCreator { get; set; }
        [Required]
        [DatabaseGenerated(DatabaseGeneratedOption.Identity)] // 标示为 自动增量 数据库有默认值 getdate()
        public DateTime OrderDateTime { get; set; }
        [Required]
        public string OrderStatus { get; set; }
        [MaxLength(1000)]
        public string Description { get; set; }
        [Required]
        [MaxLength(20)] //标示为 字符串长度最大30
        public string Creator { get; set; }
        [Required]
        public DateTime CreateDateTime { get; set; }
        public string LastModifier { get; set; }
        public DateTime? LastModifiedDateTime { get; set; }
    }
}

 

看吧，数据注解（DataAnnotations ），就是旧技术换一个叫法而已。没有什么大不了。其他的就靠大家去摸索了。

二 . Fluent API  查了一下百度翻译，“流畅的API” ,我不知道这个翻译贴不贴不切，我就以我使用Fluent API 经验说说，Fluent API 比 数据注解好的地方。

    1. 大家再看一眼上面代码，是不是感觉有点不纯净了，本来一个干干净净的类，搞得乱乱的。感觉有点恶心。

    2. 这一点可能要后面我贴出代码，分享源代码才理解，不过使用过EntityFramework Fluent API 的应该能够理解到，配置和类分离，职责更加单一。

   3. 配置和类分离，扩展性，灵活性就会更好，大家多知道，EntityFramework 不仅支持Sql Server，支持Oracle，MySql，Sqlite 等这些流行数据库，每种产品配置也许都有细微差别，如果以 DataAnnotations 方式实作，那我岂不是要重新新增模型，一样的表设计，为什么要加呢？ 只有配置不同才要加啊！ 

  4. 做技术架构，这种方式封装也比较好，怎么好大家如果是做架构的话，两种方式都用一下，感受一下。

废话不多说了，直接贴出实现 Fluent API 的流程，以及代码。

1. 创建数据库“EntityFrameworkSample”

2. 在数据库“EntityFrameworkSample”中，加表“Sample_Order”，然后向表中新增所需要的字段。

3. 新建解决方案 “EntityFrameworkSample” 

4. 在解决方案中 新增“EntityFrameworkSample.DbContext” （配置最终使用地方），“EntityFrameworkSample.Models”（纯净数据Model），“EntityFrameworkSample.Mappings” （映射配置）三个类库项目

5. 在“EntityFrameworkSample.DbContext” ，“EntityFrameworkSample.Mappings”  项目中，通过NuGet 安装EntityFramework 最新版本。

6. 在 “EntityFrameworkSample.DbContext” 项目中，新增“EntityFrameworkSampleDbContext” DbContext 类，

    在“EntityFrameworkSample.Models” 项目中，新增“OrderModel” Model类，

    在“EntityFrameworkSample.Mappings”项目中，新增“OrderMap” 映射配置类。

三个项目 代码图 和引用关系如下图

三个类的代码分别如下

EntityFrameworkSampleDbContextusing System.Data.Entity;using EntityFrameworkSample.Mappings;

using EntityFrameworkSample.Models;

namespace EntityFrameworkSample.DbContext
{
    public class EntityFrameworkSampleDbContext:System.Data.Entity.DbContext
    {
        public EntityFrameworkSampleDbContext()
            : base("EntityFrameworkSampleConnection")
        {
        }

        public DbSet<OrderModel> orders { get; set; }

        protected override void OnModelCreating(DbModelBuilder modelBuilder)
        {

            modelBuilder.Configurations.Add(new OrderMap());

            base.OnModelCreating(modelBuilder);
        }
    }
}

OrderModel

using System;

namespace EntityFrameworkSample.Models
{
    public class OrderModel
    {     
        public Guid OrderGuid { get; set; }
        public string OrderNo { get; set; }
        public string OrderCreator { get; set; }
        public DateTime OrderDateTime { get; set; }
        public string OrderStatus { get; set; }
        public string Description { get; set; }
        public string Creator { get; set; }
        public DateTime CreateDateTime { get; set; }
        public string LastModifier { get; set; }
        public DateTime LastModifiedDateTime { get; set; }
    }
}

OrderMap

using System.ComponentModel.DataAnnotations.Schema;
using System.Data.Entity.ModelConfiguration;
using EntityFrameworkSample.Models;

namespace EntityFrameworkSample.Mappings
{
    public class OrderMap : EntityTypeConfiguration<OrderModel>
    {
        public OrderMap()
        {
            this.HasKey(m => m.OrderGuid);

            this.Property(m => m.OrderGuid)
                .HasDatabaseGeneratedOption(DatabaseGeneratedOption.Identity);

            this.Property(m => m.OrderNo)
                .IsRequired()
                .HasMaxLength(30);

            this.Property(m => m.OrderCreator)
                .IsRequired()
                .HasMaxLength(20);

            this.Property(m => m.OrderStatus)
                .IsRequired()
                .HasMaxLength(30);

            this.Property(m => m.Description)
                .HasMaxLength(1000);

            this.Property(m => m.Creator)
                .IsRequired()
                .HasMaxLength(20);

            this.Property(m => m.LastModifier)
             .HasMaxLength(15)
             .HasMaxLength(20);

            this.ToTable("Sample_Order");

            this.Property(m => m.OrderGuid).HasColumnName("OrderGuid");
            this.Property(m => m.OrderNo).HasColumnName("OrderNo");
            this.Property(m => m.OrderCreator).HasColumnName("OrderCreator");
            this.Property(m => m.OrderDateTime).HasColumnName("OrderDateTime");
            this.Property(m => m.OrderStatus).HasColumnName("OrderStatus");
            this.Property(m => m.Description).HasColumnName("Description");
            this.Property(m => m.Creator).HasColumnName("Creator");
            this.Property(m => m.CreateDateTime).HasColumnName("CreateDateTime");
            this.Property(m => m.LastModifier).HasColumnName("LastModifier");
            this.Property(m => m.LastModifiedDateTime).HasColumnName("LastModifiedDateTime");
        }
    }
}

至此解决方案此阶段所有代码就完成了。

 大概讲一下一些注意点。

1. EntityFrameworkSampleDbContext 必须要继承 DbContext，并重写OnModelCreating方法，来完成映射.

2. OrderMap 必须继承EntityTypeConfiguration<>泛型类，泛型类型 OrderModel，大概告诉Map映射的是OrderModel。

好了，这篇内容结束了，不足的地方，我没有列出Fluent API 所有api，主要是表与表的关系是如何映射的，这些希望读者，能够自己去摸索，篇幅有限，

还有就是DbContext 我也没有在这篇详细介绍，会在真正讲到DbContext那篇在详细跟大家介绍。

这篇还增加一篇续篇吧，第三篇：Entity Framework CodeFirst & Model 映射 续篇 EntityFramework Power Tools 工具使用

这篇的源代码：http://pan.baidu.com/s/1gftuzuF