NHibernate - Relações Inversas

Neste capítulo, abordaremos outro recurso que são os relacionamentos inversos. É uma opção divertida que você verá na coleção que é inversamente igual a true e também confunde muitos desenvolvedores. Então, vamos falar sobre essa opção. Para entender isso, você realmente precisa pensar sobre o modelo relacional. Digamos que você tenha associações bidirecionais usando uma única chave estrangeira.

  • Do ponto de vista relacional, você tem uma chave estrangeira e ela representa o cliente para pedido e os pedidos para o cliente.

  • No modelo OO, você tem associações unidirecionais usando essas referências.

  • Não há nada que diga que duas associações unidirecionais representam a mesma associação bidirecional no banco de dados.

  • O problema aqui é que o NHibernate não tem informações suficientes para saber que customer.orders e order.customer representam o mesmo relacionamento no banco de dados.

  • Precisamos fornecer inverse equals true como uma dica, é porque as associações unidirecionais estão usando os mesmos dados.

  • Se tentarmos salvar esses relacionamentos que possuem 2 referências a eles, o NHibernate tentará atualizar essa referência duas vezes.

  • Na verdade, ele fará uma viagem extra de ida e volta ao banco de dados e também terá 2 atualizações para aquela chave estrangeira.

  • O inverso igual a verdadeiro informa ao NHibernate qual lado do relacionamento deve ser ignorado.

  • Quando você a aplica ao lado da coleção, o NHibernate sempre atualiza a chave estrangeira do outro lado, do lado do objeto filho.

  • Então, temos apenas uma atualização para essa chave estrangeira e não temos atualizações adicionais para esses dados.

  • Isso nos permite evitar essas atualizações duplicadas na chave estrangeira e também nos ajuda a prevenir violações de chave estrangeira.

Vamos dar uma olhada no customer.cs arquivo no qual você verá o AddOrdere a ideia aqui é que agora temos esse ponteiro de volta do pedido de volta ao cliente e ele precisa ser configurado. Portanto, quando um pedido é adicionado a um cliente, o ponteiro de retorno desse cliente é definido, caso contrário, seria nulo, portanto, precisamos disso para mantê-lo conectado corretamente no gráfico do objeto.

using System; 
using System.Text; 
using Iesi.Collections.Generic;

namespace NHibernateDemo {
 
   public class Customer { 
      
      public Customer() {
         MemberSince = DateTime.UtcNow; Orders = new HashedSet<Order>();
      } 
      
      public virtual Guid Id { get; set; } 
      public virtual string FirstName { get; set; } 
      public virtual string LastName { get; set; } 
      public virtual double AverageRating { get; set; } 
      public virtual int Points { get; set; } 
      public virtual bool HasGoldStatus { get; set; } 
		
      public virtual DateTime MemberSince { get; set; } 
      public virtual CustomerCreditRating CreditRating { get; set; } 
      public virtual Location Address { get; set; }
      public virtual ISet<Order> Orders { get; set; }
      public virtual void AddOrder(Order order) { Orders.Add(order); order.Customer = this; }
      
      public override string ToString() { 
         var result = new StringBuilder(); 
			
         result.AppendFormat("{1} {2} ({0})\r\n\tPoints: {3}\r\n\tHasGoldStatus:
            {4}\r\n\tMemberSince: {5} ({7})\r\n\tCreditRating: {6}\r\n\tAverageRating:
            {8}\r\n", Id, FirstName, LastName, Points, HasGoldStatus, MemberSince,
            CreditRating, MemberSince.Kind, AverageRating);
         result.AppendLine("\tOrders:"); 
         
         foreach(var order in Orders) { 
            result.AppendLine("\t\t" + order); 
         } 
			
         return result.ToString(); 
      } 
   }
   
   public class Location { 
      public virtual string Street { get; set; } 
      public virtual string City { get; set; } 
      public virtual string Province { get; set; } 
      public virtual string Country { get; set; }
   } 
   
   public enum CustomerCreditRating { 
      Excellent, 
      VeryVeryGood, 
      VeryGood, 
      Good, 
      Neutral, 
      Poor, 
      Terrible 
   } 
}

Aqui está o Program.cs implementação de arquivo.

using System; 
using System.Data; 
using System.Linq; 
using System.Reflection; 

using HibernatingRhinos.Profiler.Appender.NHibernate; 
using NHibernate.Cfg; 
using NHibernate.Dialect; 
using NHibernate.Driver; 
using NHibernate.Linq;

namespace NHibernateDemo { 

