Nhibernate-inverse-relationships
NHibernate-逆関係
この章では、逆関係というもう1つの機能について説明します。 これは、コレクションに逆にtrueと等しい面白いオプションであり、多くの開発者を混乱させます。 それでは、このオプションについて話しましょう。 これを理解するには、リレーショナルモデルについて考える必要があります。 単一の外部キーを使用する双方向の関連付けがあるとします。
リレーショナルの観点から、1つの外部キーを取得しました。これは、注文する顧客と注文する顧客の両方を表します。
OOモデルから、これらの参照を使用した単方向の関連付けがあります。
2つの単方向の関連付けがデータベース内の同じ双方向の関連付けを表しているという説明はありません。
ここでの問題は、NHibernateには customer.orders と order.customer がデータベース内の同じ関係を表すことを知るのに十分な情報がないことです。
ヒントとして inverse equals true を提供する必要があります。これは、単方向の関連付けが同じデータを使用しているためです。
2つの参照を持つこれらの関係を保存しようとすると、NHibernateはその参照を2回更新しようとします。
実際には、データベースへの余分なラウンドトリップを実行し、その外部キーに対して2つの更新も行います。
逆の値がtrueの場合、NHibernateは関係のどちらの側を無視するかを指示します。
これをコレクション側に適用すると、NHibernateは常に、子オブジェクト側から反対側から外部キーを更新します。
その後、その外部キーに対する更新は1つだけであり、そのデータに対する追加の更新はありません。
これにより、外部キーに対するこれらの重複した更新を防ぐことができ、外部キー違反の防止にも役立ちます。
*AddOrder* メソッドが表示される *customer.cs* ファイルを見てみましょう。ここでの考え方は、注文から顧客に戻るためのこのバックポインターがあり、設定する必要があるということです。 そのため、注文が顧客に追加されると、その顧客のバックポインターが設定されます。それ以外の場合はnullになるため、オブジェクトグラフで適切に接続するためにこれが必要です。
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
}
}
これが Program.cs ファイルの実装です。
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;
}
}
}
それをデータベースに保存してからリロードします。 それでは、アプリケーションを実行してNHibernate Profilerを開き、実際にどのように保存されたかを見てみましょう。
3つのグループのステートメントがあることに気付くでしょう。 最初の1つは顧客を挿入し、その顧客のIDはGuidであり、強調表示されています。 2番目のステートメントは、ordersテーブルへの挿入です。
同じCustomer Id Guidがそこに設定されていることに気付くので、その外部キーを設定します。 最後のステートメントは更新であり、外部キーを再度同じ顧客IDに更新します。
問題は、顧客に注文があり、注文に顧客がいるということです。NHibernateに実際には同じ関係であることを伝えなかったわけではありません。 これを行う方法は、逆がtrueの場合です。
次のコードに示すように、 customer.hbm.xml マッピングファイルに移動し、逆数をtrueに設定します。
<?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>
注文を保存するとき、注文側からその外部キーを設定します。 次に、このアプリケーションを再度実行して、NHibernateプロファイラーを開きます。
それらがどのように挿入されるかを見ると、顧客への挿入とオーダーへの挿入を取得しますが、オーダーの保存時に更新されているため、外部キーの重複した更新はありません。
- ここで、単方向の関連付けのみがあり、この関係を維持しているのがセットである場合、逆に等しいをtrueにすると、その外部キーは決して設定されず、それらのアイテムはデータベースに設定された外部キー。
- Order.hbm.xml ファイルで多対1の関係を見て、逆を探した場合、実際には逆属性はありません。
- 常に子アイテムから設定されますが、多対多のコレクションがある場合は、どちら側からでも設定できます。