《Entity Framework 6 Recipes》中文翻译系列 (41) ------ 第七章使用对象服务之标识关系中使用依赖实体与异步查询保存...-CSDN博客

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

7-7 标识关系中使用依赖实体

问题

　　你想在标识关系中插入，更新和删除一个依赖实体。

解决方案

　　假设你有如图7-8所示的模型。实体LineItem的实体键是一个复合键。由InvoiceNumber和ItemNumber复合而成。InvoiceNumber同是也是一个外键。

图7-8. Invoie和LineItem是一个标识关系，这是因为实体LineItem的复合实体键

　　当实体的一个属性，既是实体键又是外键时，就可以说这个实体在一个标识关系中。在我们的模型里，实体LineItem的实体键，它的标识，同时也是相对于实体Invoice的外键。实体LineItem被称作依赖实体（depaendent entity),Invoice被称作主实体（principal entity)。

　　实体框架在处理如何删除标识关系中的依赖实体时，有所不同。因为依赖实体不能离开标识关系而存在。简单地从主实体的集合中删除依赖实体，在实体框架中的结果是，删除的依赖实体被标记为删除状态。另外，删除主实体，会连同依赖实体一直被标记为删除。这让我们想起数据库中级联删除。当然，实体框架还允许显式删除依赖实体。代码清单7-5演示了这三种不同的场景。

代码清单7-5. 删除依赖实体

 1  public static class Recipe7Program
 2     {
 3         public static void Run()
 4         {
 5             using (var context = new Recipe7Context())
 6             {
 7 
 8                 var invoice1 = new Invoice
 9                                    {
10                                        BilledTo = "Julie Kerns",
11                                        InvoiceDate = DateTime.Parse("9/19/2013")
12                                    };
13                 var invoice2 = new Invoice
14                                    {
15                                        BilledTo = "Jim Stevens",
16                                        InvoiceDate = DateTime.Parse("9/21/2013")
17                                    };
18                 var invoice3 = new Invoice
19                                    {
20                                        BilledTo ="Juanita James",
21                                        InvoiceDate = DateTime.Parse("9/23/2013")
22                                    };
23                 context.LineItems.Add(new LineItem
24                                           {
25                                               Cost = 99.29M,
26                                               Invoice = invoice1
27                                           });
28                 context.LineItems.Add(new LineItem
29                                           {
30                                               Cost = 29.95M,
31                                               Invoice = invoice1
32                                           });
33                 context.LineItems.Add(new LineItem
34                                           {
35                                               Cost = 109.95M,
36                                               Invoice = invoice2
37                                           });
38                 context.LineItems.Add(new LineItem
39                                           {
40                                               Cost = 49.95M,
41                                               Invoice = invoice3
42                                           });
43                 context.SaveChanges();
44 
45                 // 显示LineItems
46                 Console.WriteLine("Original set of line items...");
47                 DisplayLineItems();
48 
49                 //从invoice1的集合中移除一个LineItem
50                 var item = invoice1.LineItems.ToList().First();
51                 invoice1.LineItems.Remove(item);
52                 context.SaveChanges();
53                 Console.WriteLine("\nAfter removing a line item from an invoice...");
54                 DisplayLineItems();
55 
56                 // 移除 invoice2
57                 context.Invoices.Remove(invoice2);
58                 context.SaveChanges();
59                 Console.WriteLine("\nAfter removing an invoice...");
60                 DisplayLineItems();
61 
62                 //单独移除一个LineItem
63                 context.LineItems.Remove(invoice1.LineItems.First());
64                 context.SaveChanges();
65                 Console.WriteLine("\nAfter removing a line item...");
66                 DisplayLineItems();
67 
68                 //单独更新一个LineItem
69                 var item2 = invoice3.LineItems.ToList().First();
70                 item2.Cost = 39.95M;
71                 context.SaveChanges();
72                 Console.WriteLine("\nAfter updating a line item from an invoice …");
73                 DisplayLineItems();
74             }
75         }
76 
77         static void DisplayLineItems()
78         {
79             bool found = false;
80             using (var context = new Recipe7Context())
81             {
82                 foreach (var lineitem in context.LineItems)
83                 {
84                     Console.WriteLine("Line item: Cost {0}", 
85                                        lineitem.Cost.ToString("C"));
86                     found = true;
87                 }
88             }
89             if (!found)
90                 Console.WriteLine("No line items found!");
91         }
92 
93     }

代码清单7-5的输出如下：

Original set of line items...
Line item: Cost $99.29
Line item: Cost $29.95
Line item: Cost $109.95
Line item: Cost $49.95
After removing a line item from an invoice...
Line item: Cost $29.95
Line item: Cost $109.95
Line item: Cost $49.95
After removing an invoice...
Line item: Cost $29.95
After removing a line item...
Line item: Cost $49.95
After updating a line item...
Line item: Cost $39.95