   internal class Program { 
	
      private static void Main() { 
		
         var cfg = ConfigureNHibernate(); 
         var sessionFactory = cfg.BuildSessionFactory();
         Guid id; 
         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(); 
         }
         
         using(var session = sessionFactory.OpenSession())

         using(var tx = session.BeginTransaction()) { 
            var query = from customer in session.Query<Customer>() where
               customer.Id == id select customer; 
					
            var reloaded = query.Fetch(x => x.Orders).ToList().First();
            Console.WriteLine("Reloaded:"); Console.WriteLine(reloaded); 
					
            tx.Commit(); 
         }
			
         Console.WriteLine("Press <ENTER> to exit..."); 
         Console.ReadLine(); 
      }
      
      private static Customer CreateCustomer() { 
         var customer = new Customer { 
            FirstName = "John", 
            LastName = "Doe", 
            Points = 100, 
            HasGoldStatus = true, 
            MemberSince = new DateTime(2012, 1, 1), 
            CreditRating = CustomerCreditRating.Good, 
            AverageRating = 42.42424242, 
            Address = CreateLocation() 
         }; 
			
         var order1 = new Order { Ordered = DateTime.Now }; 
         
         customer.AddOrder(order1); var order2 = new Order {
            Ordered = DateTime.Now.AddDays(-1), 
            Shipped = DateTime.Now, 
            ShipTo = CreateLocation()
         }; 
			
         customer.AddOrder(order2); 
         return customer; 
      }
      
      private static Location CreateLocation() { 
         return new Location { 
            Street = "123 Somewhere Avenue", 
            City = "Nowhere", 
            Province = "Alberta", 
            Country = "Canada" 
         }; 
      }
      
      private static Configuration ConfigureNHibernate() { 
         NHibernateProfiler.Initialize(); 
         var cfg = new Configuration(); 
         
         cfg.DataBaseIntegration(x => { 
            x.ConnectionStringName = "default"; 
            x.Driver<SqlClientDriver>(); 
            x.Dialect<MsSql2008Dialect>(); 
            x.IsolationLevel = IsolationLevel.RepeatableRead; 
            x.Timeout = 10; 
            x.BatchSize = 10; 
         }); 
         
         cfg.SessionFactory().GenerateStatistics();
         cfg.AddAssembly(Assembly.GetExecutingAssembly()); 
         return cfg; 
      } 
   } 
}

Ele vai salvar isso no banco de dados e, em seguida, recarregá-lo. Agora vamos executar seu aplicativo e abrir o NHibernate Profiler e ver como ele realmente o salvou.

Você notará que temos 3 grupos de declarações. O primeiro irá inserir o cliente, e o ID desse cliente é o Guid, que está destacado. A segunda instrução é inserida na tabela de pedidos.

Você notará que o mesmo Guia de Id do Cliente está definido lá, então tenha essa chave estrangeira definida. A última instrução é a atualização, que atualizará a chave estrangeira para o mesmo ID do cliente mais uma vez.

Agora o problema é que o cliente tem os pedidos, e os pedidos têm o cliente, não há como não termos dito ao NHibernate que na verdade é o mesmo relacionamento. A maneira como fazemos isso é com inverso igual a verdadeiro.

Então, vamos para o nosso customer.hbm.xml arquivo de mapeamento e defina o inverso igual a verdadeiro, conforme mostrado no código a seguir.

<?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" 
         inverse = "true"> 
         <key column = "CustomerId"/> 
         <one-to-many class = "Order"/> 
      </set> 
   
   </class> 
</hibernate-mapping>

Ao salvar os pedidos, ele definirá a chave estrangeira do lado do pedido. Agora, vamos executar este aplicativo novamente e abrir o perfilador NHibernate.

Se olharmos como eles são inseridos, obtemos a inserção no cliente e a inserção nos pedidos, mas não temos aquela atualização duplicada da chave estrangeira porque ela está sendo atualizada quando os pedidos estão sendo salvos.

  • Agora, você deve notar que se você tem apenas uma associação unidirecional e é o conjunto que está mantendo essa relação, então se você transformar o inverso em verdadeiro, aquela chave estrangeira nunca será definida e esses itens nunca terão seus chaves estrangeiras definidas no banco de dados.

  • Se você olhar para a relação muitos-para-um no Order.hbm.xml arquivo e você procura inverse, na verdade não tem um atributo inverse.

  • Ele sempre é definido a partir do item filho, mas se você tiver uma coleção muitos para muitos, poderá defini-la de qualquer lado.