【配置映射】—Entity Framework实例详解

前两篇博文中的配置属性和配置关系都是配置映射，配置属性是属性的映射，配置关系式关系的映射，本篇从讲讲实体的映射。

首先，配置实体映射到表，使用ToTable方法，它接受两个参数，第一个参数是表的名称，第二个参数是Schema名称。

            ToTable("Destination", "baga");

一、配置多个实体到一个表

下面是用到的类：

    public class Blog
    {
        public int Id { get; set; }
        public DateTime Creationdate { get; set; }
        public string ShortDescription { get; set; }
        public string Title { get; set; }
        public virtual BlogLogo BlogLogo { get; set; }
    }

    public class BlogLogo
    {
        public int Id { get; set; }
        public byte[] Logo { get; set; }
    }

映射实体到一个表中，实体需要遵循以下规则：

1. 实体之间必须是一对一的关系。

2. 实体必须共用主键。

使用Fluent API 配置Blog和BlogLogo映射到一个表，使用ToTable方法，如下：

            modelBuilder.Entity<Blog>().ToTable("Blogs");
            modelBuilder.Entity<BlogLogo>().ToTable("Blogs");

完整的Demo如下：

public class Blog
{
    public int Id { get; set; }
    public DateTime Creationdate { get; set; }
    public string ShortDescription { get; set; }
    public string Title { get; set; }
    public virtual BlogLogo BlogLogo { get; set; }
}

public class BlogLogo
{
    public int Id { get; set; }
    public byte[] Logo { get; set; }
}

public class BlogConfiguration : EntityTypeConfiguration<Blog>
{
    public BlogConfiguration()
    {
        ToTable("Blogs");
        HasKey(x => x.Id);
        Property(x => x.Id).HasDatabaseGeneratedOption(DatabaseGeneratedOption.Identity).HasColumnName("BlogId");
        Property(x => x.Title).HasMaxLength(175);
        HasRequired(x => x.BlogLogo).WithRequiredPrincipal();
    }
}

public class BlogLogoConfiguration : EntityTypeConfiguration<BlogLogo>
{
    public BlogLogoConfiguration()
    {
        ToTable("Blogs");
        HasKey(x => x.Id);
        Property(x => x.Id).HasDatabaseGeneratedOption(DatabaseGeneratedOption.Identity).HasColumnName("BlogId");
    }
}


public class BlogContext : DbContext
{
    public DbSet<Blog> Blogs { get; set; }

    protected override void OnModelCreating(DbModelBuilder modelBuilder)
    {
        modelBuilder.Configurations.Add(new BlogConfiguration());
        modelBuilder.Configurations.Add(new BlogLogoConfiguration());
        base.OnModelCreating(modelBuilder);
    }

    public IQueryable<T> Find<T>() where T : class
    {
        return this.Set<T>();
    }

    public void Refresh()
    {
        this.ChangeTracker.Entries().ToList().ForEach(x => x.Reload());
    }
    public void Commit()
    {
        this.SaveChanges();
    }
}

public class Initializer : DropCreateDatabaseAlways<BlogContext>
{
    public Initializer()
    {
    }

    protected override void Seed(BlogContext context)
    {
        context.Set<Blog>().Add(new Blog()
        {
            Creationdate = DateTime.Now,
            ShortDescription = "Testing",
            Title = "Test Blog",
            BlogLogo = new BlogLogo() { Logo = new byte[0] }
        });
        context.SaveChanges();
    }
}

测试程序：

[TestMethod]
public void ShouldReturnABlogWithLogo()
{
    //Arrange
    var init = new Initializer();
    var context = new BlogContext();
    init.InitializeDatabase(context);
    //Act
    var post = context.Blogs.FirstOrDefault();
    //Assert
    Assert.IsNotNull(post);
    Assert.IsNotNull(post.BlogLogo);
}

测试结果：

二、配置一个实体到多个表

拿用户和用户信息来说，在映射到已有的数据库时，有可能用户包含的信息比较多，为了性能或其他一些原因，不经常用的用户信息存放到单独的表中，经常使用的信息则存放到User表中，但是使用类表示时，希望将用户所有的信息放到一个类中，在映射时，就需要将实体分割。

