NHibernate - 级联操作



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

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

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

  • 这样做的原因是,您可能存在这样的关系:客户有一个默认的送货地址,并且该送货地址由许多不同的客户共享。

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

  • 因此,级联的整个概念是告诉 NHibernate 如何处理其子实体。

级联有不同的选项,如下所示:

  • none - 这是默认值,表示不级联。

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

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

  • delete - 它将级联删除操作。

  • all-delete-orphan - 这是一个特殊的选项,非常常用,它与 All 相同,除了如果它找到 Delete-orphan 行,它也会删除这些行。

您可以在 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>

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

因此,在这里,我们希望执行保存更新,因此使用 save-update,它将级联对该客户的任何保存或更新。因此,如果我们获得一个新客户或如果我们正在更改客户,它将级联它。如果它是删除操作,它不会从数据库中删除它。

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

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...

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

广告