在使用NHibernate的过程中也遇到了许多麻烦,不过也得到了不少体会。例如NH的不足之处,我理想中的ORM框架是怎么样的,等等这些,以后有机会也可以慢慢和各位进行讨论。
不过这篇文章谈论的其实只是一个小技巧,一个workaround,而且甚至于这个是由于我对NHibernate不够了解而造成的。因此,如果您有更好的做法也请不吝指出。这个问题也就是“如何实现NHibernate一对一映射的延迟加载”。
NHibernate一对一映射问题描述
之前对于问题的描述,其实还有很多额外的要求没有讲清楚,而需要“workaround”的现状,也是这些要求共同形成的。经过尝试,如果放弃其中任何一个(如把主表ID的生成策略从identity改为native),则可能就会有更直接的做法了。这些条件是:
NHibernate一对一映射
主键关联
主表的ID为自增字段
所有字段NOT NULL。
主表和子表设置级联删除
现在的问题,就是在这些条件下,如何实现“获取主表对象时,并不加载其对应的子表数据”,也就是所谓的“延迟加载”。当然,除了能够“延迟加载”以外,还必须可以插入,更新和删除——我也尝试过使用某些特殊的映射方式,可以实现延迟加载,但是却无法插入,这自然也无法满足要求。
为了便于理解和实验,我在这里也将其“具体化”。首先是Model,User和UserDetail,它们是典型的一对一关系:
- public class User
- {
- public virtual int UserID { get; set; }
- public virtual string Name { get; set; }
- public virtual UserDetail Detail { get; set; }
- }
- public class UserDetail
- {
- public virtual int UserID { get; set; }
- public virtual int Age { get; set; }
- public virtual User User { get; set; }
- }
而数据库方面则是一个User表和一个UserDetail表:
- CREATE TABLE [dbo].[User](
- [UserID] [int] IDENTITY(1,1) NOT NULL,
- [Name] [nvarchar](50) NOT NULL,
- CONSTRAINT [PK_User] PRIMARY KEY CLUSTERED
- (
- [UserID] ASC
- ))
- GO
- CREATE TABLE [dbo].[UserDetail](
- [UserID] [int] NOT NULL,
- [Age] [int] NOT NULL,
- CONSTRAINT [PK_UserDetail] PRIMARY KEY CLUSTERED
- (
- [UserID] ASC
- ))
- GO
- ALTER TABLE [dbo].[UserDetail] WITH CHECK ADD
- CONSTRAINT [FK_UserDetail_User] FOREIGN KEY([UserID])
- REFERENCES [dbo].[User] ([UserID])
- ON DELETE CASCADE
- GO
- ALTER TABLE [dbo].[UserDetail] CHECK CONSTRAINT [FK_UserDetail_User]
- GO
User表为主表,主键为UserID,自增。UserDetail为副表,主键为UserID,同时作为外键与User表产生关联。同时,外键上设置了级联删除,也就是在删除User表的纪录时,会自动删除UserDetail的纪录。
对于环境的描述就到这里,如果您想要自己实验的话,可以直接使用这些代码。值得强调一下的是,有些朋友可能会使用NHibernate自动生成数据表,那么请注意严格调整NHibernate的配置,使其与这个环境完全相同。
传统一对一映射
关于一对一映射是否可以延迟加载的问题,我在互联网上找了许多资料。有NHibernate的资料,也有没N的资料。有的资料上说不支持,有的资料却又说可以实现。不过根据那些说“可以”的资料进行配置,却还是无法做到延迟加载。而把这个问题发到NHibernate的用户邮件列表中也没有得到答复。不管怎么样,我把普通的配置也发布在这里吧。
- <?xml version="1.0" encoding="utf-8" ?>
- <hibernate-mapping xmlns="urn:nhibernate-mapping-2.2" assembly="NHTest" namespace="NHTest">
- <class name="User" table="`User`">
- <id name="UserID" type="Int32" column="UserID">
- <generator class="identity" />
- </id>
- <one-to-one name="Detail" class="UserDetail" cascade="save-update" lazy="proxy" />
- <property name="Name" type="String" />
- </class>
- <class name="UserDetail" table="`UserDetail`" lazy="true">
- <id name="UserID" type="Int32" column="UserID">
- <generator class="foreign">
- <param name="property">User</param>
- </generator>
- </id>
- <one-to-one name="User" class="User" constrained="true" />
- <property name="Age" type="Int32" />
- </class>
- </hibernate-mapping>
按照某些资料的说法,我们把one-to-one的lazy设为proxy,并且把UserDetail节点的lazy设为true,便可以实现延迟加载。也就是说,在执行以下代码时,并不会去获取UserDetail的内容:
var user = session.Get<User>(1);
可是现在,NHibernate告诉我们现在使用的SQL是这样子的(您也可以使用SQL Profiler进行观察):
- SELECT
- user0_.UserID as UserID0_1_,
- user0_.Name as Name0_1_,
- userdetail1_.UserID as UserID1_0_,
- userdetail1_.Age as Age1_0_
- FROM
- [User] user0_
- left outer join
- [UserDetail] userdetail1_
- on user0_.UserID=userdetail1_.UserID
- WHERE
- user0_.UserID=@p0;
- @p0 = 1
很明显,它仍然把UserDetail一并获取出来了。如果您觉得这里哪里错了,请告诉我。
开始绕弯路
从现在开始,我们就要走“弯路”了。虽然我们无法在一对一映射的情况下实现延迟加载,但是我们可以轻易做到“一对多”映射时,延迟加载“集合”中的子对象。我们这个workaround的关键,便是利用了“一对多”情况下的延迟加载,把“一对一”作为“一对多”的特殊情况进行处理。不过这里就需要我们修改User的Model了:
- public class User
- {
- public virtual int UserID { get; set; }
- public virtual string Name { get; set; }
- private ISet<UserDetail> m_detailLazyProxySet;
- private ISet<UserDetail> DetailLazyProxySet
- {
- get
- {
- if (this.m_detailLazyProxySet == null)
- {
- this.m_detailLazyProxySet = new HashedSet<UserDetail>();
- }
- return this.m_detailLazyProxySet;
- }
- set
- {
- this.m_detailLazyProxySet = value;
- }
- }
- public virtual UserDetail Detail
- {
- get
- {
- return this.DetailLazyProxySet.Count <= 0 ? null :
- this.DetailLazyProxySet.Single();
- }
- set
- {
- this.DetailLazyProxySet.Clear();
- this.DetailLazyProxySet.Add(value);
- }
- }
- }
也多亏NHibernate支持对private属性的读写,我们可以把DetailLazyProxySet设为私有属性,对外部保持“纯洁”——但是,很明显我们还是污染了Model。因此,这无论如何也只是一个workaround。
如果您使用xml进行配置,这自然没有什么问题。不过我还是喜欢使用Fluent NHibernate,流畅,方便,还可以导出为xml。因此,我们这里提供Fluent NHibernate的代码,相信您也可以轻易得出它所对应的xml配置内容:
- public class UserMap : ClassMap<User>
- {
- public UserMap()
- {
- Id(u => u.UserID).GeneratedBy.Identity();
- Map(u => u.Name);
- var paramExpr = Expression.Parameter(typeof(User));
- var propertyExpr = Expression.Property(paramExpr, "DetailLazyProxySet");
- var castExpr = Expression.Convert(propertyExpr, typeof(IEnumerable<UserDetail>));
- var lambdaExpr = Expression.Lambda<Func<User, IEnumerable<UserDetail>>>(castExpr, paramExpr);
- HasMany(lambdaExpr)
- .LazyLoad()
- .AsSet()
- .KeyColumnNames.Add("UserID")
- .Cascade.All()
- .Inverse();
- }
- }
- public class UserDetailMap : ClassMap<UserDetail>
- {
- public UserDetailMap()
- {
- Id(d => d.UserID).GeneratedBy.Foreign("User");
- Map(d => d.Age);
- HasOne(d => d.User).Constrained();
- }
- }
值得一提的是,由于DetailLazyProxySet是私有的,我们必须手动地构造一个Lambda表达式传递给HasMany方法。在实际使用过程中,我们应该提供额外的辅助方法(自然是为ClassMap<T>新增一个扩展方法),并配合约定(属性名 + LazyProxySet)来进行强类型的编码定义。它可能是这样的:
HasOneByProxySet(u => u.Detail)...
嗯,就是这么点代码。
实验
打开NHibernate的SQL输出,并编写如下代码:
- var user = session.Get<User>(1);
- Console.WriteLine("Name: {0}", user.Name);
- Console.WriteLine("Age: {0}", user.Detail.Age);
输出如下:
- NHibernate:
- SELECT
- user0_.UserID as UserID1_0_,
- user0_.Name as Name1_0_
- FROM
- [User] user0_
- WHERE
- user0_.UserID=@p0;
- @p0 = 1
- ===> Name: Jeffrey Zhao
- NHibernate:
- SELECT
- detaillazy0_.UserID as UserID1_,
- detaillazy0_.UserID as UserID0_0_,
- detaillazy0_.Age as Age0_0_
- FROM
- [UserDetail] detaillazy0_
- WHERE
- detaillazy0_.UserID=@p0;
- @p0 = 1
- ===> Age: 25
请注意两条输出(已标红)的位置,很明显现在已经实现了延迟加载。那么我们要“饥渴加载(Eager Load)”又当如何?其实也很简单:
- var user = session
- .CreateCriteria<User>()
- .SetFetchMode("DetailLazyProxySet", FetchMode.Eager)
- .Add(Expression.IdEq(8))
- .UniqueResult<User>();
- Console.WriteLine("===> Name: {0}", user.Name);
- Console.WriteLine("===> Age: {0}", user.Detail.Age);
同样,“扩展方法”配合“约定”,我们可以把SetFetchMode这行古怪的代码改成:
.SetFetchMode(u => u.Detail)...
输出如下:
- NHibernate:
- SELECT
- this_.UserID as UserID1_1_,
- this_.Name as Name1_1_,
- detaillazy2_.UserID as UserID3_,
- detaillazy2_.UserID as UserID0_0_,
- detaillazy2_.Age as Age0_0_
- FROM
- [User] this_
- left outer join
- [UserDetail] detaillazy2_
- on this_.UserID=detaillazy2_.UserID
- WHERE
- this_.UserID = @p0;
- @p0 = 8
- ===> Name: Jeffrey Zhao
- ===> Age: 25
我们的饥渴换来数据库的级联,和谐而统一。
NHibernate一对一映射的延迟加载总结
至此,我们成功地实现了“一对一”的延迟加载,但是对NHibernate来说,一切都是个一对多的关系。我们获得了表面的成功,付出了“Model被污染”的代价。
原文来自赵劼的博客园博文《NHibernate中一对一关联的延迟加载》
【编辑推荐】