【配置映射】—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。