第六章 继承与建模高级应用之TPH与TPT (1)

6-6 映射派生类中的NULL条件

问题

你的表中,有一列允许为null。你想使用TPH创建一个模型,列值为null时,表示一个派生类型,不为null时,表示另一个派生类型。

解决方案

假设你有一张表,描述医学实验药物。这张表包含一列指示该药是什么时候批准生产的。药在批准生产之前都被认为是实验性的。一但批准生产,它就被认为是药物了。我们就以图6-7中Drug表开始我们这一小节的学习。

图6-7 Drug表中有一列可为null鉴别列,AcceptedDate

按下面的步骤为Drug表建模:

1、创建一个派生至DbContext的上下文对象Recipe6Context;

2、创建POCO实体类Drug、Medicine和Experimental,如代码清单6-17所示;

代码清单6-17. 创建POCO实体Drug、Medicine和Experimental

[Table("Drug", Schema = "Chapter6")]
public abstract class Drug
{
    [Key]
    [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
    public int DrugId { get; set; }
    public string Name { get; set; }
}

public class Experimental : Drug
{
    public string PrincipalResearcher { get; set; }

    public void PromoteToMedicine(DateTime acceptedDate, decimal targetPrice,
                              string marketingName)
    {
        var drug = new Medicine { DrugId = this.DrugId };
        using (var context = new Recipe6Context())
        {
            context.Drugs.Attach(drug);
            drug.AcceptedDate = acceptedDate;
            drug.TargetPrice = targetPrice;
            drug.Name = marketingName;
            context.SaveChanges();
        }
    }

}

public class Medicine : Drug
{
    public decimal? TargetPrice { get; set; }
    public DateTime AcceptedDate { get; set; }
}

3、在上下文对象Recipe6Context中添加一个类型为DbSe<Drug>的属性;

4、在上下文对象Recipe6Context中重写OnModelCreating方法,让它为临床用药(Medicine)和试验性药物(Experimental)类型配置TPH映射。如代码清单6-18所示;

代码清单6-18.重写OnModelCreating方法,使之配置TPH映射

protected override void OnModelCreating(DbModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);
    modelBuilder.Entity<Experimental>()
                .Map(m => m.Requires("AcceptedDate").HasValue((DateTime?)null));
    modelBuilder.Entity<Medicine>()
                .Map(m => m.Requires(d => d.AcceptedDate).HasValue());
}

原理

在示例中,我们使用null和非null作为条件分别映射,不包含AcceptedDate的试验性药物(Experimental)和包含AcceptedDate的临床用药(Medicine)。和多数继承的例子一样,我们创建一个抽象的基类实体,之所以为抽象,是因为在我们的模型中,不会使用一个未分类的药物。

有趣的是,在Medicine实体中,我们将鉴别列映射到一个标题属性上。在绝大多数情况下,将鉴别列映射到一个标量属性是被禁止的。然而,在这个示例中,我们使用null和非null作为条件,不仅如此,AcceptedDate还设为不可空,这些对属性值的约束使得该属性可以被映射。

在代码清单6-19中,我们插入了两个试验性药物,并查询出插入的数据。我们使用AcceptedDate属性为我们提供的机会,可以将一个对象从一个派生类型改变为另一个派生类型。在我们的示例中,我们创建了两个试验性药物,随后将他们中的一个提升为临床用药。

代码清单6-19.插入并获取我们的派生类型实例

using (var context = new Recipe6Context())
{ 
    var exDrug1 = new Experimental { Name = "Nanoxol", 
                           PrincipalResearcher = "Dr. Susan James" };
    var exDrug2 = new Experimental { Name = "Percosol", 
                           PrincipalResearcher = "Dr. Bill Minor" };
    context.Drugs.Add(exDrug1);
    context.Drugs.Add(exDrug2);
    context.SaveChanges();

    // Nanoxol刚获生产批准
    exDrug1.PromoteToMedicine(DateTime.Now, 19.99M, "Treatall");
    context.Entry(exDrug1).State = EntityState.Detached; //不在使用此实例
}

using (var context = new Recipe6Context())
{
    Console.WriteLine("Experimental Drugs");
    foreach (var d in context.Drugs.OfType<Experimental>())
    {
        Console.WriteLine("\t{0} ({1})", d.Name, d.PrincipalResearcher);
    }

    Console.WriteLine("Medicines");
    foreach (var d in context.Drugs.OfType<Medicine>())
    {
        Console.WriteLine("\t{0} Retails for {1}", d.Name,
                           d.TargetPrice.Value.ToString("C"));
    }
}


代码清单6-19的输出如下:

