首页 > 代码库 > DbContext API 介绍

DbContext API 介绍

  写这篇博客的时候,听闻EF7都发布半年了,吐糟下巨硬,同时对自己老处在追赶者的角色深感不满。

  言归正传,提起DbContext就不得不提ObjectContext,在EF第一个版本发布以来,其中最重要的组件就是ObjectContext,ObjectContext提供了概念上的模型来让我们与数据库交互(写查询表达式、执行查询,跟踪模型修改状态,持久化修改到数据库),他同时也与其他重要的EF类来进行交互操作:

  • ObjectSet:在内存中对实体进行集合操作。
  • ObjectQuery:针对概念模型的类型化查询。

  所有这些类充满了特性和功能--有的很复杂,大多数只在特殊情况下是必须的。在经历了Entity Framework的两个版本之后(.NET 3.5 SP1  .NET 4)逐渐明确了,开发者大部分只会用到这些功能的一部分,但不幸的是,对于我们经常做的大部分的任务编码以及查询都有点困难。

  意识到这一点之后,EF团队开始对开发者有爱了,他们的解决方案是创建了一些新类封装了ObjectContext功能的子集,开发者在一般情况下就无需与ObjectContext打交道了(除了一些高级主题),这些新类是随同EF4.1一起发布,是EF4.1的一部分。

  这些新类就是指:DbContext,DbSet,DbQuery。同时他们是DbContext API 的一部分。这个新的API 不仅仅包含DbContext,而且包含了EF团队为其开发的一些新的功能。DbContext API 是包含在Entity Framework.dll中的,这个类库同时也包含了驱动Code First开发的逻辑,这个类库与.NET是分开的,被发布在EntityFramework NuGet package。Entity Framework的主要部分是.NET Framework一部分(主要是System.Data.Entity.dll)。被包含在.NET Framework里面的这些组件被认为是Entity Framework“核心组件”,而DbContext API是完全独立的,与这些“核心组件”是分开的。Entity Framework团队意识到集成在.NET Framework里面不是一个好的选择,他们正致力于把更多的“核心组件”从.NET Framework中移到到Entity Framework.dll中,这样发布新的Entity Framework的新功能都无需等到.NET Framework新版本发布。

  下表是DbContext API 的功能概览

DbContext

API 类/功能

相关的EF4

类/功能

目的DbContext API 优点
DbContextObjectContext代表与数据库连接的会话,提供了查询、状态跟踪、保存等功能简化了大部分ObjectContext功能
DbSet      ObjectSet

对实体类型提供了集合操作,比如Add、Attach、Remove。

继承了DbQuery,所以可以提供查询功能

 简化了大部分ObjectSet功能
 DbQueryObjectQuery提供查询功能

 DbQuery的查询功能集成在DbSet中,

所以不用直接操作DbQuery

 Change

Tracker API

 ObjectContext.

ObjectStateManager

获得实体变化跟踪信息以及相关的操作(original values、current values)

受上下文管理

 更简单、更直观的API
 Validation APIN/A提供自动的数据验证。这个API 利用了.NET 4原生的验证功能 新的
 Code First Model BuildingN/A基于已有的类以及配置信息来创建数据库及其元数据 新的

 

 

 

 

 

 

 

 

 

 

 

如何在自己项目中使用DbContext API

  通过巨硬的NuGet 以及Library Package Manager 上下载Entity Framework组件,然后一切交给宇宙第一神IDE吧。

 

 DbContext API的一些亮点

  让我们看看DbContext API 是如何来减少工作量的,如何减少当然要以ObjectContext来对比。

  示例中包含Person Destination Trip三个实体 

  Example 1-1  ObjectContext写法

 1 public class BreakAwayContext : ObjectContext 2 { 3   private ObjectSet<Person> _ people; 4   private ObjectSet<Destination> _destinations; 5   private ObjectSet<Trip> _trips; 6   public ObjectSet<Person> People 7   { 8     get { return _people ?? (_people = CreateObjectSet<Person>("People")); } 9   }10   public ObjectSet< Destination > Contacts11   {12     get { return _ destinations?? (_destinations =13     CreateObjectSet< Destination >("Destinations")); }14   }15   public ObjectSet<Trip> Trips16   {17     get { return _ trips?? (_trips = CreateObjectSet<Trip>("Trips")); }18   }19 }

  Example 1-2 DbContext 写法

1 public class BreakAwayContext : DbContext2 {3   public DbSet<Person> People { get; set; }4   public DbSet<Destination> Destinations { get; set; }5   public DbSet<Trip> Trips { get; set; }6 }

  简化以及优化一目了然。

  减少以及简化了集合操作

  在Entity Framework 4中,添加实例到实体集中,你可以使用ObjectContext.AddObject或者ObjectSet.AddObject.当添加实例到ObjectContext中的时候,ObjectContext需要知道这个实例属于哪个实   体集合,所以对于ObjectSet.AddObject你必须以文本的形式指明实体集名称,比如:

    context.AddObject("Trips",newTrip);

  使用ObjectSet.AddObject的话稍微简化点:context.Trips.AddObject(newTrip);至于ObjectContext.AddObject继续存在于EF4的原因在于与早期版本的向后兼容性,但开发者并不会意识到这个原因,   只会被这两种写法搞迷糊了。

  因为DbContext API是新的,我们无需担心与早期版本的向后兼容性,所以DbContext并没有提供在context上面添加实例的方法,只是在DbSet上面添加了Add方法:

        context.Trips.Add(newTrip);

  ObjectContext还提供了AttachObject和DeleteObject方法,同样的DbContext并没有提供类似的方法,这些方法全部在DbSet上面提供:Attach、Remove。

  使用ID与DbSet.Find检索一个实体

  开发者经常要做的一件事就是根据key来查询相应的实体,EF4时代我们都是写如下的查询语句:

    context.People.SingleOrDefault(p=>p.Id=Id);

  现在DbSet提供了Find方法:

    context.People.Find(Id);

  使用Find有个优点,调用SingleOrDefault方法会一直查询数据库,而使用Find方法,会首先查询内存中是否存在相关实例,如果有,直接返回,如果没有才会去查询数据库,对性能提高是大大的

 

 

-------To Be Continue.

 

DbContext API 介绍