NHibernate - 级联


在本章中,我们将介绍如何使用级联功能。如果您有一组或一组项目或两个类之间的关系(例如我们的客户和订单)并且具有外键关系。如果我们默认删除客户,NHibernate 不会对子对象执行任何操作,因此属于该客户和我们的子对象可能是孤立订单。

  • 我们也可能违反外键约束,因此我们可以使用级联的概念。

  • 默认情况下,NHibernate 不会将操作级联到子对象。

  • 原因是您可以拥有一些关系,例如某个客户具有默认送货地址,并且该送货地址与许多不同的客户共享。

  • 因此,您不一定希望级联这种关系,因为其他客户仍在引用它。

  • 所以级联的整个概念就是告诉 NHibernate 如何处理它的子实体。

级联有不同的选项,如下 -

  • none - 这是默认值,意味着没有级联。

  • all - 将级联保存、更新和删除。

  • save-update - 它将级联、保存和更新。

  • 删除- 它将级联删除。

  • all-delete-orphan - 这是一种非常常用的特殊行,与 All except 相同,如果它发现删除孤儿行,它也会删除这些行。

您可以在hbm.xml文件中指定默认值,这样您就可以在该 Hibernate 映射元素上提供默认级联,也可以为特定集合和关系(例如多对一)指定它。

让我们看一下简单的级联示例,让我们解决程序中的问题,我们必须手动将保存级联到订单,如以下代码所示。

using(var session = sessionFactory.OpenSession()) 

using(var tx = session.BeginTransaction()) { 
   var newCustomer = CreateCustomer(); 
   Console.WriteLine("New Customer:"); 
   Console.WriteLine(newCustomer); 
   session.Save(newCustomer); 
	
   foreach (var order in newCustomer.Orders) { 
      session.Save(order); 
   } 
	
   id = newCustomer.Id; 
   tx.Commit(); 
}

在上面的代码片段中,您可以看到我们正在手动保存客户的所有订单。现在让我们删除保存所有订单的手动级联代码。

using(var session = sessionFactory.OpenSession())
 
using(var tx = session.BeginTransaction()) { 
   var newCustomer = CreateCustomer(); 
   Console.WriteLine("New Customer:"); 
   Console.WriteLine(newCustomer);
	
   session.Save(newCustomer); 
   id = newCustomer.Id; 
   tx.Commit(); 
}

我们需要在customer.hbm.xml中指定级联选项。

<?xml version = "1.0" encoding = "utf-8" ?> 
<hibernate-mapping xmlns = "urn:nhibernate-mapping-2.2" assembly = "NHibernateDemo"
   namespace = "NHibernateDemo"> 
	
   <class name = "Customer"> 
   
      <id name = "Id"> 
         <generator class = "guid.comb"/> 
      </id> 
      
      <property name = "FirstName"/> 
      <property name = "LastName"/> 
      <property name = "AverageRating"/> 
      <property name = "Points"/> 
      <property name = "HasGoldStatus"/> 
      <property name = "MemberSince" type = "UtcDateTime"/> 
      <property name = "CreditRating" type = "CustomerCreditRatingType"/>
      
      <component name = "Address"> 
         <property name = "Street"/> 
         <property name = "City"/> 
         <property name = "Province"/> 
         <property name = "Country"/> 
      </component>
      
      <set name = "Orders" table = "`Order`" cascade = "all-delete-orphan"> 
         <key column = "CustomerId"/> 
         <one-to-many class = "Order"/> 
      </set> 
   
   </class> 
</hibernate-mapping>
  • 现在,订单完全属于客户。因此,如果从数据库中删除客户,我们的应用程序将希望删除所有这些订单,包括任何可能已孤立的订单。

  • 它最终会进行删除。此时,它会显示“从订单表中删除”,其中客户 ID 等于您要删除的客户。

  • 所以你实际上可以级联这些删除。因此,使用All,它将执行保存、更新和删除操作。

现在,当您运行此应用程序时,您将看到以下输出。

New Customer:
John Doe (00000000-0000-0000-0000-000000000000)
   Points: 100
   HasGoldStatus: True
   MemberSince: 1/1/2012 12:00:00 AM (Unspecified)
   CreditRating: Good
   AverageRating: 42.42424242

   Orders:
      Order Id: 00000000-0000-0000-0000-000000000000
      Order Id: 00000000-0000-0000-0000-000000000000

Reloaded:
John Doe (10b2a3d7-7fcf-483c-b1da-a5bb00b8512e)
   Points: 100
   HasGoldStatus: True
   MemberSince: 1/1/2012 12:00:00 AM (Utc)
   CreditRating: Good
   AverageRating: 42.4242

   Orders:
      Order Id: e6680e30-5b3b-4efa-b017-a5bb00b85133
      Order Id: b03858e7-8c36-4555-8878-a5bb00b85134