Experimental Drugs
        Percosol (Dr. Bill Minor)
Medicines
        Treatall Retails for $19.99    


我们使用PromoteToMedicine()方法将一个试验性药物(Experimental)提升为临床用药(Medicine)。在这个方法的实现中,我们创建了一个Medicine实例,将它附加到一个新的上下文中,并使用适当的值初始化它。一旦这个新的实例被初始化和附加,我们就调用SaveChanges()方法将它保存到数据库中,因为这个实例有一个和试验性药物相同的键(DrugId),实体框架会产生一个update(更新)语句,而不是insert(插入)语句

我们在POCO类Experimental中实现了这个方法。这让我们可以无缝地在这样的类中添加一个方法,通过这种方式,提供了一种更简洁的实现 。话虽这么说,但我们感兴趣的是,创建一个透明持久化(persistence-ignorant)的POCO实体,能被用在多个上下文对象中,这让我们可以在helper类中实现一个稍微不同的版本。

6-7 使用一个非主键列建模TPT继承映射

问题

在一个存在的架构中,你有一张或多张表,与一张共享表有一对一的关系,共享表中使用的键在表中不是主键,你想使用TPT对此建模。

解决方案

假设你的数据库中包含的数据库关系图如图6-8所示。

图6-8 一个包含staff,Principal和Instructor表的关系对象图

在图6-8中,我们一张职工(Staff)表,它包含员工的姓名(Name),两张包含校长(Principal)、教员(Instructor)信息的表。这里需要引起注意的是,表Principal和Instructor中的主键不是Staff表的外键。在这种类型的关系结构是不能直接使用TPT继承映射的。对于TPT,关联表的主键必须是主表(基表)的外键。同时,还要注意的是,关系是一对一。这是因为我们对Principal和Instructor表中StaffId列创建了唯一索引的约束。

按下面的步骤,为图6-8中的表及其关系建模:

1、在你的项目中添加一个ADO.NET Entity Data Model(ADO.NET实体数据模型),并导入表Staff,Principal,和Instructor;

2、删除实体Principal与Staff之间的关联,实体Instructor与Staff之间的关联;

3、右键Staff实体,选择Add(增加) ➤Inheritance(继承)。选择Staff作为基类,Principal作为派生类。重复前面的操作,选择Staff作为基类,Instructor作为派生类型。

4、从实体Instructor和Principal中删除属性StaffId;

5、右键实体Staff,选择Properties(属性)。设置Abstract(抽象)属性为True。这会让实体Staff成为一个抽象类;

6、因为StaffId在表Principal和Instructor中不是主键,所以我们不能使用默认表映射来映射实体Principal和Instructor,或者Staff。依次选择每个表,并在映射详细信息窗口删除表映射。

7、使用代码清单6-20中的代码创建存储过程,我们会将这些存储过程映射到实体Principal和Instrucotr中的插入、更新和删除操作;

代码清单6-20. 实体Instructor和Principal插入、更新和删除动作的存储过程

create procedure [chapter6].[InsertInstructor]
(@Name varchar(50), @Salary decimal)
as
begin
declare @staffid int
insert into Chapter6.Staff(Name) values (@Name)
set @staffid = SCOPE_IDENTITY()
insert into Chapter6.Instructor(Salary,StaffId) values (@Salary,@staffid)
select @staffid as StaffId,SCOPE_IDENTITY() as InstructorId
end
go
create procedure [chapter6].[UpdateInstructor]
(@Name varchar(50), @Salary decimal, @StaffId int, @InstructorId int)
as
begin
update Chapter6.Staff set Name = @Name where StaffId = @StaffId
update Chapter6.Instructor set Salary = @Salary where InstructorId = @InstructorId
end
go
create procedure [chapter6].[DeleteInstructor]
(@StaffId int)
as
begin
delete Chapter6.Staff where StaffId = @StaffId
delete Chapter6.Instructor where StaffId = @StaffId
end
go
create procedure [Chapter6].[InsertPrincipal]
(@Name varchar(50),@Salary decimal,@Bonus decimal)
as
begin
declare @staffid int
insert into Chapter6.Staff(Name) values (@Name)
set @staffid = SCOPE_IDENTITY()
insert into Chapter6.Principal(Salary,Bonus,StaffId) values
(@Salary,@Bonus,@staffid)
select @staffid as StaffId, SCOPE_IDENTITY() as PrincipalId
end
go
create procedure [Chapter6].[UpdatePrincipal]
(@Name varchar(50),@Salary decimal, @Bonus decimal, @StaffId int, @PrincipalId int)
as