原理

　　代码清单7-5使用三种方法删除LineItem。第一种从Invoice的集合中删除。因为一个LineItem依赖Invoice的标识，实体框架标记引用的LineItme对象为删除状态。第二种是删除invoice对象，实体框架会标记所有的依赖于此对象的lineItme为删除状态。最后一种，是直接调用Remove()方法从上下文对象中的LineItems实体集中删除最后剩下的一个lineItem对象。

　　你可以修改依赖实体的，除了标识关系中的属性以外的所有属性。在我们的模型中，可以修改实体LineItem中的Cost属性。但不能修改Invoice导航属性。

　　当我们保存一个标识关系中的主实体对象时，它的实体键值是从数据库中产生（由存储层产生值），并被写回到主实体对象，以及它的所有依赖实体中的。这得确保所有的操作在数据库上下文中都是同步进行的。

7-8 使用数据库上下文插入实体

问题

　　你想使用数据上下文将模型中实体插入到数据库中。

解决方案

　　假设你有如图7-9所示的模型。

图7-9 一个包含实体employee和task的模型

　　图7-9中的模型表示员工和他们的任务。你想插入一个新的员工和它的任务到数据库中。为了插入一个员工，创建一个Employee的实例并调用上下文对象中Employees实体集中的方法Add()。为了添加员工的一个任务，创建一个Task的实例，并将它添加到employee对象的Tasks集合中。你还必须调用Add()方法将employee和task添加到数据库上下文中。最后，调用SaveChanges()方法，将这些变化持久化到数据库中。

　　代码清单7-6演示了，使用Add()方法添加新对象到上下文中，并调用SaveChanges()方法持久化到数据库中。

代码清单7-6. 插入新实体到数据库

 1  public static class Recipe8Program
 2     {
 3         public static void Run()
 4         {
 5             using (var context = new Recipe8Context())
 6             {
 7                 var employee1 = new Employee
 8                 {
 9                     EmployeeNumber = 629,
10                     Name = "Robin Rosen",
11                     Salary = 106000M
12                 };
13                 var employee2 = new Employee
14                 {
15                     EmployeeNumber = 147,
16                     Name = "Bill Moore",
17                     Salary = 62500M
18                 };
19                 var task1 = new Task { Description = "Report 3rd Qtr Accounting" };
20                 var task2 = new Task { Description = "Forecast 4th Qtr Sales" };
21                 var task3 = new Task { Description = "Prepare Sales Tax Report" };
22 
23                 //在Employees实体集上使用Add()方法
24                 context.Employees.Add(employee1);
25 
26                 //添加两个新的task到employee1的Tasks中
27                 employee1.Tasks.Add(task1);
28                 employee1.Tasks.Add(task2);
29 
30                 // 添加一个task到employee2的Tasks中,并使用Add()方法添加task到上下文中
31                 employee2.Tasks.Add(task3);
32                 context.Tasks.Add(task3);
33 
34                 //持久化到数据库
35                 context.SaveChanges();
36             }
37 
38             using (var context = new Recipe8Context())
39             {
40                 foreach (var employee in context.Employees)
41                 {
42                     Console.WriteLine("Employee: {0}'s Tasks", employee.Name);
43                     foreach (var task in employee.Tasks)
44                     {
45                         Console.WriteLine("\t{0}", task.Description);
46                     }
47                 }
48             }
49             
50         }
51     }

代码清单7-6的输出如下：

Employee: Bill Moore's Tasks
    Prepare Sales Tax Repor
Employee: Robin Rosen's Tasks
    Report 3rd Qtr Accounti
    Forecast 4th Qtr Sales

原理

　　在代码清单7-6中，我们使用实体集Employees和Tasks中的Add()方法，添加实体到数据库上下文中。

　　当你添加一个实体到上下文中，实体框架会为这个新加入的实体，创建一个临时实体键。实体框架使用这个临时的键来唯一标识该实体。当实体被持久化到数据库后，这个临时的实体键，会被一个真正的键值给替换。如果添加到数据库中的两个实体被分配相同的实体键，实体框架会抛出一个异常。这种情况一般发生在客户端或者存储生成过程，给实体分配了相同的键值。

　　对于外键关联，你可以使用关联实体的实体键分配给实体的外键属性。虽然涉及临时键值，但实体框架会在实体被保存到数据库后，正确地修正键和关系。