The orders were ordered by:
John Doe (10b2a3d7-7fcf-483c-b1da-a5bb00b8512e)
   Points: 100
   HasGoldStatus: True
   MemberSince: 1/1/2012 12:00:00 AM (Utc)
   CreditRating: Good
   AverageRating: 42.4242

   Orders:
      Order Id: e6680e30-5b3b-4efa-b017-a5bb00b85133
      Order Id: b03858e7-8c36-4555-8878-a5bb00b85134

John Doe (10b2a3d7-7fcf-483c-b1da-a5bb00b8512e)
   Points: 100
   HasGoldStatus: True
   MemberSince: 1/1/2012 12:00:00 AM (Utc)
   CreditRating: Good
   AverageRating: 42.4242

   Orders:
      Order Id: e6680e30-5b3b-4efa-b017-a5bb00b85133
      Order Id: b03858e7-8c36-4555-8878-a5bb00b85134
		
Press <ENTER> to exit...

正如您所看到的,我们已经从程序中删除了手动级联的代码,并且我们的应用程序仍然可以运行。

因此,根据你们的关系,您可能想要级联这些。现在,我们来看看不同的级联关系。让我们转到Order.hbm.xml文件,我们可以级联该多对一关系。

<?xml version = "1.0" encoding = "utf-8" ?> 
<hibernate-mapping xmlns = "urn:nhibernate-mapping-2.2" assembly = "NHibernateDemo"
   namespace = "NHibernateDemo"> 
   
   <class name = "Order" table = "`Order`"> 
	
      <id name = "Id"> 
         <generator class = "guid.comb"/> 
      </id> 

      <property name = "Ordered"/> 
      <property name = "Shipped"/> 
      
      <component name = "ShipTo"> 
         <property name = "Street"/> 
         <property name = "City"/> 
         <property name = "Province"/> 
         <property name = "Country"/> 
      </component> 
      
      <many-to-one name = "Customer" column = "CustomerId" cascade = "save-update"/>
		
   </class> 
</hibernate-mapping>

因此,如果我们创建一个新订单,并且有一个新客户附加到它,我们说,保存该订单,我们可能想要级联它。但我们可能不想做的一件事是,如果删除订单以删除相应的客户。

因此,在这里,我们想要进行保存更新,因此使用保存更新,它将向该客户级联任何保存或更新。因此,如果我们获得了新客户或者我们正在更换客户,就会发生连锁反应。如果是删除,则不会从数据库中删除它。

再次运行我们的应用程序,一切仍然按预期工作。

New Customer:
John Doe (00000000-0000-0000-0000-000000000000)
   Points: 100
   HasGoldStatus: True
   MemberSince: 1/1/2012 12:00:00 AM (Unspecified)
   CreditRating: Good
   AverageRating: 42.42424242

   Orders:
      Id: 00000000-0000-0000-0000-000000000000
      Order Id: 00000000-0000-0000-0000-000000000000

Reloaded:
John Doe (10b2a3d7-7fcf-483c-b1da-a5bb00b8512e)
   Points: 100
   HasGoldStatus: True
   MemberSince: 1/1/2012 12:00:00 AM (Utc)
   CreditRating: Good
   AverageRating: 42.4242

   Orders:
      Order Id: e6680e30-5b3b-4efa-b017-a5bb00b85133
      Order Id: b03858e7-8c36-4555-8878-a5bb00b85134

The orders were ordered by:
John Doe (10b2a3d7-7fcf-483c-b1da-a5bb00b8512e)
   Points: 100
   HasGoldStatus: True
   MemberSince: 1/1/2012 12:00:00 AM (Utc)
   CreditRating: Good
   AverageRating: 42.4242

   Orders:
      Order Id: e6680e30-5b3b-4efa-b017-a5bb00b85133
      Order Id: b03858e7-8c36-4555-8878-a5bb00b85134
      John Doe (10b2a3d7-7fcf-483c-b1da-a5bb00b8512e)
		
   Points: 100
   HasGoldStatus: True
   MemberSince: 1/1/2012 12:00:00 AM (Utc)
   CreditRating: Good
   AverageRating: 42.4242

   Orders:
      Order Id: e6680e30-5b3b-4efa-b017-a5bb00b85133
      Order Id: b03858e7-8c36-4555-8878-a5bb00b85134
		
Press <ENTER> to exit...

现在您应该看一下您的应用程序,请记住默认值是“无”,您必须考虑您的实体以及它们之间的关系,以确定每个实体以及该数据库中的每个关系的适当级联。