下面是使用到的类：

    public class Blog
    {
        public int Id { get; set; }
        public DateTime Creationdate { get; set; }
        public string ShortDescription { get; set; }
        public string Title { get; set; }
        public string Description { get; set; }
        public string AboutTheAuthor { get; set; }
    }

使用Fluent API 将Blog个映射到多个表，使用Map方法，如下：

            Map(m =>
            {
                m.Properties(t => new { t.Id, t.Title, t.ShortDescription });
                m.ToTable("Blog");
            })
            .Map(m =>
            {
                m.Properties(t => new { t.Description, t.Creationdate, t.AboutTheAuthor });
                m.ToTable("BlogDetails");
            });

完整的Demo如下：

public class Blog
{
    public int Id { get; set; }
    public DateTime Creationdate { get; set; }
    public string ShortDescription { get; set; }
    public string Title { get; set; }
    public string Description { get; set; }
    public string AboutTheAuthor { get; set; }
}

public class BlogConfiguration : EntityTypeConfiguration<Blog>
{
    public BlogConfiguration()
    {
        Map(m =>
        {
            m.Properties(t => new { t.Id, t.Title, t.ShortDescription });
            m.ToTable("Blog");
        })
        .Map(m =>
        {
            m.Properties(t => new { t.Description, t.Creationdate, t.AboutTheAuthor });
            m.ToTable("BlogDetails");
        });
        HasKey(x => x.Id);
        Property(x => x.Id).HasDatabaseGeneratedOption(DatabaseGeneratedOption.Identity).HasColumnName("BlogId");
    }
}

public class BlogContext : DbContext, IUnitOfWork
{
    protected override void OnModelCreating(DbModelBuilder modelBuilder)
    {
        modelBuilder.Configurations.Add(new BlogConfiguration());
        base.OnModelCreating(modelBuilder);
    }
    public DbSet<Blog> Blogs { get; set; }

    public IQueryable<T> Find<T>() where T : class
    {
        return this.Set<T>();
    }

    public void Refresh()
    {
        this.ChangeTracker.Entries().ToList().ForEach(x => x.Reload());
    }

    public void Commit()
    {
        this.SaveChanges();
    }
}

public interface IUnitOfWork
{
    IQueryable<T> Find<T>() where T : class;
    void Refresh();
    void Commit();
}

public class Initializer : DropCreateDatabaseAlways<BlogContext>
{
    public Initializer()
    {
    }
    protected override void Seed(BlogContext context)
    {
        context.Set<Blog>().Add(new Blog()
        {
            Creationdate = DateTime.Now,
            ShortDescription = "Testing",
            Title = "Test Blog",
            Description = "Long Test",
            AboutTheAuthor = "Me me me"
        });
        context.SaveChanges();
    }
}

测试程序：

[TestMethod]
public void ShouldReturnABlogWithAuthorDetails()
{
    //Arrange
    var init = new Initializer();
    var context = new BlogContext();
    init.InitializeDatabase(context);
    //Act
    var post = context.Blogs.FirstOrDefault();
    //Assert
    Assert.IsNotNull(post);
    Assert.IsNotNull(post.AboutTheAuthor);
}

测试结果：

三、继承

TPH，Table Per Hierarchy，就是基类和派生类都映射到一张表，使用辨别列区分。

TPT，Table Per Type，就是基类存放到一张主表，每个派生类存放到一张表，通过外键与主表关联。

TPC，Table Per Concrete Type，就是基类和派生类都存放到单独的表中，没有主表。

下面是继承部分使用到的类：

    public class Blog
    {
        public int Id { get; set; }
        public DateTime Creationdate { get; set; }
        public string ShortDescription { get; set; }
        public string Title { get; set; }
        public string AboutTheAuthor { get; set; }
    }

    public class PictureBlog : Blog
    {
        //想不起来用什么字段好了，弄个“图片介绍”吧
        public string PicDescription { get; set; }
    }

    public class VideoBlog : Blog
    {
        //视频介绍
        public string VideoDescription { get; set; }
    }

首先来看一下TPH

配置继承为TPH，使用到一些新的配置方法：Requires和HasValue。Code First默认辨别列的名称为Discriminator，辨别列的值为类的名称。Requires配置辨别列的名称，HasValue定义辨别列的值。

下面看TPH的Demo：