　　你还可以使用Attach()方法来添加一个实体到上下文中。这是一个分为两步的过程，首先是调用Attach()方法。它将添加实体到上下文中，但是变化跟踪器一开始将实体标记为Unchanged状态。如果这时调用SaveChanges()方法，它不会将实体保存到数据库。第二步是，将实体递给上下文的Entry()方法，获得一个DBEntityEntry实例，并设置它的属性State为新的状态：EntityState.Added。这时调用SaveChanges()方法会将新实体保存到数据库。

7-9 异步查询和保存

问题

　　你想在执行查询和持久化变更时，保持应用程序的响应性。

解决方案

　　假设你有POCO实体，Account和Transaction,你想使用Code-First建模，如代码清单7-7所示。

 1  public class Account
 2     {
 3         public int AccountNumber { get; set; }
 4         public string AccountHolder { get; set; }
 5 
 6         public virtual ICollection<Transaction> Transactions { get; set; } 
 7     }
 8 
 9     public class Transaction
10     {
11         public int AccountNumber { get; set; }
12         public int TransactionNumber { get; set; }
13         public DateTime TransactionDate { get; set; }
14         public decimal Amount { get; set; }
15     }

　　实体Transaction显然是实体Account的依赖实体，所以我们通过创建一个EntityTypeConfiguration子类来为每个实体配置关系。如代码清单7-8所示。

代码清单7-8. 配置实体Account和Transaction

 1  public class AccountTypeConfiguration : EntityTypeConfiguration<Account>
 2     {
 3         public AccountTypeConfiguration()
 4         {
 5             HasKey(a => a.AccountNumber);
 6 
 7             Property(a => a.AccountNumber)
 8                 .HasDatabaseGeneratedOption(DatabaseGeneratedOption.Identity);
 9 
10             HasMany(a => a.Transactions)
11                 .WithRequired();
12         }
13     }
14 
15     public class TransactionTypeConfiguration : EntityTypeConfiguration<Transaction>
16     {
17         public TransactionTypeConfiguration()
18         {
19             HasKey(t => new {t.AccountNumber, t.TransactionNumber});
20 
21             Property(t => t.TransactionNumber)
22                 .HasDatabaseGeneratedOption(DatabaseGeneratedOption.Identity);
23         }
24     }

　　最后，在代码清单7-9中，我们创建DbContext的子类并重写OnModelCreating方法，在这个方法中，我们添加实体配置到模型构建器的配置集合中。

代码清单7-9. 创建DbContext的子类

 1  public class Recipe9Context : DbContext
 2     {
 3         public DbSet<Account> Accounts { get; set; }
 4         public DbSet<Transaction> Transactions { get; set; }
 5 
 6         public Recipe9Context() : base("name=EF6CodeFirstRecipesContext")
 7         {
 8             
 9         }
10 
11         protected override void OnModelCreating(DbModelBuilder modelBuilder)
12         {
13             base.OnModelCreating(modelBuilder);
14 
15             modelBuilder.Configurations.Add(new AccountTypeConfiguration());
16             modelBuilder.Configurations.Add(new TransactionTypeConfiguration());
17         }
18     }

　　为了异步查询和保存，我们将分别使用LINQ to Entities方法ForEachAsync()，和上下文DbContext的方法SaveChangesAsync()。代码清单7-10演示了这两个方法的用法。