begin
update Chapter6.Staff set Name = @Name where StaffId = @StaffId
update Chapter6.Principal set Salary = @Salary, Bonus = @Bonus where
PrincipalId = @PrincipalId
end
go
create procedure [Chapter6].[DeletePrincipal]
(@StaffId int)
as
begin
delete Chapter6.Staff where StaffId = @StaffId
delete Chapter6.Principal where StaffId = @StaffId
end

8、右键设计器窗口,选择Update Model from Database(从数据库中更新模型)。添加第7步创建的存储过程;

9、选择实体Principal,并查看Mapping Details window(映射详细信息窗口)。单击Map Entity to Function(映射实体到函数)按钮。这个按钮是在映射详细信息窗口左边最下边的一个按钮。映射Insert、Update和Delete动作到存储过程。确保映射插入动作的result columns(结果列)StaffId和PrincipalId(如图6-9)。

图6-9 为实体Principal映射Insert,Update和Delete动作

10、在上实体Instructor重复第9步。确保映射插入动作的result columns(结果列)StaffId和PrincipalId。

在解决方案浏览器中右键.edmx文件,选择Open With(打开方式) ➤XML Editor(XML文本编辑器)。这将关闭设计器窗口并在XML编辑器中打开.edmx文件。滚动到映射怪中的标签<EntityContainerMapping>。将代码清单6-21中的查询视图(QueryView)插入到标签<EntitySetMapping>中。

<EntitySetMapping Name="Staffs">
    <QueryView>
        select value
        case
        when (i.StaffId is not null) then
        Apress.EF6Recipes.BeyondModelingBasics.Recipe7.Instructor(s.StaffId,s.Name,i.InstructorId,i.Salary)
        when (p.StaffId is not null) then
        Apress.EF6Recipes.BeyondModelingBasics.Recipe7.Principal(s.StaffId,s.Name,p.PrincipalId,p.Salary,p.Bonus)
        END
        from ApressEF6RecipesBeyondModelingBasicsRecipe7StoreContainer.Staff as s
        left join ApressEF6RecipesBeyondModelingBasicsRecipe7StoreContainer.Instructor as i
        on s.StaffId = i.StaffId
        left join ApressEF6RecipesBeyondModelingBasicsRecipe7StoreContainer.Principal as p
        on s.StaffId = p.StaffId
    </QueryView>
</EntitySetMapping>

原理

使用TPT继承映射,实体框架要求基类表中的外键是派生类中的主键。在我们的示例中,每个派生类表有自己独立的主键。

为了创建TPT继承映射模型,在概念层,实体Principal和Instructor继承自实体Staff。接下来,我们删除导入表时创建的映射。然后我们使用一个QueryView表达式来创建一个新的映射。使用QueryView将Insert、Update和Delete动作放入我们的代码中。为了处理这些动作,我们在数据库中创建了额外的存储过程。

我们使用QueryView将映射派生类中的标量属性到数据库表中。QueryView中的关键部分是case语句。这里有两种情况,我们有一个Principal和一个Instructor。如果Instructor的StaffId非null时,我们就得到一个Instructor实例;如果Principal的StaffId为null时,我们就得到一个Principal实例。表达式剩下的部分是,引入派生类表中的行。

代码清单6-22插入一位校长和一位教员到数据库表中。

代码清单6-22. 从模型中插入和获取

using (var context = new Recipe7Context())
{
    var principal = new Principal
    {
        Name = "Robbie Smith",
        Bonus = 3500M,
        Salary = 48000M
    };
    var instructor = new Instructor
    {
        Name = "Joan Carlson",
        Salary = 39000M
    };
    context.Staffs.Add(principal);
    context.Staffs.Add(instructor);
    context.SaveChanges();
}

using (var context = new Recipe7Context())
{
    Console.WriteLine("Principals");
    Console.WriteLine("==========");
    foreach (var p in context.Staffs.OfType<Principal>())
    {
        Console.WriteLine("\t{0}, Salary: {1:C}, Bonus: {2:C}",
                           p.Name, p.Salary,
                           p.Bonus);
    }
    Console.WriteLine("Instructors");
    Console.WriteLine("===========");
    foreach (var i in context.Staffs.OfType<Instructor>())
    {
        Console.WriteLine("\t{0}, Salary: {1:C}", i.Name, i.Salary);
    }
}

代码清单6-22的输出如下:

Principals
==========
        Robbie Smith, Salary: $48,000.00, Bonus: $3,500.00
Instructors
===========
        Joan Carlson, Salary: $39,000.00


《Entity Framework 6 Recipes》中文翻译系列