《Entity Framework 6 Recipes》中文翻译系列 (42) ------ 第八章 POCO之使用POCO

翻译的初衷以及为什么选择《Entity Framework 6 Recipes》来学习，请看本系列开篇

第八章 POCO

　　对象不应该知道如何保存它们，加载它们或者过滤它们。这是软件开发中熟悉的口头禅，特别是在领域驱动设计中。这是一个聪明的做法，如果对象和持久化绑得太紧，以至于不能对领域对象进行单元测试、重构和复用。在ObjectContext上下对象中，实体框架为模型实体生成的类，高度依赖实体框架管道（Plumbing)。对于一此开发人员来说，这些类对持久化机制知道得太多了。而且，它们与特定的模型和映射关联太密切。幸好，我们还有另一个选项。

　　实体框架还支持使用你自己创建的类来作为模型中的实体。术语叫做“普通公共运行时对象”（Plain Old CLR Object),通常被简单地叫做POCO，这并不意味着你的类普通而老掉牙。它仅仅是说，它不包含特定框架的引用，不需要来至第三方的代码，不实现任何第三方的专用接口，并且，它不需要别的任何程序集或者命名空间。你可以实现自己的领域对象，你会看到通过自定义的ObjectContext上下对象使它们适合模型。也就是说，凭借实体框架强大的能力，你可以选择任何架构模式。你同样也能使用DbContext为你产生POCO类。

　　本章涵盖了多个关于POCO的小节。第一节展示POCO最基本的用法，剩下的小节集中在，实体的加载和实体框架使用对象状态保持同步。

　　本章故意手工编写了大量的POCO类，是为了演示如何运用POCO。如果使用来至微软ADO.NET开发团队的T4模板，这些工作都将不复存在。

8-1  使用POCO

问题

　　你想在你的项目中使用POCO。

解决方案

　　假设你有如图8-1所示的数据模型。

图8-1. 一个关于客户和它的订单的数据库模型

　　

　　为了使用POCO类创建基于图8-1所示的数据库模型的实体框架模型，请按下面的步骤进行操作：

　　　　1、右键你的项目，选择Add（增加） ➤New Item（新建项）；

　　　　2、选择Visual C#条目下的Data（数据）模板下的ADO.NET Entity Data Model（ADO.NET实体数据模型）；

　　　　3、选择Generate from database 从一个已存在的数据库创建模型；

　　　　4、选择表order,OrderDetail,Customer和Product,单击下一步。在生成的模型中，实体Product有一个导航属性OrderDetails，它是关联产品的订单明细。在这里它不是必要的，因此将其删除（译注：实际上，没有删除）。完成后的模型如图8-2所示。

图8-2. 客户订单的模型

　　　　

　　　　5、我们使用生成的类作为的我们实体，默认情况下，实体框架6生成POCO实体类。 因此，所有的数据库访问代码都在一个单独的类中，实体被生成为普通的类。还可以在实体框架生成实体类之前关闭模型的代码生成功能，然后手工创建相同的实体类。 在这个版本中，代码生成策略已经被设置成None.代码清单8-1展示了我们模型中的类。

代码清单8-1. 我们模型的POCO类

  public partial class Customer
     {
         public Customer()
         {
             this.Orders = new HashSet<Order>();
         }

         public int CustomerId { get; set; }
         public string ContactName { get; set; }

         public virtual ICollection<Order> Orders { get; set; }
     }

  public partial class Order
     {
         public Order()
         {
             this.OrderDetails = new HashSet<OrderDetail>();
         }

         public int OrderId { get; set; }
         public int CustomerId { get; set; }
         public System.DateTime OrderDate { get; set; }

         public virtual Customer Customer { get; set; }
         public virtual ICollection<OrderDetail> OrderDetails { get; set; }
     }

 public partial class OrderDetail
     {
         public int OrderId { get; set; }
         public int ProductId { get; set; }
         public decimal UnitPrice { get; set; }
         public int Quantity { get; set; }

         public virtual Order Order { get; set; }
         public virtual Product Product { get; set; }
     }
  public partial class Product
     {
         public Product()
         {
             this.OrderDetails = new HashSet<OrderDetail>();
         }

         public int ProductId { get; set; }
         public string ProductName { get; set; }
         public decimal UnitPrice { get; set; }

         public virtual ICollection<OrderDetail> OrderDetails { get; set; }
     }