代码清单7-10. 异步查询和保存

  1  public static class Recipe9Program
  2     {
  3         public static async Task Run()
  4         {
  5             using (var context = new Recipe9Context())
  6             {
  7                 var account1 = new Account
  8                 {
  9                     AccountHolder = "Robert Dewey",
 10                     Transactions = new HashSet<Transaction>()
 11                                                           {
 12                                                               new Transaction
 13                                                                   {
 14                                                                       TransactionDate = Convert.ToDateTime("07/05/2013"),
 15                                                                       Amount = 104.00M
 16                                                                   },
 17                                                              new Transaction
 18                                                                  {
 19                                                                      TransactionDate = Convert.ToDateTime("07/12/2013"),
 20                                                                      Amount = 104.00M
 21                                                                  },
 22                                                              new Transaction
 23                                                                  {
 24                                                                      TransactionDate = Convert.ToDateTime("07/19/2013"),
 25                                                                      Amount = 104.00M
 26                                                                  }
 27                                                           }
 28                 };
 29                 var account2 = new Account
 30                 {
 31                     AccountHolder = "James Cheatham",
 32                     Transactions = new List<Transaction>
 33                                                           {
 34                                                               new Transaction
 35                                                                   {
 36                                                                       TransactionDate = Convert.ToDateTime("08/01/2013"),
 37                                                                       Amount = 900.00M
 38                                                                   },
 39                                                               new Transaction
 40                                                                   {
 41                                                                       TransactionDate = Convert.ToDateTime("08/02/2013"),
 42                                                                       Amount = -42.00M
 43                                                                   }
 44                                                           }
 45                 };
 46                 var account3 = new Account
 47                 {
 48                     AccountHolder = "Thurston Howe",
 49                     Transactions = new List<Transaction>
 50                                                           {
 51                                                               new Transaction
 52                                                                   {
 53                                                                       TransactionDate = Convert.ToDateTime("08/05/2013"),
 54                                                                       Amount = 100.00M
 55                                                                   }
 56                                                           }
 57                 };
 58 
 59                 context.Accounts.Add(account1);
 60                 context.Accounts.Add(account2);
 61                 context.Accounts.Add(account3);
 62                 context.SaveChanges();
 63 
 64                 //为每个account添加每月的服务费
 65                 foreach (var account in context.Accounts)
 66                 {
 67                     var transactions = new List<Transaction>
 68                                        {
 69                                            new Transaction
 70                                                {
 71                                                    TransactionDate = Convert.ToDateTime("08/09/2013"),
 72                                                    Amount = -5.00M
 73                                                },
 74                                            new Transaction
 75                                                {
 76                                                    TransactionDate = Convert.ToDateTime("08/09/2013"),
 77                                                    Amount = -2.00M
 78                                                }
 79                                        };
 80 
 81                     Task saveTask = SaveAccountTransactionsAsync(account.AccountNumber, transactions);
 82 
 83                     Console.WriteLine("Account Transactions for the account belonging to {0} (acct# {1})", account.AccountHolder, account.AccountNumber);
 84                     await saveTask;
 85                     await ShowAccountTransactionsAsync(account.AccountNumber);
 86                 }
 87 
 88 
 89             }
 90 
 91         }
 92 
 93         private static async Task SaveAccountTransactionsAsync(int accountNumber, ICollection<Transaction> transactions)
 94         {
 95             using (var context = new Recipe9Context())
 96             {
 97                 var account = new Account { AccountNumber = accountNumber };
 98                 context.Accounts.Attach(account);
 99                 context.Entry(account).Collection(a => a.Transactions).Load();
100 
101                 foreach (var transaction in transactions.OrderBy(t => t.TransactionDate))
102                 {
103                     account.Transactions.Add(transaction);
104                 }
105 
106                 await context.SaveChangesAsync();
107 
108             }
109 
110         }
111 
112         private static async Task ShowAccountTransactionsAsync(int accountNumber)
113         {
114             Console.WriteLine("TxNumber\tDate\tAmount");
115             using (var context = new Recipe9Context())
116             {
117                 var transactions = context.Transactions.Where(t => t.AccountNumber == accountNumber);
118                 await transactions.ForEachAsync(t => Console.WriteLine("{0}\t{1}\t{2}", t.TransactionNumber, t.TransactionDate, t.Amount));
119             }
120         }
121     }

原理

　　示例中使用的异步结构是.NET4.5引入的，用来降低平常编写异步代码的复杂性。当我们调用SaveAccountTransactionsAsync()方法时，我们将它分配给Task对象。它调用方法并向调用者返回执行权。同时，异步部分,SaveAccounTransactionsAsync()也在执行。调用ShowAccountTransactionsAsync()方法的代码与调用SaveAccountTransactionsAsync()方法类似。当等待两个方法的调用返回时，执行权返回到await语句的下一行代码。

　　重要的是，要知道.NET4.5中的异步模型是单线程，不是多线程，所以，代码 await SaveAccountTransactionsAsync()会被挂起，直到这个方法返回。另外需要知道的是，任何方法在调用一个async方法时，它自己必须被async修改符标记，并且返回一个Task类型或者Task<T>类型。

　　代码清单7-10的输出如下：

Account Transactions for the account belonging to Robert Dewey (acct# 1)
TxNumber Date Amount
1 7/5/2013 12:00:00 AM 104.00
2 7/12/2013 12:00:00 AM 104.00
3 7/19/2013 12:00:00 AM 104.00
7 8/9/2013 12:00:00 AM -5.00
8 8/9/2013 12:00:00 AM -2.00
Account Transactions for the account belonging to James Cheatham (acct# 2)
TxNumber Date Amount
4 8/1/2013 12:00:00 AM 900.00
5 8/2/2013 12:00:00 AM -42.00
9 8/9/2013 12:00:00 AM -5.00
10 8/9/2013 12:00:00 AM -2.00
Account Transactions for the account belonging to Thurston Howe (acct# 3)
TxNumber Date Amount
6 8/5/2013 12:00:00 AM 100.00
11 8/9/2013 12:00:00 AM -5.00
12 8/9/2013 12:00:00 AM -2.00