[TestMethod]
public void ShouldReturnABlogWithTypeSafety()
{
//Arrange
var init = new Initializer();
var context = new
BlogContext(Settings.Default.BlogConnection);
init.InitializeDatabase(context);
//Act
var pictureBlog =
context.Set<PictureBlog>().FirstOrDefault();
var videoBlog = context.Set<VideoBlog>().FirstOrDefault();
//Assert
Assert.IsNotNull(pictureBlog);
Assert.IsNotNull(videoBlog);
}
}

测试程序：

[TestMethod]
public void ShouldReturnABlogWithTypeSafety()
{
    //Arrange
    var init = new Initializer();
    var context = new BlogContext();
    init.InitializeDatabase(context);
    //Act
    var pictureBlog =context.Set<PictureBlog>().FirstOrDefault();
    var videoBlog = context.Set<VideoBlog>().FirstOrDefault();
    //Assert
    Assert.IsNotNull(pictureBlog);
    Assert.IsNotNull(videoBlog);
}

测试结果：

TPT

配置继承为TPT，只需使用ToTable显示将派生类映射到表即可。

TPT的Demo，只需修改PictureBlog和VideoBlog的配置，其他全部一样：

public class PictureBlogConfiguration : EntityTypeConfiguration<PictureBlog>
{
    public PictureBlogConfiguration()
    {
        Map(m =>
        {
            m.ToTable("PictureBlogs");
        });
    }
}

public class VideoBlogConfiguration : EntityTypeConfiguration<VideoBlog>
{
    public VideoBlogConfiguration()
    {
        Map(m =>
        {
            m.ToTable("VideoBlogs");
        });
    }
}

最后生成的数据库表如下图所示：

Blogs表，只包含基类中的属性：

PictureBlogs表，只包含派生类中的属性：

VideoBlogs表：

TPC

TPC和TPT差不多，TPC使用MapInheritedProperties配置。MapInheritedProperties告诉Code First要映射基类中的属性到派生类的表中。

代码如下所示：

public class BlogConfiguration : EntityTypeConfiguration<Blog>
{
    public BlogConfiguration()
    {
        ToTable("Blogs");
        HasKey(t => t.Id);
        Property(t => t.Id).HasDatabaseGeneratedOption(DatabaseGeneratedOption.Identity).HasColumnName("BlogId");
        Property(t => t.Title).HasMaxLength(175);
    }
}

public class PictureBlogConfiguration : EntityTypeConfiguration<PictureBlog>
{
    public PictureBlogConfiguration()
    {
        Map(m =>
        {
            m.ToTable("PictureBlogs");
            m.MapInheritedProperties();
        });
    }
}

现在再运行程序，会出现下面的错误：

出现这个问题的主要问题是因为不支持多态关联。归根到底，就是在数据库中关联表示为外键关系，在TPC中，子类都映射到不同的表中，所以有多个关联指向基类不能使用简单的外键关系表示。

解决办法：

配置Blog的主键产生之的方式为None，在创建对象时，手动给主键赋值。

public class BlogConfiguration : EntityTypeConfiguration<Blog>
{
    public BlogConfiguration()
    {
        ToTable("Blogs");
        HasKey(t => t.Id);
        //配置不自动生成值
        Property(t => t.Id).HasDatabaseGeneratedOption(DatabaseGeneratedOption.None).HasColumnName("BlogId");
        Property(t => t.Title).HasMaxLength(175);
    }
}

protected override void Seed(BlogContext context)
{
    context.Set<PictureBlog>().Add(new PictureBlog()
    {
        //手动给主键赋值
        Id = 1,
        Creationdate = DateTime.Now,
        ShortDescription = "Testing",
        Title = "Test Blog",
        AboutTheAuthor = "Me me me",
        PicDescription = "This is a picture description"
    });
    context.Set<VideoBlog>().Add(new VideoBlog()
    {
        Id = 2,
        Creationdate = DateTime.Now,
        ShortDescription = "Testing",
        Title = "Test Blog",
        AboutTheAuthor = "Me me me",
        VideoDescription = "This is a video description"
    });
    context.SaveChanges();
}
    }

运行结果：

PictureBlogs表：

VideoBlogs表：

关于TPC的内容，可以查看这篇文章：Inheritance with EF Code First: Part 3 – Table per Concrete Type (TPC)

四、结束语

点击查看《Entity Framework实例详解》系列的其他文章。

如果遇到问题，可以访问Entity Framework社区，网址是www.ef-community.com。