注意，没有Product到OrdeDetail的关联，因为我们在设计器中移除了导航属性（译注：实际上，没有移除）

　　　　6、为了使用POCO类，实体框架生成了DbContext的派生类。这个类将我们模型中的每个实体公布成ObjectSet<T>类型。 代码清章8-2演示了，这个类的定义。

代码清单8-2. 生成模型时创建的DbContext派生类

  public partial class EFRecipesEntities : DbContext
     {
         public EFRecipesEntities()
             : base("name=EFRecipesEntities")
         {
         }

         protected override void OnModelCreating(DbModelBuilder modelBuilder)
         {
             throw new UnintentionalCodeFirstException();
         }

         public DbSet<Customer> Customers { get; set; }
         public DbSet<Order> Orders { get; set; }
         public DbSet<OrderDetail> OrderDetails { get; set; }
         public DbSet<Product> Products { get; set; }
     }

　　这样就完成了使用生成POCO类的模型，代码清单8-3演示了从模型中插入和获取数据

代码清单8-3. 使用POCO类

 class Program
     {
         static void Main(string[] args)
         {
                 RunExample();
         }

         static void RunExample()
         {
             using (var context = new EFRecipesEntities())
             {
                 var tea = new Product { ProductName = "Green Tea", UnitPrice = 1.09M };
                 var coffee = new Product
                 {
                     ProductName = "Colombian Coffee",
                     UnitPrice = 2.15M
                 };
                 var customer = new Customer { ContactName = "Karen Marlowe" };
                 var order1 = new Order { OrderDate = DateTime.Parse("10/06/13") };
                 order1.OrderDetails.Add(new OrderDetail
                 {
                     Product = tea,
                     Quantity = ,
                     UnitPrice = 1.00M
                 });
                 order1.OrderDetails.Add(new OrderDetail
                 {
                     Product = coffee,
                     Quantity = ,
                     UnitPrice = 2.15M
                 });
                 customer.Orders.Add(order1);
                 context.Customers.Add(customer);
                 context.SaveChanges();
             }

             using (var context = new EFRecipesEntities())
             {
                 var query = context.Customers.Include("Orders.OrderDetails.Product");
                 foreach (var customer in query)
                 {
                     Console.WriteLine("Orders for {0}", customer.ContactName);
                     foreach (var order in customer.Orders)
                     {
                         Console.WriteLine("--Order Date: {0}--",
                                      order.OrderDate.ToShortDateString());
                         foreach (var detail in order.OrderDetails)
                         {
                             Console.WriteLine(
                                 "\t{0}, {1} units at {2} each, unit discount: {3}",
                                 detail.Product.ProductName,
                                 detail.Quantity.ToString(),
                                 detail.UnitPrice.ToString("C"),
                                 (detail.Product.UnitPrice - detail.UnitPrice).ToString("C"));
                         }
                     }
                 }
             }
             Console.WriteLine("Enter input to exit:");
             string line = Console.ReadLine();
             if (line == "exit")
             {
                 return;
             };
         }
     }

代码清单8-3的输出如下：

Orders for Karen Marlowe
--Order Date: //--
    Green Tea,  units at $1.00 each, unit discount: $0.09
    Colombian Coffee,  units at $2.15 each, unit discount: $0.00

原理

　　生成POCO类，是当前版本实体框架的默认特性。代码生成策略的属性值已经被设置为None。上下文对象也是被单独生成。所以POCO类中已经没有了数据访问代码。

　　如果与模型中实体对应的所有类已经被创建，它们简单，洁净。这样的话就，没有代码生成，没有上下文被生成。为了实现适合我们模型和实体的上下文对象，派生至DbContext的一个新类在数据模型生成时就被创建了。这个类还提供了对应每个实体的，类型为DbSet<T>的属性。 默认情况下，我们的上下文对象EFRecipesEntities，已经包含了能连接数据库的构造函数代码。

实体框架交流QQ群:  458326058，欢迎有兴趣的朋友加入一起交流

谢谢大家的持续关注，我的博客地址：http://www.cnblogs.com/VolcanoCloud/