翻译的初衷以及为什么选择《Entity Framework 6 Recipes》来学习,请看本系列开篇
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: $,000.00, Bonus: $,500.00
Instructors
===========
Joan Carlson, Salary: $,000.00
实体框架交流QQ群: 458326058,欢迎有兴趣的朋友加入一起交流
谢谢大家的持续关注,我的博客地址:http://www.cnblogs.com/VolcanoCloud/